.. highlightlang:: us

.. _xysetbarwidthpos:

XYSetBarWidthPos
================

.. index:: XYSetBarWidthPos

.. us.tag  XYSetBarWidthPos NOTREADYENGLISH XYSet

:ref:`XYSetBarWidthPos` sets the width and offset
of 2D dataset bars.

.. function::  bool = XYSetBarWidthPos(hData, rvWidthPos)

.. us.return

**Return Value**

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

.. us.params

**Parameters**

.. uparam:: hData

   The handle of a dataset created with :ref:`XYCreate` or
   :ref:`TYCreate`.

.. uparam:: rvWidthPos

   *rvWidthPos* is a vector with 3 elements:

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

   * - Value
     - Meaning
   * - rvWidthPosType[1]
     - Width in centimeters or a percentage of the diagram width.
   * - rvWidthPosType[2]
     - Offset in centimeters.
   * - rvWidthPosType[3]
     - 0 = width in percent, 1 = width in centimeters.

.. seealso::
   :ref:`overview-xy-datasets`,
   :ref:`XYGetBarWidthPos`

:sub:`id-876842`