.. highlightlang:: us

.. _xygetpen:

XYGetPen
========

.. index:: XYGetPen

.. us.tag  XYGetPen ENGLISH XYGet

:ref:`XYGetPen` returns the pen handle for the
creation of a 2D dataset curve.

.. function::  hPen = XYGetPen(hData)

.. us.return

**Return Value**

*hPen* is the handle of a pen created with :ref:`PenCreate`. If
the pen is not used anymore, it should be deleted with the :ref:`PenDestroy` function.

.. us.params

**Parameters**

.. uparam:: hData

   The handle of a dataset created with :ref:`XYCreate` or
   :ref:`TYCreate`.

.. seealso::
   :ref:`overview-xy-datasets`,
   :ref:`XYSetPen`,
   :ref:`XYShowLine`,
   :ref:`PenCreate`,
   :ref:`XYCreate`

:sub:`id-609236`