.. highlightlang:: us

.. index:: CBRemoveAllObjects

.. _cbremoveallobjects:

CBRemoveAllObjects
==================

.. us.tag  CBRemoveAllObjects GERMAN

:ref:`CBRemoveAllObjects` entfernt alle Zugriffsnummern aus einem Gruppen-Objekt.
Die Zeichenobjekte werden gelöscht.

.. function::  bool = CBRemoveAllObjects(hlink)

.. us.return

**Returnwert**

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

.. us.params

**Parameter**

.. uparam:: hlink

   *hlink* ist die Zugriffsnummer des mit :ref:`CBCreate` erzeugten
   Gruppen-Objekts.

.. us.comment

**Kommentar**

Um bestimmte Objekte aus dem Gruppenelement zu löschen kann man mit
der Funktion :ref:`CBGetAllObjects` die Zugriffsnummer der eingebetteten
Objekte erfragen. Mit :ref:`ObjDestroy` können dann die entsprechenden
Objekte gelöscht werden. Danach sollte man noch die Funktion :ref:`CBUpdate`
aufrufen.

.. seealso::
   :ref:`uberblick-gruppen-objekte`,
   :ref:`CBCreate`,
   :ref:`CBGetAllObjects`

:sub:`id-1362400`