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
| 0 | Zadaná stránka neexistuje nebo je v dokumentu jedinou stránkou |
|---|---|
| Non-zero | ID procesu zachycení. Toto ID musí být dodáno funkci DrawCapturedPage |