.. highlightlang:: us

.. index:: LayerSetAxisTB

.. _layersetaxistb:

LayerSetAxisTB
==============

.. us.tag  LayerSetAxisTB NOTREADYGERMAN LayerAxisTitle

:ref:`LayerSetAxisTB` kopiert das angegebene Text-Objekt in den Achsentitel.

.. function::  bool = LayerSetAxisTB(hLayer, ssXYZ, hText)

.. us.return

**Returnwert**

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

.. 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 und ``"Z"``, falls die Funktion die z-Achse
   betrifft.

.. uparam:: hText

   *hText* ist der Handle eines Textobjekts.

.. us.example

**Beispiel**

::

   //hPage = auto_LoadTemplate(...)
   hPage = 20;   // Handle einfach aus Statuszeile abgelesen
   hLayer = PageGetLayerHandle(hPage, "Diagramm1");
   hText = LayerGetAxisTB(hLayer, "X");
   TBSetText(hText, "Drehzahl");
   TBSetAlignHorz(hText, LEFT);
   OBJSetColorGradient(hText, [255,0,0], [0,255,255])
   OBJSetFillMode(hText, 1)
   OBJSetBkMode(hText, 0)
   LayerSetAxisTB(hLayer, "X", hText);
   TBDestroy(hText); // Kopie wieder löschen, sonst Speicherverlust.

.. seealso::
   :ref:`LayerCreate`,
   :ref:`LayerGetAxisTB`

:sub:`id-1653779`