SetStructElemLangA

Tagged PDF & tilgængelighed

Beskrivelse

Det afsluttende A angiver ANSI-indgangspunktet (char) i DLL'en; ActiveX/COM-overfladen eksponerer kun Unicode-formen. Adfærden er identisk med SetStructElemLang, og strengargumenter fortolkes ud fra den aktuelle kodetabel i SetAnsiMode

Indstiller posten /Lang på det strukturelement, der aktuelt opbygges på tagstakken. Sprogtagget tilsidesætter sproget på dokumentniveau for dette element og alle dets efterkommere, så dokumenter med flere sprog kan angive det korrekte naturlige sprog for hvert indholdsafsnit

Syntaks

Delphi

Function DLSetStructElemLangA(InstanceID: Integer; Lang: PAnsiChar): Integer;

DLL

int DLSetStructElemLangA(int InstanceID, const char * Lang);

Parametre

Returværdi

Returnerer 1 ved succes, 0 hvis intet strukturelement er åbent, eller intet dokument er valgt

Bemærkninger

Kald denne funktion umiddelbart efter BeginTag eller BeginTagEx, mens målelementet er øverst på tagstakken. Det svarer til at sende et ikke-tomt Lang-argument til BeginTagEx, men kan være mere praktisk, når sproget bestemmes uafhængigt af elementtypen

Posten /Lang på elementniveau er defineret i ISO 32000-1 §14.9.2. Den gælder for strukturelementet og gennem nedarvning for alle underordnede elementer, som ikke selv erklærer /Lang. Skærmlæsere bruger posten til at vælge den korrekte tekst-til-tale-stemme eller sprogmotor ved højtlæsning af dokumentet

PDF/UA-1 (ISO 14289-1 §7.3) kræver, at alt indhold i naturligt sprog identificeres. Dokumentniveauets /Lang, der angives af SetDocumentLanguage eller SetPDFUAMode, dækker det primære sprog; SetStructElemLang dækker afsnit, hvis sprog afviger fra det primære.

Eksempel

// A French phrase embedded in an English document
PDFlib.SetPDFUAMode('en-US');
// ... English content
PDFlib.BeginTag('P', '', '');
PDFlib.SetStructElemLang('fr');
PDFlib.TextOut(x, y, 'Bonjour le monde');
PDFlib.EndTag;

Se også

BeginTagEx, SetDocumentLanguage, SetPDFUAMode, SetStructElemActualText, GetPDFUADiagnostics