BeginTagExA
태그 지정 PDF, 접근성
설명
끝의 A는 ANSI(char) DLL 진입점을 나타내며, ActiveX/COM 인터페이스에서는 Unicode 형식만 노출됩니다. 동작은 BeginTagEx와 동일하고 문자열 인수는 현재 SetAnsiMode 코드 페이지를 사용해 해석됩니다
현재 페이지에서 명시적인 자연어 특성과 함께 태그가 지정된 PDF 구조 요소를 엽니다. BeginTag와 동일하지만 구조 요소의 Lang 매개변수를 추가하여 요소의 /Lang 특성에 씁니다
문서의 기본 언어(SetPDFUAMode 또는 SetDocumentLanguage로 설정)와 다른 언어의 콘텐츠에 이 함수를 사용합니다. ISO 14289-1 §7.2에서는 문서 기본 언어가 아닌 텍스트 세그먼트에 /Lang 속성을 설정하도록 요구합니다
태그는 균형을 이루어야 합니다. 모든 BeginTagEx 호출 뒤에는 일치하는 EndTag 호출이 와야 합니다. 태그는 중첩할 수 있습니다
구문
Delphi
Function DLBeginTagExA(InstanceID: Integer; TagType, AltText, ActualText, Lang: PAnsiChar): Integer;
DLL
int DLBeginTagExA(int InstanceID, const char * TagType, const char * AltText, const char * ActualText, const char * 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;