BeginTagEx

태그 지정 PDF, 접근성

설명

현재 페이지에서 명시적인 자연어 특성과 함께 태그가 지정된 PDF 구조 요소를 엽니다. BeginTag와 동일하지만 구조 요소의 Lang 매개변수를 추가하여 요소의 /Lang 특성에 씁니다

문서의 기본 언어(SetPDFUAMode 또는 SetDocumentLanguage로 설정)와 다른 언어의 콘텐츠에 이 함수를 사용합니다. ISO 14289-1 §7.2에서는 문서 기본 언어가 아닌 텍스트 세그먼트에 /Lang 속성을 설정하도록 요구합니다

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

구문

Delphi

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

ActiveX

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

DLL

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

매개변수

TagType	PDF 표준 구조 형식: `P`, `H1`–`H6`, `Figure`, `Table`, `TR`, `TH`, `TD`, `L`, `LI`, `LBody`, `Span`, `Link`, `Note` 등(ISO 32000-1 §14.8.4 참조)
AltText	이미지와 기타 비텍스트 콘텐츠의 대체 텍스트(`/Alt` 속성). 필요하지 않으면 빈 문자열을 전달합니다
ActualText	시각적 형태가 논리적 의미와 다른 콘텐츠의 대체 텍스트(`/ActualText` 속성)입니다. 필요하지 않으면 빈 문자열을 전달합니다
Lang	이 요소 콘텐츠의 BCP 47 언어 태그입니다 예: `en-US`, `fr-FR`, `zh-Hans` 문서 언어를 상속하려면 빈 문자열을 전달합니다 비어 있지 않으면 이 요소와 모든 하위 요소에 대해 문서 수준 언어를 재정의합니다

반환 값

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

예제

// Document in English with a French citation
PDF.SetPDFUAMode('en-US');
PDF.BeginTag('P', '', '');
PDF.PrintText(50, 750, 'The French motto is:');
PDF.EndTag;
PDF.BeginTagEx('Span', '', '', 'fr-FR');
PDF.PrintText(50, 730, 'Liberté, Égalité, Fraternité');
PDF.EndTag;