DASetPageBox
Функционалност за директен достъп, Свойства на страницата
Описание
Задава размерите на граничните правоъгълници на указаната страница. MediaBox представлява физическия носител на страницата
CropBox представлява видимата област на страницата, а съдържанието ще бъде изрязано до тази област. BleedBox е подобен на CropBox, но е правоъгълникът, използван в производствена среда
TrimBox посочва предназначените размери на завършената страница след подрязване, а ArtBox определя обхвата на значимото съдържание на страницата според нейния създател
Поведение на PDF версията: записите на речника на страницата за BleedBox, TrimBox и ArtBox изискват PDF 1.3. Когато Direct Access промени източник с по-ниска версия и версията на записа не е заключена, DASetPageBox повишава заглавката на записания документ до PDF 1.3, така че да съответства на новите записи на граничните полета
Синтаксис
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);
Параметри
| FileHandle | Дескриптор, върнат от функциите DAOpenFile, DAOpenFileReadOnly или DAOpenFromStream |
|---|---|
| PageRef | Препратка към страница, върната от функциите DAFindPage или DANewPage |
| BoxIndex | 1 = MediaBox 2 = CropBox 3 = BleedBox 4 = TrimBox 5 = ArtBox |
| X1 | Хоризонталната координата на долния ляв ъгъл на полето, измерена в точки от левия край на страницата |
| Y1 | Вертикалната координата на долния ляв ъгъл на полето, измерена в точки от долната част на страницата |
| X2 | Хоризонталната координата на горния десен ъгъл на полето, измерена в точки от долната част на страницата |
| Y2 | Вертикалната координата на горния десен ъгъл на полето, измерена в точки от долната част на страницата |
Върнати стойности
| 0 | Параметрите FileHandle или PageRef не бяха валидни |
|---|---|
| 1 | Успех |