Shell Functions

4/8/2010

The following table shows the Windows Mobile Shell functions, with a description of the purpose of each.

Programming element	Windows Mobile Professional and Windows Mobile Classic	Windows Mobile Standard	Description
DocList_Create	X		Creates the document list window.
DocList_GetFirstSelectedWaveFile	X		Gets the first selected WAV file.
DocList_GetNextSelectedWaveFile	X		Gets the next selected WAV file.
DrawFocusRectColor	X	X	Draws a focus rectangle in a style and color that are based on the current theme.
Edit_GetExtendedStyle		X	Gets the extended style information for the current window.
Edit_GetInputMode		X	Gets the input mode of the current window.
Edit_SetExtendedStyle		X	Sets the extended style information for the specified window.
Edit_SetInputMode		X	Sets the input mode of the specified window.
Edit_SetSymbols		X	Sets the symbol information for the specified window.
ExitWindowsEx	X	X	Shuts down the system.
GetOpenFileNameEx	X	X	Creates a system-defined dialog box that shows a grid of thumbnails, enabling the user to choose a picture or video.
ListBox_GetInputMode		X	Gets the input mode for the specified list box.
ListBox_SetInputMode		X	Sets the input mode for the specified list box.
SHCameraCapture	X	X	Launches the Camera Capture dialog box, which allows the user to capture pictures and shoot videos.
SHChangeNotifyDeregister	X	X	Removes a window from the notification chain.
SHChangeNotifyRegister	X	X	Enlists an application for receiving change notifications.
SHCloseApps	X	X	Tries to free up memory for an application.
SHCreateMenuBar	X	X	Creates a menu bar at the bottom of the screen.
SHDeviceLockAndPrompt	X	X	Puts the device into a lock state and immediately attempts to unlock it.
SHDoneButton	X	X	This is provided for applications that need to dynamically show or hide the OK button based on some state that the application is in.
Shell_NotifyIcon	X	X	Sends a message to the system to add, modify, or delete an icon from the taskbar status area.
ShellExecuteEx	X	X	Performs an action on a file. The file can be an executable file or a document
SHEnableSoftkey	X	X	Enables or disables individual soft keys by command identifier or index.
SHFindMenuBar	X	X	Can be used to get a handle to a menu bar window.
SHFreeContextMenuExtensions	X	X	Releases memory that is allocated for context menu processing.
SHFullScreen	X	X	Can be used to take over certain areas of the screen. It is used to modify the soft key bar or Start menu icon.
SHGetAppKeyAssoc	X	X	Determines if a navigational control is mapped to an application.
SHGetAutoRunPath	X	X	Will search for the first storage card and construct the path that would be used to look for an autorun file.
SHGetDocumentsFolder	X	X	Retrieves the path to the documents directory for the volume specified in the pszPath parameter.
SHGetEmergencyCallList	X	X	Gets a list of emergency calls.
SHGetFileInfo	X	X	Retrieves information about an object in the file system, such as a file, a folder, a directory, or a drive root.
SHGetImeMode		X	Retrieves the SHIME_MODE value from IME or the keyboard driver.
SHGetInputContext	X	X	Retrieves the current state of a context feature of an input window.
SHGetSpecialFolderPath	X	X	Retrieves the location of a special folder.
SHGetUIMetrics	X	X	Retrieves the system font size.
SHHandleWMActivate	X	X	Manages the input panel and your application, and the restoration of the original state.
SHHandleWMSettingChange	X	X	Manages the input panel and your application.
SHIdleTimerReset	X	X	Prevents the shell from reverting to the Home screen and locking the device.
SHIdleTimerResetEx	X	X	Supercedes SHIdleTimerReset by enabling the application to specify which timer gets reset.
SHImeGetClearMessage		X	Gets the message that should go into the Input Method Editor (IME) translation buffer in order to clear the field that the user is typing in.
SHImeOnKeyPress		X	Notifies the shell that the user pressed a key.
SHImeSetCustomInputIcons		X	Gives the shell a bitmap containing icons which the shell will use to draw the status icon when in a custom input mode.
SHImeSetModeIcon		X	Sets the status icon to the specified mode. Sets the input mode icon in the tray.
SHInitDialog	X	X	Primarily used to create a full-screen dialog box with the OK button in the navigation bar.
SHInitExtraControls	X	X	Initializes parameters for the CAPEDIT controls.
SHInputDialog	X	X	Used with an input dialog box where the input panel should remain raised, regardless of where the input focus is.
SHInvokeContextMenuCommand	X	X	Invokes a command from a context menu.
SHLoadContextMenuExtensions	X	X	Loads the context menu extensions from handlers that are listed in the registry for the context-class pair that is specified.
SHLoadImageFile	X		Reads an image file, decompresses it, and returns a handle to a bitmap in memory.
SHLoadImageResource	X		Converts a .gif in the resource file to a bitmap.
SHNavigateBack	X	X	Returns to the previous application on the device.
SHNotificationAdd	X		Asynchronously adds a notification to the notification tray.
SHNotificationGetData	X		Gets the data for a notification.
SHNotificationGetLatestData	X		Gets the data for the latest notification of the specified class ID.
SHNotificationRemove	X		Removes a notification.
SHNotificationUpdate	X		Updates aspects of a pending notification.
SHRecognizeGesture	X		Recognizes the stylus tap-and-hold gesture and the Action button press-and-hold gesture.
SHSendBackToFocusWindow		X	Sends the BACK key to the control with focus.
SHSetAppKeyWndAssoc	X		Assigns a window to receive a particular hardware button's key-press messages
SHSetImeMode		X	Passes the SHIME_MODE value to IME or the keyboard driver.
SHSetInputContext	X		Changes the state of a context feature of an input window.
SHSetNavBarText	X		Sets the title text in the taskbar.
SHSetPowerTimeoutForLock	X	X	Adjusts the power timeout when the device is locked or unlocked.
SHSipInfo	X		Queries the shell for information about the input panel and input methods (IM).
SHSipPreference	X		Requests a change of position for the input panel.

See Also

Other Resources

Shell Reference