Bezeichnung
doc:SetPagesConfiguration -- legt die maximale Anzahl der Seiten fest
Übersicht
status = doc:SetPagesConfiguration(page_per_pages)
Beschreibung
In der Standardeinstellung hat ein Dokumentobjekt ein "Pages"-Objekt als Wurzel von Seiten. Alle "Page"-Objekte (Seite-Objekte) werden als Element des "Pages"-Objekts angelegt. Da ein "Pages"-Objekt nur 8191 Unterobjekte besitzen kann, beträgt die maximale Seitenzahl 8191 Seiten. Außerdem ist der Zustand, dass sich unter einem "Pages"-Objekt viele "Page"-Objekte befinden, nicht gut, da er zu einer Leistungseinbuße eines Anzeige-Programms führt.

Eine Anwendung kann die Einstellung eines Seitenbaums ändern, indem sie doc:SetPagesConfiguration() aufruft. Wenn der Parameter page_per_pages auf mehr als Null gesetzt ist, wird ein zweistufiger Seitenbaum erstellt. Ein Wurzelobjekt "Pages" kann 8191 "Pages"-Objekte besitzen und jedes untere "Pages"-Objekt kann page_per_pages "Page"-Objekte besitzen. Infolgedessen wird die maximale Anzahl 8191 * page_per_pages Seiten. Eine Anwendung kann doc:SetPagesConfiguration() nicht aufrufen, nachdem eine Seite zum Dokument hinzugefügt wurde.

Wenn doc:SetPagesConfiguration() erfolgreich ist, gibt er #HPDF_OK zurück. Andernfalls wird ein Fehlercode zurückgegeben und der Fehler-Handler wird aufgerufen.

Eingaben
page_per_pages
gibt die Anzahl der Seiten an, die ein "Pages"-Objekt besitzen kann.
Rückgabewerte
status
Statusinformation
Fehler
#HPDF_INVALID_DOCUMENT - Eine ungültige Dokument-Kennung wurde festgelegt.

#HPDF_INVALID_DOCUMENT_STATE - Im Dokument existiert bereits ein Seitenobjekt.

#HPDF_FAILED_TO_ALLOC_MEM - Speicherzuordnung ist fehlgeschlagen.

Navigation zeigen