SetStructElemExpansion

Tagged PDF i dostępność

Opis

Ustawia wpis /E (tekst rozwinięcia) w elemencie struktury aktualnie tworzonym na stosie tagów. Tekst rozwinięcia to pełna postać skrótu lub akronimu zawartego w elemencie — na przykład World Wide Web dla elementu Span z zawartością WWW albo International Organization for Standardization dla elementu Span zawierającego ISO

Czytniki ekranu i inne technologie asystujące odczytują tekst rozwinięcia zamiast próbować wymawiać skrócone znaki, co jest niezbędne w przypadku skrótów, których nie można wymówić jako słów

Składnia

Delphi

Function TPDFlib.SetStructElemExpansion(Const Expansion: WideString): Integer;

ActiveX

Function PDFlib::SetStructElemExpansion(Expansion As String) As Long

DLL

int DLSetStructElemExpansion(int InstanceID, const wchar_t * Expansion);

Parametry

Expansion	Pełny tekst rozwinięcia skrótu lub akronimu w bieżącym elemencie struktury. Przekaż pusty ciąg, aby usunąć wcześniej ustawioną wartość

Wartość zwracana

Zwraca 1 w przypadku powodzenia albo 0, gdy żaden element struktury nie jest obecnie otwarty lub nie wybrano dokumentu

Uwagi

Wywołaj tę funkcję bezpośrednio po BeginTag, gdy element docelowy znajduje się na szczycie stosu znaczników, albo w dowolnym momencie przed odpowiadającym wywołaniem EndTag

Wpis /E zdefiniowano w ISO 32000-1 §14.9.5. Jest zapisywany jako ciąg tekstowy PDF w słowniku elementu struktury i różni się od pozostałych właściwości tekstowych:

/E (Expansion) — Pełna postać skrótu lub akronimu. Używana przez czytniki ekranu do wymowy skróconej zawartości osadzonej w tekście
/Alt (zobacz SetStructElemAltText) — Pełny opis zastępczy elementów, których nie można wyrenderować wizualnie (obrazy, ilustracje, wzory)
/ActualText (zobacz SetStructElemActualText) — Dokładny zamiennik Unicode dla sekwencji glifów, których wyodrębniony tekst byłby nieprawidłowy (ligatury, warianty glifów)

PDF/UA-1 (ISO 14289-1 §7.2) wymaga, aby język naturalny każdej części tekstu można było jednoznacznie ustalić. W przypadku skrótów i akronimów, których postaci skróconej nie można odczytać na głos jako słowa, standardowym mechanizmem przekazania tej informacji jest /E

Zastosuj /E do najbardziej wewnętrznego elementu obejmującego skrót — zwykle elementu Span. Rozwinięcie dotyczy wyłącznie zawartości tego elementu i nie jest dziedziczone przez elementy podrzędne

Przykład

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

Zobacz również

BeginTag, SetStructElemAltText, SetStructElemActualText, SetStructElemLang, GetPDFUADiagnostics