AddPolygonAnnotation

Chú thích và liên kết điểm nóng

Mô tả

Thêm một chú thích markup đa giác kín (PDF /Subtype /Polygon) vào trang đang chọn với danh sách đỉnh cung cấp. Đa giác được đóng ngầm — các reader nối đỉnh cuối về đỉnh đầu khi render. Hình có thể được tô màu nền đặc tùy chọn. Các thành phần màu và độ mờ tính theo thang 0–1; Transparency tính theo thang 0–100 (0 = đặc hoàn toàn, 100 = trong suốt hoàn toàn). Thư viện nâng phiên bản tài liệu lên PDF 1.5 khi một chú thích Polygon được phát dưới một khóa phiên bản tối thiểu thấp hơn. Định nghĩa tại ISO 32000-1 §12.5.6.9

Cú pháp

Delphi

Function TPDFlib.AddPolygonAnnotation(Const VertexCoords: WideString; BorderWidth: Double; BorderRed, BorderGreen, BorderBlue: Double; Filled: Integer; FillRed, FillGreen, FillBlue: Double; Const Title, Contents: WideString; Transparency: Integer): Integer;

Tham số

VertexCoords — Tọa độ các đỉnh dưới dạng một chuỗi giá trị x/y xen kẽ, phân tách bằng khoảng trắng, dấu phẩy, chấm phẩy hay tab. Ví dụ: "100 100 200 100 200 200 100 200" định nghĩa một hình vuông. Cần ít nhất hai cặp (bốn số) và tổng số giá trị phải chẵn, nếu không lời gọi trả về 0

BorderWidth — Độ rộng nét của viền đa giác, theo đơn vị hiện tại

BorderRed, BorderGreen, BorderBlue — Các thành phần RGB (0–1) của màu viền, ghi vào /C

Filled — 1 để xuất màu tô bên trong (/IC) cho thân đa giác, 0 để giữ không tô

FillRed, FillGreen, FillBlue — Các thành phần RGB (0–1) của màu tô bên trong. Bị bỏ qua khi Filled = 0

Title — Tên tác giả ghi vào mục /T của chú thích. Truyền chuỗi rỗng để bỏ qua

Contents — Nội dung của popup gắn với chú thích. Truyền chuỗi rỗng để bỏ qua

Transparency — Độ mờ tính theo phần trăm trong suốt (0–100). Thư viện quy đổi thành PDF /CA = 1 - Transparency/100 rồi giới hạn về khoảng hợp lệ

Giá trị trả về

1 khi thành công, 0 nếu không có tài liệu nào đang chọn, chuỗi vertex parse thất bại hoặc không tạo được chú thích

Ghi chú

Mục /Rect của chú thích được tính tự động từ phạm vi các đỉnh cộng thêm một phần đệm nhỏ tỷ lệ với độ rộng viền để nét viền nằm gọn trong bounding box của chú thích

Các trường nâng cao tùy chọn theo đặc tả PDF — /BE (hiệu ứng viền, gồm kiểu viền mây), /IT (ý định, gồm PolygonCloud và PolygonDimension) và /Measure — không được entry point này phát ra. Chúng có thể được bổ sung sau khi tạo bằng cách ghi trực tiếp vào dictionary chú thích

Muốn ghi đè màu viền, kiểu viền, nội dung hay hình chữ nhật của đề mục sau khi tạo, dùng SetAnnotBorderColor, SetAnnotBorderStyle, SetAnnotContents và SetAnnotRect