.. highlightlang:: us

.. _pagegetalldatasets:

PageGetAllDatasets
==================

.. index:: PageGetAllDatasets

.. us.tag  PageGetAllDatasets GERMAN PageGet Changed5149

:ref:`PageGetAllDatasets` liefert die Zugriffsnummern aller Datensätze der Seite.

.. function::  hvData = PageGetAllDatasets(hPage)
    hvData = PageGetAllDatasets(hPage, bOnlyVisible)
    hvData = PageGetAllDatasets(hPage, bOnlyVisible, ssType)

.. us.return

**Returnwert**

*hvData* ist ein Vektor mit den Zugriffsnummern aller Datensätze der Seite.

.. us.params

**Parameter**

.. uparam:: hPage

   *hPage* ist die Zugriffsnummer der mit :ref:`PageCreate` erzeugten
   Dokument-Seite.

.. uparam:: bOnlyVisible

   Falls *bOnlyVisible* TRUE (1) ist, werden nur die Datensätze zurück gegeben,
   die im Diagramm dargestellt werden. Siehe auch :ref:`XYIsVisible` oder
   :ref:`XYZIsVisible`. Defaultwert ist FALSE (0).

.. uparam:: ssType

   Falls *ssType* "OBJ_XYZDATASET" ist, liefert die Funktion nur die Handle von
   3D-Datensätzen. Falls *ssType* gleich "OBJ_XYDATASET" ist, liefert die Funktion 
   die Handle von 1D und 2D-Datensätzen. Wenn ein leerer String übergeben 
   wird, liefert die Funktion bei Datensatztypen. Defaultwert ist "" 
   (alle Datensätze).

.. us.example

**Beispiel**

**Example**

Das folgende Beispiel erzeugt eine Liste aller im Dokument verwendeten 
Datenkanäle. Die Namen werden in einem Editorfenster angezeigt.

::

   RegisterCommand("2D-Dataset", "_list_used_channel_names", "Create Used Channel Name List");
   UserBar_Add("_list_used_channel_names");

   def _list_used_channel_names()
   {
      hDoc = AppGetActiveDocument();
      if (hDoc == 0) {
         return;
      }

      svChannel = "";
      hvPage = DocGetAllPages(hDoc, FALSE, FALSE);
      for (hPage in hvPage) {
         hvData = PageGetAllDatasets(hPage, FALSE);
         if (hvData[1] != 0) {
            for (hData in hvData) {
               svC = DS_GetChannelNames(hData);
               if (svC[1] != "") {
                  svChannel = [svChannel, svC];
               }
            }
         }
      }
      svChannel = ST_set(svChannel);
      ssText = strcat(svChannel, "\n");
      hEdit = EdCreate();
      EdSetText(hEdit, "Used Channel Names:\n" + ssText);
      EdSetModify(hEdit, TRUE);
   }

**History**

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

   * - Version
     - Beschreibung
   * - R2012.10
     - Dokumentation um 3. Parameter erweitert.
   * - 5.14.9
     - Zusätzlicher Parameter *bOnlyVisible*.

.. seealso::
   :ref:`uberblick-dokument-seiten`,
   :ref:`PageGetSelectedDataLayer`,
   :ref:`GetParent`,
   :ref:`PageCreate`,
   :ref:`DocGetAllPages`,
   :ref:`PageGetAllLayers`,
   :ref:`LayerGetAllDatasets`

:sub:`id-374603`