SetStructElemColor

ملف PDF ذو بنية، إمكانية الوصول

الوصف

يضبط سمة /Color (مالك سمة Layout) في عنصر البنية المفتوح حاليًا في مكدس الوسوم. تحدد القيمة لون المقدمة (النص أو الحد) لمحتوى العنصر على هيئة ثلاثية RGB. وهو مكافئ لاستدعاء AddTagAttribute باستخدام Owner=Layout، وName=Color، وسلسلة R G B مفصولة بمسافات

الصيغة

Delphi

Function TPDFlib.SetStructElemColor(R, G, B: Double): Integer;

ActiveX

Function PDFlib::SetStructElemColor(R As Double, G As Double, B As Double) As Long

DLL

int DLSetStructElemColor(int InstanceID, double R, double G, double B);

المعاملات

قيمة الإرجاع

تُرجع 1 عند النجاح، و0 إذا لم يكن هناك مستند مفتوح أو لا يوجد وسم مفتوح حاليًا على رصة الوسوم

ملاحظات

استدعِ هذه الدالة بعد BeginTag أو BeginTagEx وقبل EndTag. تُعرَّف خاصية /Color في ISO 32000-1 §14.8.5.4.2 (مالك خصائص التخطيط، الجدول 340) وتُخزن كمصفوفة PDF ثلاثية العناصر من أعداد

تصف هذه الخاصية لون مقدمة العنصر كما يدركه

قيم ألوان شائعة: الأسود = (0.0, 0.0, 0.0)؛ الأبيض = (1.0, 1.0, 1.0)؛ الأحمر = (1.0, 0.0, 0.0)

مثال

// Tag a heading rendered in dark blue
PDFlib.BeginTag('H2', '', '', '');
PDFlib.SetStructElemColor(0.0, 0.18, 0.39);  // RGB for dark blue
PDFlib.DrawText('Section 2', 72, 700);
PDFlib.EndTag;

انظر أيضا

SetStructElemEndIndent, SetStructElemBBox, AddTagAttribute, BeginTag, EndTag