SetStructElemColSpan

Tagged PDF, Dostępność

Opis

Ustawia atrybut /ColSpan (właściciel atrybutów Table) w elemencie struktury aktualnie otwartym na stosie tagów. Wartość określa liczbę kolumn zajmowanych przez bieżącą komórkę tabeli. Odpowiada wywołaniu AddTagAttribute z Owner=Table, Name=ColSpan i wartością całkowitą zapisaną jako ciąg

Składnia

Delphi

Function TPDFlib.SetStructElemColSpan(ColSpan: Integer): Integer;

ActiveX

Function PDFlib::SetStructElemColSpan(ColSpan As Long) As Long

DLL

int DLSetStructElemColSpan(int InstanceID, int ColSpan);

Parametry

ColSpan	Liczba kolumn zajmowanych przez bieżącą komórkę tabeli. Musi być dodatnią liczbą całkowitą. Wartość 1 oznacza, że komórka zajmuje dokładnie jedną kolumnę (zachowanie domyślne bez ustawionego ColSpan). Wartości większe niż 1 wskazują komórkę nagłówka lub danych obejmującą kilka kolumn

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 lub TD), a przed EndTag. Atrybut /ColSpan zdefiniowano w ISO 32000-1 §14.8.5.7.2 (właściciel atrybutów Table, tabela 337)

Komórki obejmujące kilka kolumn często występują w złożonych tabelach — na przykład nagłówek kolumny może obejmować dwie kolumny danych. Podanie atrybutu /ColSpan pozwala technologii asystującej poprawnie obliczyć położenia komórek i powiązać nagłówki z komórkami danych w całej siatce tabeli

Gdy komórka obejmuje także kilka wierszy, użyj SetStructElemRowSpan razem z tą funkcją

Przykład

// A header cell spanning two columns
PDFlib.BeginTag('TH', 'Q1 and Q2 Revenue', '', '');
PDFlib.SetStructElemScope('Column');
PDFlib.SetStructElemColSpan(2);
PDFlib.DrawText('Q1 and Q2 Revenue', 100, 700);
PDFlib.EndTag;

Zobacz również

SetStructElemRowSpan, SetStructElemScope, AddTagAttribute, BeginTag, EndTag