BeginTagEx

Tagged PDF, saavutettavuus

Kuvaus

Avaa tagatun PDF:n rakennetyylielementin nykyiselle sivulle erillisellä kieliattribuutilla. Sama kuin BeginTag, mutta lisää Lang-parametrin, joka kirjoitetaan rakennetyylielementin /Lang-attribuutiksi

Käytä tätä funktiota sisällölle, jonka kieli eroaa asiakirjan oletuskielestä (asetettu funktiolla SetPDFUAMode tai SetDocumentLanguage). ISO 14289-1 §7.2 edellyttää, että /Lang-attribuutti asetetaan jokaiselle tekstijaksolle, joka ei ole asiakirjan pääkielellä

Tagien on oltava tasapainossa: jokaisen BeginTagEx-kutsun jälkeen on tehtävä vastaava EndTag-kutsu. Tagit voivat olla sisäkkäin

Syntaksi

Delphi

Function TPDFlib.BeginTagEx(Const TagType, AltText, ActualText, Lang: WideString): Integer;

ActiveX

Function PDFlib::BeginTagEx(TagType As String, AltText As String, ActualText As String, Lang As String) As Long

DLL

int DLBeginTagEx(int InstanceID, const wchar_t * TagType, const wchar_t * AltText, const wchar_t * ActualText, const wchar_t * Lang);

Parametrit

TagType	Vakioto PDF-rakennetyyppi: `P`, `H1`–`H6`, `Figure`, `Table`, `TR`, `TH`, `TD`, `L`, `LI`, `LBody`, `Span`, `Link`, `Note` jne. (katso ISO 32000-1 §14.8.4)
AltText	Vaihtoehtoinen teksti kuville ja muulle ei-tekstisällölle (`/Alt`-attribuutti). Anna tyhjä merkkijono, jos ei tarvita.
ActualText	Korvaava teksti sisällölle, jonka visuaalinen muoto poikkeaa loogisesta merkityksestään (`/ActualText`-attribuutti). Anna tyhjä merkkijono, jos ei tarvita.
Lang	Elementin sisällön BCP 47 -kielitunnus, esimerkiksi `en-US`, `fr-FR`, `zh-Hans`. Anna tyhjä merkkijono periäksesi asiakirjan kielen. Kun arvo ei ole tyhjä, se korvaa asiakirjatason kielen tälle elementille ja kaikille sen jälkeläisille

Paluuarvot

0	Epäonnistui (mikään asiakirja ei ole avoinna)
1	Tag opened successfully

Esimerkki

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