Foxit PDF SDK
FoxitPDFSDKPython2.ActionCallback Class Reference

Inherits FoxitPDFSDKPython2._object.

Public Member Functions

def AddMenuItem (menu_item_config, is_prepend)
 A callback function to adds a menu item to a menu.
More...
 
def AddSearchIndex (di_path, is_selected)
 A callback function to add a search index.
More...
 
def AddSubMenu (menu_item_config)
 A callback function to add a menu item with a submenu to the application.
More...
 
def AddToolButton (button_item)
 A callback function to add a tool button.
More...
 
def Alert (msg, title, type, icon)
 A callback function used to pop up a dialog to show warnings or hints.
More...
 
def Beep (type)
 A callback function to cause the system to play a sound.
More...
 
def BrowseFile ()
 A callback function to show a file selection dialog, and the selected file path should be returned.
More...
 
def BrowseFile (is_open_dialog, file_format, file_filter)
 A callback function to show a file selection dialog.
More...
 
def CloseDoc (document, is_prompt_to_save)
 A callback function to close document.
More...
 
def CreateBlankDoc ()
 A callback function to create a blank PDF document object.
More...
 
def EnablePageLoop (is_loop)
 A callback function to set the flag specifies whether the document will loop around to the beginning of the document in response to a page advance (whether generated by mouse click, keyboard, or timer) in full screen mode.
More...
 
def ExecuteNamedAction (document, named_action)
 A callback function to execute a named action.
More...
 
def GetAppInfo (type)
 A callback function to get application information.
More...
 
def GetAttachmentsFilePath (pdf_doc, name)
 A callback function to get the file path of attachments file.
More...
 
def GetCurrentDoc ()
 A callback function to receive current PDF document object.
More...
 
def GetCurrentPage (document)
 A callback function used to receive current page index.
More...
 
def GetDocChangeMark (document)
 A callback function to receive the change mark which indicates whether the content of document is changed or not.
More...
 
def GetExtractedEmbeddedFilePath (pdf_doc, name)
 A callback function to get the file path of extracted embedded file.
More...
 
def GetFilePath (document)
 A callback function to get the file path of current PDF document.
More...
 
def GetFullScreen ()
 A callback function to get whether the full screen mode is set.
More...
 
def GetIdentityProperties ()
 A callback function used to get identity properties of current user.
More...
 
def GetLanguage ()
 A callback function to get the language of the running viewer application.
More...
 
def GetLayoutMode ()
 A callback function to get the page layout of the current document.
More...
 
def GetMenuItemNameList ()
 A callback function to get the menu item name list.
More...
 
def GetMousePosition ()
 A callback function to get current mouse position.
More...
 
def GetOpenedDoc (index)
 A callback function to receive an opened PDF document object by index.
More...
 
def GetOpenedDocCount ()
 A callback function to receive the count of opened documents.
More...
 
def GetPageRotation (document, page_index)
 A callback function used to receive current displaying rotation of a page on PDF viewer.
More...
 
def GetPageScale ()
 A callback function to get current page zoom value.
More...
 
def GetPageWindowRect ()
 A callback function to get the rectangle for the page view window. The page view window is the area inside the inner document window in which the PDF content is displayed.
More...
 
def GetPageZoomMode ()
 A callback function to get the current page zoom mode.
More...
 
def GetPrinterNameList ()
 A callback function to get the printer name list.
More...
 
def GetSignatureAPStyleNameList ()
 A callback function to get the name list of signature appearance style.
More...
 
def GetTemporaryDirectory ()
 A callback function to get temporary directory.
More...
 
def GetTemporaryFileName (document, file_suffix_name)
 A callback function to get the temporary file path. The temporary file name combine the document name with the file suffix name.
More...
 
def GetUntitledBookmarkName ()
 A callback function to get the new name for an untitled bookmark.
More...
 
def InvalidateRect (document, page_index, pdf_rect)
 A callback function to invalidate the client area within the specified rectangle.
More...
 
def IsCurrentDocOpenedInBrowser ()
 A callback function to get the flag specifies whether current document is opened in browser.
More...
 
def IsLocalFile (document)
 A callback function to check whether the file is local file.
More...
 
def IsPageLoop ()
 A callback function to get the flag specifies whether the document will loop around to the beginning of the document in response to a page advance.
More...
 
def LaunchURL (url)
 A callback function to launch to a specified URL.
More...
 
def MailData (data, data_type, is_ui, to, subject, cc, bcc, message)
 A callback function to mail data or message, with or without user interaction.
More...
 
def MailDoc (document, to_address, cc_address, bcc_address, subject, message, is_ui)
 A callback function to mails a document as an attachment.
More...
 
def OnFieldValueChanged (field_name, type, value_before_changed, value_after_changed)
 A callback function to notify the value change of the field.
More...
 
def OpenDoc (file_path, password)
 A callback function to open a PDF file.
More...
 
def OpenMediaPlayer (player_args)
 A callback function to open media player.
More...
 
def PopupMenu (menus, is_selected_item)
 A callback function to pop up a menu window.
More...
 
def PopupMenuEx (menus, is_selected_item)
 A callback function to pop up a menu window.
More...
 
def PostMessageToHtml (message)
 A callback function to send message asynchronously to the message handler for the host container of the PDF document.
More...
 
def Print (document, is_ui, page_range, is_silent, is_shrunk_to_fit, is_printed_as_image, is_reversed, is_to_print_annots)
 A callback function to print pages within a specified index range.
More...
 
def Print (document, print_params)
 A callback function to print document with print parameters.
More...
 
def Query (keywords, search_scope, search_option, di_path)
 A callback function to query the text keywords.
More...
 
def Release ()
 A callback function used to release current callback object itself.
More...
 
def RemoveSearchIndex (search_index_config)
 (Reserved, unsupported yet) A callback function to remove a search index.
More...
 
def RemoveToolButtom (button_name)
 A callback function to remove a tool button added by the function FoxitPDFSDKPython2.ActionCallback.AddToolButton .
More...
 
def Response (question, title, default_value, label, is_password)
 A callback function to display a dialog box containing a question and an entry field for the user to reply to the question.
More...
 
