SetStructElemTitleA

Tagged PDF & 접근성

설명

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

태그 스택에서 현재 생성 중인 구조 요소에 /T(제목) 항목을 설정합니다. 제목은 요소 유형을 단순히 반복하는 대신 특정 요소를 설명하는 사람이 읽을 수 있는 레이블입니다. 예: Chapter 1, Summary Table, Figure 3: Quarterly Sales

구문

Delphi

Function DLSetStructElemTitleA(InstanceID: Integer; Title: PAnsiChar): Integer;

DLL

int DLSetStructElemTitleA(int InstanceID, const char * Title);

매개변수

Title	이 특정 요소 인스턴스를 식별하는 사람이 읽을 수 있는 텍스트 문자열. 이전에 설정한 값을 지우려면 빈 문자열을 전달합니다

반환 값

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

비고

/T 항목은 ISO 32000-1 §14.7.2 Table 324에 정의되어 있습니다. 구조 요소 사전에 PDF 텍스트 문자열로 기록됩니다

Title은 구조 요소의 다른 텍스트 속성과 구별되는 용도로 사용됩니다:

/T (Title) — 탐색 및 태그 지정 패널에서 사용하는 요소의 설명 레이블입니다. 섹션 머리글, 표 캡션, 그림 캡션에 적합합니다
/Alt(SetStructElemAltText 참조) — 요소를 렌더링할 수 없을 때 보조 기술에 제공하는 요소의 완전한 텍스트 대체물
/ActualText(SetStructElemActualText 참조) — 추출된 텍스트가 잘못될 글리프 시퀀스를 위한 정확한 Unicode 대체 텍스트

PDF 뷰어는 /T를 사용하여 Tags 탐색 패널의 요소에 레이블을 지정합니다. 접근성 도구와 수정 소프트웨어는 이를 문서 탐색의 랜드마크 제목으로 사용합니다. 머리글 요소(H1–H6)에서는 요소 콘텐츠 자체가 머리글 텍스트 역할을 하며 /T는 설명 레이블이 필요한 비텍스트 요소(Table, Figure, Form)나 컨테이너(Sect, Div)에 더 유용합니다

예제

// Tag a data table with a title for navigation and accessibility tools
PDFlib.BeginTag('Table', '', '');
PDFlib.SetStructElemTitle('Table 2: Annual Revenue by Region');
// ... table rows and cells
PDFlib.EndTag;

// Tag a document section
PDFlib.BeginTag('Sect', '', '');
PDFlib.SetStructElemTitle('Chapter 3: Implementation');
// ... section content
PDFlib.EndTag;

참고 항목

BeginTag, SetStructElemAltText, SetStructElemActualText, SetStructElemID, GetPDFUADiagnostics