Share via


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