.. highlightlang:: us

.. index:: LayerSetAxisTitleFreePos

.. _layersetaxistitlefreepos:

LayerSetAxisTitleFreePos
========================

.. us.tag  LayerSetAxisTitleFreePos NOTREADYGERMAN LayerAxisTitle New500

:ref:`LayerSetAxisTitleFreePos` legt fest, ob die Position der Achsentitel mit
der Maus verändert werden kann.

.. function::  bool = LayerSetAxisTitleFreePos(hLayer, ssXYZ, bFreePos)

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

   Falls *bFreePos* TRUE (1) ist, kann die Position und Größe mit Hilfe der Maus
   verändert werden.

.. us.example

**Beispiel**

   
**Example**

Y-Achsentitel oben links im Diagramm ausgeben

::

   hLayer = 20;   // Handle retrieved from status bar
   rvPS = OBJGetPosSize(hLayer);
   LayerSetAxisTitleFreePos(hLayer, "Y", TRUE);
   // returns a copy of the text object!
   hText = LayerGetAxisTB(hLayer, "Y");
   rvT_PS = OBJGetPosSize(hText);
   TBSetAngle(hText, 0);
   rvNewPos = [rvPS[1], rvPS[2]+rvPS[4], rvT_PS[3], rvT_PS[4]];
   OBJSetPosSize(hText, rvNewPos);
   TBSetAutoSize(hText, TRUE);
   LayerSetAxisTB(hLayer, "Y", hText);
   TBDestroy(hText); // delete the copy

.. us.history

**History**

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

   * - Version
     - Beschreibung
   * - 5.0.0
     - Neu

.. seealso::
   :ref:`uberblick-diagramme`,
   :ref:`LayerIsAxisTitleAutoPos`,
   :ref:`LayerSetAxisTitleOffset`,
   :ref:`LayerSetAxisTitleAutoPos`,
   :ref:`LayerCreate`

:sub:`id-282353`