AddTagAttributeA
Tagged PDF, Přístupnost
Popis
Koncové A označuje vstupní bod ANSI (char) knihovny DLL; rozhraní ActiveX/COM zpřístupňuje pouze formu Unicode. Chování je shodné s AddTagAttribute a řetězcové argumenty jsou interpretovány pomocí aktuální znakové stránky nastavené funkcí SetAnsiMode
Přidá pojmenovaný atribut ke strukturálnímu prvku, který se právě sestavuje na vrcholu zásobníku tagů. Při uložení dokumentu se atribut zapíše jako PDF slovník atributů /A (nebo pole slovníků). Zavolejte po BeginTag nebo BeginTagEx a před EndTag
Syntaxe
Delphi
Function DLAddTagAttributeA(InstanceID: Integer; Owner, Name, Value: PAnsiChar): Integer;DLL
int DLAddTagAttributeA(int InstanceID, const char * Owner, const char * Name, const char * Value);Parametry
| Owner | Název vlastníka atributu dle ISO 32000-1 Table 348 (například Layout, Table, List, PrintField). Stane se z něj klíč /O ve slovníku atributů |
|---|---|
| Name | Název atributu pro daného vlastníka (například BBox pro Layout, Scope pro Table). Nesmí být prázdný |
| Value | Hodnota atributu jako řetězec. Hodnoty obsahující jen čísla oddělená mezerou (například "0 0 200 100") se zapíšou jako PDF pole reálných čísel. Jakákoli jiná hodnota se zapíše jako PDF name objekt (bez úvodního /). Nesmí být prázdná |
Návratová hodnota
Returns 1 on success. Returns 0 if no document is open, no tag is currently open, or Owner or Name is empty.
Poznámky
Opakovaná volání AddTagAttribute pro stejný otevřený tag se hromadí. Patří-li atributy jednomu vlastníkovi, knihovna zapíše jeden slovník atributů /A. Používá-li se více vlastníků, seskupí se atributy po vlastnících a zapíší se jako pole slovníků atributů
Pro běžné atributy lze místo přímého volání AddTagAttribute použít praktické obaly SetStructElemScope a SetStructElemBBox
Atributy se při otevření nového tagu resetují; podřízené prvky je nedědí
Příklad
// Mark a table header cell with column scope
PDFlib.BeginTag('TH', '', '', '');
PDFlib.AddTagAttribute('Table', 'Scope', 'Column');
// ... draw cell content
PDFlib.EndTag;
// Mark a figure with a bounding box
PDFlib.BeginTag('Figure', 'Company logo', '', '');
PDFlib.AddTagAttribute('Layout', 'BBox', '72 600 200 700');
PDFlib.EndTag;Viz také
BeginTag, BeginTagEx, EndTag, SetStructElemScope, SetStructElemBBox