BeginTag

태그 지정 PDF, 접근성

설명

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

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

구문

Delphi

Function TPDFlib.BeginTag(Const TagType, AltText, ActualText: WideString): Integer;

ActiveX

Function PDFlib::BeginTag(TagType As String, AltText As String, ActualText As String) As Long

DLL

int DLBeginTag(int InstanceID, const wchar_t * TagType, const wchar_t * AltText, const wchar_t * ActualText);

매개변수

TagTypePDF 표준 구조 형식: 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를 호출합니다

문서에 태그를 지정하면 저장할 때 태그된 것으로 표시되며 리더가 구조를 존재하는 것으로 처리하려면 이 표시가 필요합니다. 호출자가 지정한 SetMarkInfo 설정은 그대로 유지됩니다