CVoIPDesktopManager (Windows CE 5.0)
CVoIPApp defers control of the TUI user interface to the CVoIPDesktopManager class. CVoIPDesktopManager
- Manages UI controls and dialogs
- Maintains z-order and focus information
- Handles UI events (all events are passed by the CVoIPApp instance)
This class is defined in %_WINCEROOT%\Public\VoIP\OAK\Phone\TUI\App\DesktopManager.cpp (and DesktopManager.h).
CVoIPDesktopManager Functionality
CVoIPDesktopManager owns the context buttons displayed at the bottom of the screen. This class also owns most of the user interface — the section that exists above the context buttons.
There is only a single CVoIPDesktopManager instance in a running TUI application. You can access this instance using the global GetDesktopManager function defined in %_WINCEROOT%\Public\VoIP\OAK\Phone\TUI\App\Main.cpp.
For most screens in the application, most of the UI is represented by an instance of the CVoIPMainDialog class, which generates a user interface that contains
- A list box for phone numbers, contact information, and so on
- A title
- A status bar
Some TUI screens don't use a list box. For example, the PIN entry screen contains a UI to enable the user to enter a PIN.
Screens that do not use the standard list box interface provided by CVoIPMainDialog use other dialog classes. For example, the PIN dialog is represented by the CVoIPPinDialog class.
CVoIPDesktopManager is also responsible for
- Message boxes like those displayed when an incoming call arrives or when confirmation of user input is needed
- Popup menus displayed when the user presses a context button, like the input menu that enables users to choose between different keypad input modes like 123, ABC, abc, and so on.
For more information about which parts of the user interface are owned by which UI classes, see TUI User Interface Organization.
For more information about how this class is involved in handling UI events, see Handling TUI User Input.
CVoIPDesktopManager Hierarchy Location
The CVoIPDesktopManager class is the root of the UI object model, from a containment perspective: for example, it contains references to the CVoIPDesktop and CVoIPMainDialog instances.
CVoIPDesktopManager is not the root of the TUI Win32 window hierarchy. That is, CVoIPDesktopManager is not a Win32 window.
The root of the Win32 window hierarchy is CVoIPDesktop. As the root of the window hierarchy, CVoIPDesktop receives window messages that are not handled by child windows.
The CVoIPDesktop implementation doesn't do much with these events. It serves primarily as a single location for unhandled events. When it receives these unhandled events, it notifies the CVoIPDesktopManager instance, which processes the events.
For information about the difference between the overall TUI object hierarchy and the TUI window hierarchy, see TUI Object and Window Hierarchies. For information about TUI UI classes, see TUI UI Object Model.
See Also
Send Feedback on this topic to the authors