AddBoxToPath

Vector graphics, Path definition and drawing

Description

Adiciona um retângulo alinhado ao eixo como um subcaminho fechado completo ao caminho atual; diferente de AddLineToPath, esta função não requer uma chamada prévia a StartPath — um novo subcaminho é iniciado e fechado automaticamente

Syntax

Delphi

Function TPDFlib.AddBoxToPath(Left, Top, Width, Height: Double): Integer;

ActiveX

Function PDFlib::AddBoxToPath(Left As Double, Top As Double, Width As Double, Height As Double) As Long

DLL

int DLAddBoxToPath(int InstanceID, double Left, double Top, double Width, double Height);

Parameters

Left	A coordenada horizontal da borda esquerda da caixa
Top	A coordenada vertical da borda superior da caixa
Width	A largura da caixa; larguras negativas são refletidas para que o retângulo ainda tenha extensão positiva
Height	A altura da caixa

Return values

0	Falhou — nenhum documento está aberto
1	O retângulo foi adicionado ao caminho atual

Remarks

Várias caixas podem ser adicionadas ao mesmo caminho; junto com DrawPathEvenOdd, esta é a maneira mais simples de desenhar formas com furos retangulares. Depois que todas as caixas forem adicionadas, chame DrawPath (regra de enrolamento) ou DrawPathEvenOdd (regra par-ímpar) para pintar o resultado

Example

// A filled rectangle frame: outer box with an inner box punched out
PDF.SetFillColor(0.2, 0.4, 0.8);
PDF.AddBoxToPath(100, 100, 200, 120);  // outer
PDF.AddBoxToPath(120, 120, 160,  80);  // inner cut-out
PDF.DrawPathEvenOdd(1);                // 1 = fill