TableSetName¶
Tauscht den vorhandenen Namen einer Zelle, einer Auswahl von Zellen oder in allen Zellen aus.
- bool = TableSetName(hTable, smName)
- bool = TableSetName(hTable, smName, rvRowCol)
- bool = TableSetName(hTable, smName, rvSel)
Returnwert
bool ist TRUE (1), wenn die Funktion erfolgreich war und FALSE (0), wenn ein Fehler aufgetreten ist.
Parameter
- hTable
hTable ist die Zugriffsnummer (Handle) des mit TableCreate erzeugten Tabellen-Objekts.
- smName
smName ist eine Stringmatrix. Falls die Funktion mit zwei Parametern aufgerufen wird, muss die Anzahl der Zeilen und Spalten der Matrix mit der Anzahl der Zeilen und Spalten des Tabellenobjekts übereinstimmen. Falls die Funktion mit drei Parametern aufgerufen wird, muss die die Anzahl der Zeilen und Spalten der Matrix mit der Selektion im Parameter rvSel übereinstimmen.
- rvSel
rvSel ist ein Vektor mit vier Elementen:
Element
Beschreibung
rvSel[1]
Linke Zelle der Selektion
rvSel[2]
Obere Zelle der Selektion
rvSel[3]
Rechte Zelle der Selektion
rvSel[4]
Untere Zelle der Selektion
Die Zellennummerierung beginnt mit 1. svSel bestimmt, welche Zellen der Tabelle auf einen neuen Wert gesetzt werden.
- rvRowCol
rvRowCol ist ein Vektor mit zwei Elementen. Falls die Funktion mit drei Parameteren aufgerufen wird und der dritte Parameter rvRowCol ein Vektor mit zwei Elementen ist, wird nur der Text der angegebenen Zelle überschrieben. Der Parameter smText sollte bei diesem Aufruf nur ein Element enthalten. Die Elemente des Vektors rvRowCol haben die folgende Bedeutung:
Element
Beschreibung
rvRowCol[1]
Zeilennummer
rvRowCol[2]
Spaltennummer
Kommentar
Der Name kann für unterschiedliche Zwecke genutzt werden. Beispielsweise können im Namen Platzhalter eingetragen werden. Das sind in $-Zeichen eingeschlossene Texte, z. B. $Origin$ oder $Motornummer$ die dann über einen speziellen Dialog bedient werden können oder durch Stammdaten aus Dateien ersetzt werden können.
Siehe auch
id-283041