AddBoxToPath

Gráficos vetoriais, Definição e desenho de caminhos

Descrição

Adiciona um retângulo alinhado aos eixos como um sub-path fechado completo ao path atual. Ao contrário de AddLineToPath, esta função não exige uma chamada prévia a StartPath — um sub-path novo é iniciado e fechado automaticamente.

Sintaxe

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);

Parâmetros

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, de modo que o retângulo ainda tenha extensão positiva.
Height	The height of the box.

Valores retornados

0	Failed — no document is open.
1	O retângulo foi adicionado ao path atual.

Observações

Várias caixas podem ser adicionadas ao mesmo path; junto com DrawPathEvenOdd, esta é a maneira mais simples de desenhar formas com buracos retangulares. Depois de adicionar todas as caixas, chame DrawPath (regra winding) ou DrawPathEvenOdd (regra even-odd) para pintar o resultado.

Exemplo

// 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

Veja também

StartPath, AddLineToPath, AddArcToPath, DrawPath, DrawPathEvenOdd