Customizing the Setup Wizard and Property Sheets for a Thin Client
Other versions of this page are also available for the following:
.gif "A hyphen indicates that the information in this topic is not relevant for this platform, or that the platform does not support the API that is listed.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
8/27/2008
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
In Platform Builder, select Catalog Items View.
Expand the Core OS node and navigate to Core OS\CEBASE\Shell and User Interface\Graphical Shell\Windows Client Shell.
Expand the Windows Client Shell node.
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.
Right click the component and select Display in Solution View.
In the Solution Explorer window, expand the highlighted component node, and then expand Source files.
Select a source file to modify. For example, double-click the .rc file to modify the UI resources.
When you are finished with customizing the code, on the File menu, select Save <Filename>.
Right-click on the highlighted component node and select Build and Sysgen.
See Also
Reference
Changing the Shell Startup Behavior in Thin Client
Concepts
Configuring the Windows Thin Client Shell