_onSqlGridGetCellColors

value _onSqlGridGetCellColors ( string strControl, value strRowContent, value RowNr, value ColumnNr, string strColumnName, string strContent, 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 Zelle ü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 Zelle (RowNr | ColumnNr/strColumnName) 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 Zelle, die abgefragt wird.

ColumnNr

Die Spaltennummer der Zelle, die abgefragt wird.

strColumnName

Der Name der Spalte, die abgefragt wird.

strContent

Der Inhalt der Zelle, 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 einzelner Tabellenzellen. Sie wird vom Bauelement vor jedem Neuzeichnen der Zellen aufgerufen.

Da diese Funktion für jede einzelne Zelle aufgerufen wird, sollte diese Callback-Funktion nicht für SQL-Select Abfragen eingesetzt werden, die ein sehr umfangreiches Abfrageergebnis haben. Für komplette Zeileneinfärbungen sollte daher die Callback-Funktion _onSqlGridGetRowColors verwendet oder auf die Zeilenfärbung durch Spalten (siehe dort unter 'Zeilenfärbung durch Spalteninhalt steuern') ausgewichen werden.

Beispiel

Im nachfolgenden Beispiel werden die Zeilen abwechselnd mit zwei unterschiedlichen Farben hinterlegt. Da hier weder die Spaltennummer noch der Spaltenname berücksichtigt wird, wird jeder Zelle einer Zeile der Farbwert zugewiesen.

//_onSqlGridGetCellColors (strControl, strRowContent, RowNr, ColumnNr, strColumnName, strContent, 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