BeginTagEx

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, kèm attribute ngôn ngữ tự nhiên tường minh. Giống hệt BeginTag nhưng thêm tham số Lang được ghi vào attribute /Lang của structure element

Dùng hàm này cho nội dung có ngôn ngữ khác ngôn ngữ mặc định của tài liệu (đặt bằng SetPDFUAMode hoặc SetDocumentLanguage). ISO 14289-1 §7.2 yêu cầu đặt thuộc tính /Lang cho mọi đoạn văn bản không thuộc ngôn ngữ chính của tài liệu.

Các tag phải cân bằng: mỗi lần gọi BeginTagEx 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.BeginTagEx(Const TagType, AltText, ActualText, Lang: WideString): Integer;

ActiveX

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

DLL

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

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 (attribute `/Alt`). Truyền chuỗi rỗng nếu không cần
ActualText	Văn bản thay thế cho nội dung mà dạng hiển thị khác ý nghĩa hợp lý của nó (attribute `/ActualText`). Truyền chuỗi rỗng nếu không cần
Lang	Thẻ ngôn ngữ BCP 47 cho nội dung trong phần tử này, vd. `en-US`, `fr-FR`, `zh-Hans`. Truyền chuỗi rỗng để kế thừa ngôn ngữ tài liệu. Khi khác rỗng, nó ghi đè ngôn ngữ cấp tài liệu cho phần tử này và toàn bộ hậu duệ của nó

Giá trị trả về

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

Ví dụ

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