SetStructElemColor

PDF برچسب‌گذاری‌شده، دسترس‌پذیری

توضیحات

ویژگی /Color (با مالک ویژگی Layout) را روی عنصر ساختاریِ بازِ فعلی در پشته tag تنظیم می‌کند. این مقدار رنگ پیش‌زمینه (متن یا stroke) محتوای عنصر را به‌صورت سه‌تایی 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 برمی‌گرداند. اگر سندی باز نباشد یا در حال حاضر هیچ tagای روی tag stack باز نباشد، 0 برمی‌گرداند

ملاحظات

این تابع را بعد از BeginTag یا BeginTagEx و قبل از EndTag فراخوانی کنید. ویژگی /Color در ISO 32000-1 §14.8.5.4.2 (مالک ویژگی Layout، جدول 340) تعریف شده و به‌صورت آرایهٔ PDF سه‌عضوی از اعداد ذخیره می‌شود

این ویژگی رنگ پیش‌زمینهٔ عنصر را چنان‌که فناوری یاری‌رسان یا موتور re-flow درک می‌کند توصیف می‌کند. جنبهٔ توصیه‌ای دارد — رنگ بصری رندرشده در PDF را وضعیت گرافیکی کنترل می‌کند نه این ویژگی. با این حال ارائهٔ اطلاعات دقیق رنگ به ابزارهای پایین‌دستی امکان می‌دهد نسبت کنتراست رنگ را بررسی کنند (WCAG 2.x Success Criterion 1.4.3) و هنگام reflow محتوا وفاداری را حفظ کنند

مقادیر رنگ رایج: black = (0.0, 0.0, 0.0); white = (1.0, 1.0, 1.0); red = (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