SetStructElemWritingMode

태그 지정 PDF, 접근성

설명

태그 스택에서 현재 열린 구조 요소에 /WritingMode 속성(Layout 속성 소유자)을 설정합니다. 쓰기 모드는 요소 내 텍스트의 주된 쓰기 방향을 선언하며 보조 기술이 읽기 순서를 해석하는 방식에 영향을 줍니다. AddTagAttribute를 Owner=Layout, Name=WritingMode 및 값으로 모드 이름을 지정하여 호출하는 것과 같습니다

구문

Delphi

Function TPDFlib.SetStructElemWritingMode(Const WritingMode: WideString): Integer;

ActiveX

Function PDFlib::SetStructElemWritingMode(WritingMode As String) As Long

DLL

int DLSetStructElemWritingMode(int InstanceID, const wchar_t * WritingMode);

매개변수

WritingMode	요소의 쓰기 방향입니다 다음 값 중 하나여야 합니다(대소문자 구분): LrTb — 왼쪽에서 오른쪽, 위에서 아래(기본값, 라틴 문자, 키릴 문자, 그리스 문자 및 대부분의 문자) RlTb — 오른쪽에서 왼쪽, 위에서 아래(아랍어, 히브리어) TbRl — 위에서 아래, 오른쪽에서 왼쪽(전통적인 CJK 세로 텍스트)

반환 값

성공하면 1을 반환합니다. 열린 문서가 없거나 태그 스택에 현재 열린 태그가 없으면 0을 반환합니다

비고

BeginTag 또는 BeginTagEx 이후, EndTag 이전에 이 함수를 호출하십시오. /WritingMode 특성은 ISO 32000-1 §14.8.5.4.2 (Layout 특성 소유자, Table 340)에 정의되어 있음

문서 전체에서 일관된 쓰기 방향을 사용하면 모든 요소에 /WritingMode를 설정할 필요가 없습니다. 특성이 없으면 기본 LrTb가 적용됩니다. 예를 들어 영어 단락에 포함된 히브리어 인용문처럼 주변 콘텐츠와 쓰기 방향이 다른 블록 수준 요소에는 이 특성을 명시적으로 설정합니다

PDF/UA-1(ISO 14289-1 §7.2)은 모든 텍스트 조각의 자연어를 모호하지 않게 결정할 수 있어야 한다고 요구합니다. /WritingMode는 /Lang 특성(SetStructElemLang)을 보완합니다. /Lang은 사용 언어를 선언하고 /WritingMode는 보조 기술이 표시에 사용할 물리적 쓰기 방향을 선언합니다

예제

// Arabic paragraph — right-to-left writing direction
PDFlib.BeginTagEx('P', '', '', 'ar-SA');
PDFlib.SetStructElemWritingMode('RlTb');
PDFlib.DrawText('...Arabic text...', 450, 700);
PDFlib.EndTag;

// Vertical CJK heading
PDFlib.BeginTagEx('H1', '', '', 'zh-TW');
PDFlib.SetStructElemWritingMode('TbRl');
PDFlib.DrawText('...CJK vertical text...', 500, 700);
PDFlib.EndTag;

참고 항목

SetStructElemBBox, SetStructElemLang, AddTagAttribute, BeginTag, EndTag