IDtmEvents::OnNavigation() method information

M&M FDT 1.2.1 Online Specification
IDtmEvents::OnNavigation() method information

Interfaces and Methods - Schemas - FDT Specification - Quicklinks - Abbreviations

4.9.1.7 IDtmEvents::OnNavigation()

This method can be called in the states:

HRESULT OnNavigation (
[in] BSTR systemTag
);

Description:

A DTM sends an notification to cause the navigation to a Frame Application-specific application.

Parameters:

systemTag

Identifier of the device instance

Return Value:

Behavior:

If a DTM sends a navigation request, the Frame Application decides which application will be opened. For example, if a DTM is started for diagnostic and shows the current device status, the user may want to know, where the device is connected within the system topology. Therefore the DTM provides a menu item or button for changing the application. If the user selects such a ‘navigation’ element the DTM send the OnNavigation() event and the Frame Application can open the system topology tree. In general, the Frame Application has started the DTM and checks the application context to decide which Frame Application specific application will be started to guarantee a unique navigation behavior for the user. The Frame Application can identify the calling DTM by the systemTag.

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.