EndTag

PDF có gắn thẻ, Khả năng tiếp cận

Mô tả

Đóng structure element được mở gần nhất trên tag stack, ghi một toán tử EMC (End Marked Content) vào content stream của trang hiện tại và pop phần tử khỏi stack. Mỗi lần gọi BeginTag, BeginTagEx hay BeginTagEx2 phải được bù bằng đúng một lần gọi EndTag trước khi tài liệu được lưu hoặc trang kế tiếp được thêm

Cú pháp

Delphi

Function TPDFlib.EndTag: Integer;

ActiveX

Function PDFlib::EndTag() As Long

DLL

int DLEndTag(int InstanceID);

Giá trị trả về

0	Thất bại — không có tài liệu nào đang mở hoặc ngăn xếp thẻ trống (`EndTag` được gọi nhiều lần hơn các hàm `Begin*` tương ứng).
1	Đã đóng structure element thành công

Ghi chú

Các tag phải lồng gọn gàng. Mỗi EndTag đóng structure element đang mở trong cùng nhất; thứ tự đóng ngược chặt chẽ thứ tự mở, y như các phần tử khối thường lồng nhau trong HTML hay XML

Nếu tài liệu được lưu khi còn một hoặc nhiều phần tử cấu trúc chưa đóng, GetPDFUADiagnostics sẽ báo số lượng dưới mã STRUCT-UNCLOSED. Các phần tử chưa đóng bị thiếu trong cây cấu trúc đã lưu, nên các đoạn nội dung đánh dấu tương ứng trên mỗi trang không có cha hợp lý – công nghệ hỗ trợ sẽ bỏ qua chúng.

Đừng dùng EndTag để đóng một vùng artifact mở bằng BeginArtifact; hãy gọi EndArtifact cho việc đó. Artifact và structure element nằm trên các stack marked-content độc lập

Ví dụ

// 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

Xem thêm

BeginTag, BeginTagEx, BeginTagEx2, EndArtifact, GetPDFUADiagnostics