def Scroll (point)
 A callback function to scroll the specified point on the current page into the middle of the current view.
More...
 
def SelectPageNthWord (page_index, start_offset, end_offset, is_show_selection)
 A callback function to change the current page number and selects the specified word on the page.
More...
 
def SetCurrentPage (document, destination)
 A callback function used to set the current page by destination.
More...
 
def SetDefaultPageTransitionMode (trans_type, trans_di)
 A callback function to set the default page trastion mode for full screen mode.
More...
 
def SetDocChangeMark (document, change_mark)
 A callback function to set the change mark which indicates whether the content of document is changed or not.
More...
 
def SetFullScreen (is_full_screen)
 A callback function to set full screen mode.
More...
 
def SetIdentityProperties (identity_properties)
 A callback function used to set identity properties of current user.
More...
 
def SetLayoutMode (layout_mode, is_cover_mode)
 A callback function to set the page layout of the current document.
More...
 
def SetPageRotation (document, page_index, rotation)
 A callback function used to set the rotation value of a page on PDF viewer.
More...
 
def SetPageScale (zoom_mode, dest)
 A callback function to set current page zoom value.
More...
 
def ShowDialog (dlg_config)
 A callback function to show the dialog.
More...
 
def SoapRequest (request_params)
 Initiates a remote procedure call (RPC) or sends an XML message to a SOAP HTTP endpoint.
More...
 
def SubmitForm (document, form_data, length, url, file_format_type)
 A callback function to submit the form data to a specified URL.
More...
 
def UpdateLogicalLabel ()
 A callback function to update logical label.
More...
 
def VerifySignature (document, pdf_signature)
 A callback function to verify specified signature..
More...
 

Static Public Attributes

 e_AppInfoTypeAppVersion = _fsdk.ActionCallback_e_AppInfoTypeAppVersion
 Application's app version information.

 
 e_AppInfoTypeFormsVersion = _fsdk.ActionCallback_e_AppInfoTypeFormsVersion
 Application's forms version information.

 
 e_AppInfoTypeViewerType = _fsdk.ActionCallback_e_AppInfoTypeViewerType
 Application's viewer type information.

 
 e_AppInfoTypeViewerVariation = _fsdk.ActionCallback_e_AppInfoTypeViewerVariation
 Application's viewer variation information.

 
 e_AppInfoTypeViewerVersion = _fsdk.ActionCallback_e_AppInfoTypeViewerVersion
 Application's viewer version information.

 
 e_JSFieldValueChangedByCalculation = _fsdk.ActionCallback_e_JSFieldValueChangedByCalculation
 javascript field value changed type : calculation.

 
 e_JSFieldValueChangedByFillColor = _fsdk.ActionCallback_e_JSFieldValueChangedByFillColor
 javascript field value changed type: field fill color.

 
 e_JSFieldValueChangedByFormat = _fsdk.ActionCallback_e_JSFieldValueChangedByFormat
 javascript field value changed type: format.

 
 e_JSFieldValueChangedBySetReadOnly = _fsdk.ActionCallback_e_JSFieldValueChangedBySetReadOnly
 javascript field value changed type: field set read-only property.

 
 e_JSFieldValueChangedBySetValue = _fsdk.ActionCallback_e_JSFieldValueChangedBySetValue
 javascript field value changed type: field set value.

 
 e_JSMailResultFailed = _fsdk.ActionCallback_e_JSMailResultFailed
 Mailed result: mail failed.

 
 e_JSMailResultSuccess = _fsdk.ActionCallback_e_JSMailResultSuccess
 Mailed result: mail success.

 
 e_JSMailResultUserAbort = _fsdk.ActionCallback_e_JSMailResultUserAbort
 Mailed result: user abort.

 
 e_JSMediaPlayerStateClose = _fsdk.ActionCallback_e_JSMediaPlayerStateClose
 media player state: Close.

 
 e_JSMediaPlayerStateOpen = _fsdk.ActionCallback_e_JSMediaPlayerStateOpen
 media player state: Open.

 
 e_JSMediaPlayerStatePlaying = _fsdk.ActionCallback_e_JSMediaPlayerStatePlaying
 media player state: Playing.

 
 e_JSMediaPlayerStateStop = _fsdk.ActionCallback_e_JSMediaPlayerStateStop
 media player state: Stop.

 
 e_JSMediaPlayerStateSuspend = _fsdk.ActionCallback_e_JSMediaPlayerStateSuspend
 media player state: Suspend.

 
 e_LanguageCHS = _fsdk.ActionCallback_e_LanguageCHS
 Chinese Simplified.

 
 e_LanguageCHT = _fsdk.ActionCallback_e_LanguageCHT
 Chinese Traditional.

 
 e_LanguageDAN = _fsdk.ActionCallback_e_LanguageDAN
 Danish.

 
 e_LanguageDEU = _fsdk.ActionCallback_e_LanguageDEU
 German.

 
 e_LanguageENU = _fsdk.ActionCallback_e_LanguageENU
 English.

 
 e_LanguageESP = _fsdk.ActionCallback_e_LanguageESP
 Spanish.

 
 e_LanguageFRA = _fsdk.ActionCallback_e_LanguageFRA
 French.

 
 e_LanguageITA = _fsdk.ActionCallback_e_LanguageITA
 Italian.

 
 e_LanguageJPN = _fsdk.ActionCallback_e_LanguageJPN
 Japanese.

 
 e_LanguageKOR = _fsdk.ActionCallback_e_LanguageKOR
 Korean.

 
 e_LanguageNLD = _fsdk.ActionCallback_e_LanguageNLD
 Dutch.

 
 e_LanguageNOR = _fsdk.ActionCallback_e_LanguageNOR
 Norwegian.

 
 e_LanguagePTB = _fsdk.ActionCallback_e_LanguagePTB
 Brazilian Portuguese.

 
 e_LanguageSUO = _fsdk.ActionCallback_e_LanguageSUO
 Finnish.

 
 e_LanguageSVE = _fsdk.ActionCallback_e_LanguageSVE
 Swedish.

 
 e_LanguageUnknown = _fsdk.ActionCallback_e_LanguageUnknown
 Unknown language.

 
 e_LayoutModeContinuous = _fsdk.ActionCallback_e_LayoutModeContinuous
 Layout mode: continuous page.

 
 e_LayoutModeContinuousFacing = _fsdk.ActionCallback_e_LayoutModeContinuousFacing
 Layout mode: continuous two pages.

 
 e_LayoutModeFacing = _fsdk.ActionCallback_e_LayoutModeFacing
 Layout mode: two pages.

 
 e_LayoutModeSinglePage = _fsdk.ActionCallback_e_LayoutModeSinglePage
 Layout mode: single page.

 
 e_MailTypeDoc = _fsdk.ActionCallback_e_MailTypeDoc
 Mailed data type: document.

 
 e_MailTypeForm = _fsdk.ActionCallback_e_MailTypeForm
 Mailed data type: form.

 
 e_MailTypeMsg = _fsdk.ActionCallback_e_MailTypeMsg
 Mailed data type: string message.

 
 e_SearchScopeActiveDoc = _fsdk.ActionCallback_e_SearchScopeActiveDoc
 Search scope: active document.

 
 e_SearchScopeActiveIndexes = _fsdk.ActionCallback_e_SearchScopeActiveIndexes
 Search scope: active indexes.

 
 e_SearchScopeFolder = _fsdk.ActionCallback_e_SearchScopeFolder
 Search scope: folder.

 
 e_SearchScopeIndex = _fsdk.ActionCallback_e_SearchScopeIndex
 Search scope: index.

 

