|
M&M FDT 1.2.1 Online Specification |
Interfaces and Methods - Schemas - FDT Specification - Quicklinks - Abbreviations
4.9.9.1 IFdtDialog::UserDialog()
| This method can be called in the states: |       |
|
HRESULT UserDialog ( [in] BSTR systemTag, [in] FdtXmlDocument userMessage, [out, retval] FdtXmlDocument* result ); |
Description:
| Call the Container to display a message |
Parameters:
| systemTag | Identifier of the device instance |
| userMessage | XML document according to the message specified by the FDTUserMessageSchema |
Return Value:
| result | XML document according to the user action specified by the FDTUserMessageSchema |
Behavior:
| A DTM should always use this method for standard user dialogs like error or information messages. Especially if a DTM is not allowed to open a user dialog (see IDtm::PrivateDialogEnabled()) this method is called to instruct the Frame Application to open it. The method will return the selection of the user action or the specified default answer of the dialog. It is up to the Frame Application to open a dialog or to send the default answer. The Frame Application should answer within a proper time-space, because the method works synchronously so that the DTM is blocked until it receives the answer. In case of a distributed system the Frame Application must ensure displaying the user dialog and the user interface of the DTM at the same workplace. |
Comments:
| -/- |
© by M&M Software GmbH, parts of this website taken from FDT Interface Specification Version 1.2.1, © by FDT Group, AISBL.
This website is published for support of M&M products as granted in license conditions, chapter 2.1.
Last updated 2015-02-05 15:17
Email: FDT Technical Support Line.