Context Menu Extension Handler
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
.gif "A hyphen indicates that the information in this topic is not relevant for this platform, or that the platform does not support the API that is listed.")
8/28/2008
This code sample is named CTXMenu. It demonstrates how to implement a context menu extension handler. The application extends the File Explorer context menu that appears when you tap and hold a file.
Feature Area
Relevant APIs
- Shell Reference
- IContextMenu interface
Usage
To run the code sample
Run "guidgen.exe" to generate a new GUID.
Copy this GUID to "guids.h", replacing the one that is already there.
Navigate to the solution file (*.sln), and double-click it. By default, the solution file is copied to the following folder:
C:\Program Files\Windows Mobile 6 SDK\Samples\PocketPC\CPP\win32\ctxmenuMicrosoft Visual Studio 2005 launches and loads the solution.
Build the solution (Ctrl+Shift+B).
Deploy the solution (F5). ctxmenu.dll is registered. built, and deployed to the folder
\windows.
To use the application
Launch File Explorer on the mobile device.
Tap and hold on any .BMP file to bring up the context menu. You should see an additional menu item.
Remarks
The filename is retrieved from File Explorer via the IDataObject:IUnknown interface.
Context menu extensions are only loaded when a single file is selected; if multiple files are selected and the user invokes the context menu, File Explorer will not load any extension handlers.
Development Environments
SDK: Windows Mobile 6 Professional SDK and Windows Mobile 6 Standard SDK
Development Environment: Visual Studio 2005.
ActiveSync: Version 4.5.
See Also
Concepts
Code Samples for Windows Mobile
Read View Menu Extension
Medical History