AddLineAnnotation

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

Mô tả

Thêm một chú thích markup đường thẳng (PDF /Subtype /Line) giữa hai điểm mút trên trang đang chọn. Mỗi đầu có thể mang một kiểu đầu mút khác nhau (mũi tên, vuông, tròn, kim cương, …) và thân đường vẽ được bằng bất kỳ màu RGB nào với độ mờ cấu hình được. 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. Vì entry point này phát khóa độ mờ chú thích /CA của PDF 1.4, thư viện nâng các tài liệu chưa khóa thấp hơn lên PDF 1.4 trước khi lưu; các đích thấp hơn đã bị khóa bị cổng tương thích từ chối. Định nghĩa tại ISO 32000-1 §12.5.6.7

Cú pháp

Delphi

Function TPDFlib.AddLineAnnotation(StartLeft, StartTop, EndLeft, EndTop: Double; BorderWidth: Double; LineRed, LineGreen, LineBlue: Double; StartStyle, EndStyle: Integer; Filled: Integer; FillRed, FillGreen, FillBlue: Double; Const Title, Contents: WideString; Transparency: Integer): Integer;

Tham số

StartLeft, StartTop — Tọa độ điểm đầu của đường thẳng, theo đơn vị hiện tại

EndLeft, EndTop — Tọa độ điểm cuối của đường thẳng, theo đơn vị hiện tại

BorderWidth — Độ rộng nét của đường thẳng 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 điểm đầu và điểm cuối. 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 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ừ hai đầu mút 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 PDF reader đòi hỏi /Rect bao phải chứa toàn bộ phần vẽ hiển thị, nếu không phần trang trí đầu mút có thể bị cắt

Các trường nâng cao tùy chọn theo đặc tả PDF — /LL (chiều dài leader), /LLE, /LLO, /Cap, /CP, /CO 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