SetStructElemExpansionA

Tagged PDF & 접근성

설명

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

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

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

구문

Delphi

Function DLSetStructElemExpansionA(InstanceID: Integer; Expansion: PAnsiChar): Integer;

DLL

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