SetStructElemColor

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

Mô tả

Đặt thuộc tính /Color (chủ sở hữu thuộc tính Layout) trên phần tử cấu trúc hiện đang mở trong ngăn xếp thẻ. Giá trị xác định màu tiền cảnh (văn bản hoặc nét vẽ) của nội dung phần tử dưới dạng bộ ba RGB. Tương đương với việc gọi AddTagAttribute với Owner=Layout, Name=Color và chuỗi R G B phân tách bằng dấu cách.

Cú pháp

Delphi

Function TPDFlib.SetStructElemColor(R, G, B: Double): Integer;

ActiveX

Function PDFlib::SetStructElemColor(R As Double, G As Double, B As Double) As Long

DLL

int DLSetStructElemColor(int InstanceID, double R, double G, double B);

Tham số

R	Thành phần đỏ của màu, trong khoảng 0.0 (không đỏ) đến 1.0 (đỏ tối đa)
G	Thành phần xanh lá của màu, trong khoảng 0.0 đến 1.0
B	Thành phần xanh dương của màu, trong khoảng 0.0 đến 1.0

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 hoặc BeginTagEx và trước EndTag. Thuộc tính /Color được định nghĩa trong ISO 32000-1 §14.8.5.4.2 (chủ sở hữu thuộc tính Layout, Bảng 340) và được lưu dưới dạng mảng số PDF ba phần tử.

Thuộc tính này mô tả màu tiền cảnh của phần tử như công nghệ hỗ trợ hoặc engine xắp xếp lại nội dung cảm nhận. Nó chỉ mang tính tham khảo – màu hiển thị thực tế trong PDF do graphics state điều khiển, không phải thuộc tính này. Tuy vậy, cung cấp thông tin màu chính xác giúp các công cụ phía sau kiểm tra tỷ lệ tương phản màu (WCAG 2.x Success Criterion 1.4.3) và giữ độ trung thực khi xắp xếp lại nội dung.

Common color values: black = (0.0, 0.0, 0.0); white = (1.0, 1.0, 1.0); red = (1.0, 0.0, 0.0).

Ví dụ

// Tag a heading rendered in dark blue
PDFlib.BeginTag('H2', '', '', '');
PDFlib.SetStructElemColor(0.0, 0.18, 0.39);  // RGB for dark blue
PDFlib.DrawText('Section 2', 72, 700);
PDFlib.EndTag;

Xem thêm

SetStructElemEndIndent, SetStructElemBBox, AddTagAttribute, BeginTag, EndTag