.. highlightlang:: us

.. index:: PageSendLayerToPos

.. _pagesendlayertopos:

PageSendLayerToPos
==================

.. us.tag  PageSendLayerToPos GERMAN PageSet Changed5500

:ref:`PageSendLayerToPos` verschiebt ein Diagramm innerhalb einer Seite an eine
neue Position innerhalb der Z-Ordnung.

.. function::  bool = PageSendLayerToPos(hPage, hLayer, nPos)

.. us.return

**Returnwert**

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

.. us.params

**Parameter**

.. uparam:: hPage

   *hPage* ist die Zugriffsnummer einer Seite.

.. uparam:: hLayer

   *hLayer* ist der Diagramm-Handle. Der Hintergrund-Layer kann nicht verschoben 
   werden.

.. uparam:: nPos

   *nPos* ist die neue Position des Diagramms. *nPos* = 1 schiebt das Dokument
   nach unten und  *nPos* = 255 nach oben.

.. us.example

**Beispiel**

Verschiebt das zweite Diagramm nach unten an die Position 1.

::

   hvLayer = PageGetAllDataLayers(hPage);
   if (len(hvLayer) >= 2) {
      PageSendLayerToPos(hPage, hvLayer[2], 1);
   }

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

   * - Version
     - Beschreibung
   * - R2013.0
     - Dokumentation zugefügt.

.. seealso::
   :ref:`uberblick-dokument-seiten`,
   :ref:`AppGetActivePage`,
   :ref:`PageGetAllDataLayers`

:sub:`id-98501`