AddTagAttributeA
Getagde PDF, toegankelijkheid
Beschrijving
Het achtervoegsel A duidt het ANSI-toegangspunt (char) van de DLL aan; het ActiveX/COM-oppervlak stelt alleen de Unicode-vorm beschikbaar. Het gedrag is identiek aan AddTagAttribute en tekenreeksargumenten worden geïnterpreteerd met behulp van de huidige SetAnsiMode-codetabel
Voegt een benoemd attribuut toe aan het structuurelement dat momenteel op de tagstack wordt opgebouwd. Het attribuut wordt bij het opslaan van het document weggeschreven als PDF /A-attribuutwoordenboek (of array van woordenboeken). Roep dit aan na BeginTag of BeginTagEx en vóór EndTag
Syntaxis
Delphi
Function DLAddTagAttributeA(InstanceID: Integer; Owner, Name, Value: PAnsiChar): Integer;DLL
int DLAddTagAttributeA(int InstanceID, const char * Owner, const char * Name, const char * Value);Parameters
| Owner | De attribuuteigenaarnaam zoals gedefinieerd in ISO 32000-1 Table 348 (bijv. Layout, Table, List, PrintField). Dit wordt de /O-sleutel in het attribuutwoordenboek |
|---|---|
| Name | De attribuutnaam voor de opgegeven eigenaar (bijv. BBox voor Layout, Scope voor Table). Mag niet leeg zijn |
| Value | De attribuutwaarde als string. Waarden die alleen door spaties gescheiden getallen bevatten (bijv. "0 0 200 100") worden weggeschreven als PDF-array van reële getallen. Elke andere waarde wordt weggeschreven als PDF name-object (zonder voorloop /). Mag niet leeg zijn |
Retourwaarde
Geeft bij succes 1 terug. Geeft 0 terug als er geen document is geopend, momenteel geen tag open is, of Owner of Name leeg is
Opmerkingen
Meerdere aanroepen van AddTagAttribute voor dezelfde open tag worden opgeteld. Horen attributen bij één eigenaar, dan schrijft de library één /A-attribuutwoordenboek. Bij meerdere eigenaren worden de attributen per eigenaar gegroepeerd en weggeschreven als array van attribuutwoordenboeken
Voor gangbare attributen kunnen de handige wrappers SetStructElemScope en SetStructElemBBox worden gebruikt in plaats van direct AddTagAttribute aan te roepen
Attributen worden gereset wanneer een nieuwe tag wordt geopend; ze worden niet overgeërfd door kindelementen
Voorbeeld
// 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;Zie ook
BeginTag, BeginTagEx, EndTag, SetStructElemScope, SetStructElemBBox