Foxit PDF SDK
<FSFillerAssistCallback> Protocol Reference

Inherits <NSObject>.

Instance Methods

(void) - focusGotOnControl:value:
 A callback function which is triggered when the focus is set to a form control. More...
 
(void) - focusLostFromControl:value:
 A callback function which is triggered when the focus is lost from a form control. More...
 
(BOOL) - killTimer:
 A callback function used to kill the timer event by timer identifier. More...
 
(void) - refresh:rect:
 A callback function used to refresh the specified area on a specified page. More...
 
(BOOL) - setTimer:timer:out_timer_id:
 A callback function used to set a system timer. More...
 

Detailed Description

This class represents a callback object to assist form filler. All the pure virtual functions in this class are used as callback functions and should be implemented by user.

Method Documentation

◆ focusGotOnControl:value:()

- (void) focusGotOnControl: (FSControl *)  control
value: (NSString *)  value 
required

A callback function which is triggered when the focus is set to a form control.

This callback function supports text field, combo box field, list box field, push button field,

Parameters
[in]controlThe form control object to which the focus is set.
[in]valueThe value of form field associated with the control. If the control belongs to a push button field, this value would always be an empty string.
Returns
None.

◆ focusLostFromControl:value:()

- (void) focusLostFromControl: (FSControl *)  control
value: (NSString *)  value 
required

A callback function which is triggered when the focus is lost from a form control.

This callback function supports text field, combo box field, list box field, push button field, check box field, radio button field.

Parameters
[in]controlThe form control object, from which the focus is lost.
[in]valueThe value of form field associated with the control. If the control belongs to a push button field, this value would always be an empty string.
Returns
None.

◆ killTimer:()

- (BOOL) killTimer: (int)  timer_id
required

A callback function used to kill the timer event by timer identifier.

Parameters
[in]timer_idThe timer identifier returned by an earlier calling of callback function FSFillerAssistCallback::setTimer:timer:out_timer_id:.
Returns
YES means success, while NO means failure.

◆ refresh:rect:()

- (void) refresh: (FSPDFPage *)  page
rect: (FSRectF *)  rect 
required

A callback function used to refresh the specified area on a specified page.

Parameters
[in]pageA PDF page object.
[in]rectA rectangle that specifies the area on the page to be redrawn. nil means to refresh the whole page.
Returns
None.

◆ setTimer:timer:out_timer_id:()

- (BOOL) setTimer: (int)  elapse
timer: (FSTimer *)  timer
out_timer_id: (int *)  out_timer_id 
required

A callback function used to set a system timer.

This callback function is called to install a system timer. When a time-out value is specified, and every time when a time-out occurs, the system passes a message to the timer callback function.

Parameters
[in]elapseSpecifies the time-out value, in milliseconds.
[in]timerPointer to a timer callback object as timer.
[out]out_timer_idOutput parameter that receives the timer identifier of the new timer if the function is finished successfully. This value would be passed to callback function FSFillerAssistCallback::killTimer: to kill the timer. Nonzero if the function is successful; otherwise, this should be zero.
Returns
YES means success, while NO means failure.