SetStructElemExpansionA

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 SetStructElemExpansion och strängargument tolkas med aktuell SetAnsiMode-kod sida

Sätter posten /E (expansionstext) på det strukturelement som för tillfället byggs på taggstacken. Expansionstexten är den fullständigt utskrivna formen av en förkortning eller akronym som finns i elementet — till exempel World Wide Web för ett Span-element vars innehåll lyder WWW, eller International Organization for Standardization för ett Span som innehåller ISO

Skärmläsare och annan hjälpmedelsteknik läser upp expansionstexten i stället för att försöka uttala förkortningstecknen, vilket är avgörande för förkortningar som inte kan ljudas ut som ord

Syntax

Delphi

Function DLSetStructElemExpansionA(InstanceID: Integer; Expansion: PAnsiChar): Integer;

DLL

int DLSetStructElemExpansionA(int InstanceID, const char * Expansion);

Parametrar

Expansion	Den fullständigt utskrivna texten av förkortningen eller akronymen i det aktuella strukturelementet. Ange en tom sträng för att rensa ett tidigare satt värde

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 medan målelementet ligger överst på taggstacken, eller när som helst före det matchande EndTag-anropet

Posten /E är definierad i ISO 32000-1 §14.9.5. Den skrivs som en PDF-textsträng i strukturelementdictionaryn och skiljer sig från de övriga textegenskaperna:

/E (Expansion) – Den utskrivna formen av en förkortning eller akronym. Används för uppläsning av förkortad inline-text i skärmläsare.
/Alt (se SetStructElemAltText) – En komplett ersättningsbeskrivning för element som inte kan visas visuellt (bilder, figurer, formler).
/ActualText (see SetStructElemActualText) — An exact Unicode replacement for glyph sequences whose extracted text would otherwise be incorrect (ligatures, glyph variants).

PDF/UA-1 (ISO 14289-1 §7.2) kräver att textens naturliga språk går att avgöra entydigt för varje textdel. För förkortningar och akronymer som inte kan läsas ut som ett ord är /E standardmekanismen för att ge den informationen.

Använd /E på det innersta element som wrappar förkortningen — typiskt ett Span-element. Expansionen gäller bara elementets innehåll och ävs inte av barn

Exempel

// Tag an abbreviation with its expansion
PDFlib.BeginTag('Span', '', '');
PDFlib.SetStructElemExpansion('World Wide Web');
PDFlib.WriteText('WWW');
PDFlib.EndTag;

// Tag a standards acronym
PDFlib.BeginTag('Span', '', '');
PDFlib.SetStructElemExpansion('International Organization for Standardization');
PDFlib.WriteText('ISO');
PDFlib.EndTag;

Se även

BeginTag, SetStructElemAltText, SetStructElemActualText, SetStructElemLang, GetPDFUADiagnostics