acroform.h

Go to the documentation of this file.

// Copyright (c) 2009-2025 Avanquest Software. All rights reserved.
 
#ifndef PDFSDK_CORE_ACROFORM_H_INCLUDED_
#define PDFSDK_CORE_ACROFORM_H_INCLUDED_

 
#include <pdfsdk/core/actions.h>
#include <pdfsdk/core/annots.h>
#include <pdfsdk/core/api_macro.h>
#include <pdfsdk/core/document.h>
#include <pdfsdk/core/streams.h>
#include <pdfsdk/errors.h>
#include <pdfsdk/math_types.h>
 
#ifdef __cplusplus
extern "C" {
#endif
 
// FormField opaque type
typedef struct PDFieldRec_* PDField;
 
typedef void(PDFSDK_CALLCONV* PDFieldChangedProc)(PDField field, void* clientData);
 
// Field Flags
typedef uint32_t PDFieldFlags;

enum {
    // Common - See 12.7.4 Field dictionaries, Table 227 — Field flags common to all field types.
    kPDFieldFlagReadOnly = 0x00000001,                  
    kPDFieldFlagRequired = 0x00000002,                  
    kPDFieldFlagNoExport = 0x00000004,                  
 
    // Text - See 12.7.5.3 Text fields, Table 231 — Field flags specific to text fields.
    kPDTextFieldFlagMultiline = 0x00001000,             
    kPDTextFieldFlagPassword = 0x00002000,              
    kPDTextFieldFlagFileSelect = 0x00100000,            
    kPDTextFieldFlagDoNotSpellCheck = 0x00400000,       
    kPDTextFieldFlagDoNotScroll = 0x00800000,           
    kPDTextFieldFlagComb = 0x01000000,                  
    kPDTextFieldFlagRichText = 0x02000000,              
 
    // Button - See 12.7.5.2 Button fields, Table 229 — Field flags specific to button fields.
    kPDButtonFieldFlagNoToggleToOff = 0x00004000,       
    kPDButtonFieldFlagRadio = 0x00008000,               
    kPDButtonFieldFlagPushbutton = 0x00010000,          
    kPDButtonFieldFlagRadiosInUnison = 0x02000000,      
 
    // Choice - See 12.7.5.4 Choice fields, Table 233 — Field flags specific to choice fields.
    kPDChoiceFieldFlagCombo = 0x00020000,               
    kPDChoiceFieldFlagEdit = 0x00040000,                
    kPDChoiceFieldFlagSort = 0x00080000,                
    kPDChoiceFieldFlagMultiSelect = 0x00200000,         
    kPDChoiceFieldFlagDoNotSpellCheck = 0x00400000,     
    kPDChoiceFieldFlagCommitOnSelChange = 0x04000000    
};
 
#define kPDChoiceNoSelection ((size_t)(-1))

typedef enum {
    kPDIconScaleAlways,     
    kPDIconScaleBigger,     
    kPDIconScaleSmaller,    
    kPDIconScaleNever       
} PDIconScaleWhen;

typedef enum {
    kPDIconScaleAnamorphic,     
    kPDIconScaleProportional    
} PDIconScaleHow;
 
typedef struct
{
    PDIconScaleWhen scaleWhen;
    PDIconScaleHow scaleHow;
    float allocLeft;
    float allocBottom;
    bool fitBounds;
} PDIconFit;

typedef enum {
    kPDTextPositionCaptionOnly = 0,         
    kPDTextPositionIconOnly = 1,            
    kPDTextPositionCaptionBelowIcon = 2,    
    kPDTextPositionCaptionAboveIcon = 3,    
    kPDTextPositionCaptionRight = 4,        
    kPDTextPositionCaptionLeft = 5,         
    kPDTextPositionCaptionOnIcon = 6        
} PDTextPosition;
 
#define kPDAutoFontSize 0.f

enum {
    kPDSubmitFormFlagExclude = 1 << 0,              
    kPDSubmitFormFlagIncludeNoValueFields = 1 << 1, 
    kPDSubmitFormFlagExportFormat = 1 << 2,         
    kPDSubmitFormFlagGetMethod = 1 << 3,            
    kPDSubmitFormFlagSubmitCoordinates = 1 << 4,    
    kPDSubmitFormFlagXFDF = 1 << 5,                 
    kPDSubmitFormFlagIncludeAppendSaves = 1 << 6,   
    kPDSubmitFormFlagIncludeAnnotations = 1 << 7,   
    kPDSubmitFormFlagSubmitPDF = 1 << 8,            
    kPDSubmitFormFlagCanonicalFormat = 1 << 9,      
    kPDSubmitFormFlagExclNonUserAnnots = 1 << 10,   
    kPDSubmitFormFlagExclFKey = 1 << 11,            
    kPDSubmitFormFlagEmbedForm = 1 << 13            
};
typedef uint32_t PDSubmitFormFlags;

enum {
    kPDResetFormFlagExclude = 1 << 0
};
typedef uint32_t PDResetFormFlags;
 
typedef PDErrCode(PDFSDK_CALLCONV* PDSignGetNameProc)(void* signData, PDAtom* pName);
typedef PDErrCode(PDFSDK_CALLCONV* PDSignCustomizeSigDict)(void* signData, PDDoc doc, PDObject dict);
typedef PDErrCode(PDFSDK_CALLCONV* PDSignGetNumCertsProc)(void* signData, size_t* pNumCerts);
typedef PDErrCode(PDFSDK_CALLCONV* PDSignGetCertDataProc)(void* signData, size_t index, void* buffer, size_t bufLen, size_t* pSize);
typedef PDErrCode(PDFSDK_CALLCONV* PDSignEstimateMaxSizeProc)(void* signData, size_t* pMaxSize);
typedef PDErrCode(PDFSDK_CALLCONV* PDSignSignProc)(void* signData, const void* data, size_t dataLen, void* buffer, size_t bufLen, size_t* pSize);
typedef PDErrCode(PDFSDK_CALLCONV* PDSignDestroyProc)(void* signData);
 
typedef struct
{
    PDSignGetNameProc getFilter;
    PDSignGetNameProc getSubFilter;
    PDSignCustomizeSigDict customizeSigDict;
    PDSignGetNumCertsProc getNumCerts;
    PDSignGetCertDataProc getCertData;
    PDSignEstimateMaxSizeProc estimateMaxSize;
    PDSignSignProc sign;
    PDSignDestroyProc destroy;
} PDSignHandler;
 
typedef PDErrCode(PDFSDK_CALLCONV* PDTimestampEstimateMaxSizeProc)(void* data, size_t* pSize);
typedef PDErrCode(PDFSDK_CALLCONV* PDTimestampGetTokenProc)(void* data, const void* bytes, size_t byteLen, void* buffer, size_t bufLen, size_t* pSize);
typedef PDErrCode(PDFSDK_CALLCONV* PDTimestampDestroyProc)(void* data);
 
typedef struct
{
    PDTimestampEstimateMaxSizeProc estimateMaxSize;
    PDTimestampGetTokenProc getToken;
    PDTimestampDestroyProc destroy;
} PDTimestampHandler;

typedef PDErrCode(PDFSDK_CALLCONV* PDLTVGetRevocationProc)(void* data,
    const void* cert,   size_t certLen,
    const void* issuer, size_t issuerLen,
    void* buffer, size_t bufLen, size_t* pSize);
 
typedef PDErrCode(PDFSDK_CALLCONV* PDLTVDestroyProc)(void* data);

typedef struct
{
    PDLTVGetRevocationProc getOCSP;   
    PDLTVGetRevocationProc getCRL;    
    PDLTVDestroyProc       destroy;
} PDLTVHandler;

typedef enum {
    kPDSignLockPermsNotSet = 0,               
    kPDSignLockPermsAllowNoChanges = 1,       
    kPDSignLockPermsAllowFormFill = 2,        
    kPDSignLockPermsAllowFormFillAnnotate = 3 
} PDSignLockPerms;

typedef enum {
    kPDTextWidgetScrollNone = 0,        
    kPDTextWidgetScrollVertical = 1,    
    kPDTextWidgetScrollHorizontal = 2,  
} PDTextWidgetScrollType;
 
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDDocGetNumFields(PDDoc doc, size_t* pNumFields);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDDocGetField(PDDoc doc, size_t index, PDField* pField);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDDocAppendField(PDDoc doc, PDField field);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDDocRemoveField(PDDoc doc, PDField field);
 
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDDocCreateField(PDDoc doc, const wchar_t* fullnameBuf, size_t fullnameSize, PDAtom type, PDFieldFlags flags, PDField* pField);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDDocFindField(PDDoc doc, const wchar_t* fullname, PDField* pField);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDDocRenameField(PDDoc doc, PDField field, const wchar_t* fullnameBuf, size_t fullnameSize);
 
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDDocAttachFieldChangedCallback(PDDoc doc, PDFieldChangedProc proc, void* clientData);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDDocDetachFieldChangedCallback(PDDoc doc, PDFieldChangedProc proc, void* clientData);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDDocNotifyFieldChanged(PDDoc doc, PDField field);
 
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDCreateActionFieldsData(PDDoc doc, const PDField* fields, size_t numFields, PDObject* pData);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDActionFieldsDataGetNumFields(PDObject data, size_t* pNumFields);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDActionFieldsDataGetField(PDObject data, size_t index, PDDoc doc, PDField* pField);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDActionFieldsDataAddField(PDObject data, PDField field);
 
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDActionSubmitFormGetServerURL(PDAction action, PDFileSpec* pFileSpec);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDActionSubmitFormSetServerURL(PDAction action, PDFileSpec fileSpec);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDActionSubmitFormGetFieldsData(PDAction action, PDObject* pFields);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDActionSubmitFormSetFieldsData(PDAction action, PDObject fields);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDActionSubmitFormGetFlags(PDAction action, PDSubmitFormFlags* pFlags);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDActionSubmitFormSetFlags(PDAction action, PDSubmitFormFlags flags);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDActionResetFormGetFieldsData(PDAction action, PDObject* pFields);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDActionResetFormSetFieldsData(PDAction action, PDObject fields);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDActionResetFormGetFlags(PDAction action, PDResetFormFlags* pFlags);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDActionResetFormSetFlags(PDAction action, PDResetFormFlags flags);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDActionImportDataGetFileSpec(PDAction action, PDFileSpec* pFileSpec);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDActionImportDataSetFileSpec(PDAction action, PDFileSpec fileSpec);
 
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDCalculationOrderGetNumFields(PDDoc doc, size_t* pNumFields);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDCalculationOrderGetField(PDDoc doc, size_t index, PDField* pField);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDCalculationOrderInsertField(PDDoc doc, PDField field);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDCalculationOrderRemoveField(PDDoc doc, PDField field);
 
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDDocExportFormFDF(PDDoc doc, PDObject fields, bool exclude, const wchar_t* path);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDDocExportFormFDFToStream(PDDoc doc, PDObject fields, bool exclude, PDWriteStream stream);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDDocImportFormFDF(PDDoc doc, const wchar_t* path);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDDocImportFormFDFFromBuffer(PDDoc doc, const void* data, size_t size);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDDocExportFormXFDF(PDDoc doc, PDObject fields, bool exclude, const wchar_t* path);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDDocExportFormXFDFToStream(PDDoc doc, PDObject fields, bool exclude, PDWriteStream stream);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDDocImportFormXFDF(PDDoc doc, const wchar_t* path);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDDocImportFormXFDFFromBuffer(PDDoc doc, const void* data, size_t size);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDDocResetForm(PDDoc doc, PDObject fields, PDResetFormFlags flags);
 
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDDocOpenXFAStream(PDDoc doc, PDReadStream* pStm);
 
/*
    An indirect reference to the widget annotation’s parent field.
    A widget annotation may have at most one parent; that is,
    it can be included in the Kids array of at most one field
*/
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDWidgetAnnotGetParent(PDAnnot widget, PDField* pParent);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDWidgetAnnotSetHighlight(PDAnnot widget, PDAnnotHighlightMode highlight);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDWidgetAnnotGetHighlight(PDAnnot widget, PDAnnotHighlightMode* pHighlight);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDWidgetAnnotSetBorderStyle(PDAnnot annot, const PDAnnotBorderStyle* borderStyle);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDWidgetAnnotGetBorderStyle(PDAnnot annot, PDAnnotBorderStyle* pBorderStyle);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDWidgetAnnotSetRotate(PDAnnot annot, PDRotate rotate);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDWidgetAnnotGetRotate(PDAnnot annot, PDRotate* pRotate);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDWidgetAnnotSetBorderColor(PDAnnot annot, PDColorValue borderColor);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDWidgetAnnotGetBorderColor(PDAnnot annot, PDColorValue* pBorderColor);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDWidgetAnnotSetBgColor(PDAnnot annot, PDColorValue bgColor);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDWidgetAnnotGetBgColor(PDAnnot annot, PDColorValue* pBgColor);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDWidgetAnnotSetFont(PDAnnot widget, PDEFont font);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDWidgetAnnotGetFont(PDAnnot widget, PDEFont* pFont);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDWidgetAnnotSetFontColor(PDAnnot widget, PDColorValue fontColor);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDWidgetAnnotGetFontColor(PDAnnot widget, PDColorValue* pFontColor);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDWidgetAnnotSetFontSize(PDAnnot widget, float fontSize);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDWidgetAnnotGetFontSize(PDAnnot widget, float* pFontSize);
 
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDWidgetAnnotSetMouseEnterAction(PDAnnot widget, PDAction action);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDWidgetAnnotGetMouseEnterAction(PDAnnot widget, PDAction* pAction);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDWidgetAnnotSetMouseExitAction(PDAnnot widget, PDAction action);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDWidgetAnnotGetMouseExitAction(PDAnnot widget, PDAction* pAction);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDWidgetAnnotSetMouseDownAction(PDAnnot widget, PDAction action);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDWidgetAnnotGetMouseDownAction(PDAnnot widget, PDAction* pAction);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDWidgetAnnotSetMouseUpAction(PDAnnot widget, PDAction action);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDWidgetAnnotGetMouseUpAction(PDAnnot widget, PDAction* pAction);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDWidgetAnnotSetFocusAction(PDAnnot widget, PDAction action);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDWidgetAnnotGetFocusAction(PDAnnot widget, PDAction* pAction);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDWidgetAnnotSetBlurAction(PDAnnot widget, PDAction action);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDWidgetAnnotGetBlurAction(PDAnnot widget, PDAction* pAction);
 
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDCreateButtonWidgetAnnot(PDDoc doc, PDField parent, const PDRectF* rect, PDAnnot* pOut);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDButtonWidgetAnnotSetCaption(PDAnnot widget, const wchar_t* captionBuf, size_t captionSize);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDButtonWidgetAnnotGetCaption(PDAnnot widget, wchar_t* buffer, size_t bufSize, size_t* pSize);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDButtonWidgetAnnotSetRolloverCaption(PDAnnot widget, const wchar_t* captionBuf, size_t captionSize);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDButtonWidgetAnnotGetRolloverCaption(PDAnnot widget, wchar_t* buffer, size_t bufSize, size_t* pSize);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDButtonWidgetAnnotSetDownCaption(PDAnnot widget, const wchar_t* captionBuf, size_t captionSize);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDButtonWidgetAnnotGetDownCaption(PDAnnot widget, wchar_t* buffer, size_t bufSize, size_t* pSize);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDButtonWidgetAnnotSetIcon(PDAnnot widget, PDEXObject icon);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDButtonWidgetAnnotGetIcon(PDAnnot widget, PDEXObject* pIcon);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDButtonWidgetAnnotSetRolloverIcon(PDAnnot widget, PDEXObject icon);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDButtonWidgetAnnotGetRolloverIcon(PDAnnot widget, PDEXObject* pIcon);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDButtonWidgetAnnotSetDownIcon(PDAnnot widget, PDEXObject icon);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDButtonWidgetAnnotGetDownIcon(PDAnnot widget, PDEXObject* pIcon);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDButtonWidgetAnnotSetIconFit(PDAnnot widget, const PDIconFit* iconFit);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDButtonWidgetAnnotGetIconFit(PDAnnot widget, PDIconFit* pIconFit);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDButtonWidgetAnnotSetTextPosition(PDAnnot widget, PDTextPosition textPosition);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDButtonWidgetAnnotGetTextPosition(PDAnnot widget, PDTextPosition* pTextPosition);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDButtonWidgetAnnotToggle(PDAnnot widget);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDButtonWidgetAnnotSetChoice(PDAnnot widget, const wchar_t* choiceBuf, size_t choiceSize);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDButtonWidgetAnnotGetChoice(PDAnnot widget, wchar_t* buffer, size_t bufSize, size_t* pSize);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDButtonWidgetAnnotGetOnStateName(PDAnnot widget, PDAtom* pName);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDButtonWidgetAnnotSetAction(PDAnnot widget, PDAction action);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDButtonWidgetAnnotGetAction(PDAnnot widget, PDAction* pAction);
 
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDCreateTextWidgetAnnot(PDDoc doc, PDField parent, const PDRectF* rect, PDAnnot* pOut);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDTextWidgetAnnotSetTopLine(PDAnnot widget, size_t topLine);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDTextWidgetAnnotGetTopLine(PDAnnot widget, size_t* pTopLine);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDTextWidgetAnnotKeystroke(PDAnnot widget, size_t selStart, size_t selEnd, const wchar_t* change, size_t changeSize, bool allowOverflow);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDTextWidgetAnnotHitTestChar(PDAnnot widget, const PDPointF* pagePt, size_t* pCharIndex);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDTextWidgetAnnotSetText(PDAnnot widget, const wchar_t* text, size_t textSize);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDTextWidgetAnnotGetText(PDAnnot widget, wchar_t* buffer, size_t bufSize, size_t* pSize);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDTextWidgetAnnotGetCharQuad(PDAnnot widget, size_t index, PDQuad* pQuad);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDTextWidgetAnnotGetNumVisibleLines(PDAnnot widget, size_t* pMaxLines);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDTextWidgetAnnotGetNumLines(PDAnnot widget, size_t* pNumLines);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDTextWidgetAnnotGetFirstCharOnLine(PDAnnot widget, size_t lineIndex, size_t* pCharIndex);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDTextWidgetAnnotGetLineWithChar(PDAnnot widget, size_t charIndex, size_t* pLineIndex);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDTextWidgetAnnotDoesNeedScroll(PDAnnot widget, PDTextWidgetScrollType* pScrollType);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDTextWidgetAnnotSetFirstVisibleChar(PDAnnot widget, size_t charIndex);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDTextWidgetAnnotGetFirstVisibleChar(PDAnnot widget, size_t* pcharIndex);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDTextWidgetAnnotGetNumberOfVisibleChars(PDAnnot widget, size_t* pnumOfVisibleChars);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDTextWidgetAnnotSetQuadding(PDAnnot widget, PDQuadding quadding);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDTextWidgetAnnotGetQuadding(PDAnnot widget, PDQuadding* pQuadding);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDTextWidgetAnnotHasOverflow(PDAnnot widget, bool* hasOverflow);
 
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDCreateChoiceWidgetAnnot(PDDoc doc, PDField parent, const PDRectF* rect, PDAnnot* pOut);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDChoiceWidgetAnnotSetTopLine(PDAnnot widget, size_t topLine);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDChoiceWidgetAnnotGetTopLine(PDAnnot widget, size_t* pTopLine);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDChoiceWidgetAnnotKeystroke(PDAnnot widget, size_t selStart, size_t selEnd, const wchar_t* change, size_t changeSize);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDChoiceWidgetAnnotHitTestChar(PDAnnot widget, const PDPointF* pagePt, size_t* pCharIndex);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDChoiceWidgetAnnotSetText(PDAnnot widget, const wchar_t* text, size_t textSize);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDChoiceWidgetAnnotGetText(PDAnnot widget, wchar_t* buffer, size_t bufSize, size_t* pSize);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDChoiceWidgetAnnotGetCharQuad(PDAnnot widget, size_t index, PDQuad* pQuad);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDChoiceWidgetAnnotGetNumVisibleLines(PDAnnot widget, size_t* pMaxLines);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDChoiceWidgetAnnotGetNumLines(PDAnnot widget, size_t* pNumLines);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDChoiceWidgetAnnotGetNumOptions(PDAnnot widget, size_t* pNumOptions);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDChoiceWidgetAnnotHitTestOption(PDAnnot widget, const PDPointF* pagePt, size_t* pOption);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDChoiceWidgetAnnotSetSelection(PDAnnot widget, size_t option);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDChoiceWidgetAnnotGetSelection(PDAnnot widget, size_t* pOption);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDChoiceWidgetAnnotSetQuadding(PDAnnot widget, PDQuadding quadding);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDChoiceWidgetAnnotGetQuadding(PDAnnot widget, PDQuadding* pQuadding);
PDF_CORE_API void PDFSDK_CALLCONV PDChoiceWidgetAnnotSetGlobalSelectionColor(PDColorValue color);
 
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDCreateSignWidgetAnnot(PDDoc doc, PDField parent, const PDRectF* rect, PDAnnot* pOut);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDSignWidgetAnnotSetAppearanceParams(PDAnnot widget, PDEXObject icon, bool addCaption);
 
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDFieldCreateFromPDObject(PDObject obj, PDField* pField);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDFieldGetPDObject(PDField field, PDObject* pObj);
PDF_CORE_API bool PDFSDK_CALLCONV PDFieldEqual(PDField fieldA, PDField fieldB);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDFieldGetType(PDField field, PDAtom* pType);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDFieldGetParent(PDField field, PDField* pParent);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDFieldIsTerminal(PDField field, bool* pTerminal);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDFieldGetNumChildren(PDField field, size_t* pNumChildren);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDFieldGetChildByIndex(PDField field, size_t index, PDField* pChild);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDFieldAppendChild(PDField field, PDField child);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDFieldRemoveChild(PDField field, PDField child);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDFieldGetNumWidgets(PDField field, size_t* pNumWidgets);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDFieldGetWidget(PDField field, size_t index, PDAnnot* pWidget);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDFieldAppendWidget(PDField field, PDAnnot widget);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDFieldRemoveWidget(PDField field, PDAnnot widget);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDFieldSetName(PDField field, const wchar_t* nameBuf, size_t nameSize);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDFieldGetName(PDField field, wchar_t* buffer, size_t bufSize, size_t* pSize);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDFieldSetUIName(PDField field, const wchar_t* nameBuf, size_t nameSize);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDFieldGetUIName(PDField field, wchar_t* buffer, size_t bufSize, size_t* pSize);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDFieldSetMappingName(PDField field, const wchar_t* nameBuf, size_t nameSize);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDFieldGetMappingName(PDField field, wchar_t* buffer, size_t bufSize, size_t* pSize);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDFieldGetFlags(PDField field, PDFieldFlags* pFlags);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDFieldSetFlags(PDField field, PDFieldFlags flags);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDFieldUpdateWidgets(PDField field);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDFieldGetFullName(PDField field, wchar_t* buffer, size_t bufSize, size_t* pSize);
 
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDFieldSetModifyAction(PDField field, PDAction action);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDFieldGetModifyAction(PDField field, PDAction* pAction);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDFieldSetValidateAction(PDField field, PDAction action);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDFieldGetValidateAction(PDField field, PDAction* pAction);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDFieldSetFormatAction(PDField field, PDAction action);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDFieldGetFormatAction(PDField field, PDAction* pAction);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDFieldSetCalculateAction(PDField field, PDAction action);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDFieldGetCalculateAction(PDField field, PDAction* pAction);
 
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDFieldGetValue(PDField field, wchar_t* buffer, size_t bufSize, size_t* pSize);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDFieldSetValue(PDField field, const wchar_t* value, size_t valueSize, PDAnnot source);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDFieldGetEValue(PDField field, wchar_t* buffer, size_t bufSize, size_t* pSize);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDFieldSetEValue(PDField field, const wchar_t* value, size_t valueSize);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDFieldGetDefaultValue(PDField field, wchar_t* buffer, size_t bufSize, size_t* pSize);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDFieldSetDefaultValue(PDField field, const wchar_t* value, size_t valueSize);
 
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDCreateButtonField(PDDoc doc, PDField parent, PDFieldFlags flags, PDField* pOut);
 
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDCreateTextField(PDDoc doc, PDField parent, PDFieldFlags flags, PDField* pOut);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDTextFieldSetMaxLen(PDField field, size_t maxlen);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDTextFieldGetMaxLen(PDField field, size_t* pMaxLen);
 
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDCreateChoiceField(PDDoc doc, PDField parent, PDFieldFlags flags, PDField* pOut);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDChoiceFieldGetNumOptions(PDField field, size_t* pNumOptions);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDChoiceFieldFindOptionByValue(PDField field, const wchar_t* value, size_t valueSize, size_t* pOption);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDChoiceFieldFindOptionByExportValue(PDField field, const wchar_t* exportValue, size_t exportValueSize, size_t* pOption);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDChoiceFieldGetOptionValue(PDField field, size_t option, wchar_t* buffer, size_t bufSize, size_t* pSize);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDChoiceFieldGetOptionExportValue(PDField field, size_t option, wchar_t* buffer, size_t bufSize, size_t* pSize);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDChoiceFieldInsertOption(PDField field, size_t index, const wchar_t* value, size_t valueSize, const wchar_t* exportValue, size_t exportValueSize);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDChoiceFieldRemoveOption(PDField field, size_t index);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDChoiceFieldRemoveAllOptions(PDField field);
 
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDCreateSignField(PDDoc doc, PDField parent, PDFieldFlags flags, PDField* pOut);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDDocIsSigned(PDDoc doc, bool* pSigned);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDDocHasURPerms(PDDoc doc, bool* pHasURPerms);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDSignFieldIsBlank(PDField field, bool* pBlank);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDSignFieldSetLock(PDField field, PDAtom action, PDObject fields, PDSignLockPerms perms);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDSignFieldGetLock(PDField field, PDAtom* action, PDObject* fields, PDSignLockPerms* perms);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDSignFieldSignApprove(PDField field, const PDSignHandler* signHandler, void* signData, const wchar_t* reason);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDSignFieldSignCertify(PDField field, PDSignLockPerms perms, const PDSignHandler* signHandler, void* signData, const wchar_t* reason);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDSignFieldClear(PDField field);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDSignFieldVerify(PDField field, bool* pValid);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDSignFieldDocModifiedAfterSign(PDField field, bool* pModified);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDSignFieldGetReason(PDField field, wchar_t* buffer, size_t bufSize, size_t* pSize);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDSignFieldGetSigningDate(PDField field, PDDateTime* pDate);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDSignFieldGetNumCertificates(PDField field, size_t* pNumCerts);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDSignFieldGetCertificate(PDField field, size_t index, void* buffer, size_t bufSize, size_t* pSize);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDSignFieldGetRevision(PDField field, int* pRevision);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDSignFieldSaveSignedVersion(PDField field, const wchar_t* filename);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDSignFieldIsApproval(PDField field, bool* pIsApproval);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDSignFieldIsCertification(PDField field, bool* pIsCertification);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDSignFieldIsDocumentTimestamp(PDField field, bool* pIsDocumentTimestamp);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDSignFieldAddDocumentTimestamp(PDField field, const PDTimestampHandler* handler, void* handlerData);
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDSignFieldAddLTVData(PDField field, const PDLTVHandler* handler, void* handlerData);

typedef enum {
    kPDSigChainOk,          
    kPDSigChainUntrusted,   
    kPDSigChainIncomplete,  
    kPDSigChainExpired,     
    kPDSigChainError
} PDSigChainStatus;

typedef enum {
    kPDSigRevocationGood,     
    kPDSigRevocationRevoked,  
    kPDSigRevocationUnknown,  
    kPDSigRevocationError
} PDSigRevocationStatus;

typedef enum {
    kPDSigTimeDocTimestamp,  
    kPDSigTimeClaimedM,      
    kPDSigTimeNone
} PDSigTimeSource;

typedef struct {
    const void* const* trustAnchors;     
    const size_t*      trustAnchorSizes; 
    size_t             numTrustAnchors;
    bool               requireRevocation; 
} PDSignValidationOptions;

typedef struct {
    bool                  integrityValid;  
    bool                  documentCovered; 
    PDSigChainStatus      chain;
    PDSigRevocationStatus revocation;
    PDSigTimeSource       timeSource;
    PDDateTime            referenceTime;
    bool                  ltvEnabled;      
} PDSignValidationResult;
 
PDF_CORE_API PDErrCode PDFSDK_CALLCONV PDSignFieldValidateLTV(PDField field, const PDSignValidationOptions* options, PDSignValidationResult* pResult);
 
#ifdef __cplusplus
}
#endif
 
#endif  // PDFSDK_CORE_ACROFORM_H_INCLUDED_