SetStructElemColSpan

Tagged PDF, Přístupnost

Popis

Nastaví atribut /ColSpan (vlastník Table) na strukturním elementu aktuálně otevřeném na zásobníku tagů. Hodnota určuje, kolik sloupců aktuální buňka tabulky přesahuje. Ekvivalent volání AddTagAttribute s Owner=Table, Name=ColSpan a celočíselnou hodnotou jako řetězcem

Syntaxe

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	Počet sloupců, přes které aktuální buňka tabulky přesahuje. Musí být kladné celé číslo. Hodnota 1 znamená, že buňka zabírá přesně jeden sloupec (výchozí chování, když není nastaveno ColSpan). Hodnoty větší než 1 označují záhlaví či datovou buňku přesahující více sloupců

Návratová hodnota

Při úspěchu vrací 1. Vrací 0, pokud není otevřený žádný dokument nebo žádný tag v zásobníku tagů

Poznámky

Call this function after BeginTag (with tag type TH or TD) and before EndTag. The /ColSpan attribute is defined in ISO 32000-1 §14.8.5.7.2 (Table attribute owner, Table 337).

Buňky přesahující více sloupců jsou ve složitých tabulkách běžné — například záhlaví sloupce, které pokrývá dva datové sloupce Atribut /ColSpan umožňuje asistenčním technologiím správně vypočítat pozice buněk a přiřadit záhlaví k datovým buňkám v celé mřížce tabulky

When a cell also spans multiple rows, use SetStructElemRowSpan in combination with this function.

Příklad

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

Viz také

SetStructElemRowSpan, SetStructElemScope, AddTagAttribute, BeginTag, EndTag