AddBoxToPath

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

Descrição

Adiciona um retângulo alinhado com os eixos como subcaminho fechado completo ao caminho atual. Ao contrário de AddLineToPath, esta função não exige uma chamada anterior de StartPath — é iniciado e fechado automaticamente um novo subcaminho

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 margem esquerda da caixa
Top	A coordenada vertical da extremidade superior da caixa
Width	A largura da caixa. As larguras negativas são refletidas para que o retângulo continue a ter uma extensão positiva
Height	A altura da caixa

Valores devolvidos

0	Falha — não existe um documento aberto
1	O retângulo foi adicionado ao caminho atual

Observações

Podem ser adicionadas várias caixas ao mesmo caminho; em conjunto com DrawPathEvenOdd, esta é a forma mais simples de desenhar formas com orifícios retangulares. Depois de adicionar todas as caixas, chame DrawPath (regra de enrolamento) ou DrawPathEvenOdd (regra par-ímpar) 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

Consulte também

StartPath, AddLineToPath, AddArcToPath, DrawPath, DrawPathEvenOdd