.. highlightlang:: us

.. _xyzdeletelabel:

XYZDeleteLabel
==============

.. index:: XYZDeleteLabel

.. us.tag  XYZDeleteLabel GERMAN XYZSet_label

:ref:`XYZDeleteLabel` löscht die Beschriftungen der Isolinien innerhalb eines Rechtecks.

.. function::  bool = XYZDeleteLabel(hData, rvRect)

.. us.return

**Returnwert**

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

.. us.params

**Parameter**

.. uparam:: hData

   *hData* ist die Zugriffsnummer (Handle) des Datensatzes, der mit :ref:`XYZCreate`
   erzeugt wurde.

.. uparam:: rvRect

   *rvRect* ist ein Vektor mit 4 Elementen:

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

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

.. us.example

**Beispiel**

Alle Label löschen:

::

   ...
   rvRect = XYZGetMatrixRange(hData);
   XYZDeleteLabel(hData, rvRect);
   ...

Die Koordinaten werden in Weltkoordinaten eingegeben. Alle Beschriftungen, die
sich innerhalb des durch die Punkte P1 und P2 gebildeten Rechtecks befinden,
werden gelöscht.

.. seealso::
   :ref:`uberblick-xyz-datensatze`,
   :ref:`XYZCreate`,
   :ref:`XYZInsertLabel`

:sub:`id-314814`