.. highlightlang:: us

.. index:: LayerAutoScale

.. _layerautoscale:

LayerAutoScale
==============

.. us.tag  LayerAutoScale GERMAN LayerSet Changed5505

:ref:`LayerAutoScale` skaliert die Diagrammachsen in Abhängigkeit von den
Datensätzen im Diagramm.

.. function::  bool = LayerAutoScale(hLayer)
    bool = LayerAutoScale(hLayer, ssXYZ)
    bool = LayerAutoScale(hLayer, ssXYZ, nTicks)
    bool = LayerAutoScale(hLayer, ssAxis, nTicks, bOnlyForXRange)

.. us.return

**Returnwert**

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

.. us.params

**Parameter**

.. uparam:: hLayer

   *hLayer* ist die Zugriffsnummer des Diagramms, das mit :ref:`LayerCreate`
   erzeugt wurde.

.. uparam:: ssXYZ

   *ssXYZ* ist ``"X"``, falls die Funktion die x-Achse betrifft, ``"Y"``, falls
   die Funktion die y-Achse betrifft und ``"Z"``, falls die Funktion die z-Achse
   betrifft.

.. uparam:: nTicks

   *nTicks* ist die Anzahl der Haupt-Achsenticks, die zwischen 2 und 50 liegen
   darf.

.. uparam:: bOnlyForXRange

   Falls *bOnlyForXRange* TRUE (1) ist, wird nur die Y-Achse für den 
   im Diagramm ausgewählten x-Bereich skaliert. Wenn *nTicks* gleich 0 ist
   wird die Anzahl der Label automatisch bestimmt.  Setze *ssAxis* auf "Y".

.. us.comment

**Kommentar**

Wird die Funktion nur mit dem Parameter *hLayer* aufgerufen, werden alle Achsen
neu skaliert. Es werden dabei zwischen 6 und 11 Ticks erzeugt. Die Funktion gibt
bei Aufruf mit drei Parametern FALSE (0) zurück, falls die Achse logarithmisch
skaliert ist.

Bevor die Funktion aufgerufen wird, sollte der Layer in ein Dokument (siehe
:ref:`PageAddLayer`) eingefügt worden sein.

.. us.history

**History**

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

   * - Version
     - Beschreibung
   * - R2013.5
     - Neuer Parameter *bOnlyForXRange*.

.. seealso::
   :ref:`uberblick-diagramme`,
   :ref:`LayerCreate`,
   :ref:`LayerSetLabelNum`,
   :ref:`PageAddLayer`

:sub:`id-620231`