SetStructElemExpansion

Tagged PDF & 접근성

설명

태그 스택에서 현재 작성 중인 구조 요소에 /E(확장 텍스트) 항목을 설정합니다. 확장 텍스트는 요소 안의 약어나 머리글자를 완전히 풀어 쓴 형식입니다. 예를 들어 콘텐츠가 WWW인 Span 요소에는 World Wide Web, ISO를 포함하는 Span에는 International Organization for Standardization을 사용합니다

화면 읽기 프로그램과 기타 보조 기술은 축약 문자를 발음하려 하지 않고 확장된 텍스트를 읽으며, 단어처럼 소리 낼 수 없는 약어에 필수적입니다

구문

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

매개변수

Expansion	현재 구조 요소에 있는 약어 또는 두문자어의 완전한 확장 텍스트. 이전에 설정한 값을 지우려면 빈 문자열을 전달합니다

반환 값

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

비고

대상 요소가 태그 스택 맨 위에 있을 때 BeginTag 직후 또는 일치하는 EndTag 호출 전 어느 시점에든 이 함수를 호출합니다

/E 항목은 ISO 32000-1 §14.9.5에 정의되어 있습니다 구조 요소 사전에 PDF 텍스트 문자열로 기록되며 다른 텍스트 속성과 구별됩니다:

/E (Expansion) — 약어 또는 두문자어를 풀어쓴 형식입니다. 화면 읽기 프로그램이 축약된 인라인 콘텐츠를 발음할 때 사용합니다
/Alt(SetStructElemAltText 참조) — 시각적으로 렌더링할 수 없는 요소(이미지, 그림, 공식)의 완전한 대체 설명
/ActualText(SetStructElemActualText 참조) — 추출 텍스트가 잘못될 글리프 시퀀스(합자, 글리프 변형)의 정확한 Unicode 대체 텍스트

PDF/UA-1(ISO 14289-1 §7.2)은 모든 텍스트 조각의 자연어를 명확히 확인할 수 있도록 요구합니다. 단어로 소리 내어 읽을 수 없는 약어나 머리글자에는 /E가 이 정보를 제공하는 표준 메커니즘입니다

약어를 감싸는 가장 안쪽 요소(일반적으로 Span 요소)에 /E를 적용하십시오. 확장형은 해당 요소의 콘텐츠에만 적용되며 자식에게 상속되지 않음

예제

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

참고 항목

BeginTag, SetStructElemAltText, SetStructElemActualText, SetStructElemLang, GetPDFUADiagnostics