BeginTagA

태그 지정 PDF, 접근성

설명

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

현재 페이지에서 태그가 지정된 PDF 구조 요소를 엽니다. 콘텐츠 스트림에 BDC(Begin Marked Content with Dictionary) 연산자를 쓰고 문서의 논리 구조 트리에 요소를 등록합니다. 문서를 저장할 때 구조 트리가 자동으로 완성됩니다

태그는 균형을 이루어야 합니다. 모든 BeginTag 호출 뒤에는 일치하는 EndTag 호출이 와야 합니다. 태그는 중첩할 수 있습니다

구문

Delphi

Function DLBeginTagA(InstanceID: Integer; TagType, AltText, ActualText: PAnsiChar): Integer;

DLL

int DLBeginTagA(int InstanceID, const char * TagType, const char * AltText, const char * ActualText);

매개변수

TagType	PDF 표준 구조 형식: `P`, `H1`–`H6`, `Figure`, `Table`, `TR`, `TH`, `TD`, `L`, `LI`, `LBody`, `Span`, `Link`, `Note` 등(ISO 32000-1 §14.8.4 참조)
AltText	이미지 및 기타 비텍스트 콘텐츠의 대체 텍스트(PDF `/Alt` 속성에 매핑됨)입니다. 필요하지 않으면 빈 문자열을 전달합니다
ActualText	시각적 표현과 논리적 의미가 다른 콘텐츠의 대체 텍스트이며 PDF `/ActualText` 속성에 매핑됩니다. 필요 없으면 빈 문자열을 전달합니다

반환 값

0	실패(열린 문서 없음)
1	태그가 성공적으로 열렸습니다

예제

// Heading, then a paragraph
PDF.SetPDFUAMode('en-US');
PDF.BeginTag('H1', '', '');
PDF.PrintText(50, 750, 'Introduction');
PDF.EndTag;
PDF.BeginTag('P', '', '');
PDF.PrintText(50, 730, 'This document demonstrates tagged PDF.');
PDF.EndTag;

// Figure with alt text
PDF.BeginTag('Figure', 'Company logo', '');
PDF.DrawImage(50, 650, 120, 60, 'logo.png');
PDF.EndTag;

비고

화면 읽기 프로그램이 읽지 않아야 하는 장식 콘텐츠(페이지 머리글, 바닥글, 배경 요소)에는 BeginArtifact/EndArtifact를 사용합니다

문서는 쓰기 모드(생성되었거나 수정용으로 열림)여야 합니다. PDF/UA-1 요구 사항을 충족하려면 태그 지정 전에 SetPDFUAMode를 호출합니다