AddBoxToPath

Διανυσματικά γραφικά, ορισμός και σχεδίαση διαδρομών

Περιγραφή

Προσθέτει ένα ορθογώνιο στοιχισμένο με τους άξονες ως πλήρη κλειστή υποδιαδρομή στην τρέχουσα διαδρομή. Σε αντίθεση με το AddLineToPath, η συνάρτηση δεν απαιτεί προηγούμενη κλήση StartPath — μια φρέσκια υποδιαδρομή ξεκινά και κλείνει αυτόματα

Σύνταξη

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

Παράμετροι

Left	Η οριζόντια συντεταγμένη της αριστερής πλευράς του box
Top	Η κατακόρυφη συντεταγμένη της πάνω πλευράς του box
Width	Το πλάτος του box. Αρνητικά πλάτη αντικατοπτρίζονται ώστε το ορθογώνιο να εξακολουθεί να έχει θετική έκταση
Height	The height of the box.

Τιμές επιστροφής

0	Αποτυχία — δεν υπάρχει ανοιχτό έγγραφο
1	Το ορθογώνιο προστέθηκε στην τρέχουσα διαδρομή

Παρατηρήσεις

Στην ίδια διαδρομή μπορούν να προστεθούν πολλά ορθογώνια· μαζί με το DrawPathEvenOdd είναι ο πιο απλός τρόπος για σχήματα με ορθογώνιες τρύπες. Όταν προστεθούν όλα, καλέστε DrawPath (κανόνας winding) ή DrawPathEvenOdd (κανόνας even-odd) για να ζωγραφιστεί το αποτέλεσμα.

Παράδειγμα

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

Δείτε επίσης

StartPath, AddLineToPath, AddArcToPath, DrawPath, DrawPathEvenOdd