AddBoxToPath

Vektör grafikleri, Yol tanımlama ve çizim

Açıklama

Geçerli yola tam ve kapalı bir alt yol olarak eksenlere hizalı bir dikdörtgen ekler. AddLineToPath işlevinden farklı olarak bu işlev önceden StartPath çağrısı gerektirmez; yeni bir alt yol başlatılır ve otomatik olarak kapatılır

Sözdizimi

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

Parametreler

Left	Kutunun sol kenarının yatay koordinatı
Top	Kutunun üst kenarının dikey koordinatı
Width	Kutunun genişliği. Negatif genişlikler yansıtılır; böylece dikdörtgen yine pozitif uzanıma sahip olur
Height	Kutunun yüksekliği

Dönüş değerleri

0	Başarısız — açık belge yok
1	Dikdörtgen geçerli yola eklendi

Açıklamalar

Aynı yola birkaç kutu eklenebilir; DrawPathEvenOdd ile birlikte bu, dikdörtgen delikli şekiller çizmenin en basit yoludur. Tüm kutular eklendikten sonra sonucu boyamak için DrawPath (sarım kuralı) veya DrawPathEvenOdd (çift-tek kuralı) çağırın

Örnek

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

Ayrıca bkz

StartPath, AddLineToPath, AddArcToPath, DrawPath, DrawPathEvenOdd