Detailed Description

This class represents a callback object for performing PDF actions. All the pure virtual functions in this class are used as callback functions and should be implemented by user, to perform PDF actions, such as javascript actions.

Member Function Documentation

◆ AddMenuItem()

def FoxitPDFSDKPython2.ActionCallback.AddMenuItem (   menu_item_config,
  is_prepend 
)

A callback function to adds a menu item to a menu.

This callback function will be triggered by the javascript method "app.addMenuItem".

Parameters
[in]menu_item_configThe config of the menu item.
[in]is_prependDetermines the position of the new menu item relative to the position specified by MenuItemConfig::pos or MenuItemConfig::pos_str. The default value is false. If this parameter is true, the rules for insertion are as follows:
  • If MenuItemConfig::pos_str is used, the new item is placed before the named item.
  • If MenuItemConfig::pos is used, the new item is placed before the numbered item.
  • If the named item cannot be found or position is not between zero and the number of items in the list, inclusive, the new item is inserted as the first item in the menu (rather than at the end of the menu).

    parameter is useful when the named item is the first item in a group.


Returns
true means success, while false means failure.

◆ AddSearchIndex()

def FoxitPDFSDKPython2.ActionCallback.AddSearchIndex (   di_path,
  is_selected 
)

A callback function to add a search index.

This callback function will be triggered by the javascript method "search.addIndex". This callback function is optional, so it can be implemented to do nothing.

Parameters
[in]di_pathA device-independent path to an index file on the user's hard drive.
[in]is_selectedSpecifies whether the index should be selected for searching.
Returns
A SearchIndexConfig .

◆ AddSubMenu()

def FoxitPDFSDKPython2.ActionCallback.AddSubMenu (   menu_item_config)

A callback function to add a menu item with a submenu to the application.

This callback function will be triggered by the javascript method "app.addSubMenu".

Parameters
[in]menu_item_configThe config of the menu item.
Returns
true means success, while false means failure.

◆ AddToolButton()

def FoxitPDFSDKPython2.ActionCallback.AddToolButton (   button_item)

A callback function to add a tool button.

This callback function will be triggered by the javascript method "app.addToolButton".

Parameters
[in]button_itemThe ButtonItem object of the tool button.
Returns
true means success, while false means failure.

◆ Alert()

def FoxitPDFSDKPython2.ActionCallback.Alert (   msg,
  title,
  type,
  icon 
)

A callback function used to pop up a dialog to show warnings or hints.

This callback function is optional, so it can be implemented to do nothing and just return a useless value.

Parameters
[in]msgThe message string to be displayed in the dialog.
[in]titleThe title of the dialog.
[in]typeType of button group. It would be one of following values:
  • 0: OK;(default value.)
  • 1: OK, Cancel;
  • 2: Yes, NO;
  • 3: Yes, NO, Cancel.

[in]iconIcon type. It would be one of following values:
  • 0: Error;(default value.)
  • 1: Warning;
  • 2: Question;
  • 3: Status.

Returns
The return value should be one of following values:
  • 1: OK;
  • 2: Cancel;
  • 3: NO;
  • 4: Yes;

◆ Beep()

def FoxitPDFSDKPython2.ActionCallback.Beep (   type)

A callback function to cause the system to play a sound.

This callback function is optional, so it can be implemented to do nothing and just return a useless value.

Parameters
[in]typeSound type. The value would be on of following values:
  • 0: Error
  • 1: Warning
  • 2: Question
  • 3: Status
  • 4: Default (default value)

Returns
true means success, while false means failure.

◆ BrowseFile() [1/2]

def FoxitPDFSDKPython2.ActionCallback.BrowseFile ( )

A callback function to show a file selection dialog, and the selected file path should be returned.

This callback function is optional, so it can be implemented to do nothing and just return a useless value.

Returns
The file path. It can be an empty string.

◆ BrowseFile() [2/2]

def FoxitPDFSDKPython2.ActionCallback.BrowseFile (   is_open_dialog,
  file_format,
  file_filter 
)

A callback function to show a file selection dialog.

This callback function is optional, so it can be implemented to do nothing and just return a useless value.

Parameters
[in]is_open_dialogA boolean value to specify whether the dialog is for opening file or saving file. true means the dialog should be used to open file, while false means the dialog should be used to save file.
[in]file_formatThe file format string.
[in]file_filterThe file filter string.
Returns
The file path. It can be an empty string.

◆ CloseDoc()

def FoxitPDFSDKPython2.ActionCallback.CloseDoc (   document,
  is_prompt_to_save 
)

A callback function to close document.

This callback function will be triggered by the javascript method "Doc.closeDoc". This callback function is optional, so it can be implemented to do nothing.

Parameters
[in]documentA PDF document object. It would be valid.
[in]is_prompt_to_savetrue means show save prompt, while false means not.
Returns
None.

