BeginTagEx

Tagged PDF, Tilgængelighed

Beskrivelse

Åbner et tagged PDF-strukturelement på den aktuelle side med en eksplicit attribut for naturligt sprog. Identisk med BeginTag, men tilføjer en Lang-parameter, der skrives til strukturelementets /Lang-attribut

Brug denne funktion til indhold, hvis sprog afviger fra dokumentets standardsprog (indstillet af SetPDFUAMode eller SetDocumentLanguage). ISO 14289-1 §7.2 kræver, at attributten /Lang indstilles på ethvert tekstsegment, der ikke er på dokumentets primære sprog.

Tags skal være afbalancerede: Hvert kald til BeginTagEx skal efterfølges af et tilsvarende kald til EndTag. Tags kan indlejres.

Syntaks

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

Parametre

TagType	PDF-standardstrukturtype: `P`, `H1`–`H6`, `Figure`, `Table`, `TR`, `TH`, `TD`, `L`, `LI`, `LBody`, `Span`, `Link`, `Note` osv. (se ISO 32000-1 §14.8.4).
AltText	Alternativ tekst til billeder og andet ikke-tekstligt indhold (`/Alt`-attribut). Angiv en tom streng, hvis den ikke er påkrævet.
ActualText	Erstatningstekst for indhold, hvis visuelle form afviger fra dets logiske betydning (attributten `/ActualText`). Angiv en tom streng, hvis den ikke er påkrævet.
Lang	BCP 47-sprogtag for indholdet i dette element, f.eks. `en-US`, `fr-FR`, `zh-Hans`. Angiv en tom streng for at arve dokumentets sprog. Når strengen ikke er tom, tilsidesætter den sproget på dokumentniveau for dette element og alle dets efterkommere.

Returværdier

0	Mislykkedes (intet dokument er åbent)
1	Tagget blev åbnet

Eksempel

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