.. highlightlang:: us

.. _auto_xy_labeldataset:

auto_xy_LabelDataset
====================

.. index:: auto_xy_LabelDataset

.. us.tag  auto_xy_LabelDataset NOTREADYGERMAN auto_xy

:ref:`auto_xy_LabelDataset` beschriftet den letzten
Datenspunkt eines 1D- oder 2D-Datensatzes mit dem Namen des Datensatzes.

.. function::  hText = auto_xy_LabelDataset(hData)
    hText = auto_xy_LabelDataset(hData, rvOffsetCM)
    hText = auto_xy_LabelDataset(hData, rvOffsetCM, bShowHelpLine)
    hText = auto_xy_LabelDataset(hData, rvOffsetCM, bShowHelpLine, nType)
    hText = auto_xy_LabelDataset(hData, rvOffsetCM, bShowHelpLine, nType, rsXPos)

.. us.return

**Returnwert**

*hText* ist die Zugriffsnummer (handle) des erzeugten Text Objekts oder 0
falls das Textobjekt nicht erzeugt werden kann.

.. us.params

**Parameter**

.. uparam:: hData

   *hData* ist die Zugriffsnummer (handle)
   eines 2D Datensatzes.

.. uparam:: rvOffsetCM

   *rvOffsetCM* ist ein Vektor mit
   zwei Elementen:

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

   * - Wert
     - Bedeutung
   * - rvOffsetCM[1]
     - Verschiebung in x-Richtung in Zentimeter.
   * - rvOffsetCM[2]
     - Verschiebung in y-Richtung in Zentimeter.

.. uparam:: bShowHelpLine

   Falls *bShowHelpLine* den Wert
   TRUE (1) hat,  wird eine Hilfslinie vom Datenpunkt zum Text
   gezeichnet.

.. uparam:: nType

   *nType* ist einer der folgenden Werte
   (Default ist 1):

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

   * - Wert
     - Bedeutung
   * - 0
     - Beschrifte ersten Datenpunkt.
   * - 1
     - Beschrifte letzten Datenpunkt.
   * - 2
     - Beschrifte letzten Datenpunkt, wobei der Textwinkel vom Gradient der Kurve abhängt.

.. uparam:: rsXPos

   *rsXPos* Zeichnet den Namen an eine
   bestimmte x-Position. Der Wert wird in den Koordinaten des Datensatzes
   angegeben. Damit kann man erreichen, das wenn mehrere Datensätze beschriftet werden
   sollen, alle Beschriftungen an der gleichen x-Position beginnen.

.. seealso::
   :ref:`uberblick-automatisierung-der-diagrammerstellung`,
   :ref:`auto_LoadTemplate`,
   :ref:`auto_LoadDataset`,
   :ref:`ObjSetName`

:sub:`id-97051`