SetStructElemRowSpan

Tagged PDF, נגישות

תיאור

מגדירה את המאפיין /RowSpan (בעלים Table) על רכיב המבנה הפתוח כרגע במחסנית התגים. הערך מציין על כמה שורות משתרע תא הטבלה הנוכחי. שקול לקרוא ל-AddTagAttribute עם Owner=Table, ‏Name=RowSpan והערך השלם כמחרוזת.

תחביר

Delphi

Function TPDFlib.SetStructElemRowSpan(RowSpan: Integer): Integer;

ActiveX

Function PDFlib::SetStructElemRowSpan(RowSpan As Long) As Long

DLL

int DLSetStructElemRowSpan(int InstanceID, int RowSpan);

פרמטרים

RowSpan	מספר השורות שתא הטבלה הנוכחי חופף. חייב להיות מספר שלם חיובי. ערך 1 משמעו שהתא תופס בדיוק שורה אחת (ההתנהגות כברירת מחדל כשלא הוגדר RowSpan). ערכים גדולים מ-1 מציינים תא שחופף כמה שורות

ערך מוחזר

מחזירה 1 במקרה של הצלחה. מחזירה 0 אם לא פתוח מסמך או אם אין כרגע תגית פתוחה בערימת התגיות

הערות

קראו לפונקציה זו אחרי BeginTag (עם סוג התג TH או TD) ולפני EndTag. המאפיין /RowSpan מוגדר ב-ISO 32000-1 §14.8.5.7.2 (בעל מאפיין טבלה, Table 337)

תאים משתרעי-שורות מופיעים בטבלאות שבהן תא כותרת או תא נתונים צריך להימתח אנכית על פני כמה שורות — למשל, כותרת שורה המשותפת לכמה שורות נתונים. מתן המאפיין /RowSpan מאפשר לטכנולוגיה מסייעת לבנות נכון את מודל הסריג הלוגי של הטבלה.

כאשר תא גם משתרע על מספר עמודות, השתמשו ב-SetStructElemColSpan בשילוב עם הפונקציה הזו.

דוגמה

// A row header cell spanning two data rows
PDFlib.BeginTag('TH', 'First Quarter', '', '');
PDFlib.SetStructElemScope('Row');
PDFlib.SetStructElemRowSpan(2);
PDFlib.DrawText('First Quarter', 72, 680);
PDFlib.EndTag;

ראו גם

SetStructElemColSpan, SetStructElemScope, AddTagAttribute, BeginTag, EndTag