CapturePageEx

Manipulace se stránkami

Popis

Tato funkce "zachytí" stránku. Zachycenou stránku lze poté kreslit na další stránky. To je užitečné pro kombinování různých stránek nebo pro umísťování více než jedné původní stránky na jinou stránku (impozice). Po zachycení je stránka z dokumentu odebrána. Má-li zůstat v dokumentu, je třeba vytvořit prázdnou stránku a zachycenou stránku na ni nakreslitProtože dokument musí mít stále alespoň jednu stránku, stránku, jež je v dokumentu jediná, nelze zachytit. V takovém případě je před zachycením stávající stránky nutné přidat novou prázdnou stránkuCapturePageEx odstraní zachycenou stránku z jejího aktuálního dokumentu; chcete-li zdrojovou stránku zachovat, použijte

ImportPageAsFormXObject nebo ji importujte z jiného otevřeného dokumentuJako ohraničující obdélník zachycené stránky slouží "media box" stránky. Funkci CapturePageEx lze použít v případech, kdy má být místo něj použit "crop box" stránky

Syntaxe

Delphi

Function TPDFlib.CapturePageEx(Page, Options: Integer): Integer;

ActiveX

Function PDFlib::CapturePageEx(Page As Long, Options As Long) As Long

DLL

int DLCapturePageEx(int InstanceID, int Page, int Options);

Parametry

Page	Číslo zachycované stránky. První stránkou v dokumentu je stránka 1
Options	0 = Jako ohraničující obdélník použít media box stránky 1 = Jako ohraničující obdélník použít crop box stránky, je-li k dispozici, jinak media box 2 = Jako ohraničující obdélník použít bleed box stránky, je-li k dispozici, jinak crop box 3 = Jako ohraničující obdélník použít trim box stránky, je-li k dispozici, jinak crop box 4 = Jako ohraničující obdélník použít art box stránky, je-li k dispozici, jinak crop box

Page

Číslo zachycované stránky. První stránkou v dokumentu je stránka 1

Options

0 = Jako ohraničující obdélník použít media box stránky 1 = Jako ohraničující obdélník použít crop box stránky, je-li k dispozici, jinak media box 2 = Jako ohraničující obdélník použít bleed box stránky, je-li k dispozici, jinak crop box 3 = Jako ohraničující obdélník použít trim box stránky, je-li k dispozici, jinak crop box 4 = Jako ohraničující obdélník použít art box stránky, je-li k dispozici, jinak crop box

Návratové hodnoty

0	Zadaná stránka neexistuje, nebo je jedinou stránkou v dokumentu
Non-zero	ID procesu zachycení. Toto ID musí být předáno funkci DrawCapturedPage