Context Menu Extension Handler

Windows Mobile SupportedWindows Embedded CE Not Supported

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

Usage

To run the code sample

  1. Run "guidgen.exe" to generate a new GUID.

  2. Copy this GUID to "guids.h", replacing the one that is already there.

  3. 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\ctxmenu

    Microsoft Visual Studio 2005 launches and loads the solution.

  4. Build the solution (Ctrl+Shift+B).

  5. Deploy the solution (F5). ctxmenu.dll is registered. built, and deployed to the folder \windows.

To use the application

  1. Launch File Explorer on the mobile device.

  2. 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