.. highlightlang:: us

.. _objsetrefpoint:

OBJSetRefPoint
==============

.. index:: OBJSetRefPoint

.. us.tag  OBJSetRefPoint ENGLISH New580 draw-set

:ref:`OBJSetRefPoint` specifies, to which corner of the object the position 
coordinates refer.

.. function::  bool = OBJSetRefPoint(hobj, nRefPointWC)

.. us.return

**Return Value**

*bool* is TRUE (1) if the function was successful, and FALSE (0) if an
error occued.

.. us.params

**Parameters**

.. uparam:: hobj

   *hobj* identifies the text, rectangle, table or
   ellipse object.

.. uparam:: nRefPointWC

   *nRefPointWC* is an OR combination of two of
   the following values:

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

   * - Name
     - Value
     - Meaning
   * - LEFT
     - 4
     - Left corner.
   * - CENTER
     - 2
     - Center between left and right corner.
   * - RIGHT
     - 1
     - Right corner.
   * - TOP
     - 8
     - Top corner.
   * - MIDDLE
     - 16
     - Center between top and bottom corner.
   * - BOTTOM
     - 32
     - Bottom corner.

.. us.example

**Example**

::

   OBJSetRefPoint(hTable, LEFT | TOP);

.. seealso::
   :ref:`overview-drawing-objects`,
   :ref:`OBJSetPosWC`,
   :ref:`OBJSetRefPointWC`,
   :ref:`OBJGetRefPointWC`

:sub:`id-329311`