AddCircleAnnotation

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

Mô tả

Thêm một chú thích markup ellipse (PDF /Subtype /Circle) nội tiếp trong hình chữ nhật cho trước. Dù có cái tên đó, chú thích là một ellipse trọn vẹn và chỉ render thành đường tròn thật khi Width bằng Height. Chú thích 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). 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.8

Cú pháp

Delphi

Function TPDFlib.AddCircleAnnotation(Left, Top, Width, Height: Double; BorderWidth: Double; BorderRed, BorderGreen, BorderBlue: Double; Filled: Integer; FillRed, FillGreen, FillBlue: Double; Const Title, Contents: WideString; Transparency: Integer): Integer;

Tham số

Left — Tọa độ ngang của góc dưới bên trái hình chữ nhật bao, theo đơn vị hiện tại

Top — Tọa độ dọc của góc dưới bên trái hình chữ nhật bao, theo đơn vị hiện tại

Width — Chiều rộng của hình chữ nhật bao

Height — Chiều cao của hình chữ nhật bao

BorderWidth — Độ rộng nét của viền ellipse, theo đơn vị hiện tại. Ghi vào cả trường cũ /Border lẫn dictionary kiểu viền /BS

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

Filled — 1 để xuất màu tô bên trong (/IC), 0 để giữ ellipse 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 hoặc không tạo được chú thích

Ghi chú

Chú thích được phát với bộ trường markup chuẩn: /Type /Annot, /Subtype /Circle, /Rect, /C, /IC (khi Filled), /BS, /Border, /CA, /F = 4 (in được), /M, /CreationDate, /NM, /T, /Contents, /Subj = "Ellipse", /P. Điều này khớp với những gì Adobe Acrobat và Foxit sinh ra cho công cụ review ellipse của họ, nên các quy trình review bên ngoài có thể định vị, sửa, bình luận và trả lời chú thích thu được

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