.. highlightlang:: us

.. _auto_scaleaxes:

auto_ScaleAxes
==============

.. index:: auto_ScaleAxes

.. us.tag  auto_ScaleAxes NOTREADYENGLISH

:ref:`auto_ScaleAxes` re-scales all diagrams on
the page created with the :ref:`auto_LoadTemplate` function, so that all
datasets on the diagrams are completely visible.

.. function::  bool = auto_ScaleAxes()
    bool = auto_ScaleAxes(ssXYZ)

.. us.return

**Return Value**

*bool* is always TRUE (1).

.. us.params

**Parameters**

.. uparam:: ssXYZ

   can be one of these three letters:

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

   * - Value
     - Meaning
   * - "X"
     - only the x-axes will be re-scaled.
   * - "Y"
     - only the y-axes will be re-scaled.
   * - "Z"
     - only the z-axes will be re-scaled.

.. us.comment

**Comment**

If invoked without parameters, all axes will be auto scaled.

.. us.example

**Example**

Auto scale the Y axis only:

::

   auto_ScaleAxes("Y");

.. seealso::
   :ref:`overview-automation`,
   :ref:`auto_LoadTemplate`,
   :ref:`PageGetLayerHandle`,
   :ref:`LayerSetAxisMinMaxDelta`

:sub:`id-650958`