Customizing a UI Component

To suit the requirements of your target device, Windows CE allows you to customize and replace certain user interface (UI) components. Windows CE provides these UI components in the form of libraries that you can either use as supplied or replace with your own custom components. The following table shows these UI components.

To customize a UI component, modify the files in the %_WINCEROOT%\Public\Common\Oak\Drivers directory for the UI component you want to customize. To replace the default component with the component you customize, you must modify your Cesysgen.bat file.

To replace a component in Cesysgen.bat

1. Remove the ModuleName from the definition of the environment variable CE_MODULES. This step is done only once for each module, regardless of the number of components in the module that are being replaced. For example, to replace a GWES component, remove the GWES module entry from CE_MODULES.

   The following example shows the GWES module entry in the definition of the environment variable CE_MODULES.

   set CE_MODULES=   %CE_MODULES%      gwes
   

   The following example shows the definition of the environment variable CE_MODULES after the removal of the GWES module entry.

   set CE_MODULES=   %CE_MODULES%
   

2. Add the ModuleName to the definition of the environment variable REPLACE_MODULES. For example, to replace a GWES component, add the GWES module entry to REPLACE_MODULES. If you are replacing other components, you can add their names to the same command.

   The following example shows the addition of the GWES module entry in the definition of the environment variable REPLACE_MODULES.

   set REPLACE_MODULES=gwes
   

3. Remove the ComponentName for each component being replaced from the definition of the environment variable ModuleName_COMPONENTS. For example, to replace the Out of Memory User Interface (Oomui) component in the GWES module, remove the Oomui component entry from GWE4_COMPONENTS.

   The following example shows the Oomui component entry in the definition of the environment variable GWE4_COMPONENTS.

   set GWE4_COMPONENTS=%GWE4_COMPONENTS%     oomui
   

   The following example shows the definition of the environment variable GWE4_COMPONENTS after the removal of the Oomui component.

   set GWE4_COMPONENTS=%GWE4_COMPONENTS%
   

4. Add the ComponentName to the definition of the environment variable ModuleName_REPLACE. For example, to replace the Oomui component in the GWES module, add the Oomui entry to the environment variable GWES_REPLACE.

   The following example shows the Oomui entry in the definition of the environment variable GWES_REPLACE.

   set GWES_REPLACE=oomui
   

See Also

Customizing the Out of Memory User Interface Component | Customizing the Startup User Interface Component | Customizing the Touch Screen Calibration User Interface Component | Customizing the User Interface

Last updated on Wednesday, April 13, 2005

© 2005 Microsoft Corporation. All rights reserved.