.. highlightlang:: us

.. index:: PenCreate

.. _pencreate:

PenCreate
=========

.. us.tag  PenCreate GERMAN Changed427

:ref:`PenCreate` erzeugt einen Zeichenstift, der an Zeichenobjekte und Datensätze
übergeben werden kann.

.. function::  hPen = PenCreate()
    hPen = PenCreate(hPenOther)
    hPen = PenCreate(nStyle, nWidth, rvColorRGB)

.. us.return

**Returnwert**

*hPen* ist die Zugriffsnummer (Handle) mit der auf den Zeichenstift zugegriffen
werden kann. Falls der Zeichenstift nicht erzeugt werden kann ist *hPen*
gleich 0.

.. us.params

**Parameter**

.. uparam:: nStyle

   *nStyle* ist einer der folgenden Werte:

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

      * - Wert
        - Bedeutung
      * - PS_SOLID
        - durchgezogener Zeichenstift
      * - PS_DASH
        - gestrichelter Zeichenstift
      * - PS_DOT
        - gepunkteter Zeichenstift
      * - PS_DASHDOT
        - strich-punktierter Zeichenstift
      * - PS_DASHDOTDOT
        - strich-doppel-punktierter Zeichenstift
      * - PS_NULL
        - nicht sichtbarer Zeichenstift

.. uparam:: nWidth

   *nWidth* ist die Dicke des Zeichenstifts in 0.1 mm.

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

.. us.history

**History**

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

   * - Version
     - Beschreibung
   * - 4.2.7
     - Die Funktion kann auch als Kopier-Konstruktor aufgerufen werden.

.. seealso::
   :ref:`uberblick-pens`,
   :ref:`PenDestroy`,
   :ref:`ObjCopy`

:sub:`id-246394`