BeginTagExA

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 BeginTagEx en tekenreeksargumenten worden geïnterpreteerd met behulp van de huidige SetAnsiMode-codetabel

Opent een getagd-PDF-structuurelement op de huidige pagina, met een expliciet attribuut voor de natuurlijke taal. Identiek aan BeginTag, maar voegt een parameter Lang toe die naar het /Lang-attribuut van het structuurelement wordt geschreven

Gebruik deze functie voor inhoud waarvan de taal afwijkt van de standaardtaal van het document (gezet via SetPDFUAMode of SetDocumentLanguage). ISO 14289-1 §7.2 vereist dat het attribuut /Lang op elk tekstsegment staat dat niet in de primaire taal van het document is gesteld

Tags moeten in balans zijn: op elke BeginTagEx-aanroep moet een bijbehorende EndTag-aanroep volgen. Tags mogen genest zijn

Syntaxis

Delphi

Function DLBeginTagExA(InstanceID: Integer; TagType, AltText, ActualText, Lang: PAnsiChar): Integer;

DLL

int DLBeginTagExA(int InstanceID, const char * TagType, const char * AltText, const char * ActualText, const char * Lang);

Parameters

TagType	PDF standard structure type: `P`, `H1`–`H6`, `Figure`, `Table`, `TR`, `TH`, `TD`, `L`, `LI`, `LBody`, `Span`, `Link`, `Note`, etc. (see ISO 32000-1 §14.8.4).
AltText	Alternatieve tekst voor afbeeldingen en andere niet-tekstinhoud (`/Alt`-attribuut). Geef een lege string door als dat niet nodig is
ActualText	Vervangende tekst voor inhoud waarvan de visuele vorm afwijkt van de logische betekenis (`/ActualText`-attribuut). Geef een lege string door als dat niet nodig is
Lang	BCP 47-taaltag voor de inhoud van dit element, bijv. `en-US`, `fr-FR`, `zh-Hans`. Geef een lege string door om de documenttaal te erven. Als hij niet leeg is, overschrijft hij de taal op documentniveau voor dit element en al zijn afstammelingen

Retourwaarden

0	Failed (no document is open)
1	Tag opened successfully

Voorbeeld

// Document in English with a French citation
PDF.SetPDFUAMode('en-US');
PDF.BeginTag('P', '', '');
PDF.PrintText(50, 750, 'The French motto is:');
PDF.EndTag;
PDF.BeginTagEx('Span', '', '', 'fr-FR');
PDF.PrintText(50, 730, 'Liberté, Égalité, Fraternité');
PDF.EndTag;