AddBoxToPath

Vector graphics, Path definition and drawing

Description

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

Parameters

Left	Die horizontale Koordinate der linken Kante der Box
Top	Die vertikale Koordinate der Oberkante der Box
Width	Die Breite der Box. Negative Breiten werden gespiegelt, sodass das Rechteck immer noch eine positive Ausdehnung hat
Height	Die Höhe der Box

Return values

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

Remarks

Legt das Attribut /ListNumbering (Besitzer des Listenattributs) für das Strukturelement fest, das derzeit auf dem Tag-Stapel geöffnet ist; der Wert deklariert das Markierungs- oder Nummerierungsschema, das für Elemente in einem L- (Listen-) Strukturelement verwendet wird, sodass assistierende Technologien den Listentyp korrekt ansagen können; entspricht dem Aufruf von AddTagAttribute mit Owner=List, Name=ListNumbering und dem Schemanamen als Wert

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