Customizing a UI Component

Article
06/30/2006

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.

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.
Fatui	Controls the file allocation table (FAT) file system.

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

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

Partager via

Customizing a UI Component

See Also

Ressources supplémentaires