.. highlightlang:: us

.. index:: OBJSetSelect

.. _objsetselect:

OBJSetSelect
============

.. us.tag  OBJSetSelect ENGLISH draw-set

:ref:`OBJSetSelect` selects or unselects an object.

.. function::  bool = OBJSetSelect(hobj, bSelect)

.. us.return

**Return Value**

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

.. us.params

**Parameters**

.. uparam:: hobj

   *hobj* identifies a line, text, rectangle, ellipse or layer (diagram) object.

.. uparam:: bSelect

   If *bSelect* is TRUE (1), the object will be selected. If *bSelect* is
   FALSE (0), the object will be unselected.

.. us.example

**Example**

::

   hDoc = DocCreate()
   hPage = PageCreate()
   DocAddPage(hDoc, hPage);
   hLayer = LayerCreate()
   PageAddLayer(hPage, hLayer)
   hRb = RBCreate()
   LayerAddObjects(hLayer, hrb)
   OBJSetPosSize(hRb, [3, -8, 3, 3])
   OBJSetSelect(hRb, FALSE)    // Deselect Object
   PageReplot(hPage)

.. seealso::
   :ref:`overview-drawing-objects`,
   :ref:`OBJIsSelected`

:sub:`id-68294`