The CAR sample Workplace Shell object included in the Toolkit provides an example of how to create an object. CAR is a spin-off implementation of the CAR object example used in the Systems Application Architecture: Common User Access Guide to User Interface Design.

The CAR object has two views:

• An Open car view, which is a representation of a CAR that moves randomly around a window.

• A Settings notebook that permits the user to change the sound of the horn, on the Horn beep page, and the speed of the CAR, on the Dashboard page.

The Horn beep and Dashboard pages in the CAR's Settings notebook are dialog windows whose contents are defined in a dialog template in the CAR.RC resource file. The resources are appended to the binary CAR.DLL file. The help panels associated with the dialogs are defined in the CAR.HLP help library. The association between the help panels and the dialogs is established with the dialog template in the resource file.

CAR is a persistent object but not a part of the file system. Therefore, it is derived from the WPAbstract class, which is derived from the WPObject root Workplace Shell class. This means that CAR inherits the methods from WPAbstract, which, in turn, inherits all of the instance and class methods from WPObject. CAR defines new methods and overrides some instance and class methods inherited from both WPAbstract and WPObject. New methods defined for the CAR class are summarized in the following table:

ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÂÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿³Method Name           ³Description              ³
ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´
³carQueryInfo          ³Gets the CAR information.³
³                      ³It is called by the      ³
³                      ³dialog procedure to get  ³
³                      ³the latest CAR data when ³
³                      ³the dialog window opened.³
ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´
³carSetInfo            ³Sets up the CAR          ³
³                      ³information. It is called³
³                      ³by the dialog procedure  ³
³                      ³to update the CAR data as³
³                      ³the user interacts with  ³
³                      ³the dialog window.       ³
ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´
³wpAddDashboardPage    ³Inserts the Dashboard    ³
³                      ³page into the Settings   ³
³                      ³notebook. It is called by³
³                      ³wpAddSettingsPages.      ³
ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´
³wpAddHornBeepPage     ³Inserts the Horn beep    ³
³                      ³page into the Settings   ³
³                      ³notebook. It is called by³
³                      ³wpAddSettingsPages.      ³
ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÁÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