SetStructElemLangA

taggad PDF & tillgänglighet

Beskrivning

Det avslutande A:et betecknar ANSI (char)-DLL-ingångspunkten; ActiveX/COM-ytan exponerar bara Unicode-formen. Beteendet är identiskt med SetStructElemLang och strängargument tolkas med aktuell SetAnsiMode-kod sida

Sätter /Lang-posten på det strukturelement som för tillfället byggs på taggstacken. Språktaggen åsidosätter dokumentnivåspråket för det här elementet och alla dess ättlingar, så att flerspråkiga dokument kan deklarera rätt naturligt språk för varje innehållsavsnitt

Syntax

Delphi

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

DLL

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

Parametrar

Returvärde

Returnerar 1 vid lyckat anrop, 0 om inget strukturelement för tillfället är öppet eller inget dokument är valt

Anmärkningar

Anropa den här funktionen omedelbart efter BeginTag eller BeginTagEx medan målelementet ligger överst på taggstacken. Det är ekvivalent med att skicka ett icke-tomt Lang-argument till BeginTagEx, men kan vara bekvämare när språket bestäms separat från elementtypen

Posten /Lang på elementnivå är definierad i ISO 32000-1 §14.9.2. Den gäller strukturelementet och, genom arv, alla barelement som inte själva deklarerar en /Lang. Skärmläsare använder posten för att välja lämplig text-till-tal-röst eller språkmotor när dokumentet läses upp

PDF/UA-1 (ISO 14289-1 §7.3) kräver att allt innehåll med naturligt språk identifieras. Dokumentnivåns /Lang som sätts av SetDocumentLanguage eller SetPDFUAMode täcker primärspråket; SetStructElemLang täcker avsnitt vars språk skiljer sig från primärspråket

Exempel

// 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 även

BeginTagEx, SetDocumentLanguage, SetPDFUAMode, SetStructElemActualText, GetPDFUADiagnostics