_onSqlGridGetRowColors

value _onSqlGridGetRowColors ( string strControl, value strRowContent, value RowNr, BYREF value rgbTextColor, BYREF value rgbBackColor );

Rückgabewert

Rückgabewert	Beschreibung
TRUE / true / 1	Die neuen Farbwerte für Text- und/oder Hintergrundfarbe sollen für die Zeile übernommen werden.
FALSE / false / 0	Die Farbwerte für Text- und Hintergrundfarbe sollen nicht geändert werden.

Parameter

strControl

Der Name des Bauelements SQL-Tabelle, die nach der Text- und Hintergrundfarbe der Zeile RowNr fragt.

strRowContent

Der Inhalt der kompletten Zeile. Die Zeichenkette besteht aus den einzelnen Spaltenwerten, die mit einem Linefeed '\n' zusammengefügt sind.

RowNr

Die Zeilennummer der Zeile, die abgefragt wird.

rgbTextColor

Soll eine Umfärbung der Textfarbe erfolgen, muss diesem Parameter die neue Farbe zugewiesen werden.

rgbBackColor

Soll eine Umfärbung der Hintergrundfarbe erfolgen, muss diesem Parameter die neue Farbe zugewiesen werden.

Bemerkungen

Diese Callback-Funktion dient zum Einfärben des Textes und/oder des Hintergrunds einer kompletten Tabellenzeile. Sie wird vom Bauelement vor jedem Neuzeichnen der Zeile aufgerufen.

Alternativ kann auch die Zeilenfärbung durch Spalten (siehe dort unter 'Zeilenfärbung durch Spalteninhalt steuern') verwendet werden.

Beispiel

Im nachfolgenden Beispiel werden die Zeilen abwechselnd mit zwei unterschiedlichen Farben hinterlegt.

//_onSqlGridGetRowColors (strControl, strRowContent, RowNr, BYREF rgbTextColor, BYREF rgbBackColor)
//
//////////////////////////////////////////////////////////////////////
if (RowNr % 2)
    rgbBackColor = RGB_Cornsilk;
else
    rgbBackColor = RGB_Azure;
end
return (true);

Die Callback-Funktionen der SQL-Tabelle

Siehe auch onOdbcGridGetColumnTitle, onOdbcGridError, onOdbcGridSelChangeRow, onOdbcGridSelectedRows