.. highlightlang:: us

.. index:: DocSelectPage

.. _docselectpage:

DocSelectPage
=============

.. us.tag  DocSelectPage GERMAN DocSet Changed300 Changed5300 Changed5701

Die Funktion wechselt zur angegebenen Seite. Die Seite wird im Dokumentfenster
sichtbar.

.. function::  hPage = DocSelectPage(hDoc, nPage)
				hPage = DocSelectPage(hDoc, nPage, bUpdateFields)
			hPage = DocSelectPage(hDoc, ssPageName)
			hPage = DocSelectPage(hDoc, ssPageName, bUpdateFields)

.. us.return

**Returnwert**

*hPage* ist die Zugriffsnummer einer Seite. Die Zugriffsnummer muss größer als 0
sein.

.. us.params

**Parameter**

.. uparam:: hDoc

   *hDoc* ist die Zugriffsnummer des mit :ref:`DocCreate` erzeugten Dokuments.

.. uparam:: nPage

   *nPage* ist der Index der Seite. Der Index beginnt  mit 1.

.. uparam:: ssPageName

   *ssPageName* ist der Name einer Seite, die aktiviert werden soll.

.. uparam:: bUpdateFields

   Wenn *bUpdateFields* TRUE (1) ist, werden die Feldfunktionen aktualisiert.
   Die Aktualisierung der Feldfunktionen kann relativ langsam sein.
   Defaultwert ist TRUE (1).

.. us.example

**Beispiel**

Das folgende Beispiel lädt alle Seiten eines Dokuments.

::

   AppGetActiveDocument();
   nPages = DocGetPageCount(hDoc);
   hvData = 0;
   for (i in 1:nPages) {
       hActivePage = DocSelectPage(hDoc, i);
       if (hActivePage == 0) {
           MessageBox("Cannot display page");
           continue;
       }
       // Do something with hActivePage...
   }

.. us.history

**History**

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

   * - Version
     - Beschreibung
   * - R2015.1
     - Neuer Parameter *ssPageName*.
   * - 5.30.0
     - Neuer Parameter *bUpdateFields*.

.. seealso::
   :ref:`uberblick-dokumente`,
   :ref:`uberblick-dokument-seiten`,
   :ref:`DocLoadPage`,
   :ref:`DocGetAllPages`

:sub:`id-1898806`