.. highlightlang:: us

.. index:: OBJSetPosSize

.. _objsetpossize:

OBJSetPosSize
=============

.. us.tag  OBJSetPosSize GERMAN draw-set

:ref:`OBJSetPosSize` setzt die Position und Größe eines Zeichenobjekts oder
Diagramms.

.. function::  bool = OBJSetPosSize(hobj, rvPosSize)

.. us.return

**Returnwert**

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

.. us.params

**Parameter**

.. uparam:: hobj

   *hobj* ist die Zugriffsnummer einer Linie, eines Textes, eines Rechtecks,
   einer Ellipse, einer Tabelle oder eines Layers (Diagramms).

.. uparam:: rvPosSize

   *rvPosSize* ist ein Vektor mit 4 Elementen:

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

      * - Wert
        - Bedeutung
      * - rvPosSize[1]
        - x-Koordinate der linken Ecke in Zentimeter
      * - rvPosSize[2]
        - y-Koordinate der unteren Ecke in Zentimeter
      * - rvPosSize[3]
        - Breite des Zeichenobjekts in Zentimeter
      * - rvPosSize[4]
        - Höhe des Zeichenobjekts in Zentimeter

.. us.example

**Beispiel**

::

   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)

Größe einer Tabelle setzen:

::

   hDoc = DocCreate()
   hPage = PageCreate()
   DocAddPage(hDoc, hPage);
   hLayer = LayerCreate()
   PageAddLayer(hPage, hLayer)

   hTable = TableCreate(["Title1:", "A longer line of text"; ..
                "Title1:", "A longer line of text"; ..
                "Title1:", "A longer line of text"]);

   rmAttrib = TableGetAttrib(hTable);
   rmAttrib[;1] = rmAttrib[;1] | (TABLE_AUTOSIZE_WIDTH | TABLE_AUTOSIZE_HEIGHT);
   rmAttrib[;2] = rmAttrib[;2] | (TABLE_AUTOSIZE_WIDTH | TABLE_AUTOSIZE_HEIGHT | TABLE_WORDWRAP);
   TableSetAttrib(hTable, rmAttrib);

   TableSetColumnWidth(hTable, [2, 3]);

   // Because we don't know the size of the table in centimeters, we ask for the 
   // size:
   rvPS = OBJGetPosSize(hTable);

   // We want a distance of 2 centimeters the top/left corner to the paper
   // but we have to specify the left/bottom corner of the table
   // OBJSetRefPoint(hTable, LEFT | TOP), 
   OBJSetPosSize(hTable, [2, -2-rvPS[4], rvPS[3], rvPS[4]]);

   // If the column size is modified we want the top/left corner to be anchored:
   OBJSetRefPoint(hTable, LEFT | TOP);

   OBJSetSelect(hTable, FALSE)    // Deselect Object
   LayerAddObjects(hLayer, hTable)
   PageReplot(hPage)

.. seealso::
   :ref:`uberblick-zeichenobjekte`,
   :ref:`OBJSetRect`,
   :ref:`OBJGetPosSize`

:sub:`id-622093`