TableSetText¶
Tauscht den vorhandenen Test einer Zelle, einer Auswahl von Zellen oder in alle Zellen aus.
-
bool = TableSetText(hTable, smText, rvRowCol)
-
bool = TableSetText(hTable, smText)
-
bool = TableSetText(hTable, smText, 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.
-
smText
smText 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 Nummerierung 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 Parametern 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
Im Zellentext können Feldfunktionen eingefügt werden, die dann bestimmte Aktionen
bzw. einen Ergebnistext erzeugen, z. B. @f{date}{25.02.2003}. Bei dieser
Feldfunktion wird beispielsweise der Text 25.02.2003 ausgegeben. Einen
Zeilenumbruch wird durch die folgende Zeichenfolge erreicht: \n
oder \r\n
.
Weitere Informationen über die Texteingabe finden Sie unter
Objekt bearbeiten=>Text. Falls die Zellentexte als Zahlen formatiert werden
sollen, muss als Dezimaltrennzeichen ein Punkt verwendet werden.
Siehe auch
id-1724895