Property sheets can have up to four buttons at the bottom. These buttons are displayed by the system, but you can select which buttons appear when you design the property sheet.
You close a property sheet, like any other panel, by redisplaying an underlying panel.
For example, if your program displayed panel A, followed by property sheet B, just call GUI ScreenIO to redisplay panel A. Property sheet B will be closed automatically.
The Windows standard assigns specific behavior to these buttons, and you should keep this in mind when you implement your application, in particular the behavior of the Cancel button.
| Button | Program Response |
| Apply | Apply all of the changes the user made in the property
sheet, then redisplay the property sheet.
This allows the user to examine their changes without closing the property sheet, and make more changes (or undo them - see Cancel). |
| Cancel | Undo the changes the user made, then close the property
sheet.
If the user pressed Apply, this could get a bit complicated, so bear this in mind when you design your application! You cannot continue to work with a property sheet after Cancel has been pressed. The property sheet will quit responding to your program and you will have to force the application to terminate. |
| Help | No action required; GUI ScreenIO will launch your help file automatically. |
| OK | Apply all of the changes the user made in the property
sheet and close the property sheet.
You cannot continue to work with a property sheet after OK has been pressed. The property sheet will quit responding to your program and you will have to force the application to terminate. |
| © 2000-2006 Norcom, all rights reserved |