BeginTagEx2

Tagged PDF & 접근성

설명

새 구조 요소를 열어 태그 스택에 푸시하고 한 번의 호출로 모든 주요 요소 속성을 설정합니다. BeginTagEx2는 BeginTagEx를 호출한 다음 SetStructElemTitle, SetStructElemID 및 SetStructElemExpansion을 호출하는 편의 래퍼입니다. Title, ElemID 또는 Expansion에 빈 문자열을 전달하면 해당 setter를 건너뛰며, 다른 매개변수는 BeginTagEx와 동일하게 작동함

요소를 열 때 모든 설명 속성을 이미 알고 있다면 연속적인 setter 호출을 피하기 위해 BeginTagEx2를 사용하십시오. 속성이 나중에 결정되는 경우(예: AltText가 비동기적으로 도착)에는 BeginTag 또는 BeginTagEx를 사용하고 나중에 개별 setter를 호출하십시오

구문

Delphi

Function TPDFlib.BeginTagEx2(Const TagType, AltText, ActualText, Lang, Title, ElemID, Expansion: WideString): Integer;

ActiveX

Function PDFlib::BeginTagEx2(TagType As String, AltText As String, ActualText As String, Lang As String, Title As String, ElemID As String, Expansion As String) As Long

DLL

int DLBeginTagEx2(int InstanceID, const wchar_t * TagType, const wchar_t * AltText, const wchar_t * ActualText, const wchar_t * Lang, const wchar_t * Title, const wchar_t * ElemID, const wchar_t * Expansion);

매개변수

TagType	구조 요소 유형 이름입니다(예: `Figure`, `Table`, `Span`, `P`). BeginTag에서 허용하는 것과 같은 유형입니다
AltText	/Alt 항목에 기록되는 대체 텍스트(ISO 32000-1 §14.9.3). 생략하려면 빈 문자열을 전달합니다
ActualText	/ActualText 항목에 기록되는 실제 텍스트(ISO 32000-1 §14.9.4)입니다. 생략하려면 빈 문자열을 전달하십시오
Lang	/Lang 항목에 기록되는 BCP 47 언어 태그(ISO 32000-1 §14.9.2)입니다. 예: `en-US`, `fr`, `zh-Hant-TW`. 문서 언어를 상속하려면 빈 문자열을 전달합니다
Title	/T 항목에 기록되는 사람이 읽을 수 있는 레이블(ISO 32000-1 §14.7.2)입니다. Tags 탐색 패널에 표시됩니다. 생략하려면 빈 문자열을 전달합니다
ElemID	/ID 항목에 기록할 고유 요소 식별자(ISO 32000-1 §14.7.4)입니다. 설정하면 문서 안에서 고유해야 하며 생략하려면 빈 문자열을 전달합니다
Expansion	/E 항목에 기록할 약어 또는 두문자어의 전체 표현(ISO 32000-1 §14.9.5)입니다. 생략하려면 빈 문자열을 전달합니다

반환 값

성공하면 1, 선택한 문서가 없으면 0을 반환합니다

비고

성공한 호출마다 EndTag를 한 번 호출해 태그 스택에서 요소를 꺼냅니다. 해당 호출은 BeginTagEx2이며 구조 요소는 중첩할 수 있습니다. 다른 요소가 열린 상태에서 BeginTagEx2를 호출하면 자식 요소가 생성됩니다

내부 구현은 다음과 정확히 동일합니다:

BeginTagEx(TagType, AltText, ActualText, Lang);
if Title <> '' then SetStructElemTitle(Title);
if ElemID <> '' then SetStructElemID(ElemID);
if Expansion <> '' then SetStructElemExpansion(Expansion);

요소를 연 후 결정되는 속성이나 BeginTagEx2에서 다루지 않는 속성(예: 표 셀 속성을 위한 AddTagAttribute)에는 개별 설정자를 계속 사용할 수 있습니다

예제

// Tag a figure with all descriptive properties in one call
PDFlib.BeginTagEx2(
  'Figure',                              // TagType
  'Bar chart: Q1 120, Q2 145, Q3 98',   // AltText
  '',                                    // ActualText (not needed for images)
  '',                                    // Lang (inherit document language)
  'Figure 3: Quarterly Sales',           // Title
  'fig-quarterly-sales',                 // ElemID
  ''                                     // Expansion (not an abbreviation)
);
PDFlib.SetStructElemBBox(x, y, x + w, y + h);
PDFlib.DrawImage(imgHandle, x, y, w, h);
PDFlib.EndTag;

// Tag an acronym span with its expansion
PDFlib.BeginTagEx2(
  'Span',
  '',                                          // AltText
  '',                                          // ActualText
  '',                                          // Lang
  '',                                          // Title
  '',                                          // ElemID
  'World Wide Web Consortium'                  // Expansion
);
PDFlib.WriteText('W3C');
PDFlib.EndTag;

참고 항목

BeginTag, BeginTagEx, EndTag, SetStructElemTitle, SetStructElemID, SetStructElemExpansion