SetStructElemColor

Tagged 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 (Layout attribute owner, Table 340) ונשמר כמערך PDF בן שלושה אלמנטים של מספרים.

המאפיין מתאר את צבע החזית של הרכיב כפי שנתפס על ידי טכנולוגיה מסייעת או מנוע re-flow. הוא ייעוצי — הצבע הוויזואלי המעובד ב-PDF נשלט על ידי מצב הגרפיקה ולא על ידי המאפיין הזה. עם זאת, מתן מידע צבע מדויק מאפשר לכלים במורד הזרם לבדוק יחסי ניגודיות צבע (WCAG 2.x Success Criterion 1.4.3) ולשמור על נאמנות בעת זרימת תוכן מחדש.

Common color values: 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