◆ CreateBlankDoc()

def FoxitPDFSDKPython2.ActionCallback.CreateBlankDoc ( )

A callback function to create a blank PDF document object.

This callback function is optional, so it can be implemented to do nothing and just return a useless value.

Returns
The newly created blank PDF document object.

◆ EnablePageLoop()

def FoxitPDFSDKPython2.ActionCallback.EnablePageLoop (   is_loop)

A callback function to set the flag specifies whether the document will loop around to the beginning of the document in response to a page advance (whether generated by mouse click, keyboard, or timer) in full screen mode.

This callback function will be triggered by the javascript property "app.fs.loop". This callback function is optional, so it can be implemented to do nothing.

Parameters
[in]is_looptrue means to loop around to the beginning of the document, while false means not.
Returns
None.

◆ ExecuteNamedAction()

def FoxitPDFSDKPython2.ActionCallback.ExecuteNamedAction (   document,
  named_action 
)

A callback function to execute a named action.

Please refer to description of "Named Actions" in Section 8.5.3 of <PDF Reference 1.7> for more details. This callback function is optional, so it can be implemented to do nothing and just return a useless value.

Parameters
[in]documentA PDF document object. It would be valid.
[in]named_actionA string to specify a named action.
Returns
true means success, while false means failure.

◆ GetAppInfo()

def FoxitPDFSDKPython2.ActionCallback.GetAppInfo (   type)

A callback function to get application information.

This callback function is optional, so it can be implemented to do nothing and just return a useless value.
For the digital information like FoxitPDFSDKPython2.ActionCallback.e_AppInfoTypeViewerVersion , FoxitPDFSDKPython2.ActionCallback.e_AppInfoTypeAppVersion and FoxitPDFSDKPython2.ActionCallback.e_AppInfoTypeFormsVersion , please use string to represent it.

Parameters
[in]typeType of information. Please refer to values starting from FoxitPDFSDKPython2.ActionCallback.e_AppInfoTypeFormsVersion and this would be one of these values.
Returns
The application information.

◆ GetAttachmentsFilePath()

def FoxitPDFSDKPython2.ActionCallback.GetAttachmentsFilePath (   pdf_doc,
  name 
)

A callback function to get the file path of attachments file.

This callback function will be triggered by the javascript method "Doc.importDataObject". This callback function is optional, so it can be implemented to do nothing and just return a useless value.

Parameters
[in]pdf_docA PDF document object. It will embed with a data object.
[in]nameThe name to associate with the data object. It's the parameter "cName" of the method "Doc.importDataObject".
Returns
The path of the file which will be embedded as a data object.

◆ GetCurrentDoc()

def FoxitPDFSDKPython2.ActionCallback.GetCurrentDoc ( )

A callback function to receive current PDF document object.

This callback function is optional, so it can be implemented to do nothing and just return a useless value.

Returns
Current PDF document object.

◆ GetCurrentPage()

def FoxitPDFSDKPython2.ActionCallback.GetCurrentPage (   document)

A callback function used to receive current page index.

This callback function is optional, so it can be implemented to do nothing and just return a useless value.

Parameters
[in]documentA PDF document object. It would be valid.
Returns
Current page index. The value should be stared from 0 and less than page count of the specified document.

◆ GetDocChangeMark()

def FoxitPDFSDKPython2.ActionCallback.GetDocChangeMark (   document)

A callback function to receive the change mark which indicates whether the content of document is changed or not.

This callback function is optional, so it can be implemented to do nothing and just return a useless value.

Parameters
[in]documentA PDF document object. It would be valid.
Returns
true means the PDF document is changed, while false means not.

◆ GetExtractedEmbeddedFilePath()

def FoxitPDFSDKPython2.ActionCallback.GetExtractedEmbeddedFilePath (   pdf_doc,
  name 
)

A callback function to get the file path of extracted embedded file.

This callback function will be triggered by the javascript method "Doc.exportDataObject". This callback function is optional, so it can be implemented to do nothing and just return a useless value.

Parameters
[in]pdf_docA PDF document object. It will be embedded as a data object to the file .
[in]nameThe name of the data object to extract. It's the parameter "cName" of the method "Doc.exportDataObject".
Returns
The path of the file which will embed with a data object.

◆ GetFilePath()

def FoxitPDFSDKPython2.ActionCallback.GetFilePath (   document)

A callback function to get the file path of current PDF document.

This callback function is optional, so it can be implemented to do nothing and just return a useless value.

Parameters
[in]documentA PDF document object. It would be valid.
Returns
The file path.

◆ GetFullScreen()

def FoxitPDFSDKPython2.ActionCallback.GetFullScreen ( )

A callback function to get whether the full screen mode is set.

This callback function will be triggered by the javascript property "app.fullScreen" or "app.fs.isFullScreen".

Returns
true means the full screen mode is set, while false means not.

◆ GetIdentityProperties()

def FoxitPDFSDKPython2.ActionCallback.GetIdentityProperties ( )

A callback function used to get identity properties of current user.

This callback function is optional, so it can be implemented to do nothing and just return a useless value.

Returns
An identity properties object that specifies the identity properties of current user.

◆ GetLanguage()

def FoxitPDFSDKPython2.ActionCallback.GetLanguage ( )

A callback function to get the language of the running viewer application.

This callback function is optional, so it can be implemented to do nothing and just return a useless value.

Returns
The language type. Please refer to values starting from FoxitPDFSDKPython2.ActionCallback.e_LanguageUnknown and this should be one of these values.

◆ GetLayoutMode()

def FoxitPDFSDKPython2.ActionCallback.GetLayoutMode ( )

A callback function to get the page layout of the current document.

This callback function will be triggered by the javascript properties "Doc.layout". This callback function is optional, so it can be implemented to do nothing and just return a useless value.

Returns
The layout mode. Please refer to values starting from FoxitPDFSDKPython2.ActionCallback.e_LayoutModeSinglePage and this should be one of these values.

◆ GetMenuItemNameList()

def FoxitPDFSDKPython2.ActionCallback.GetMenuItemNameList ( )

A callback function to get the menu item name list.

