DASetPageBox

Funkcje dostępu bezpośredniego, Właściwości strony

Opis

Ustawia wymiary prostokątów granicznych 'podanej strony’. MediaBox reprezentuje fizyczny nośnik strony.

CropBox przedstawia widoczny obszar strony, a zawartość zostanie przycięta do tego obszaru. BleedBox jest podobny do CropBox, lecz stanowi prostokąt używany w środowisku produkcyjnym

TrimBox wskazuje zamierzone wymiary gotowej strony po przycięciu, a ArtBox określa zasięg 'istotnej zawartości' strony zgodnie z zamiarem jej twórcy

Zachowanie wersji PDF: wpisy słownika strony BleedBox, TrimBox i ArtBox wymagają PDF 1.3. Gdy Direct Access modyfikuje źródło o niższej wersji, a wersja zapisu nie jest zablokowana, DASetPageBox podnosi nagłówek zapisanego dokumentu do PDF 1.3, aby odpowiadał nowym wpisom pól granicznych.

Składnia

Delphi

Function TPDFlib.DASetPageBox(FileHandle, PageRef, BoxIndex: Integer; X1, Y1, X2, Y2: Double): Integer;

ActiveX

Function PDFlib::DASetPageBox(FileHandle As Long, PageRef As Long, BoxIndex As Long, X1 As Double, Y1 As Double, X2 As Double, Y2 As Double) As Long

DLL

int DLDASetPageBox(int InstanceID, int FileHandle, int PageRef, int BoxIndex, double X1, double Y1, double X2, double Y2);

Parametry

FileHandleUchwyt zwrócony przez funkcję DAOpenFile, DAOpenFileReadOnly lub DAOpenFromStream
PageRefOdwołanie do strony zwrócone przez funkcję DAFindPage lub DANewPage
BoxIndex1 = MediaBox 2 = CropBox 3 = BleedBox 4 = TrimBox 5 = ArtBox
X1Współrzędna pozioma lewego dolnego narożnika pola, mierzona w punktach od lewej krawędzi strony
Y1Współrzędna pionowa lewego dolnego narożnika pola, mierzona w punktach od dołu strony
X2Współrzędna pozioma prawego górnego narożnika pola, mierzona w punktach od dołu strony
Y2Współrzędna pionowa prawego górnego narożnika pola, mierzona w punktach od dołu strony

Wartości zwracane

0Parametr FileHandle lub PageRef był nieprawidłowy
1Powodzenie