.. highlightlang:: us

.. index:: LayerSetAxesAttribs
.. index:: LayerIsYAxisTitleInCurveColor
.. index:: LayerIsYAxisInCurveColor
.. index:: LayerIsAxisShowSymbol
.. index:: LayerIsYLabelFree_StackedDia
.. index:: LayerIsTitleProtected
.. index:: LayerIsAutoTitle
.. index:: LayerIsTitleSetOnLoad
.. index:: LayerSetYAxisTitleInCurveColor
.. index:: LayerSetYAxisInCurveColor
.. index:: LayerSetAutoTitle
.. index:: LayerSetAxisShowSymbol
.. index:: IsAxisShowSymbol
.. index:: LayerGetAxisSymbolID
.. index:: LayerSetAxisSymbolID
.. index:: LayerSetYLabelFree_StackedDia
.. index:: LayerSetTitleProtected

.. _layersetautotitle:
.. _layersetaxesattribs:

LayerSetAxesAttribs
===================

.. us.tag  LayerSetAxesAttribs NOTREADYENGLISH LayerAxisLabel Changed5510

The :ref:`LayerSetAxesAttribs` sets display attribs for the x an y axis.

.. function::  bool = LayerSetAxesAttribs(hLayer, nAttrib)

.. us.return

**Return Value**

*bool* is TRUE (1) if the function was successful and otherwise FALSE (0).

.. us.params

**Parameters**

.. uparam:: hLayer

   *hLayer* is the handle of a diagram (layer).

.. uparam:: nAttrib

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

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

      * - Define
        - Value
        - Description
      * - YAXIS_STACKEDDIA_LABELFREE
        - 1
        - The axis scaling can be set independently of the stacked diagram 
          grid settings. Otherwise the scaling is adjusted to the grid.
          This setting has no effect, if the diagram is not part of a stacked
          diagram. If the axis belongs to a stacked diagram, only two blue 
          handles at to top and bottom of the diagram box are displayed.
          Otherwise 8 blue handles are displayed.
      * - XAXIS_PROTECTTITLE
        - 2
        - The axis title can only be set manually. If the attribute is not set,
          the axis title will be updated if a new dataset is loaded.
      * - XAXIS_AUTOTITLE
        - 4
        - The x-channel name of the first dataset will be displayed as an axis
          title.
      * - YAXIS_PROTECTTITLE
        - 8
        - The axis title can only be set manually. If the attribute is not, set
          the axis title will be updated if a new dataset is loaded.
      * - YAXIS_AUTOTITLE
        - 16
        - The axis title is the y-channel name of the displayed datasets.
      * - ZAXIS_PROTECTTITLE
        - 32
        - The axis title can only be set manually. If the attribute is not set
          the axis title will be updated if a new dataset is loaded.
      * - ZAXIS_AUTOTITLE
        - 64
        - The axis title is the channel name of the displayed datasets.
      * - YAXIS_SHOWSYMBOL
        - 128
        - A line symbol will be displayed in front of the axis title.
      * - YAXIS_AUTOCOLORTITLE
        - 256
        - The axis title will be displayed in the color of the first dataset.
      * - YAXIS_AUTOCOLORAXIS
        - 512
        - The axis and the labelling will be displayed in the color of the first
          dataset.
      * - YAXIS_SYMBOL_MARKER
        - 1024
        - The marker symbol will be displayed in front of the axis title.

To set the attributes the following helper functions can be used::

   LayerIsYAxisTitleInCurveColor(hLayer)   // YAXIS_AUTOCOLORTITLE
   LayerIsYAxisInCurveColor(hLayer)        // YAXIS_AUTOCOLORAXIS
   LayerIsAxisShowSymbol(hLayer)           // YAXIS_SHOWSYMBOL
   LayerIsYLabelFree_StackedDia(hLayer)    // YAXIS_STACKEDDIA_LABELFREE
   LayerIsTitleProtected(hLayer, ssAxis)   // XAXIS_PROTECTTITLE, YAXIS.., ZAXIS...
   LayerIsAutoTitle(hLayer, ssAxis)        // XAXIS_AUTOTITLE,...
   LayerIsTitleSetOnLoad(hLayer, ssAxis)   // XAXIS_PROTECTTITLE, ..
   LayerSetYAxisTitleInCurveColor(hLayer, bool) // YAXIS_AUTOCOLORTITLE
   LayerSetYAxisInCurveColor(hLayer, bool) // YAXIS_AUTOCOLORAXIS, ..
   LayerSetAutoTitle(hLayer, ssAxis, bool) // XAXIS_AUTOTITLE, ...
   LayerSetAxisShowSymbol(hLayer, bool)    // YAXIS_SHOWSYMBOL
   IsAxisShowSymbol(hLayer)                // YAXIS_SHOWSYMBOL
   LayerGetAxisSymbolID(hLayer)            // YAXIS_SYMBOL_MARKER
   LayerSetAxisSymbolID(hLayer, bool)      // YAXIS_SYMBOL_MARKER
   LayerSetYLabelFree_StackedDia(hLayer, bool)  // YAXIS_STACKEDDIA_LABELFREE
   LayerSetTitleProtected(hLayer, ssAxis, bool) // XAXIS_PROTECTTITLE;

.. us.history

**History**

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

   * - Version
     - Description
   * - R2013.10
     - Documentation added.

.. seealso::
   :ref:`overview-diagrams`,
   :ref:`LayerCreate`,
   :ref:`LayerIsFirstLabel`,
   :ref:`LayerShowFirstLabel`,
   :ref:`LayerGetLastLabel`,
   :ref:`LayerSetFixedLabelNum`,
   :ref:`LayerGetAxesAttribs`,
   :ref:`LayerSetAxisTitle`,
   :ref:`LayerShowAxisTitle`

:sub:`id-307275`