.. highlightlang:: us

.. _auto_xy_labeldatapoints:

auto_xy_LabelDataPoints
=======================

.. index:: auto_xy_LabelDataPoints

.. us.tag  auto_xy_LabelDataPoints NOTREADYGERMAN auto_xy Changed5151 Changed5500

Die Funktion :ref:`auto_xy_LabelDataPoints` beschriftet die Datenpunkte eines 
1D- oder 2D-Datensatzes mit den Y-Koordinaten. Falls der Datensatz mehr als 50
Datenpunkte enthält, werden 50 Beschriftungen auf die Datenpunkte
verteilt.

.. function::  bool = auto_xy_LabelDataPoints(hData)
    bool = auto_xy_LabelDataPoints(hData, rvOffsetCM)
    bool = auto_xy_LabelDataPoints(hData, rvOffsetCM, ssStart)
    bool = auto_xy_LabelDataPoints(hData, rvOffsetCM, ssStart, ssEnd)
    bool = auto_xy_LabelDataPoints(hData, rvOffsetCM, ssStart, ssEnd, ssFormat)
    bool = auto_xy_LabelDataPoints(hData, rvOffsetCM, ssStart, ssEnd, ssFormat, bShowHelpLine)
    bool = auto_xy_LabelDataPoints(hData, rvOffsetCM, ssStart, ssEnd, ssFormat, bShowHelpLine, bHorizontal)
    bool = auto_xy_LabelDataPoints(hData, rvOffsetCM, ssStart, ssEnd, ssFormat, bShowHelpLine, bHorizontal, bExt)

.. us.return

**Returnwert**

*bool* ist TRUE (1), wenn die Funktion erfolgreich war und sonst FALSE (0).

.. us.params

**Parameter**

.. uparam:: hData

   *hData* ist die Zugriffsnummer (handle) eines 2D Datensatzes. Falls *hData* 
   ein Vektor mit zwei Datensatz-Zugriffsnummern ist, wird der Datensatz mit den
   y-Koordinaten des zweiten Datensatzes beschriftet. In diesem Fall müssen
   beide Datensätze die gleiche Punktanzahl besitzen. Siehe Beispiel.

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

   *ssStart* Ein Text der vor dem Wert erscheint. Beispiel: ``"Y="``.

.. uparam:: ssEnd

   *ssEnd* Ein Text der nach dem Wert erscheint. Beispiel: ``" Nm"``.

.. uparam:: ssFormat

   *ssFormat* ist das Zahlenformat. Mögliche Einstellungen, siehe :ref:`printf`.

.. uparam:: bShowHelpLine

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

.. uparam:: bHorizontal

   Falls *bHorizontal* den Wert TRUE (1) hat, wird das Label horizontal
   ausgegeben. Beim Wert FALSE (0) wird der Text um 90° gedreht. Defaultwert ist
   FALSE (0).

.. uparam:: bExt

   Der Parameter legt fest, ob die Funktion auf die Originaldaten oder die 
   gefilterten Daten zugreift.

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

      * - Wert
        - Beschreibung
      * - 1
        - Falls gefilterte Daten vorhanden sind: Zugriff auf die gefilterten Daten, sonst auf die Originaldaten. Der Defaultwert ist 1.
      * - 0
        - Zugriff auf die Originaldaten.

.. us.example

**Beispiel**

In diesem Beispiel wird die Leistung an die Momentenkurve geschrieben.

::

   auto_AddToUI("Examples", "Example 6: WOT 1", "RS_Example6");
   def RS_Example6()
   {
       MessageBox("In the following dialog please select the file VOLLAST.ASC");
       auto_SetFileNameDialogInit("*.asc; *.nc", GetRootDirectory() + "samples/");
       svFile = auto_GetFileNameDialog(3);
       if (svFile[1] == "DLG_CANCEL") {
           return;
       }
       NumberOfFiles = len(svFile);
       hPage = auto_LoadTemplate("example");
       for (i in 1:NumberOfFiles) {
           svFile[i] = auto_ImportData(svFile[i]);
           hData1 = auto_LoadDataset("Diagramm 1", "N", "MEFF");
           hData2 = auto_LoadDataset("Diagramm 1", "N", "EWGLST");
           auto_xy_LabelDataPoints([hData1, hData2], [0, 0.3], "p=", "kW");
           XYShow(hData2, FALSE);
       }
       auto_ScaleAxes();
       auto_ReplaceTextDialog(svFile[1]);
       auto_UpdatePage(TRUE);
   }

.. us.history

**History**

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

   * - Version
     - Beschreibung
   * - R2013
     - Neuer Parameter *bExt*.
   * - 5.15.1
     - Neuer Parameter *bHorizontal*.

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

:sub:`id-689640`