SetStructElemColSpan

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

Mô tả

Đặt attribute /ColSpan (owner Table) lên structure element đang mở trên tag stack. Giá trị cho biết ô bảng hiện tại chiếm bao nhiêu cột. Tương đương gọi AddTagAttribute với Owner=Table, Name=ColSpan và giá trị số nguyên dạng chuỗi

Cú pháp

Delphi

Function TPDFlib.SetStructElemColSpan(ColSpan: Integer): Integer;

ActiveX

Function PDFlib::SetStructElemColSpan(ColSpan As Long) As Long

DLL

int DLSetStructElemColSpan(int InstanceID, int ColSpan);

Tham số

ColSpan	Số cột mà ô bảng hiện tại chiếm. Phải là số nguyên dương. Giá trị 1 nghĩa là ô chiếm đúng một cột (hành vi mặc định khi không đặt ColSpan). Giá trị lớn hơn 1 chỉ ra ô tiêu đề hoặc dữ liệu trải qua nhiều cột

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ú

Call this function after BeginTag (with tag type TH or TD) and before EndTag. The /ColSpan attribute is defined in ISO 32000-1 §14.8.5.7.2 (Table attribute owner, Table 337).

Spanning cells are common in complex tables — for example, a column header that spans two data columns. Providing the /ColSpan attribute allows assistive technology to correctly compute cell positions and associate headers with data cells across the entire table grid.

Khi một ô còn trải qua nhiều hàng, dùng SetStructElemRowSpan kết hợp với hàm này

Ví dụ

// A header cell spanning two columns
PDFlib.BeginTag('TH', 'Q1 and Q2 Revenue', '', '');
PDFlib.SetStructElemScope('Column');
PDFlib.SetStructElemColSpan(2);
PDFlib.DrawText('Q1 and Q2 Revenue', 100, 700);
PDFlib.EndTag;

Xem thêm

SetStructElemRowSpan, SetStructElemScope, AddTagAttribute, BeginTag, EndTag