ShowAuthenticationDialogEx method

Opens the electronic signature window for the specified SignatureButton object and, if the optional Wait parameter is not specified, returns immediately. This allows procedures to be called if an event is raised while the window is open.
If the Wait parameter is specified for the ShowAuthenticationDialogEx method, and the value of the parameter is set to FALSE, the method behaves as described above.
If the Wait parameter is specified but not set to a value, the default value, FALSE, is assumed.
This behavior is the opposite of the ShowAuthenticationDialog method, which blocks calls and thereby prevents procedures from executing while the electronic signature window is open.
If the Wait parameter is specified for the ShowAuthenticationDialogEx method, and the value of the parameter is set to TRUE, the method waits for signature authentication and the associated operation to be completed or cancelled, and the window closed, before subsequent calls can proceed. This is the same way the ShowAuthenticationDialog method works.
Syntax
object
.
ShowAuthenticationDialogEx
[
Wait
as Boolean
])
where
object
– is the name of a SignatureButton object or an expression that evaluates to a SignatureButton object.
Wait
– is an optional parameter of the type Boolean that specifies whether or not the method waits before returning.
  • If the value for Wait is (FALSE), the method returns immediately, which allows subsequent procedures to be called.
  • If Wait is set to TRUE, the method does not return until signature authentication and the associated operations have occurred or are cancelled, and the window is closed.
Remarks
  • The electronic signature window allows signature authentication and the operations that have been set up for a SignatureButton object, to be carried out.
  • If Wait is False, the method always returns False.
  • If Wait is True: the method returns True if the authentication operation occurred, or returns False if the electronic signature window was canceled.
Provide Feedback
Have questions or feedback about this documentation? Please submit your feedback here.
Normal