.. highlightlang:: us

.. _xysetbarattrib:

XYSetBarAttrib
==============

.. index:: XYSetBarAttrib

.. us.tag  XYSetBarAttrib NOTREADYENGLISH XYSet

:ref:`XYSetBarAttrib` sets the attribute for 2D dataset bars.

.. function::  bool = XYSetBarAttrib(hData, nAttrib)

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

   *nAttrib* is an OR combination of the following values:

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

   * - Value
     - Meaning
   * - BAR_VERT
     - Vertical Bars
   * - BAR_WIDTH_PERCENT
     - Bar width in percent
   * - BAR_BASE_AXIS
     - Bar origin is the mimimum axis value otherwise the origin is set to the drop value (see XYSetDropValue).
   * - BAR_HATCH
     - Hatch fill
   * - BAR_SOLIDCOLOR
     - Solid color fill

.. seealso::
   :ref:`overview-xy-datasets`,
   :ref:`XYGetBarAttrib`,
   :ref:`XYSetDropValue`

:sub:`id-641749`