Share via

Customizing the Setup Wizard and Property Sheets for a Thin Client (Windows Embedded CE 6.0)

  • Article

1/5/2010

Windows Embedded CE 6.0 includes sample source code for implementing the Windows Thin Client Setup Wizard and property sheets. These Windows-based applications must be available to a user to set up and configure a Windows Embedded CE powered thin client.

Setup Wizard Overview

The Setup wizard must run the first time that the thin client device is turned on. If the user does not finish the wizard, for example, if the thin client was turned off or reset, or if factory defaults have been applied to the thin client, the Setup wizard must run again to configure the thin client.

Property Sheets Overview

After the Setup wizard is finished, a user can change the settings by pressing the F2 key. When the F2 key is pressed, the Terminal Properties dialog box appears. This displays the thin client property sheets. In these property sheets, the user can change settings for the screen saver, the display resolution, and the printer.

The user interface (UI) design for new settings displayed on the property sheets must be consistent with the UI design of the samples.

Setup Wizard Requirements

The following list describes the requirements for the Setup wizard.

  • The product ID must be the universally unique identifier (UUID) assigned to the device. For more information, see Assign a UUID to a Thin Client.
  • The setup wizard must call RegFlushKey as the final step before exiting in order to make sure that all registry changes that the user makes are saved to an OEM-provided persistent store. To optimize performance, do not call RegFlushKey too much because, depending on your implementation, doing this could cause significant delays.
  • The Setup wizard must not let a user configure any of the settings that are not configurable from the property sheets.

Source Code Location

Source code for the wizard is located in the %_WINCEROOT%\PUBLIC\RDP\OAK\UIT\TSCONWIZ directory and the %_WINCEROOT%\PUBLIC|RDP\OAK\UIT\WBTWIZ directory.

Source code for the property pages is located in the %_WINCEROOT%\PUBLIC\RDP\OAK\UIT\WBTCMNPRPG directory.

To get started with customizing the setup wizard and property sheets

  1. In Platform Builder, select Catalog Items View.

  2. Expand the Core OS node and navigate to Core OS\CEBASE\Shell and User Interface\Graphical Shell\Windows Client Shell.

  3. Expand the Windows Client Shell node.

  4. Select a component to locate source code for. For example, Windows Based Terminal Common Property Pages, Windows Based Terminal Connection Wizard, or Windows Based Terminal Wizard.

  5. Right click the component and select Display in Solution View.

  6. In the Solution Explorer window, expand the highlighted component node, and then expand Source files.

  7. Select a source file to modify. For example, double-click the .rc file to modify the UI resources.

  8. When you are finished with customizing the code, on the File menu, select Save <Filename>.

  9. Right-click on the highlighted component node and select Sysgen.

See Also

Reference

Changing the Shell Startup Behavior in Thin Client

Concepts

Configuring the Windows Thin Client Shell

Other Resources

Customizing a Thin Client