TableAddBrush

TableAddBrush fügt eine neue Füllfarbe in die Füllfarbenliste (brush list) ein.

nBrushIndex = TableAddBrush(hTable, rvColorRGB)

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

hTable ist die Zugriffsnummer (Handle) des mit TableCreate erzeugten Tabellen-Objekts.

rvColorRGB

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