Customizing a UI Component

Other versions of this page are also available for the following:

• Windows Embedded CE 6.0 R3

8/28/2008

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

Component	Description
Oomui	Controls the appearance and behavior of your target device in out of memory conditions.
Startui	Controls the appearance and behavior of system startup windows.
Calibrui	Controls the appearance and behavior of your target device during calibration of the touch screen.

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 UI component with the component you customize, you must modify your Winceos.bat file.

To replace a UI component in Winceos.bat

1. Set the sysgen REPLACE_SYSGEN_GWES to 1.

2. Set the sysgen REPLACE_SYSGEN_OOMUI or REPLACE_SYSGEN_STARTUI to 1 if you are replacing either the Oomui or Startui.

3. (Optional) Follow this step only if you are replacing Calibrui. Remove the ComponentName for each UI component being replaced from the definition of the environment variable ModuleName_COMPONENTS.

   The following code example shows the Calibrui component entry in the definition of the environment variable GWE2_COMPONENTS.

   set GWE2_COMPONENTS=%GWE2_COMPONENTS%     calibrui
   

   The following example shows the definition of the environment variable GWE2_COMPONENTS after the removal of the Calibrui component.

   set GWE2_COMPONENTS=%GWE2_COMPONENTS%
   

4. If the module has a resource file associated with it, add the ComponentName to the definition of the environment variable ModuleName_REPLACE. For example, to replace the Calibrui component in the GWES module, add the Calibrui entry to the environment variable GWES_REPLACE.

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

   set GWES_REPLACE=%GWES_REPLACE% calibrui
   

   If the module does not have a resource file associated with it, then replace GWES_REPLACE with GWES_REPLACE_COMPONENT. The following code example shows the replacement.

   set GWES_REPLACE_COMPONENTS=%GWES_REPLACE_COMPONENTS% calibrui
   

5. The last step is to ensure that all the resources and libraries are put in the right directory

   $(_PROJECTROOT)\oak\lib\$(_CPUINDPATH)\$@.lib
   !IF EXIST($(REPLACE_ROOT)\oak\lib\$(_CPUINDPATH)\$(CURRENT_LANGID)\*.res)
   @set GWES_RESOURCES=%%GWES_RESOURCES%% $(REPLACE_ROOT)\oak\lib\$(_CPUINDPATH)\$(CURRENT_LANGID)\$@.res
   

   Finally, make the run-time image using makeimg.

See Also

Concepts

Customizing the Out of Memory User Interface Component
Customizing the Startup User Interface Component
Customizing the Touch Screen (Stylus) Calibration User Interface Component

Other Resources

Graphics, Windowing and Events (GWES)