AddBoxToPath

Vektorgrafik, Pfaddefinition und Zeichnen

Beschreibung

Fügt dem aktuellen Pfad ein achsenparalleles Rechteck als vollständigen geschlossenen Unterpfad hinzu. Im Gegensatz zu AddLineToPath erfordert diese Funktion keinen vorherigen Aufruf von StartPath — ein neuer Unterpfad wird automatisch begonnen und geschlossen

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

Parameter

Left	Die horizontale Koordinate des linken Boxrands.
Top	Die vertikale Koordinate der Oberkante des Rahmens
Width	Die Breite des Felds. Negative Breiten werden gespiegelt, sodass das Rechteck weiterhin eine positive Ausdehnung besitzt
Height	Die Höhe des Rahmens

Rückgabewerte

0	Fehlgeschlagen — es ist kein Dokument geöffnet.
1	Das Rechteck wurde dem aktuellen Pfad hinzugefügt

Anmerkungen

Mehrere Rahmen können demselben Pfad hinzugefügt werden; zusammen mit DrawPathEvenOdd ist dies die einfachste Methode, Formen mit rechteckigen Löchern zu zeichnen. Nachdem alle Rahmen hinzugefügt wurden, rufen Sie DrawPath für die Windungsregel oder DrawPathEvenOdd für die Gerade-Ungerade-Regel auf, um das Ergebnis zu zeichnen

Beispiel

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

Siehe auch

StartPath, AddLineToPath, AddArcToPath, DrawPath, DrawPathEvenOdd