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 LongDLL
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 | Success |