SetStructElemRowSpan

Tagged PDF, Dostępność

Opis

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

Składnia

Delphi

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

ActiveX

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

DLL

int DLSetStructElemRowSpan(int InstanceID, int RowSpan);

Parametry

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

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 /RowSpan zdefiniowano w ISO 32000-1 §14.8.5.7.2 (właściciel atrybutów Table, tabela 337)

Komórki obejmujące kilka wierszy występują w tabelach, w których komórka nagłówka lub danych musi rozciągać się pionowo na kilka wierszy — na przykład nagłówek wiersza wspólny dla kilku wierszy danych. Podanie atrybutu /RowSpan pozwala technologii asystującej poprawnie zbudować logiczny model siatki tabeli

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

Przykład

// 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;

Zobacz również

SetStructElemColSpan, SetStructElemScope, AddTagAttribute, BeginTag, EndTag