.. highlightlang:: us

.. index:: OBJSetColorGradient

.. _objsetcolorgradient:

OBJSetColorGradient
===================

.. us.tag  OBJSetColorGradient GERMAN draw-set Changed6002

:ref:`OBJSetColorGradient` setzt die Farben für den
Farbverlauf eines Zeichenobjekts oder Diagramms.

.. function::  bool = OBJSetColorGradient(hobj, rvRGB1, rvRGB2)
               bool = OBJSetColorGradient(hobj, rvARGB1, rvARGB2)

.. us.return

**Returnwert**

*bool* ist TRUE (1), wenn die Funktion erfolgreich war und
sonst FALSE (0).

.. us.params

**Parameter**

.. uparam:: hobj

   *hobj* ist die Zugriffsnummer einer Linie, eines
   Textes, eines Rechtecks, einer Ellipse oder eines Layers (Diagramms).

.. uparam:: rvRGB1

   ist ein Vektor mit 3 Elementen:

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

      * - Wert
        - Bedeutung
      * - rvRGB1[1]
        - (Unten) Rot (0 bis 255)
      * - rvRGB1[2]
        - (Unten) Grün (0 bis 255)
      * - rvRGB1[3]
        - (Unten) Blau (0 bis 255)

.. uparam:: rvRGB2

   ist ein Vektor mit 3 Elementen:

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

      * - Wert
        - Bedeutung
      * - rvRGB2[1]
        - (Oben) Rot (0 bis 255)
      * - rvRGB2[2]
        - (Oben) Grün (0 bis 255)
      * - rvRGB2[3]
        - (Oben) Blau (0 bis 255)

.. uparam:: rvARGB1

   *rvARGB1* ist ein Vektor mit vier Elementen für die Farbe unten:

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

      * - Wert
        - Bedeutung
      * - rvARGB1[1]
        - Alpha: 0 = Transparent, 255 = Deckend
      * - rvARGB1[2]
        - Rotanteil der Farbe im Bereich 0 bis 255
      * - rvARGB1[3]
        - Grünanteil der Farbe im Bereich 0 bis 255
      * - rvARGB1[4]
        - Blauanteil der Farbe im Bereich 0 bis 255

.. uparam:: rvARGB2

   *rvARGB2* ist ein Vektor mit vier Elementen für die Farbe oben:

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

      * - Wert
        - Bedeutung
      * - rvARGB2[1]
        - Alpha: 0 = Transparent, 255 = Deckend
      * - rvARGB2[2]
        - Rotanteil der Farbe im Bereich 0 bis 255
      * - rvARGB2[3]
        - Grünanteil der Farbe im Bereich 0 bis 255
      * - rvARGB2[4]
        - Blauanteil der Farbe im Bereich 0 bis 255

.. us.example

**Beispiel**

::

   hRB = RBCreate();  // Rechteck erzeugen
   OBJSetBkMode(hRB, OPAQUE);
   OBJSetFillMode(hRB, 1); // Farbverlauf
   OBJSetColorGradient(hRB, [0,0,0], [255,255,255]);

.. us.history

**History**

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

   * - Version
     - Beschreibung
   * - R2018.2
     - Transparenz.

.. seealso::
   :ref:`uberblick-zeichenobjekte`,
   :ref:`OBJGetColorGradient`

:sub:`id-824681`