.. highlightlang:: us

.. _tableaddbrush:

TableAddBrush
=============

.. index:: TableAddBrush

.. us.tag  TableAddBrush table.brush New400

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

.. function::  nBrushIndex = TableAddBrush(hTable, rvColorRGB)

.. us.return

**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 :ref:`TableSetBrushIndex` gesetzt
werden.

.. us.params

**Parameter**

.. uparam:: hTable

   *hTable* ist die Zugriffsnummer (Handle) des mit
   :ref:`TableCreate` erzeugten Tabellen-Objekts.

.. uparam:: rvColorRGB

   *rvColorRGB* ist ein Vektor mit 3 Elementen:

   .. list-table::
      :header-rows: 1

      * - 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

.. us.example

**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 :ref:`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);

.. seealso::
   :ref:`uberblick-tabellenobjekt`,
   :ref:`TableGetBrushList`,
   :ref:`TableGetBrushIndex`,
   :ref:`TableSetBrushIndex`

:sub:`id-849620`