DASetPageBox
Chức năng truy cập trực tiếp, Thuộc tính trang
Mô tả
Đặt kích thước các hình chữ nhật biên của trang chỉ định. MediaBox biểu diễn bề mặt vật lý của trang
CropBox là vùng hiển thị của trang, nội dung sẽ bị clip theo vùng này. BleedBox tương tự CropBox nhưng là hình chữ nhật dùng trong môi trường sản xuất (in ấn)
TrimBox cho biết kích thước trang thành phẩm sau khi cắt, còn ArtBox xác định phạm vi nội dung có ý nghĩa của trang theo ý người tạo trang
Hành vi phiên bản PDF: các mục dictionary trang BleedBox, TrimBox và ArtBox đòi PDF 1.3. Khi Direct Access sửa một nguồn phiên bản thấp hơn và phiên bản lưu chưa bị khóa, DASetPageBox nâng header tài liệu lưu ra lên PDF 1.3 để khớp với các mục boundary box mới
Cú pháp
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);
Tham số
| FileHandle | Handle được trả về bởi các hàm DAOpenFile, DAOpenFileReadOnly hoặc DAOpenFromStream |
|---|---|
| PageRef | Page reference do các hàm DAFindPage hoặc DANewPage trả về |
| BoxIndex | 1 = MediaBox 2 = CropBox 3 = BleedBox 4 = TrimBox 5 = ArtBox |
| X1 | Tọa độ ngang của góc dưới bên trái box, đo bằng point từ cạnh trái trang |
| Y1 | Tọa độ dọc của góc dưới bên trái box, đo bằng point từ đáy trang |
| X2 | Tọa độ ngang của góc trên bên phải box, đo bằng point từ đáy trang |
| Y2 | Tọa độ dọc của góc trên bên phải box, đo bằng point từ đáy trang |
Giá trị trả về
| 0 | Tham số FileHandle hoặc PageRef không hợp lệ |
|---|---|
| 1 | Success |