.. highlightlang:: us

.. _xyzinsertlabel:

XYZInsertLabel
==============

.. index:: XYZInsertLabel

.. us.tag  XYZInsertLabel GERMAN XYZSet_label Changed500

:ref:`XYZInsertLabel` beschriftet die Isolinien mit ihrem z-Wert.

.. function::  bool = XYZInsertLabel(hData, rvP1P2)

.. 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) des
   Datensatzes, der mit :ref:`XYZCreate` erzeugt wurde.

.. uparam:: rvP1P2

   *rvP1P2* ist ein Vektor mit 4 Elementen:

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

   * - Wert
     - Bedeutung
   * - rvP1P2[1]
     - x-Koordinate von Punkt 1 (P1)
   * - rvP1P2[2]
     - y-Koordinate von Punkt 1 (P1)
   * - rvP1P2[3]
     - x-Koordinate von Punkt 2 (P2)
   * - rvP1P2[4]
     - y-Koordinate von Punkt 2 (P2)

Die Koordinaten werden in Weltkoordinaten eingegeben. Die Beschriftungen der
Isolinien werden an den Schnittpunkten der Geraden mit den Isolinien eingefügt.

.. us.history

**History**

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

   * - Version
     - Beschreibung
   * - 5.0.0
     - Die Funktion schaltet auf User-Label um, siehe :ref:`XYZSetLabelTypeIsolines`.

.. seealso::
   :ref:`uberblick-xyz-datensatze`,
   :ref:`XYZCreate`,
   :ref:`XYZDeleteLabel`,
   :ref:`XYZSetLabelTypeIsolines`

:sub:`id-128941`