DocSelectPage

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

hPage = DocSelectPage(hDoc, nPage)
hPage = DocSelectPage(hDoc, nPage, bUpdateFields)
hPage = DocSelectPage(hDoc, ssPageName)
hPage = DocSelectPage(hDoc, ssPageName, bUpdateFields)

Returnwert

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

Parameter

hDoc

hDoc ist die Zugriffsnummer des mit DocCreate erzeugten Dokuments.

nPage

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

ssPageName

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

bUpdateFields

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

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...
}

History

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

id-1898806