Create a Custom Input Method

8/28/2008

This code sample is named PhoneIme. It demonstrates how to create a custom Input Method for Windows Mobile 6 Standard..

Feature Area

• Shell Application Development

Relevant APIs

• Shell Reference
• SHImeSetCustomInputIcons function
• SHImeSetModeIcon function
• SHImeOnKeyPress function
• SHImeGetClearMessage function

Source File Listing

• custom.bmp
  Contains the bitmap used as the image list for numeric entry modes.

• engine.cpp
  Contains the conversion engine that implements MultiTap.

• ime.cpp
  Contains the front-end to the Input Method Editor (IME). Calls the converter for the active mode.

• misc.cpp
  Contains the CreateFullScreenWindow helper function.

• mtapconv.cpp
  Contains the CMTapConverter class implementation. Conversion engine wrapper.

• mtapime.cpp
  Contains the MultiTap IME wrapper for the input converter.

• phoneime.cpp
  Contains the IME wrapper for the input converter. Contains the DLL entry points.

• phoneime.rc
  Contains the resources for the IME.

• prshld.cpp
  Contains the IME wrapper for input converter. Contains the CPressHOldDetectorClass implementation.

• symmenu.cpp
  Contains the Symbols menu.

• utils.cpp
  Contains the composition string utilities functions.

Usage

To run the code sample

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\Smartphone\cpp\Win32\PhoneIme Microsoft Visual Studio 2005 launches and loads the solution. Build the solution (Ctrl+Shift+B). Deploy the solution (F5). If you have not installed the SamplePrivDeveloper certificate, you will need to so that your Dll and CAB projects are signed correctly. To install the certificate from the windows desktop Click Start > Run. Type the path-name to SamplePrivDeveloper.pfx certificate, and click OK. By default, this is located in the following folder: C:\Program Files\Windows Mobile 6 SDK\Tools\Security\SDK Development Certificates Double-click the SamplePrivDeveloper.pfx certificate icon. The Certificate Import Wizard appears. Click Next. The certificate path-name is filled-in. Click Next. Click Next (you do not need a password). Click Next. Accept the default options; automatically select the certificate store based on certificate type. Click Finish.

For further details on how to install the SDK certificates onto the mobile device and how to use the privileged SDK certificate to sign this application, see Certificate Management and Application Signing for Application Developers.

Development Environments

SDK: Windows Mobile 6 Standard SDK 

Development Environment: Visual Studio 2005.

ActiveSync: Version 4.5.

See Also

Concepts

Code Samples for Windows Mobile

Other Resources

Shell, GWES, and User Interface
IIMCallbackEx