THPDFPage Advanced Methods

Trang này tập hợp các phương thức cấp trang được public trong THPDFPage và hữu ích cho các luồng biên soạn nâng cao, nhưng chưa có trang chủ đề riêng

Chú thích đánh dấu và rich annotation

Method	Cách dùng
`AddHighlightAnnotation`, `AddUnderlineAnnotation`, `AddSquigglyAnnotation`, `AddStrikeOutAnnotation`	Tạo chú thích đánh dấu văn bản trên một vùng văn bản hình chữ nhật. HotPDF phát ra subtype PDF 1.7 tương ứng và suy ra `/QuadPoints` từ hình chữ nhật
`AddPolylineAnnotation`, `AddPolygonAnnotation`	Tạo chú thích review polyline hoặc polygon PDF 1.7 từ một mảng đỉnh `THPDFCurrPoint`. Các overload dùng `THPDFPolyExtras` thêm màu nội thất tùy chọn, viền mây, intent và chi tiết đầu mút
`HPDFDefaultLineExtras`, `HPDFDefaultPolyExtras`	Trả về các record `THPDFLineExtras` và `THPDFPolyExtras` đã khởi tạo về 0 để người gọi chỉ đặt các trường tùy chọn của chú thích line hoặc polygon mà họ cần
`AddInkAnnotation`, `AddCaretAnnotation`	Thêm đánh dấu review vẽ tay hoặc dấu chèn caret. Dùng LastAnnotation cùng SetAnnotationBorderStyle khi cần chỉnh kiểu viền sau khi tạo
`AddScreenAnnotation`, `AddWatermarkAnnotation`, `AddRedactAnnotation`	Thêm chú thích screen đa phương tiện, watermark in cố định hoặc redaction. Các phương thức này tuân theo cùng cổng kiểm tra phiên bản PDF và compliance như các subtype chú thích tương ứng
`Add3DAnnotation`, `AddRichMediaAnnotation`	Thêm chú thích media tương tác PDF 1.7. Chúng dành cho các luồng trình xem hỗ trợ tường minh nội dung 3D hoặc rich-media nhúng và không phù hợp cho đầu ra PDF/A lưu trữ
`AddPopupAnnotation`	Tạo trực tiếp một chú thích popup. Khi popup cần gắn vào chú thích khác, hãy ưu tiên AddPopupAnnotationFor

Mở rộng hành động nút

Method	Mô tả
`AddPushButtonWithHideAction`	Tạo một push button có hành động ẩn hoặc hiện một hay nhiều trường biểu mẫu. Hữu ích khi form cần các phần tùy chọn mà không phải chạy JavaScript
`AddPushButtonWithSubmitAction`	Tạo nút submit với `THPDFSubmitFormFlags` tường minh để người gọi kiểm soát FDF, HTML, XFDF, PDF, GET/POST và các tùy chọn gửi liên quan
`AddPushButtonWithRenditionAction`	Tạo một push button điều khiển hành động Rendition gắn với chú thích Screen và một tệp media. Các chế độ compliance PDF/A và PDF/X sẽ từ chối hành động đa phương tiện
`AddPushButtonWithSoundAction`	Tạo một push button phát `/Sound` PDF nhúng. Các overload nhận либо tên tệp либо byte âm thanh thô do người gọi cung cấp cùng `THPDFSoundParams`
`AddPushButtonWithMovieAction`	Tạo một nút hành động Movie kiểu cũ tham chiếu dictionary do `AddMovieAnnotation` trả về

Page box và điều khiển hiển thị

