GUI ScreenIO for Windows

 ScreenIO.com


Property sheet behavior

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.

Closing a 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.

Standard property sheet behavior

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/Finish Apply all of the changes the user made in the property sheet and close the property sheet.  Finish appears only on Wizards, but is equivelent to OK in regular property sheets.

You cannot continue to work with a property sheet after OK/Finish has been pressed.  The property sheet will quit responding to your program and you will have to force the application to terminate. If you need to continue working with the property sheet after OK/Finish, Close the property sheet (DO-CLOSE) and then call GUI ScreenIO to display the panel again.  

After Finish is selected on a Wizard, it is customary to display subsequent invocations of the same panel as a property sheet so that choices made in the wizard mode can be edited.


© 2000-2019 Norcom, all rights reserved 

TOC

Send feedback to Norcom