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.

id-1724895