.. highlightlang:: us

.. index:: PenDialog

.. _pendialog:

PenDialog
=========

.. us.tag  PenDialog GERMAN DialogBoxes

:ref:`PenDialog` zeigt ein Dialogfeld zur Konfiguration eines Zeichenstifts an.

.. function::  hNewPen = PenDialog()
    hNewPen = PenDialog(hPen)
    hNewPen = PenDialog(nStyle, nWidth, rvColorRGB)

.. us.return

**Returnwert**

*hNewPen* ist die Zugriffsnummer des neu erzeugten
Zeichenstifts. Falls der Zeichenstift nicht erzeugt werden kann
liefert die Funktion den Wert 0. Falls der Benutzer die
Abbrechen-Schaltfläche gedrückt hat, liefert die Funktion den Wert -1.

.. us.params

**Parameter**

.. uparam:: hPen

   *hPen* ist die Zugriffsnummer eines Zeichenstifts,
   mit dem das Dialogfeld initialisiert werden soll.

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

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

:sub:`id-1334085`