.. highlightlang:: us

.. index:: CBRemoveAllObjects

.. _cbremoveallobjects:

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

.. us.tag  CBRemoveAllObjects ENGLISH

Removes all drawing objects from a grouped object. The drawing objects will be
destroyed.

.. function::  bool = CBRemoveAllObjects(hlink)

.. us.return

**Return Value**

If the function succeeds, the return value is TRUE (1); otherwise it is FALSE (0).

.. us.params

**Parameters**

.. uparam:: hlink

   *hlink* identifies the object.

.. us.comment

**Comment**

To remove only some objects use the :ref:`CBGetAllObjects` function to retrieve
the object handles. With the :ref:`ObjDestroy` function the objects can be deleted.
To update the bounding box call :ref:`CBUpdate`.

.. seealso::
   :ref:`overview-group-object`,
   :ref:`CBCreate`,
   :ref:`CBGetAllObjects`

:sub:`id-1362400`