Phương thức hoặc thuộc tính	Mô tả
`SetCropBox`, `SetBleedBox`, `SetTrimBox`, `SetArtBox`	Gắn các page box sản xuất tùy chọn được định nghĩa bởi ISO 32000-1 §14.11.2. `MediaBox` vẫn theo dõi kích thước giấy vật lý; các box chưa đặt sẽ rơi xuống chuỗi mặc định chuẩn của PDF
`SetPageRotation`	Đặt mục `/Rotate` của trang. Giá trị được chuẩn hóa về bội số 90 độ theo yêu cầu PDF trong phạm vi `0..359`
`SetUserUnit`	Đặt `/UserUnit` PDF 1.6 cho các trang rất lớn. Truyền `0` sẽ xóa mục này và đưa trang về thang đơn vị mặc định
`SetTabsOrder`	Đặt thứ tự tab của chú thích trang qua mục `/Tabs`. Dùng `R`, `C`, `S`, `A` hoặc `W` như đặc tả PDF quy định
`DocScale`	Điều chỉnh thang vẽ trang dùng bởi các đường vẽ tương thích. Hãy để mặc định trừ khi người gọi thực sự cần tọa độ cũ đã được scale

Độ trong suốt và nội dung tùy chọn

Method	Mô tả
`SetTransparencyGroup`, `SetTransparencyGroupICC`, `ClearTransparencyGroup`	Gắn hoặc gỡ dictionary `/Group` của trang để nội dung có alpha được ghép như một transparency group của PDF. Biến thể ICC tham chiếu một hồ sơ ICC đã đăng ký trên tài liệu
`BeginOptionalContent`, `EndOptionalContent`	Bọc phần vẽ trang tiếp theo trong một marked-content sequence nội dung tùy chọn PDF 1.5. Hãy đăng ký lớp trước bằng `THotPDF.RegisterOptionalContentGroup`

Nội dung gắn thẻ và phông Type 3

Method	Mô tả
`BeginMarkedContentMCIDProps`	Bắt đầu một marked-content sequence với một dictionary thuộc tính nội dòng chứa `/MCID` cùng các mục tùy chọn `/Lang`, `/Alt`, `/ActualText` và `/E`. Dùng `EndMarkedContent` để đóng sequence
`SetType3Font`	Chọn một phông Type 3 đã đăng ký qua `THotPDF.RegisterType3Font` để các lời gọi `ShowText` tiếp theo phát ra văn bản bằng các glyph stream do người gọi định nghĩa

Định vị văn bản và trợ giúp tương thích

Method	Mô tả
`SetCharacterSpacing`, `SetTextMatrix`, `MoveToNextLine`	Phát các toán tử text-state và định vị văn bản cấp thấp cho những người gọi cần kiểm soát trực tiếp vượt quá TextOut, UnicodeTextOut hoặc các trợ giúp text-box
`SetRGBHyperlinkColor`	Đặt màu RGB dùng bởi PrintHyperlink. Thuộc tính public HyperlinkColor gọi setter này
`FMEllipse`, `MFRectangle`	Các bí danh vẽ kiểu cũ được giữ lại để tương thích ngược với mã gọi cũ. Với mã mới, hãy ưu tiên Ellipse và Rectangle
`DirectDrawBarcode`	Vẽ barcode bằng tọa độ trang trực tiếp và một kiểu barcode dạng số. Với mã có kiểu tường minh, hãy ưu tiên `DrawBarcode` cùng enum `THPDFBarcodeType`
`TextOutStr`, `OutText`, `RtLTextOutStr`, `SetFontAndSize`, `ShowMetafileEx`	Các bí danh tương thích hoặc điểm vào riêng cho C++Builder vẫn còn cho mã hiện có. Mã mới thường có thể dùng `TextOut`, `RtLTextOut`, `SetFont` và `ShowMetafile`
`Debug_GetProcessedRtlString`, `ProcessFont`	Các trợ giúp chẩn đoán và cấp thấp được phơi ra từ class. Chúng được ghi ở đây để dễ thấy trên API; việc tạo tài liệu thông thường nên dùng các phương thức văn bản và phông ở mức cao hơn

Trợ giúp trường chữ ký số

AttachPAdESSeedValue - Gắn một dictionary seed-value PAdES vào một trường chữ ký hiện có để trình xem có thể công bố các ràng buộc về digest, subfilter, reason, location, contact, timestamp và chứng chỉ trước khi ký. Hãy tạo trường bằng AddPAdESSignatureField hoặc một trợ giúp trường chữ ký khác trước, rồi gọi AttachPAdESSeedValue với tên trường và các thiết lập THPDFPAdESSeedValue