SetStructElemLang

Tagged PDF i dostępność

Opis

Ustawia wpis /Lang w elemencie struktury aktualnie tworzonym na stosie tagów. Znacznik języka zastępuje język dokumentu dla tego elementu i wszystkich jego potomków, co pozwala dokumentom wielojęzycznym deklarować właściwy język naturalny każdego fragmentu zawartości

Składnia

Delphi

Function TPDFlib.SetStructElemLang(Const Lang: WideString): Integer;

ActiveX

Function PDFlib::SetStructElemLang(Lang As String) As Long

DLL

int DLSetStructElemLang(int InstanceID, const wchar_t * Lang);

Parametry

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 lub BeginTagEx, gdy element docelowy znajduje się na szczycie stosu tagów. Odpowiada ona przekazaniu niepustego argumentu Lang do BeginTagEx, lecz może być wygodniejsza, gdy język ustala się niezależnie od typu elementu

Wpis /Lang na poziomie elementu zdefiniowano w ISO 32000-1 §14.9.2. Dotyczy elementu struktury oraz, przez dziedziczenie, wszystkich elementów podrzędnych, które nie deklarują własnego /Lang. Czytniki ekranu używają tego wpisu do wyboru odpowiedniego głosu syntezy mowy lub mechanizmu językowego podczas odczytywania dokumentu na głos

PDF/UA-1 (ISO 14289-1 §7.3) wymaga zidentyfikowania całej zawartości w języku naturalnym. Wpis /Lang na poziomie dokumentu ustawiony przez SetDocumentLanguage lub SetPDFUAMode obejmuje język podstawowy; SetStructElemLang obejmuje sekcje w języku innym niż podstawowy

Przykład

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

Zobacz również

BeginTagEx, SetDocumentLanguage, SetPDFUAMode, SetStructElemActualText, GetPDFUADiagnostics