EndTag

태그 지정 PDF, 접근성

설명

태그 스택에서 가장 최근에 연 구조 요소를 닫고 현재 페이지의 콘텐츠 스트림에 EMC(End Marked Content) 연산자를 쓰며 스택에서 요소를 꺼냅니다. 문서를 저장하거나 다음 페이지를 추가하기 전에 BeginTag, BeginTagEx 또는 BeginTagEx2의 각 호출은 정확히 하나의 EndTag 호출과 일치해야 합니다

구문

Delphi

Function TPDFlib.EndTag: Integer;

ActiveX

Function PDFlib::EndTag() As Long

DLL

int DLEndTag(int InstanceID);

반환 값

0	실패 — 열린 문서가 없거나 태그 스택이 비어 있습니다(`EndTag`가 해당 `Begin*` 함수보다 더 많이 호출됨)
1	구조 요소를 성공적으로 닫았습니다

비고

태그는 올바르게 중첩되어야 합니다. 각 EndTag는 가장 안쪽의 열린 구조 요소를 닫습니다. 닫는 순서는 여는 순서의 정확한 역순이며 HTML 또는 XML에서 일반 블록 요소가 중첩되는 방식과 같습니다

하나 이상의 구조 요소가 열린 상태에서 문서를 저장하면 GetPDFUADiagnostics가 STRUCT-UNCLOSED 코드 아래에 개수를 보고합니다. 닫히지 않은 요소는 저장된 구조 트리에서 누락되므로 각 페이지의 해당 표시 콘텐츠 섹션에는 논리적 부모가 없으며 보조 기술이 이를 건너뜀

아티팩트 영역을 닫을 때 절대 EndTag를 사용하지 마십시오. BeginArtifact로 연 영역은 EndArtifact를 호출하여 닫아야 합니다. 아티팩트와 구조 요소는 서로 독립적인 표시 콘텐츠 스택에 존재함

예제

// Nested structure: a section with a heading and two paragraphs
PDF.BeginTag('Sect', '', '');
  PDF.BeginTag('H1', '', '');
    PDF.PrintText(50, 750, 'Introduction');
  PDF.EndTag;   // H1
  PDF.BeginTag('P', '', '');
    PDF.PrintText(50, 720, 'First paragraph of the introduction.');
  PDF.EndTag;   // P
  PDF.BeginTag('P', '', '');
    PDF.PrintText(50, 690, 'Second paragraph follows in the same section.');
  PDF.EndTag;   // P
PDF.EndTag;     // Sect

참고 항목

BeginTag, BeginTagEx, BeginTagEx2, EndArtifact, GetPDFUADiagnostics