This callback function will be triggered by the javascript method "app.listMenuItems".

Returns
An array of menu list objects.

◆ GetMousePosition()

def FoxitPDFSDKPython2.ActionCallback.GetMousePosition ( )

A callback function to get current mouse position.

This callback function will be triggered by the javascript properties "doc.mouseX" or "doc.mouseY". This callback function is optional, so it can be implemented to do nothing and just return a useless value.

Returns
A position in device coordinate system.

◆ GetOpenedDoc()

def FoxitPDFSDKPython2.ActionCallback.GetOpenedDoc (   index)

A callback function to receive an opened PDF document object by index.

This callback function is optional, so it can be implemented to do nothing and just return a useless value.

Parameters
[in]indexThe index of an opened PDF documents. Valid range: from 0 to count-1. count is returned by callback function FoxitPDFSDKPython2.ActionCallback.GetOpenedDocCount ;
Returns
A opened PDF document object.

◆ GetOpenedDocCount()

def FoxitPDFSDKPython2.ActionCallback.GetOpenedDocCount ( )

A callback function to receive the count of opened documents.

This callback function is optional, so it can be implemented to do nothing and just return a useless value.

Returns
The count of opened documents.

◆ GetPageRotation()

def FoxitPDFSDKPython2.ActionCallback.GetPageRotation (   document,
  page_index 
)

A callback function used to receive current displaying rotation of a page on PDF viewer.

This callback function is optional, so it can be implemented to do nothing and just return a useless value.

Parameters
[in]documentA PDF document object. It would be valid.
[in]page_indexA page index, used to specify which page's rotation is to be retrieved. The index would start from 0 and less than page count of the specified document.
Returns
The rotation of specified page. Please refer to values starting from FoxitPDFSDKPython2.e_Rotation0 and this should be one of these values.

◆ GetPageScale()

def FoxitPDFSDKPython2.ActionCallback.GetPageScale ( )

A callback function to get current page zoom value.

This callback function will be triggered by the javascript properties "Doc.zoom". This callback function is optional, so it can be implemented to do nothing and just return a useless value.

Returns
A zoom value. For example, a zoom value of 1.0 specifies 100%. It should be a positive number.

◆ GetPageWindowRect()

def FoxitPDFSDKPython2.ActionCallback.GetPageWindowRect ( )

A callback function to get the rectangle for the page view window. The page view window is the area inside the inner document window in which the PDF content is displayed.

This callback function will be triggered by the javascript property "Doc.pageWindowRect". This callback function is optional, so it can be implemented to do nothing and just return a useless value.

Returns
A rectangle for the page view window.

◆ GetPageZoomMode()

def FoxitPDFSDKPython2.ActionCallback.GetPageZoomMode ( )

A callback function to get the current page zoom mode.

This callback function will be triggered by the javascript properties "Doc.zoom" or "Doc.zoomType". This callback function is optional, so it can be implemented to do nothing and just return a useless value.

Returns
The zoom mode. Please refer to values starting from FoxitPDFSDKPython2.Destination.e_ZoomXYZ and this should be one of these values.

◆ GetPrinterNameList()

def FoxitPDFSDKPython2.ActionCallback.GetPrinterNameList ( )

A callback function to get the printer name list.

This callback function will be triggered by the javascript property "app.printerNames". This callback function is optional, so it can be implemented to do nothing and just return a useless value.

Returns
An array of the printer name.

◆ GetSignatureAPStyleNameList()

def FoxitPDFSDKPython2.ActionCallback.GetSignatureAPStyleNameList ( )

A callback function to get the name list of signature appearance style.

This callback function will be triggered by the javascript method "SecurityHandler.appearances". This callback function is optional, so it can be implemented to do nothing.

Returns
An array of signature appearance style name.

◆ GetTemporaryDirectory()

def FoxitPDFSDKPython2.ActionCallback.GetTemporaryDirectory ( )

A callback function to get temporary directory.

This callback function will be triggered by the javascript method "Doc.extractpages". This callback function is optional, so it can be implemented to do nothing and just return a useless value.

Returns
The temporary directory.

◆ GetTemporaryFileName()

def FoxitPDFSDKPython2.ActionCallback.GetTemporaryFileName (   document,
  file_suffix_name 
)

A callback function to get the temporary file path. The temporary file name combine the document name with the file suffix name.

This callback function will be triggered by the javascript method "Doc.mailForm". This callback function is optional, so it can be implemented to do nothing and just return a useless value.

Parameters
[in]documentA PDF document object. It would be valid.
[in]file_suffix_nameFile suffix name.
Returns
The temporary file path.

◆ GetUntitledBookmarkName()

def FoxitPDFSDKPython2.ActionCallback.GetUntitledBookmarkName ( )

A callback function to get the new name for an untitled bookmark.

This callback function will be triggered by the javascript mothod "bookmark.createChild" when the parameter "cName" of the method is an empty string. This callback function is optional, so it can be implemented to do nothing and just return a useless value.

Returns
A new name for an untitled bookmark.

◆ InvalidateRect()

def FoxitPDFSDKPython2.ActionCallback.InvalidateRect (   document,
  page_index,
  pdf_rect 
)

A callback function to invalidate the client area within the specified rectangle.

All positions are measured in PDF "user space". Implementation should call function FoxitPDFSDKPython2.Renderer.StartRender for repainting a specified page area.

Parameters
[in]documentA PDF document object. It would be valid.
[in]page_indexA page index. It would start from 0 and less than page count of the specified document.
[in]pdf_rectA rectangle that specifies the page area in [PDF coordinate system] (). If this is an empty rectangle, that means to refresh the whole page.
Returns
true means success, while false means failure.

◆ IsCurrentDocOpenedInBrowser()

def FoxitPDFSDKPython2.ActionCallback.IsCurrentDocOpenedInBrowser ( )

A callback function to get the flag specifies whether current document is opened in browser.

This callback function will be triggered by the javascript property "doc.hostContainer". This callback function is optional, so it can be implemented to do nothing.

Returns
true means current document is opened in browser, while false means not.

◆ IsLocalFile()

def FoxitPDFSDKPython2.ActionCallback.IsLocalFile (   document)

