Loaded Document Toolkit

HotPDF can open an existing PDF, apply page and form operations, inspect typed document state, render or search pages, print with device capabilities, and save the result without moving the workflow to another library

Page operations and merging

• THotPDF.DeletePages accepts the standard one-based page-range syntax, removes duplicate selections once, and preserves a valid page tree
• THotPDF.InsertPagesFromDocument and THotPDF.AppendPagesFromDocument accept THPDFMergeOptions
• Form-name conflicts are checked before page insertion when automatic renaming is disabled, so a rejected merge leaves the destination page count unchanged
• THPDFMergeOption values are moIncludeOutlines, moIncludeFormFields, and moRenameConflictingFormFields
• Outline destinations are remapped through the selected source-to-destination page map, while imported form roots are registered in the destination AcroForm
• THotPDF.InsertLoadedBlankPage inserts a caller-sized blank page at an exact zero-based position

Forms and search

• THotPDF.AddLoadedRadioButton creates a parent radio field with child widgets, shared export values, and valid on/off appearance states
• GetLoadedFormFieldNameValuePairs and SetLoadedFormFieldNameValuePairs exchange lightweight name=value batches through TStrings
• ExtractLoadedPagesText aggregates a one-based page range with a caller-selected separator
• CMapResourcePath overrides automatic CMap discovery for services, plug-ins, and applications with external resource layouts
• THotPDF.SearchLoadedNext is a stateless page-local search primitive that moves forward from a previous THPDFTextMatch
• THPDFLoadedDocumentFacade groups loaded forms, annotations, outlines, fonts, and images into typed collection objects
• THPDFLoadedFormInfo includes the current and default value, field type, description, read-only flag, and choice options

Outlines and resources

• THotPDF.GetLoadedOutlineEntries returns a complete preorder snapshot as THPDFLoadedOutlineEntryArray
• Each THPDFLoadedOutlineEntry has an index, parent index, level, title, and resolved destination page index
• THPDFLoadedOutlineInfo exposes the same hierarchy through THPDFLoadedOutlineCollection
• THPDFLoadedResourceCollection enumerates fonts and loaded images and can extract supported images as caller-owned bitmaps

System certificate signing

• THotPDF.SignPDFWithSystemCertificate signs file or stream input through a Windows certificate-store private key
• THPDFCertificateStoreSelector selects current-user or local-machine scope, store name, SHA-1 thumbprint, and whether key-provider UI is allowed
• THPDFCMSSignDigestCallback and HPDFCMSSignPDFStreamWithExternalSigner provide the underlying external-digest signer hook
• CNG keys use RSA PKCS#1 SHA-256 signing and legacy CSP keys use the equivalent CryptoAPI path

Printing

• THPDFPrintOptions supports collated copies, paper code, custom paper width and length, orientation, duplex, bin, and quality
• THPDFPrinterCapabilities reports parallel paper codes, names, and physical sizes alongside bins, resolutions, duplex, colour, and maximum copies
• HPDFBuildPrintPageSequence exposes the deterministic physical page sequence used for collated and uncollated jobs

VCL viewer components

• THPDFViewerModel owns navigation, zoom state, text-search results, wrapping, and change notifications without creating a window
• THPDFViewer renders the selected page into a scrollable cached bitmap, supports actual size, fit page, fit width, and custom zoom, and draws current search hits over the rendered page
• THPDFSearchPanel connects search text, case sensitivity, whole-word matching, and next or previous navigation to a viewer
• THPDFOutlineViewer displays the full recursive bookmark tree and navigates the linked viewer
• THPDFViewerAction descendants provide first, prior, next, last, zoom, fit, find-next, and clear-search actions

Minimal viewer setup

PDF.LoadFromFile('input.pdf');
PDFViewer.PDFDocument := PDF;
OutlineViewer.Viewer := PDFViewer;
SearchPanel.Viewer := PDFViewer;
PDFViewer.ZoomMode := vzmFitWidth;

Ownership and indexing

• Loaded page indexes and destination page indexes are zero-based
• Page-range strings are one-based and use the same parser as extraction and printing
• Facade records are snapshots and collection mutation methods operate on the current loaded document
• Extracted bitmaps are owned by the caller

Related typed inspection and placement records

• THPDFPageElementKind, THPDFPageElement, and THPDFBaselineRole describe text, image, path, and baseline results returned by loaded page-element inspection
• THPDFWatermarkKind, THPDFWatermarkHorizPos, and THPDFWatermarkVertPos select the content and placement of loaded-document watermarks