DASetPageBox
Funcionalidade de acesso direto, Propriedades da página
Descrição
Define as dimensões dos retângulos de limites da página especificada. O MediaBox representa o meio físico da página
O CropBox representa a região visível da página; o conteúdo será recortado a essa região. O BleedBox é semelhante ao CropBox, mas é o retângulo usado em um ambiente de produção
O TrimBox indica as dimensões pretendidas da página acabada após o corte, e o ArtBox define a extensão do conteúdo significativo da página conforme a intenção de quem a criou
Comportamento de versão do PDF: entradas BleedBox, TrimBox e ArtBox do dicionário de página exigem PDF 1.3. Quando o Direct Access modifica uma origem de versão menor e a versão de salvamento não está travada, DASetPageBox eleva o header do documento salvo para PDF 1.3, para que bata com as novas entradas de boundary box.
Sintaxe
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);Parâmetros
| FileHandle | Um handle retornado pelas funções DAOpenFile, DAOpenFileReadOnly ou DAOpenFromStream |
|---|---|
| PageRef | Uma referência de página retornada pelas funções DAFindPage ou DANewPage |
| BoxIndex | 1 = MediaBox 2 = CropBox 3 = BleedBox 4 = TrimBox 5 = ArtBox |
| X1 | A coordenada horizontal do canto inferior esquerdo da caixa, medida em pontos a partir da borda esquerda da página |
| Y1 | A coordenada vertical do canto inferior esquerdo da caixa, medida em pontos a partir da parte inferior da página |
| X2 | A coordenada horizontal do canto superior direito da caixa, medida em pontos a partir da base da página |
| Y2 | A coordenada vertical do canto superior direito da caixa, medida em pontos a partir da base da página |
Valores retornados
| 0 | Os parâmetros FileHandle ou PageRef eram inválidos |
|---|---|
| 1 | Success |