AddSquareAnnotation

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

Mô tả

Thêm một chú thích markup hình chữ nhật (PDF /Subtype /Square) vào trang đang chọn. Chú thích vẽ một hình chữ nhật có nét nằm nội tiếp trong hình chữ nhật bao cho trước và 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.AddSquareAnnotation(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 chú thích, 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 chú thích, theo đơn vị hiện tại

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

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

BorderWidth — Độ rộng nét của viền hình chữ nhật, 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ữ hình chữ nhật 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 /Square, /Rect, /C, /IC (khi Filled), /BS, /Border, /CA, /F = 4 (in được), /M, /CreationDate, /NM, /T, /Contents, /Subj = "Rectangle", /P. Điều này khớp với những gì Adobe Acrobat và Foxit sinh ra cho công cụ review hình chữ nhật 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, màu, nội dung hay viền của chú thích sau khi tạo, dùng SetAnnotRect, SetAnnotBorderColor, SetAnnotContents và SetAnnotBorderStyle