A callback function to check whether the file is local file.

This callback function is optional, so it can be implemented to do nothing and just return a useless value.

Parameters
[in]documentA PDF document object. It would be valid.
Returns
true means the PDF file is loacl file.

◆ IsPageLoop()

def FoxitPDFSDKPython2.ActionCallback.IsPageLoop ( )

A callback function to get the flag specifies whether the document will loop around to the beginning of the document in response to a page advance.

This callback function will be triggered by the javascript property "app.fs.loop". This callback function is optional, so it can be implemented to do nothing.

Returns
true means to loop around to the beginning of the document, while false means not.

◆ LaunchURL()

def FoxitPDFSDKPython2.ActionCallback.LaunchURL (   url)

A callback function to launch to a specified URL.

This callback function is optional, so it can be implemented to do nothing and just return a useless value.

Parameters
[in]urlA URL.
Returns
true means success, while false means failure.

◆ MailData()

def FoxitPDFSDKPython2.ActionCallback.MailData (   data,
  data_type,
  is_ui,
  to,
  subject,
  cc,
  bcc,
  message 
)

A callback function to mail data or message, with or without user interaction.

This callback function is optional, so it can be implemented to do nothing and just return a useless value.

Parameters
[in]dataA data which is to be mailed. The value and type of the data depends on parameter data_type:
[in]data_typeMail type. Please refer to values starting from FoxitPDFSDKPython2.ActionCallback.e_MailTypeDoc and this would be one of these values.
[in]is_uitrue means that the remaining parameters are used to seed the compose-new-message window which is displayed to the user.
false means that the parameter to is required and all other parameters are optional.
[in]toA string that specifies a semicolon-delimited list of recipients for the message.
[in]subjectA string that specifies the subject of the message. The limit of this string's length is 64 KB.
[in]ccA string that specifies a semicolon-delimited list of CC recipients for the message.
[in]bccA string that specifies a semicolon-delimited list of BCC recipients for the message.
[in]messageA string that specifies the content of the message. The limit of this string's length is 64 KB.
Returns
true means success, while false means failure.

◆ MailDoc()

def FoxitPDFSDKPython2.ActionCallback.MailDoc (   document,
  to_address,
  cc_address,
  bcc_address,
  subject,
  message,
  is_ui 
)

A callback function to mails a document as an attachment.

This callback function will be triggered by the javascript method "Doc.mailDoc". This callback function is optional, so it can be implemented to do nothing and just return a useless value.

Parameters
[in]documentA PDF document object. It would be valid.
[in]to_addressTo address.
[in]cc_addressCc address.
[in]bcc_addressBcc address.
[in]subjectMail subject.
[in]messageMail message.
[in]is_uitrue means to show mail dialog, while false means not.
Returns
The mail result. Please refer to values starting from FoxitPDFSDKPython2.ActionCallback.e_JSMailResultFailed and this should be one of these values.

◆ OnFieldValueChanged()

def FoxitPDFSDKPython2.ActionCallback.OnFieldValueChanged (   field_name,
  type,
  value_before_changed,
  value_after_changed 
)

A callback function to notify the value change of the field.

This callback function will be triggered when the field's value is changed via JavaScript.

Parameters
[in]field_nameA string that specifies the field name.
[in]typeField value change type. Please refer to values starting from FoxitPDFSDKPython2.ActionCallback.e_JSFieldValueChangedByFormat and this would be one of these values.
[in]value_before_changedA string array that specifies the field's value before the change.
For a list box, the parameter represent one or more than one of the field's items which be selected simultaneously.
[in]value_after_changedA string array that specifies the field's value after the change. For a list box, the parameter represent one or more than one of the field's items which be selected simultaneously.
Returns
None.

◆ OpenDoc()

def FoxitPDFSDKPython2.ActionCallback.OpenDoc (   file_path,
  password 
)

A callback function to open a PDF file.

This callback function is optional, so it can be implemented to do nothing and just return a useless value.

Parameters
[in]file_pathA full path of an existing PDF file.
[in]passwordPassword for input PDF file. This may be an empty string.
Returns
An opened PDF document object.

◆ OpenMediaPlayer()

def FoxitPDFSDKPython2.ActionCallback.OpenMediaPlayer (   player_args)

A callback function to open media player.

This callback function will be triggered by the javascript method "app.media.openPlayer" or "app.media.createPlayer".

Parameters
[in]player_argsThe PlayerArgs object.
Returns
A MediaPlayerCallback object.

◆ PopupMenu()

def FoxitPDFSDKPython2.ActionCallback.PopupMenu (   menus,
  is_selected_item 
)

A callback function to pop up a menu window.

The position of menu window is the same as cursor's. This callback function is optional, so it can be implemented to do nothing and just return a useless value.

Parameters
[in]menusAn array of menu list objects.
[out]is_selected_itemOutput parameter that receives the value of whether a menu item is selected or not. true means that the menu item is selected, while false means that the menu item is not selected.
Returns
The name of the menu item that was selected.

◆ PopupMenuEx()

def FoxitPDFSDKPython2.ActionCallback.PopupMenuEx (   menus,
  is_selected_item 
)

A callback function to pop up a menu window.

The position of menu window is the same as cursor's. This callback function is optional, so it can be implemented to do nothing and just return a useless value.

Parameters
[in]menusAn array of MenuItemEx objects.
[out]is_selected_itemOutput parameter that receives the value of whether a menu item is selected or not. true means that the menu item is selected, while false means that the menu item is not selected.
Returns
The MenuItemEx object of the menu item that was selected.

◆ PostMessageToHtml()

def FoxitPDFSDKPython2.ActionCallback.PostMessageToHtml (   message)

A callback function to send message asynchronously to the message handler for the host container of the PDF document.

For this message to be delivered, the host container (for example, an <OBJECT> element in an HTML page) must have registered for notification by setting its messageHandler property.
This callback function will be triggered by the javascript method "doc.hostContainer.postMessage". This callback function is optional, so it can be implemented to do nothing.

Parameters
[in]messageAn array of string that specifies the message to be posted.
Returns
None.

◆ Print() [1/2]

