BeginTag

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

Mô tả

Mở một structure element tagged-PDF trên trang hiện tại. Ghi một toán tử BDC (Begin Marked Content with Dictionary) vào content stream và đăng ký phần tử vào structure tree hợp lý của tài liệu. Structure tree được hoàn tất tự động khi tài liệu được lưu

Các tag phải cân bằng: mỗi lần gọi BeginTag phải có một lần gọi EndTag tương ứng theo sau. Tag được lồng vào nhau

Cú pháp

Delphi

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

ActiveX

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

DLL

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

Tham số

TagType	PDF standard structure type: `P`, `H1`–`H6`, `Figure`, `Table`, `TR`, `TH`, `TD`, `L`, `LI`, `LBody`, `Span`, `Link`, `Note`, etc. (see ISO 32000-1 §14.8.4).
AltText	Văn bản thay thế cho ảnh và nội dung phi văn bản khác (ánh xạ sang attribute `/Alt` của PDF). Truyền chuỗi rỗng nếu không cần
ActualText	Văn bản thay thế cho nội dung mà phần hiển thị khác với ý nghĩa hợp lý của nó (ánh xạ sang attribute `/ActualText` của PDF). Truyền chuỗi rỗng nếu không cần

Giá trị trả về

0	Failed (no document is open)
1	Tag opened successfully

Ví dụ

// Heading, then a paragraph
PDF.SetPDFUAMode('en-US');
PDF.BeginTag('H1', '', '');
PDF.PrintText(50, 750, 'Introduction');
PDF.EndTag;
PDF.BeginTag('P', '', '');
PDF.PrintText(50, 730, 'This document demonstrates tagged PDF.');
PDF.EndTag;

// Figure with alt text
PDF.BeginTag('Figure', 'Company logo', '');
PDF.DrawImage(50, 650, 120, 60, 'logo.png');
PDF.EndTag;

Ghi chú

Dùng BeginArtifact/EndArtifact cho nội dung trang trí (header, footer, phần tử nền) mà screen reader không nên đọc

Tài liệu phải ở chế độ ghi (được tạo hoặc mở để sửa đổi). Gọi SetPDFUAMode trước khi gắn tag để đáp ứng yêu cầu PDF/UA-1

Gắn tag cho tài liệu sẽ đánh dấu nó là tagged khi được lưu - điều reader cần trước khi coi cấu trúc là có mặt. Thiết lập SetMarkInfo do caller thực hiện được giữ nguyên