AddBoxToPath

Gráficos vectoriales, definición y trazado de rutas

Descripción

Añade un rectángulo alineado como subruta cerrada. A diferencia de AddLineToPath, no requiere StartPath previo

Sintaxis

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	La coordenada horizontal del borde izquierdo del cuadro
Top	La coordenada vertical del borde superior del cuadro
Width	La anchura del cuadro. Las anchuras negativas se reflejan para que el rectángulo siga teniendo una extensión positiva
Height	La altura del cuadro

Valores devueltos

0	Fallo: no hay ningún documento abierto
1	El rectángulo se añadió al trazado actual

Observaciones

Se pueden añadir varios cuadros a la misma ruta; junto con DrawPathEvenOdd, esta es la forma más sencilla de dibujar figuras con huecos rectangulares. Después de añadir todos los cuadros, llame a DrawPath (regla de relleno no nulo) o DrawPathEvenOdd (regla par-impar) para pintar el resultado

Ejemplo

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

Véase también

StartPath, AddLineToPath, AddArcToPath, DrawPath, DrawPathEvenOdd