.. highlightlang:: us

.. index:: LayerGetAxisUserLabel

.. _layergetaxisuserlabel:

LayerGetAxisUserLabel
=====================

.. us.tag  LayerGetAxisUserLabel GERMAN LayerAxisLabel New5600

:ref:`LayerGetAxisUserLabel` erfragt die Benutzer Label. Ein Label besteht aus
dem Anzeigetext und der Position auf der Achse.

.. function::  smLabel = LayerGetAxisUserLabel(hLayer, ssXYZ)

.. us.return

**Returnwert**

*smLabel* ist eine Stringmatrix  mit 2 Spalten. Die erste Spalte ist 
enthält die Position auf der Achse als String und die zweite Spalte den
Anzeigetext (siehe Beispiel). Falls keine Benutzerlabel definiert sind, liefert
die Funktion einen leeren String. 

.. us.params

**Parameter**

.. uparam:: hLayer

   *hLayer* ist die Zugriffsnummer des Diagramms, das mit :ref:`LayerCreate`
   erzeugt wurde.

.. uparam:: ssXYZ

   *ssXYZ* ist ``"X"``, falls die Funktion die x-Achse betrifft, ``"Y"``, falls
   die Funktion die y-Achse betrifft. Für die Z-Achse können keine 
   Benutzerlabel angezeigt werden.

.. us.example

**Beispiel**

::

   smEnum = ["1", "On";
             "0", "Off"];
   LayerSetAxisUserLabel(hLayer, "Y", smEnum);
   LayerSetAxisUserLabelAttribs(hLayer, "Y", ...
          AXIS_USERLABEL_ENABLE | AXIS_STANDARDLABEL_DISABLE | AXIS_USERLABEL_SKIPOVERLAP);
   smLabel = LayerGetAxisUserLabel(hLayer, "Y");

.. us.history

**History**

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

   * - Version
     - Beschreibung
   * - R2014
     - Neu.

.. seealso::
   :ref:`uberblick-diagramme`,
   :ref:`LayerCreate`,
   :ref:`LayerGetAxisUserLabelAttribs`,
   :ref:`LayerSetAxisUserLabel`

:sub:`id-1190577`