SetStructElemRowSpan

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

Mô tả

Đặt attribute /RowSpan (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 hàng. Tương đương gọi AddTagAttribute với Owner=Table, Name=RowSpan và giá trị số nguyên dạng chuỗi

Cú pháp

Delphi

Function TPDFlib.SetStructElemRowSpan(RowSpan: Integer): Integer;

ActiveX

Function PDFlib::SetStructElemRowSpan(RowSpan As Long) As Long

DLL

int DLSetStructElemRowSpan(int InstanceID, int RowSpan);

Tham số

RowSpan	Số hàng 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 hàng (hành vi mặc định khi không đặt RowSpan). Giá trị lớn hơn 1 chỉ ra ô trải qua nhiều hàng

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ú

Gọi hàm này sau BeginTag (với kiểu thẻ TH hoặc TD) và trước EndTag. Thuộc tính /RowSpan được định nghĩa trong ISO 32000-1 §14.8.5.7.2 (chủ sở hữu thuộc tính Table, Bảng 337).

Ô ghép nhiều hàng xuất hiện trong các bảng mà ô đầu đề hoặc ô dữ liệu cần kéo dài theo chiều dọc qua nhiều hàng – ví dụ ô đầu hàng dùng chung cho vài hàng dữ liệu. Cung cấp thuộc tính /RowSpan giúp công nghệ hỗ trợ dựng đúng mô hình lưới logic của bảng.

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

Ví dụ

// A row header cell spanning two data rows
PDFlib.BeginTag('TH', 'First Quarter', '', '');
PDFlib.SetStructElemScope('Row');
PDFlib.SetStructElemRowSpan(2);
PDFlib.DrawText('First Quarter', 72, 680);
PDFlib.EndTag;

Xem thêm

SetStructElemColSpan, SetStructElemScope, AddTagAttribute, BeginTag, EndTag