BeginFormXObject

Layout da página

Descrição

Inicia uma superfície de desenho temporária de Form XObject com a largura e a altura solicitadas. Enquanto a construção está ativa, as chamadas normais de desenho gravam na página temporária selecionada por esta função

Conclua a construção com EndFormXObject para receber um handle de página capturada, ou chame CancelFormXObject para descartar a superfície de desenho temporária

Sintaxe

Delphi

Function TPDFlib.BeginFormXObject(Width, Height: Double): Integer;

ActiveX

Function PDFlib::BeginFormXObject(Width As Double, Height As Double) As Long

DLL

int DLBeginFormXObject(int InstanceID, double Width, double Height);

Parâmetros

WidthA largura da superfície de desenho do Form XObject em unidades PDF
HeightA altura da superfície de desenho do Form XObject em unidades PDF

Valores retornados

0As dimensões não eram válidas, uma construção já estava ativa, ou a superfície de desenho temporária não pôde ser criada
1A superfície de desenho do Form XObject foi criada e selecionada

Observações

EndFormXObject retorna um handle que pode ser reutilizado com DrawCapturedPage, DrawCapturedPageMatrix, DrawRotatedCapturedPage, NewTilingPatternFromCapturedPage, SetCapturedPageOptional e SetCapturedPageTransparencyGroup

Não selecione outra página ou documento até que a construção seja concluída ou cancelada; os comandos de desenho devem mirar na página temporária selecionada por BeginFormXObject

Veja também

EndFormXObject, CancelFormXObject, DrawCapturedPage, NewTilingPatternFromCapturedPage