Shell Functions
The following table shows the Shell functions, with a description of the purpose of each.
| Programming element | PPC | SP | 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. |
| SHChangeNotifyFree | X | X | Frees memory that was allocated for a change notification. |
| 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. |
| SHCreateShortcut | X | X | Creates a shortcut. |
| SHCreateShortcutEx | X | Creates a uniquely named shortcut in a specified directory | |
| SHDeviceLockAndPrompt | X | X | Puts the device into a lock state and prompts the user 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. |
| SHEnableSoftkey | X | X | Enables or disables individual soft keys by command or index. |
| SHEnumPropSheetHandlers | X | X | Enumerates the sub-keys under the class key hkey for property sheet extension. |
| 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 pszVolume 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. |
| SHGetInputContext | X | X | Retrieves the current state of a context feature of an input window. |
| SHGetSpecialFolderLocation | X | X | Retrieves the location of a special folder, such as My Handheld PC, Recycle Bin, Desktop, Printers, Fonts, or various file system directories. |
| 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. |
| SHImeOnKeyPress | X | Notifies the shell that the user pressed a key. | |
| 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. | |
| 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. | |
| 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 | |
| SHSetInputContext | X | Changes the state of a context feature of an input window. | |
| SHSetNavBarText | X | Sets the title text in the taskbar. | |
| 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. | |
| SndGetSoundDirectoriesList | X | X | Returns an array of possible directories for sound files for the specified sound event type and memory location. |
| SndGetSoundFileList | X | X | Returns an array of available soundfiles on the device for the specified sound event. |
| SndSetSound | X | X | Sets the current sound file for the indicated event. |
| SndGetSound | X | X | Gets the current sound file for the indicated sound event. |
See Also
Send Feedback on this topic to the authors