.. highlightlang:: us

.. index:: OBJSetProtect

.. _objsetprotect:

OBJSetProtect
=============

.. us.tag  OBJSetProtect GERMAN draw-set Changed5402

:ref:`OBJSetProtect` schaltet bestimmte Attribute für Diagramme und
Zeichenelemente ein oder aus.

.. function::  bool = OBJSetProtect(hobj, nProtect)

.. us.return

**Returnwert**

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

.. us.params

**Parameter**

.. uparam:: hobj

   *hobj* ist die Zugriffsnummer einer Linie, eines Textes, eines Rechtecks,
   einer Ellipse oder eines Layers (Diagramms).

.. uparam:: nProtect

   *nProtect* ist eine Kombination (ODER-Verknüpfung) aus den folgenden
   Attributen:

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

      * - Wert
        - Bedeutung
      * - BL_FULLCONTROL
        - Schaltet alle Attribute aus.
      * - BL_NOEDIT
        - Das Objekt kann nicht doppelgeklickt werden.
      * - BL_NOSIZE
        - Die Größe eines Objektes kann nicht verändert werden.
      * - BL_NOPOS
        - Die Position eines Objektes kann nicht verändert werden.
      * - BL_NODIVIDE
        - Zusammgengefaßte Objekte können nicht aufgetrennt werden.
      * - BL_NOBLOCKEDIT
        - Einzelne Objekte eines zusammengefaßten Objektes können nicht doppelgeklickt werden.
      * - BL_NOAXISEDIT
        - Achsenelemente können nicht doppelgeklickt werden.
      * - BL_NOPRINT
        - Das Objekt wird nicht auf dem Drucker ausgegeben.
      * - BL_NOHANDLE
        - Die Element-Handle werden nicht gezeichnet.
      * - BL_NODATA
        - Das Diagramm kann keine Datensätze aufnehmen.
      * - BL_NODRAG
        - Ist eine Abkürzung für (BL_NOSIZE | BL_NOPOS)
      * - BL_FIXED
        - Ist eine Abkürzung für (BL_NOEDIT | BL_NOSIZE | BL_NOPOS).
      * - BL_NOSELECT
        - Entspricht BL_FIXED.
      * - BL_HIDE
        - Versteckt das Element. Es ist dann nicht mehr sichtbar.
      * - BL_CLICKBUTTON
        - Textfelder: Callbackfunktion wird aufgerufen.
      * - BL_DISPLAYBUTTON
        - Textfeld wird als Schalfläche dargestellt.

.. us.example

**Beispiel**

::

   hrect = RBCreate();
   OBJSetPosSize(hrect, [5, -10, 5, 5]);
   OBJSetProtect(hrect, BL_FIXED | BL_NOHANDLE);

.. us.history

**History**

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

   * - Version
     - Beschreibung
   * - R2012.2 (5.40.2)
     - Neue Attribute ``BL_CLICKBUTTON`` und ``BL_DISPLAYBUTTON``.

.. seealso::
   :ref:`uberblick-zeichenobjekte`,
   :ref:`OBJGetProtect`,
   :ref:`OBJGetVisible`,
   :ref:`OBJSetVisible`

:sub:`id-639009`