AddPolyLineAnnotation

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

Mô tả

Thêm một chú thích markup đường gấp khúc hở (PDF /Subtype /PolyLine) vào trang đang chọn với danh sách đỉnh cung cấp. Đường gấp khúc là hở — các reader không nối đỉnh cuối về đỉnh đầu — và có thể mang kiểu đầu mút khác nhau tại từng điểm mút. Các phần trang trí đầu mút có lòng bên trong (ClosedArrow, Square, Circle, Diamond) có thể được tô 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 PolyLine đượ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.AddPolyLineAnnotation(Const VertexCoords: WideString; BorderWidth: Double; LineRed, LineGreen, LineBlue: Double; StartStyle, EndStyle: Integer; 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 150 300 100" định nghĩa hình chữ V. 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 đường gấp khúc và phần trang trí hai đầu, theo đơn vị hiện tại

LineRed, LineGreen, LineBlue — Các thành phần RGB (0–1) của màu đường nét, ghi vào /C

StartStyle, EndStyle — Kiểu đầu mút cho đỉnh đầu tiên và đỉnh cuối cùng. Dùng một trong:

0 = None, 1 = Square, 2 = Circle, 3 = Diamond, 4 = OpenArrow, 5 = ClosedArrow, 6 = Butt, 7 = ROpenArrow, 8 = RClosedArrow, 9 = Slash.

Out-of-range values clamp to 0 (None).

Filled — 1 để xuất màu tô bên trong (/IC) cho các phần trang trí đầu mút, 0 để giữ chúng không tô

FillRed, FillGreen, FillBlue — Các thành phần RGB (0–1) của màu tô bên trong phần trang trí đầu mút. 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 tỷ lệ với độ rộng viền để các phần trang trí đầu mút 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 — /IT (ý định, gồm PolyLineDimension) 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 đường nét, viền, nội dung hay hình chữ nhật sau khi tạo, dùng SetAnnotBorderColor, SetAnnotBorderStyle, SetAnnotContents và SetAnnotRect