SetStructElemScope

Tagged PDF, Dostępność

Opis

Ustawia atrybut /Scope (właściciel atrybutu Table) dla elementu struktury obecnie otwartego na stosie znaczników. Zakres wskazuje, czy komórka TH (nagłówek tabeli) dotyczy kolumny, wiersza czy obu — jest to wymagane przez PDF/UA-1 dla tabel z komórkami nagłówkowymi. Odpowiada wywołaniu AddTagAttribute z Owner=Table, Name=Scope i nazwą zakresu jako wartością

Składnia

Delphi

Function TPDFlib.SetStructElemScope(Const Scope: WideString): Integer;

ActiveX

Function PDFlib::SetStructElemScope(Scope As String) As Long

DLL

int DLSetStructElemScope(int InstanceID, const wchar_t * Scope);

Parametry

Scope	Zakres komórki nagłówka. Musi być jedną z poniższych wartości (z rozróżnianiem wielkości liter): Column — nagłówek dotyczy wszystkich komórek w kolumnie Row — nagłówek dotyczy wszystkich komórek w wierszu Both — nagłówek dotyczy zarówno kolumny, jak i wiersza

Wartość zwracana

Zwraca 1 w przypadku powodzenia. Zwraca 0, jeżeli żaden dokument nie jest otwarty albo stos znaczników nie zawiera obecnie otwartego znacznika

Uwagi

Wywołaj tę funkcję po BeginTag z typem tagu TH, a przed EndTag. Atrybut /Scope zdefiniowano w ISO 32000-1 §14.8.5.7.2 (właściciel atrybutów Table)

PDF/UA-1 (ISO 14289-1 §7.10) wymaga wyraźnego powiązania komórek nagłówka tabeli z komórkami danych. Podanie atrybutu /Scope jest zalecaną metodą, gdy pozwala na to układ tabeli

Przykład

// Tag a column header cell
PDFlib.BeginTag('TH', 'Product Name', '', '');
PDFlib.SetStructElemScope('Column');
PDFlib.DrawText('Product Name', 100, 700);
PDFlib.EndTag;

// Tag a row header cell
PDFlib.BeginTag('TH', 'Row 1', '', '');
PDFlib.SetStructElemScope('Row');
PDFlib.DrawText('Row 1', 72, 680);
PDFlib.EndTag;

Zobacz również

AddTagAttribute, SetStructElemBBox, BeginTag, EndTag, SetPDFUAMode