_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