ImportPageAsFormXObject
Seitenmanipulation, Form XObjects
Beschreibung
Importiert eine Seite aus einem beliebigen offenen Dokument als unabhängiges, wiederverwendbares Form-XObject in das ausgewählte Dokument und gibt ein Captured-Page-Handle zurückQuell- und Ziel-Seitenbaum bleiben unverändert, Seiteninhalte werden einmal dekodiert und komprimiert, und jede spätere Platzierung schreibt nur eine Ressourcenreferenz und eine
Do
/Group-OperationDokumentübergreifende Importe kopieren den geerbten Ressourcenabschluss und die Form-kompatiblen Einträge /Metadata, /PieceInfo, /LastModified und
Syntax
Delphi
Function TPDFlib.ImportPageAsFormXObject(SourceDocumentID, SourcePage, Options: Integer): Integer;Parameter
| SourceDocumentID | Das von einer Dokumenterzeugungs- oder -ladeoperation zurückgegebene Dokument-Handle; es kann das ausgewählte Dokument bezeichnen |
|---|---|
| SourcePage | Die 1-basierte Seitennummer im Quelldokument |
| Options | 0 verwendet die MediaBox; 1 verwendet die CropBox mit MediaBox-Fallback; 2 verwendet die BleedBox mit Crop- und Media-Fallback; 3 verwendet die TrimBox mit Crop- und Media-Fallback; 4 verwendet die ArtBox mit Crop- und Media-Fallback |
Rückgabewerte
| 0 | Das Dokument-Handle, die Seitennummer oder die Option war ungültig, die gewählte Box war unbrauchbar, oder eine referenzierte Ressource konnte nicht importiert werden |
|---|---|
| Nicht null | Ein Captured-Page-Handle, das von den Zeichnungs- und Form-Konfigurationsfunktionen akzeptiert wird |
Anmerkungen
Die gewählte Seitenbox wird zur Form-Bounding-Box, und die geerbte Seitenrotation wird in die Form-Matrix normalisiert, einschließlich nicht nuller BoxursprüngeAnnotationen, Formularfelder, Vorschaubilder, Seitenbaum-Links, Navigationseinträge und strukturelle Elternnummern sind keine Seitengrafiken und werden nicht importiertRufen Sie diese Funktion einmal auf und verwenden Sie das zurückgegebene Handle wieder mit
DrawCapturedPage, DrawCapturedPageMatrix, DrawRotatedCapturedPage, NewTilingPatternFromCapturedPage, SetCapturedPageOptional oder SetCapturedPageTransparencyGroup