def FoxitPDFSDKPython2.ActionCallback.Print (   document,
  is_ui,
  page_range,
  is_silent,
  is_shrunk_to_fit,
  is_printed_as_image,
  is_reversed,
  is_to_print_annots 
)

A callback function to print pages within a specified index range.

This callback function is optional, so it can be implemented to do nothing and just return a useless value.

Parameters
[in]documentA PDF document object. It would be valid.
[in]is_uitrue means that a UI should be presented to the user to obtain printing information and confirm the action.
[in]page_rangeA range object to specify the page range for printing. All the indexes represented in this range would start from 0 and less than page count of the specified document.
[in]is_silenttrue means that the cancel dialog box should be suppressed while the document is printing.
[in]is_shrunk_to_fittrue means that the page should be shrunk (if necessary) to fit within the area of the printed page.
[in]is_printed_as_imagetrue means that pages should be printed as image.
[in]is_reversedtrue means that the printing order should be from parameter end to parameter start.
[in]is_to_print_annotstrue means that annotations should be printed with page.
Returns
true means success, while false means failure.

◆ Print() [2/2]

def FoxitPDFSDKPython2.ActionCallback.Print (   document,
  print_params 
)

A callback function to print document with print parameters.

This callback function is optional, so it can be implemented to do nothing and just return a useless value.

Parameters
[in]documentA PDF document object. It would be valid.
[in]print_paramsA PrintParams object.
Returns
true means success, while false means failure.

◆ Query()

def FoxitPDFSDKPython2.ActionCallback.Query (   keywords,
  search_scope,
  search_option,
  di_path 
)

A callback function to query the text keywords.

This callback function will be triggered by the javascript method "search.query". This callback function is optional, so it can be implemented to do nothing.

Parameters
[in]keywordsThe text content for which to search.
[in]search_scopeSpecifies where the text should be searched. Please refer to values starting from FoxitPDFSDKPython2.ActionCallback.e_SearchScopeActiveDoc and this should be one of these values.
[in]search_optionA SearchOption object that represents search option.
[in]di_pathA device-independent path to a folder or search index on the user's computer. This parameter is optional. When search_scope is FoxitPDFSDKPython2.ActionCallback.e_SearchScopeFolder or FoxitPDFSDKPython2.ActionCallback.e_SearchScopeIndex , this parameter is required.
Returns
None.

◆ Release()

def FoxitPDFSDKPython2.ActionCallback.Release ( )

A callback function used to release current callback object itself.

Returns
None.

◆ RemoveSearchIndex()

def FoxitPDFSDKPython2.ActionCallback.RemoveSearchIndex (   search_index_config)

(Reserved, unsupported yet) A callback function to remove a search index.

This callback function will be triggered by the javascript method "search.removeIndex". This callback function is optional, so it can be implemented to do nothing.

Parameters
[in]search_index_configA SearchIndexConfig that represents the search index config.
Returns
true means success, while false means failure.

◆ RemoveToolButtom()

def FoxitPDFSDKPython2.ActionCallback.RemoveToolButtom (   button_name)

A callback function to remove a tool button added by the function FoxitPDFSDKPython2.ActionCallback.AddToolButton .

This callback function will be triggered by the javascript method "app.removeToolButton".

Parameters
[in]button_nameThe name of the tool button.
Returns
true means success, while false means failure.

◆ Response()

def FoxitPDFSDKPython2.ActionCallback.Response (   question,
  title,
  default_value,
  label,
  is_password 
)

A callback function to display a dialog box containing a question and an entry field for the user to reply to the question.

This callback function is optional, so it can be implemented to do nothing and just return a useless value.

Parameters
[in]questionA string that specifies the question to be posed to the user.
[in]titleA string that specifies the title of the dialog box.
[in]default_valueA string that specifies a default value as the answer to the question. If the answer is not specified, no default value is presented.
[in]labelA string that specifies a short string to appear in front of the edit text field.
[in]is_passwordA boolean value that indicates whether user's response should be masked to show:
true means that the user's response should show as asterisks (*) or bullets (?) to mask the response, which might be sensitive information.
Returns
User's response. It can be an empty string.

◆ Scroll()

def FoxitPDFSDKPython2.ActionCallback.Scroll (   point)

A callback function to scroll the specified point on the current page into the middle of the current view.

This callback function will be triggered by the javascript method "Doc.scroll". This callback function is optional, so it can be implemented to do nothing and just return a useless value.

Parameters
[in]pointThe specified point[PDF coordinate system].
Returns
None.

◆ SelectPageNthWord()

def FoxitPDFSDKPython2.ActionCallback.SelectPageNthWord (   page_index,
  start_offset,
  end_offset,
  is_show_selection 
)

A callback function to change the current page number and selects the specified word on the page.

This callback function will be triggered by the javascript method "Doc.selectPageNthWord". This callback function is optional, so it can be implemented to do nothing and just return a useless value.

Parameters
[in]page_indexThe page index.
[in]start_offsetThe start word offset.
[in]end_offsetThe end word offset.
[in]is_show_selectiontrue means to show selection, while false means not.
Returns
None.

◆ SetCurrentPage()

def FoxitPDFSDKPython2.ActionCallback.SetCurrentPage (   document,
  destination 
)

A callback function used to set the current page by destination.

This callback function is optional, so it can be implemented to do nothing.

Parameters
[in]documentA PDF document object. It would be valid.
[in]destinationA

◆ SetDefaultPageTransitionMode()

def FoxitPDFSDKPython2.ActionCallback.SetDefaultPageTransitionMode (   trans_type,
  trans_di 
)

A callback function to set the default page trastion mode for full screen mode.

This callback function will be triggered by the javascript property "app.fs.defaultTransition". This callback function is optional, so it can be implemented to do nothing.

Parameters
[in]trans_typeA string that specifies the type of the transition effect. Please refer to the follow values: "Split", "Box", "Fly", "Blinds", "Push", "Wipe", "Glitter", "Cover", "Uncover", "Dissolve", "Replace", "Fade".
[in]trans_diA string that specifies the direction of the transition effect.
  • For "Split", this value can be "HorizontalInward", "HorizontalOutward", "VerticalInward" or "VerticalOutward".
  • For "Box", this value can be "Outward" or "Inward".
  • For "Fly" and "Push", this value can be "Left", "Right", "Up" or "Down".
  • For "Blinds", this value can be "Horizontal" or "Vertical".
  • For "Wipe", "Glitter", "Uncover" and "Cover", this value can be "Left","LeftUp", "LeftDown", "Right", "RightUp", "RightDown","Up" or "Down".
  • For "Dissolve", "Replace" and "Fade", this value will be NULL.

