Interface IFinDecoupledForm
Asynchronous UI for showing and hiding modeless prompts for decoupled transaction confirmation.
Namespace: Subsembly.FinTS.Online
Assembly: Subsembly.FinTS.Core.dll
Syntax
public interface IFinDecoupledFormRemarks
At any one time there can always be only one Decoupled Prompt showing. If StartDecoupledPrompt(FinContact, FinCredential, Action) is invoked, while there is already a Prompt showing, then the new Prompt shall replace the old Prompt. This could be done in order to update the prompt text. Also, be prepared that FinishDecoupledPrompt(FinContact, FinDialogResultCode) may be invoked with any prompt currently showing.
An asynchronous modeless prompt only works when it is shown from a background worker thread. Hence the methods of this interface must never be called from the main UI thread. In order to ensure this, an implementation of IFinDecoupledForm must only be provided to the FinCredentialManager, when it will be solely used from a worker thread.
Methods
FinishDecoupledPrompt(FinContact, FinDialogResultCode)
Remove the prompt previously shown by StartDecoupledPrompt(FinContact, FinCredential, Action).
Declaration
void FinishDecoupledPrompt(FinContact aContact, FinDialogResultCode nResult)Parameters
| Type | Name | Description |
|---|---|---|
| FinContact | aContact | |
| FinDialogResultCode | nResult | The actual result from the decoupled confirmation. Possible result values are: Success, Cancelled, Error, or any FinTS status error code with a value between 9000 and 9999. |
StartDecoupledPrompt(FinContact, FinCredential, Action)
Invoked in order to show a modeless prompt to instruct the user to perform a decoupled transaction confirmation. The method must show the prompt and return.
Declaration
bool StartDecoupledPrompt(FinContact aContact, FinCredential aCredential, Action fnOnCancel)Parameters
| Type | Name | Description |
|---|---|---|
| FinContact | aContact | Identifies the contact for which to complete the decoupled transaction confirmation. This is used to provide as much information to the user as possible. |
| FinCredential | aCredential | Provides the information to be shown on the prompt. Not all properties of this instance shall actually be used when constructing the prompt. Only the following properties are of concern: Heading, Prompt, TanProcessParameters, and TanMediaName. All other properties must be ignored. |
| System.Action | fnOnCancel | Optional callback that shall be invoked when the user clicks on a CANCEL button
located on the prompt, or otherwise dismisses the prompt. If this is |
Returns
| Type | Description |
|---|---|
| System.Boolean | If the prompt was created successfully, and it is now shown, then |
Remarks