SetStructElemLangA

Tagged PDF & 접근성

설명

끝의 A는 ANSI(char) DLL 진입점을 나타내며, ActiveX/COM 인터페이스는 Unicode 형식만 노출합니다. 동작은 SetStructElemLang과 동일하고 문자열 인수는 현재 SetAnsiMode 코드 페이지를 사용하여 해석됩니다

태그 스택에서 현재 작성 중인 구조 요소에 /Lang 항목을 설정합니다. 언어 태그는 이 요소와 모든 하위 항목에서 문서 수준 언어를 재정의하여 혼합 언어 문서가 각 콘텐츠 범위의 올바른 자연어를 선언할 수 있게 합니다

구문

Delphi

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

DLL

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

매개변수

Lang	`en-US`, `fr`, `de-CH`, `zh-Hant-TW` 같은 BCP 47 언어 태그 문자열입니다. 이전 값을 지우고 문서 수준 언어를 상속하려면 빈 문자열을 전달합니다

반환 값

성공하면 1, 현재 열린 구조 요소가 없거나 문서를 선택하지 않았으면 0을 반환함

비고

대상 요소가 태그 스택 맨 위에 있을 때 BeginTag 또는 BeginTagEx 직후에 이 함수를 호출하십시오. 이는 비어 있지 않은 Lang 인수를 BeginTagEx에 전달하는 것과 같지만 요소 유형과 별도로 언어를 결정할 때 더 편리할 수 있음

요소 수준 /Lang 항목은 ISO 32000-1 §14.9.2에 정의되어 있습니다. 구조 요소와 상속을 통해 자체 /Lang을 선언하지 않은 모든 하위 요소에 적용됩니다. 화면 읽기 프로그램은 문서를 소리 내어 읽을 때 이 항목을 사용하여 적절한 음성 합성 음성 또는 언어 엔진을 선택합니다

PDF/UA-1(ISO 14289-1 §7.3)은 모든 자연어 콘텐츠의 언어를 식별하도록 요구합니다. SetDocumentLanguage 또는 SetPDFUAMode로 설정한 문서 수준 /Lang은 기본 언어를 다루며 SetStructElemLang은 기본 언어와 다른 언어를 사용하는 섹션을 다룹니다

예제

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

참고 항목

BeginTagEx, SetDocumentLanguage, SetPDFUAMode, SetStructElemActualText, GetPDFUADiagnostics