Returns
None.

◆ SetDocChangeMark()

def FoxitPDFSDKPython2.ActionCallback.SetDocChangeMark (   document,
  change_mark 
)

A callback function to set the change mark which indicates whether the content of document is changed or not.

This callback function is optional, so it can be implemented to do nothing and just return a useless value.

Parameters
[in]documentA PDF document object. It would be valid.
[in]change_markA boolean value that indicates whether the content of document is changed or not.
Returns
true means success, while false means failure.

◆ SetFullScreen()

def FoxitPDFSDKPython2.ActionCallback.SetFullScreen (   is_full_screen)

A callback function to set full screen mode.

This callback function will be triggered when the javascript property "app.fullScreen" or "app.fs.isFullScreen" is to be set.

Parameters
[in]is_full_screentrue means to set full screen mode, while false means not.
Returns
None.

◆ SetIdentityProperties()

def FoxitPDFSDKPython2.ActionCallback.SetIdentityProperties (   identity_properties)

A callback function used to set identity properties of current user.

This callback function is optional, so it can be implemented to do nothing.

Parameters
[in]identity_propertiesAn identity properties object used to be set.
Returns
true means success, while false means failure.

◆ SetLayoutMode()

def FoxitPDFSDKPython2.ActionCallback.SetLayoutMode (   layout_mode,
  is_cover_mode 
)

A callback function to set the page layout of the current document.

This callback function will be triggered by the javascript properties "Doc.layout". This callback function is optional, so it can be implemented to do nothing and just return a useless value.

Parameters
[in]layout_modeThe layout mode. Please refer to values starting from FoxitPDFSDKPython2.ActionCallback.e_LayoutModeSinglePage and this should be one of these values.
[in]is_cover_modetrue means that the cover will always displayed separately, while false means not.
Returns
None.

◆ SetPageRotation()

def FoxitPDFSDKPython2.ActionCallback.SetPageRotation (   document,
  page_index,
  rotation 
)

A callback function used to set the rotation value of a page on PDF viewer.

This callback function is optional, so it can be implemented to do nothing.

Parameters
[in]documentA PDF document object. It would be valid.
[in]page_indexA page index, used to specify which page's rotation is to be changed. The index would start from 0 and less than page count of the specified document.
[in]rotationNew rotation value. Please refer to values starting from FoxitPDFSDKPython2.e_Rotation0 and this should be one of these values except FoxitPDFSDKPython2.e_RotationUnknown .
Returns
true means success, while false means failure.

◆ SetPageScale()

def FoxitPDFSDKPython2.ActionCallback.SetPageScale (   zoom_mode,
  dest 
)

A callback function to set current page zoom value.

This callback function will be triggered by the javascript properties "Doc.zoom" or "Doc.zoomType". This callback function is optional, so it can be implemented to do nothing and just return a useless value.

Parameters
[in]zoom_modeThe zoom mode. Please refer to values starting from FoxitPDFSDKPython2.Destination.e_ZoomXYZ and this should be one of these values.
[in]destA FoxitPDFSDKPython2.Destination object that represents destination data.
Returns
None.

◆ ShowDialog()

def FoxitPDFSDKPython2.ActionCallback.ShowDialog (   dlg_config)

A callback function to show the dialog.

This callback function will be triggered by the javascript method "app.execDialog".

Parameters
[in]dlg_configThe DialogDescriptionConfig object.
Returns
true means success, while false means failure.

◆ SoapRequest()

def FoxitPDFSDKPython2.ActionCallback.SoapRequest (   request_params)

Initiates a remote procedure call (RPC) or sends an XML message to a SOAP HTTP endpoint.

The method either waits for the endpoint to reply (synchronous processing) or calls a method on the notification object (asynchronous processing).
This callback function will be triggered by the javascript method "SOAP.request". This callback function is optional, so it can be implemented to do nothing.

Parameters
[in]request_paramsA SOAPRequestProperties object that contains the property parameters for the SOAP request.
Returns
A SOAPResponseInfo object.

◆ SubmitForm()

def FoxitPDFSDKPython2.ActionCallback.SubmitForm (   document,
  form_data,
  length,
  url,
  file_format_type 
)

A callback function to submit the form data to a specified URL.

This callback function is optional, so it can be implemented to do nothing and just return a useless value.

Parameters
[in]documentA PDF document object. It would be valid.
[in]form_dataA form data buffer which is to be submitted.
[in]lengthThe size (in bytes) of the buffer parameterform_data.
[in]urlA URL, to which the form data will be submitted.
[in]file_format_typeFile format type for submission form. Please refer to values starting from FoxitPDFSDKPython2.e_FileFormatTypeFDF and this would be one of these values.
Returns
true means success, while false means failure.

◆ UpdateLogicalLabel()

def FoxitPDFSDKPython2.ActionCallback.UpdateLogicalLabel ( )

A callback function to update logical label.

This callback function will be triggered by the javascript method "Doc.setPageLabels". This callback function is optional, so it can be implemented to do nothing and just return a useless value.

Returns
None.

◆ VerifySignature()

def FoxitPDFSDKPython2.ActionCallback.VerifySignature (   document,
  pdf_signature 
)

A callback function to verify specified signature..

This callback function will be triggered when a signature is to be verified by an action. If user does not want to verify the signature, just implement this function to do nothing and just return FoxitPDFSDKPython2.Signature.e_StateUnknown . User is recommended to use class FoxitPDFSDKPython2.LTVVerifier to verify if a signed signature is valid or not.

Parameters
[in]documentA PDF document object. It would be valid.
[in]pdf_signatureA PDF signature which is signed. This signature belongs to input parameter document.
Returns
The signature verified state. Please refer to values starting from FoxitPDFSDKPython2.Signature.e_StateUnknown and this would be one or combination of them.