SetStructElemHeadersA

Tagged PDF, Dostępność

Opis

Końcowa litera A oznacza punkt wejścia DLL ANSI (char); powierzchnia ActiveX/COM udostępnia wyłącznie postać Unicode. Zachowanie jest identyczne jak w SetStructElemHeaders, a argumenty ciągów są interpretowane przy użyciu bieżącej strony kodowej SetAnsiMode

Ustawia atrybut /Headers (właściciel atrybutów Table) w elemencie struktury aktualnie otwartym na stosie tagów. Atrybut wiąże bieżącą komórkę danych lub nagłówka z co najmniej jedną komórką nagłówka tabeli identyfikowaną przez jej ID elementu. Służy do opisu złożonych struktur tabel, których nie można wywnioskować wyłącznie z położenia. Wywołaj tę funkcję po BeginTag lub BeginTagEx, a przed EndTag

Składnia

Delphi

Function DLSetStructElemHeadersA(InstanceID: Integer; Headers: PAnsiChar): Integer;

DLL

int DLSetStructElemHeadersA(int InstanceID, const char * Headers);

Parametry

Headers	Rozdzielona przecinkami lista ID elementów komórek TH, które są nagłówkami kolumny lub wiersza bieżącej komórki TD albo TH. Każdy ID musi odpowiadać ElemID przypisanemu wcześniej w tym samym dokumencie do elementu TH za pomocą SetStructElemID. Białe znaki wokół przecinków są ignorowane. Przykład: `TH-ProductName,TH-Price`

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

Ta funkcja odpowiada wywołaniu AddTagAttribute z Owner=Table, Name=Headers i tą samą listą ID rozdzieloną przecinkami jako Value. Atrybut jest zapisywany jako tablica ciągów tekstowych PDF /Headers w słowniku atrybutów /A elementu struktury

Atrybut /Headers zdefiniowano w ISO 32000-1 §14.8.5.7.2 (właściciel atrybutów Table). Dla prostych tabel, w których nagłówki kolumn znajdują się bezpośrednio nad komórkami danych, zwykle wystarcza atrybut /Scope ustawiany przez SetStructElemScope. Użyj /Headers dla nieregularnych tabel z komórkami obejmującymi kilka wierszy lub kolumn albo z nagłówkami wielopoziomowymi

PDF/UA-1 (ISO 14289-1 §7.10) wymaga jawnego powiązania każdej komórki TD z jej komórkami nagłówka w tabelach, w których powiązania nie można ustalić wyłącznie z kolejności odczytu

Przykład

// A data cell that spans two logical columns, referencing both headers
PDFlib.BeginTag('TD', '', '', '');
PDFlib.SetStructElemHeaders('TH-ProductName,TH-Price');
PDFlib.DrawText('Widget A  $9.99', 100, 660);
PDFlib.EndTag;

Zobacz również

SetStructElemID, SetStructElemScope, AddTagAttribute, BeginTag, SetPDFUAMode