SetStructElemLangA

Tagged PDF i dostępność

Opis

Końcowa litera A oznacza punkt wejścia DLL ANSI (char); powierzchnia ActiveX/COM udostępnia wyłącznie postać Unicode. Zachowanie jest identyczne jak w SetStructElemLang, a argumenty ciągów są interpretowane przy użyciu bieżącej strony kodowej SetAnsiMode

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 DLSetStructElemLangA(InstanceID: Integer; Lang: PAnsiChar): Integer;

DLL

int DLSetStructElemLangA(int InstanceID, const char * 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