.. highlightlang:: us

.. index:: XYProtectLegendText

.. _xyprotectlegendtext:

XYProtectLegendText
===================

.. us.tag  XYProtectLegendText GERMAN XYSet New5600

:ref:`XYProtectLegendText` schützt den Legendentext eines Datensatzes gegen
Veränderung.

.. function::  bool = XYProtectLegendText(hData, bProtect)

.. 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:`XYCreate` oder :ref:`TYCreate` erzeugt wurde.

.. uparam:: bProtect

   Wenn *bProtect* auf den Wert TRUE (1) gesetzt wird, kann der Legendentext 
   nicht mehr automatisch, beispielsweise beim Datenaustausch, aktualisiert 
   werden.

.. us.comment

**Kommentar**

Falls die Option **Legendentext bei 1D- und 2D-Datensätzen immer aktualisieren.**
im Dialogfeld :ref:`file-import-options` ausgeschaltet ist, werden die 
Legendentexte nicht aktualisiert.

.. seealso::
   :ref:`uberblick-xy-datensatze`,
   :ref:`XYIsSelected`,
   :ref:`XYCreate`,
   :ref:`XYSetLegendText`

:sub:`id-1702303`