.. highlightlang:: us

.. index:: Überblick Pens, Pens 

.. _uberblick-pens:

Überblick Pens
==============

Pens (Zeichenstifte) enthalten die Attribute für die Darstellung von 
Linien (Dicke, Farbe und Stil). Pens können an Datensätze, Diagramme 
und Zeichenobjekte übergeben werden.

Ein erzeugter Pen belegt Speicher. Damit der Speicher wieder frei 
gegeben wird, muss ein Pen gelöscht werden wenn er nicht mehr benötigt 
wird. Ein Pen wird mit der Funktion :ref:`PenDestroy` gelöscht.

.. us.example

**Beispiel**

Das folgende Beispiel bewirkt, das eine rote, 0.4 mm dicke 
gestrichelte Sinus-Kurve erzeugt wird.

::

   // Sinus-Kurve erzeugen
   x = linspace(0,2*PI,100);
   y = sin(x);
   h = plot(x, y);
   // Pen erzeugen
   hPen = PenCreate(PS_DASH, 4, [255, 0, 0]);
   // Den Pen der sinus-Kurve zuweisen
   // Gestrichelt, 0.4 mm dick, rot
   XYSetPen(h[3], hPen);
   // Am Schluss den Pen wieder zerstören.
   // Die ...SetPen-Funktionen verwenden eine
   // Kopie des übergebenen Pens
   PenDestroy(hPen);

.. us.indexlist ErzeugenundZerstörenPenCreatePenDestroyP,Erzeugen und Zerstören,PenCreate,PenDestroy,PenDialog,

.. include:: ../ftab/ErzeugenundZerstörenPenCreatePenDestroyP.ftab

.. us.indexlist SetzenPenSetColorPenSetStylePenSetWidth,Setzen,PenSetColor,PenSetStyle,PenSetWidth,

.. include:: ../ftab/SetzenPenSetColorPenSetStylePenSetWidth.ftab

.. us.indexlist ErfragenPenGetColorPenGetStylePenGetWidt,Erfragen,PenGetColor,PenGetStyle,PenGetWidth,

.. include:: ../ftab/ErfragenPenGetColorPenGetStylePenGetWidt.ftab

.. seealso::
   :ref:`uberblick-fonts`,
   :ref:`uberblick-schraffuren`,
   :ref:`uberblick-marker`,
   :ref:`funktionen-eingeteilt-in-kategorien`

:sub:`id-192412`