.. highlightlang:: us

.. _objsetrect:

OBJSetRect
==========

.. index:: OBJSetRect

.. us.tag  OBJSetRect ENGLISH draw-set

:ref:`OBJSetRect` sets the bounding rectangle of an object.

.. function::  bool = OBJSetRect(hobj, rvRect)

.. 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:: rvRect

   *rvRect* is [left, bottom, right, top] in centimeters.

.. 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:`OBJGetRect`,
   :ref:`OBJSetPosSize`

:sub:`id-1144290`