CapturePage

Manipulace se stránkou

Popis

Tato funkce "zachytí" stránku. Jakmile je stránka zachycená, dá se kreslit na jiné stránky. To se hodí ke spojování různých stránek nebo k umístění více původních stránek na jinou stránku (impozice). Jakmile se stránka zachytí, odstraní se z dokumentu. Pokud chcete, aby zůstala v dokumentu, musíte vytvořit prázdnou stránku a nakreslit zachycenou stránku na ni

Dokument musí mít vždy alespoň jednu stránku, takže stránku nelze zachytit, pokud je v dokumentu jediná. V takovém případě nejprve přidejte novou prázdnou stránku a teprve pak může být stávající zachycena

Přes CapturePage nelze přesouvat stránky z jednoho dokumentu do jiného nového dokumentu, takže všechny požadované stránky je nutné sloučit do jediného dokumentu dřív, než zavoláte CapturePage. CaptureID je jen ukazatel na skrytou stránku, takže paměť není třeba uvolňovat

Jako ohraničující obdélník zachycené stránky se použije "media box" stránky. Když se má místo toho použít "crop box" stránky, použijte funkci CapturePage

Syntaxe

Delphi

Function TPDFlib.CapturePage(Page: Integer): Integer;

ActiveX

Function PDFlib::CapturePage(Page As Long) As Long

DLL

int DLCapturePage(int InstanceID, int Page);

Parametry

PageČíslo stránky k zachycení. První stránka v dokumentu je stránka 1

Návratové hodnoty

0Zadaná stránka neexistuje nebo je v dokumentu jedinou stránkou
Non-zeroID procesu zachycení. Toto ID musí být dodáno funkci DrawCapturedPage