Customizing a UI Component (Windows CE 5.0)

Article
09/14/2012

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

Set the sysgen REPLACE_SYSGEN_GWES to 1.
Set the sysgen REPLACE_SYSGEN_OOMUI or REPLACE_SYSGEN_STARTUI to 1 if you are replacing either the Oomui or Startui.
(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%
```
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
```

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.

Customizing a UI Component (Windows CE 5.0)

See Also

Additional resources