How to Replace the Calibrui Module (Windows CE 5.0)

Send Feedback

A Touch Screen and Stylus are one of the ways that a user can interact with a Windows CE-based device. A touch screen usually needs to be calibrated before it can be used the first time. Calibration ensures that the coordinates of the area touched by the stylus on the touch screen are close to the coordinates of the display. Windows CE has a default user interface for calibrating the Touch Screen, and it is called Calibrui. Calibrui module controls the appearance of the touch screen calibration window. User calibration is necessary because of the physical nature of touch screen hardware. For example, on the Handheld PC (H/PC), a user is prompted to tap the stylus at various points, indicated by a cross-hair cursor, on the screen before the target device is ready for first use.

If your application has a dramatically different touch screen display size or orientation, you can replace the default Calibrui module with a user interface that is more appropriate for the target device.

This how-to shows the steps that are necessary for you to replace the Calibrui module.

Hardware and Software Assumptions

To track your progress in the following table, select the check box next to each step.

  Step Topic
1. Create an OS design. The following list shows the choices to make in the New Platform Wizard:
  • Name the OS design ReplaceCalibrui.
  • From the Available BSPs list, choose CEPC: x86.
  • From the Available design templates list in the New Platform Wizard, choose the Mobile Handheld design template.
Creating an OS Design
2. Specify the configuration of your OS Design.

Choose the Release configuration.

Building a Run-Time Image
2. Create a clone of the Calibrui module in your workspace.

For more information on Cloning, see Cloning a Catalog Item.

Cloning the Calibrui Module
3. Modify the cloned calibrui code in your workspace. You may choose to change the Calibrui function implementations in order to customize calibration, or to change the Calibrui resource files to customize the messages displayed during calibration. Customizing the Calibrui Module
4. Build the run-time image. The following list shows the choices to make:
  1. From the Build OS menu, make sure that the following items are selected:

    Copy Files to Release Directory after Build

    Make Run-Time Image After Build

  2. From the Build OS menu, choose Sysgen.
Building a Run-Time Image
5. Verify that the changes you made to the code appear in the executable by using the following steps:
  • Choose File –and then Open. Open %_WINCEROOT%\PBWorkspaces\ReplaceCalibrui\RelDir\CEPC_x86_Release\gwes.exe.
  • In the workspace window, expand the gwes.exe\String Table node. Double-click the String Table icon.
  • This will bring up the resource file that contains the modified string. Verify that the modified string appears in the String table.
None.

See Also

Touch Screen (Stylus) OS Design Development | Touch Screen (Stylus)

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.