|
M&M FDT 1.2.1 Online Specification |
Interfaces and Methods - Schemas - FDT Specification - Quicklinks - Abbreviations
4.3.4.2 IDtmApplication::StartApplication()
| This method can be called in the states: |      |
|
HRESULT StartApplication ( [in] FdtUUIDString invokeId, [in] FdtXmlDocument functionCall, [in] BSTR windowTitle, [out, retval] VARIANT_BOOL* result ); |
Description:
| Opens a user interface of a DTM for a specific function call. |
Parameters:
| invokeId | Identifier for the started application. |
| functionCall | XML document containing the function id for the requested function or user interface specified by the DTMFunctionCallSchema |
| windowTitle | Window title required by the Frame Application |
Return Value:
| result | TRUE The requested application is started FALSE The operation failed. |
Behavior:
| The function call id associates a DTM with a functional/logical context. Each DTM can provide more than one function. Which functions are supported by a DTM can be requested via the schema provided by IDtm::GetFunctions(). In general, it is up to the Frame Application to determine the passed function call id and the DTM decides the kind of presentation. IDtmApplication::StartApplication() brings always a user interface to the foreground, or at least an error message. Already started applications, identified by the invoke id, will be popped to the foreground. The request of an already started application with a new invoke id will be rejected by the DTM. The invoke id is used by a Frame Application for the association at the callback interface if the application is terminated within the user interface of the DTM. (see IDtmEvents::OnApplicationClosed()). Furthermore it allows the Frame Application to handle a list of open user interfaces. |
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.