SetStructElemHeaders

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

Mô tả

Đặt attribute /Headers (owner Table) lên structure element đang mở trên tag stack. Attribute này gắn ô dữ liệu hoặc ô tiêu đề hiện tại với một hoặc nhiều ô tiêu đề bảng được nhận dạng qua element ID của chúng. Dùng để mô tả các cấu trúc bảng phức tạp mà không suy ra được từ vị trí một mình. Gọi sau BeginTag hoặc BeginTagEx và trước EndTag

Cú pháp

Delphi

Function TPDFlib.SetStructElemHeaders(Const Headers: WideString): Integer;

ActiveX

Function PDFlib::SetStructElemHeaders(Headers As String) As Long

DLL

int DLSetStructElemHeaders(int InstanceID, const wchar_t * Headers);

Tham số

Headers	Danh sách ID phần tử của các ô TH đóng vai trò tiêu đề cột hoặc hàng cho ô TD/TH hiện tại, phân tách bằng dấu phẩy. Mỗi ID phải khớp một ElemID đã gán cho phần tử TH qua SetStructElemID ở phần trước của cùng tài liệu. Khoảng trắng quanh dấu phẩy bị bỏ qua. Ví dụ: `TH-ProductName,TH-Price`

Giá trị trả về

Trả về 1 khi thành công. Trả về 0 nếu không có tài liệu nào đang mở hoặc tag stack hiện không còn tag nào đang mở

Ghi chú

Hàm này tương đương với việc gọi AddTagAttribute với Owner=Table, Name=Headers và cùng danh sách ID phân tách bằng dấu phẩy làm Value. Attribute được ghi thành mảng /Headers gồm các text string PDF trong attribute dictionary /A của structure element

Thuộc tính /Headers được định nghĩa trong ISO 32000-1 §14.8.5.7.2 (chủ sở hữu thuộc tính Table). Với bảng đơn giản, nơi đầu cột nằm ngay trên ô dữ liệu của nó, thuộc tính /Scope đặt qua SetStructElemScope thường là đủ. Dùng /Headers cho các bảng bất quy tắc có ô ghép hoặc đầu đề nhiều cấp.

PDF/UA-1 (ISO 14289-1 §7.10) yêu cầu mọi ô TD phải được liên kết rõ ràng với các ô đầu đề của nó trong các bảng mà mối liên kết không thể suy ra chỉ từ thứ tự đọc.

Ví dụ

// A data cell that spans two logical columns, referencing both headers
PDFlib.BeginTag('TD', '', '', '');
PDFlib.SetStructElemHeaders('TH-ProductName,TH-Price');
PDFlib.DrawText('Widget A  $9.99', 100, 660);
PDFlib.EndTag;

Xem thêm

SetStructElemID, SetStructElemScope, AddTagAttribute, BeginTag, SetPDFUAMode