.. highlightlang:: us

.. _pensetcolor:

PenSetColor
===========

.. index:: PenSetColor

.. us.tag  PenSetColor GERMAN

:ref:`PenSetColor` setzt die Farbe eines
Zeichenstifts.

.. function::  bool = PenSetColor(hPen, rvColorRGB)

.. us.return

**Returnwert**

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

.. us.params

**Parameter**

.. uparam:: hPen

   *hPen* ist die Zugriffsnummer (Handle) des mit
   :ref:`PenCreate` erzeugten Zeichenstifts.

.. uparam:: rvColorRGB

   *rvColorRGB* ein Vektor mit drei Elementen,
   der die Farbe des Zeichenstifts angibt:

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

.. seealso::
   :ref:`uberblick-pens`,
   :ref:`PenCreate`

:sub:`id-796575`