_onSqlGridIterateRows
value _onSqlGridIterateRows ( string strControl, value RowNr, string strRowContent, value UserValue );
Rückgabewert
Rückgabewert |
Beschreibung |
|
Diese Callback-Funktion erwartet keinen Rückgabewert. |
Parameter
strControl
Der Name des Bauelements SQL-Tabelle, dessen Zeilen bzw. ausgewählte Zeilen durchlaufen werden sollen.
RowNr
Die Zeilennummer, der Zeile die in diesem
Durchlauf abgehandelt wird, außer RowNr
ist kleiner als 0. Dann gilt:
Mit RowNr == -1 wird der Start von
nachfolgenden Callback-Aufrufen signalisiert.
Mit RowNr == -2 wird das Ende der
Zeileniteration signalisiert.
strRowContent
Der Inhalt der Zeile, die in diesem Durchlauf abgehandelt wird. Die Zeichenkette besteht aus den einzelnen Spaltenwerten, die mit einem Linefeed '\n' zusammengefügt sind.
Bemerkungen
Diese Callback-Funktion wird für alle Zeilen einer SQL-Tabelle aufgerufen, nachdem die Funktion SqlGridStartIteration zu dieser SQL-Tabelle aufgerufen wurde. Es erfolgen immer (n+2)-fache Aufrufe dieser Funktion, wobei n die Anzahl der selektieren bzw. verfügbaren Zeilen ist.
Beispiel
Im nachfolgenden Beispiel werden die Durchlaufergebnisse einer SqlGridStartIteration in der Tabelle result abgelegt. Mit Abschluss des Durchlaufs wird eine Aktualisierung der SQL-Tabelle result ausgelöst.
//_onSqlGridIterateRows (strControl, RowNr, strRowContent, UserValue) ////////////////////////////////////////////////////////////////////// if (RowNr == -1) SqliteExecute(dxDatabase, "delete from result"); elseif (RowNr == -2) SqlGridRequery("result"); end string content = strRowContent; StringReplace(content, "\n", ","); SqliteExecute(dxDatabase, "insert into result (RowNr, Content) values ('%d', '%s')", RowNr, content);
Die Callback-Funktionen der SQL-Tabelle
Siehe auch onOdbcGridGetColumnTitle, onOdbcGridError, onOdbcGridSelChangeRow, onOdbcGridSelectedRows