PHMenuScreen (Windows Embedded CE 6.0)
1/6/2010
This function creates a menu screen control with the specified parameters. A Menu screen is a dialog screen with a series of user selection choices displayed on the screen. It resembles in the list-like appearance a typical dropdown menu, except the screen itself holds the list of choices directly. If the dialog is modal, the ID associated with the selected item (or PHMENU_CANCELLED) is returned in the result union contained in the PH_MENU_SCREEN_PARAMETERS structure. If the dialog is modeless, the ID associated with the selected item is sent as the WPARAM of the message that is sent to the owner window.
The following image is an example of a menu screen (from the IP Phone Suite) shown below:
.gif "Ee501712.420d97bf-0440-49fd-bfbe-8d48658a84f1(en-US,WinEmbedded.60).gif")
Syntax
BOOL PHMenuScreen(
PH_MENU_SCREEN_PARAMETERS* pParameters
);
Parameters
- pParameters
[in, out] A PH_MENU_SCREEN_PARAMETERS struct that inputs and receives the menu screen parameters.
Return Value
The function returns TRUE or FALSE to indicate success or failure. To get extended error information, call GetLastError.
Remarks
Note
This documentation applies to functionality implemented in sample code for PhCommon. For more information, see PhCommon Reference.
The menu screen is actually a special type of dialog screen.
Requirements
| Header | controldefinitions.h |
| Library | PhCommon.dll |
| Windows Embedded CE | Windows Embedded CE 6.0 and later |