TableAddBrush fügt eine neue Füllfarbe in die Füllfarbenliste (brush list) ein.
Returnwert
nBrushIndex liefert den Index der Füllfarben. Damit die Füllfarbe für die gewünschten Zellen verwendet wird, muss der Index über die Funktion TableSetBrushIndex gesetzt werden.
Parameter
hTable ist die Zugriffsnummer (Handle) des mit TableCreate erzeugten Tabellen-Objekts.
rvColorRGB ist ein Vektor mit 3 Elementen:
| Wert | Bedeutung |
|---|---|
| rvColorRGB[1] | Rotanteil der Farbe im Bereich 0 bis 255 |
| rvColorRGB[2] | Grünanteil der Farbe im Bereich 0 bis 255 |
| rvColorRGB[3] | Blauanteil der Farbe im Bereich 0 bis 255 |
Beispiel
Im folgenden Beispiel wird ein neuer Brush erzeugt und der Brushliste zugefügt. Damit die Zellen der ersten Zeile mit der neuen Füllfarbe dargestellt werden wird der Index mit der Funktion TableSetBrushIndex gesetzt.
rvColor = GetColorDialog();
index = TableAddBrush(hTable, rvColor);
rvSize = TableGetSize(hTable);
rmIndex = zeros(1, rvSize[2]) + index;
rvSel = [1, 1, rvSize[2], 1];
TableSetBrushIndex(hTable, rmIndex, rvSel);
id-849620