GUI ScreenIO for
Windows|
GUI ScreenIO for
Windows |
Panel properties are collected on several property sheets and popups. You can jump directly to the page of interest using the links below.
The items are arranged in alphabetical order by page.
| Item | Significance |
| Standard Main | The main window for your application. All GUI ScreenIO applications must begin by displaying a main panel. |
| Base (standard) | Dialog box that completely occupies the client area of the main window. |
| Embedded | Embedded panels were included
primarily to support conversion from Legacy ScreenIO applications where
they were rarely used.
Not recommended. |
| Popup dialog box | Standalone dialog box that appears to float above the main window, and can be moved wherever you want it on your desktop. |
| Property sheet/Wizard | A type of popup that presents its content on multiple
tabbed pages.
A Wizard is a style of property sheet that presents its pages in sequential order. |
| Item | Significance |
| Appearance (nonstandard):
Transparent background |
Panel background appears transparent. |
| Appearance (nonstandard):
Always on top |
Panel is always on top of other panels. |
| Border:
Raised appearance |
Draws a border around the client area that makes it appear to be raised. |
| Border:
Static edge look |
Draws a border around the client area that makes it appear flat. |
| Border:
Sunken appearance |
Draws a border around the client area that makes it appear to be sunken. |
| Description | Description of the panel, shown in the panel editor's index listing and in the comments in the panel copybook. |
| Title bar:
Context help (?) |
Panel's title bar has a question-mark context-help
button.
When the user clicks this, the mouse cursor changes to a question mark. If the user then clicks on a control, GUI ScreenIO will launch your Help documentation and attempt to jump to the page containing documentation for that control. |
| Title bar:
Maximize/Minimize |
Panel's title bar has minimize and maximize buttons.
Not recommended for popup panels! |
| Title bar:
No buttons on title bar |
Panel's title bar has no buttons; only the title text |
| Title bar:
No title bar |
Panel is displayed without a title bar. |
| Title bar:
System menu and X button |
Panel's title bar has a system menu and an X button. |
| Title | Text displayed in your panel's title bar. |
| Item | Significance |
| Copybook options:
Memory: IS EXTERNAL |
Appends the clause IS EXTERNAL to your panel copybook 01 level items. |
| Copybook options:
Memory: IS GLOBAL |
Appends the clause IS GLOBAL to your panel copybook 01 level items. |
| Copybook options: | The static text strings in the panel copybook will be separated into discrete data elements. Used if you want to modify them at runtime. It's usually simpler to use an edit control for this purpose. |
| Copybook options:
Suppress detailed attribute definitions |
Your panel copybook contains definitions for the attributes
of your controls, which consist of the name of the control and a
suffix. This makes it easy to use attributes to modify the behavior
of the control; to protect it, for example. If you suppress these
definitions, you will need to refer to attributes by number, which is a
maintenance problem.
Selecting this option does NOT save memory; the panel size is unchanged. |
| Initial position:
Center |
If the panel state was not previously saved, the window will be centered on the desktop. |
| Initial position:
Default |
If the panel state was not previously saved, Windows will determine the location of the panel. |
| Initial position:
Use exact position |
If the panel state was not previously saved, it will be positioned with the origin (in pixels) that you specify. |
| Size of panel's client area:
Height |
Height of your panel's client
area in dialog
box units when it is initially created. Panels may subsequently
be resized by dragging their border.
Property sheet and wizard panel size must be set here; they cannot be resized by dragging. |
| Size of panel's client area:
Width |
Width of your panel's client
area in dialog
box units when it is initially created. Panels may subsequently
be resized by dragging their border.
Property sheet and wizard panel size must be set here; they cannot be resized by dragging. |
| Item | Significance |
| Customized
message box:
Enable customized message boxes |
Inserts additional fields in the panel copybook that allow
you to display more elaborate message boxes than the default.
See this reference on issuing messages. |
| Customized message box:
Title |
Title that is displayed in your customized message box. This is only used if you use Customized message box options (above) and select both the Icon type and buttons to appear on the panel as explained in issuing messages. |
| Panel timeout events:
No timeouts |
Panel never times out. |
| Panel timeout events:
Reset timer each keystroke |
Panel will return a panel-EVENT-TIMEOUT event if the user allows the timeout interval to be exceeded between keystrokes. |
| Panel timeout events:
Reset timer each time panel is displayed |
Panel will return a panel-EVENT-TIMEOUT event if the panel is displayed for longer than the timeout interval. |
| Panel timeout events:
Timeout enabled only on initial display |
Panel will return a panel-EVENT-TIMEOUT
event if the panel is displayed for longer than the timeout interval, but
only the first time. It will not timeout when it is redisplayed.
If the panel closes, the timeout will be re-enabled. |
| Panel timeout events:
Timeout interval (seconds) |
Specify the timeout interval, in seconds. |
| Runtime
behavior:
Accepts dropped files |
Panel returns an event when user
drags a file over the panel and releases the mouse button.
Not presently implemented. |
| Runtime behavior:
Enter key behaves as tab
|
This allows the Enter key to be used to tab from field to
field. This is not standard windows behavior but is sometimes
desirable for fast data entry without having to reach for the tab key. For
instance, it allows for rapid entry of numeric data in multiple fields
using only the numeric pad.
Never, the default means that Enter is not equated to tab. Edit Controls means that if the active field is an edit control, pressing the Enter key will cause the next field in the tabbing sequence to become active, just as if the Tab key was pressed. Always means that the Edit control will always be a tab key and this eliminates the use of the enter key for any other use, including buttons, selections from listviews, etc. Note: Multiline Edit controls with the Enter = Line Break option is selected will not honor Enter as Tab. |
| Runtime behavior:
Up/Down Arrow keys behave as tab,
|
This will cause up and down arrow keys to act as back-tab and tab respectively. These keys are operational in all controls except ComboBoxes, Listboxes, Treeviews, ListViews and Multi-Line edit controls, where the up and down arrow is needed for within-control navigation. Nonstandard; occasionally useful for data entry applications were users do not want to touch the mouse. |
| Runtime behavior:
May be resized by user |
Allows the panel to be resized by dragging its border. |
| Runtime behavior:
Modal (disables all others) |
When the panel is displayed, it prevents the user from activating a panel in a different working-set in a multiple working-set application. |
| Runtime
behavior:
Not captive in main |
Not applicable; popups are never captive in the main. |
| Runtime behavior:
Save/restore panel state using registry |
Saves the panel state (size, position, listview column
width, etc.) in the registry when it is closed, and restores the panel to
the same state when it is redisplayed.
Requires that you specify registry keys in your main panel properties, and also select this option for your main panel. You must also CLOSE your main panel prior to terminating the program. |
| Item | Significance |
| Characters | Size of the status bar cell, in characters. |
| Popup has dedicated status bar | If the panel is a popup, causes a status bar to be present
in the popup when it is displayed.
Note: This is not standard for Windows applications; status bars rarely, if ever, appear in popups. |
| Reorder cells in status bar | Displays a popup that allows you to rearrange the order of the cells in the status bar. |
| Status bar cell usage | Right-click to specify what data is to be displayed in the cell. |
| Item | Significance |
| Buttons:
?-Help (Context help) |
Includes a ? button for context help in the title bar of the property sheet. |
| Buttons:
Apply |
Includes an Apply button when the property sheet is displayed. |
| Buttons:
Help |
Includes a Help button when the property sheet is displayed. |
| Label on page tab | Text that appears on the tab for the page (for a property sheet) or in the page's title bar (for a wizard). |
| Number of pages | Number of pages in the property sheet |
| Wizard presentation:
Acts as Wizard |
Causes the property sheet to be displayed as a wizard,
which presents the pages in sequence instead of as a tabbed property
sheet.
You can select to display the same panel as either a property sheet or a wizard at runtime if you select this option. |
| Wizard presentation:
Finish on every page |
Displays a Finish button on every page of the wizard. |
| Wizard presentation:
Wizard 97 style |
Displays the wizard using the Wizard 97 style. |
| Item | Significance |
| Defer appearance of main until a base panel is displayed | Used by applications composed entirely of popups, when you
do not want the main panel to be displayed.
The main is created but is not visible to the user. If you display a base panel, the main will be displayed, and will remain visible for the duration of the application. |
| Help style:
Internet URL |
GUI ScreenIO will launch your browser with the URL of your documentation on the Internet, which is specified in Location of Help files. |
| Help style:
Local HTML files |
GUI ScreenIO will launch your browser to display your HTML documentation. |
| Help style:
Location of Help files... |
Normally, GUI ScreenIO expects to find your Help files in a
\Help subdirectory beneath the directory where your application's
executable file resides.
Supply a complete pathspec here if your Help files are in a different location. If your Help target is an Internet URL, specify it here. |
| Help style:
Microsoft Html Help |
GUI ScreenIO will launch Microsoft Html Help and pass it the name of your Html Help file when the user requests help. |
| Help style:
None |
No Help is provided for the application. |
| Registry keys:
Application name |
The name of the application.
GUI ScreenIO will use this as part of the key when it stores data in the Windows registry for this application. If you want GUI ScreenIO to remember the size, and position of panels from one run of your application you must supply this field as well as the one below. |
| Registry
keys:
Company name |
Typically, the name of the company that developed the
application.
GUI ScreenIO will use this as part of the key when it stores data in the Windows registry for this application. If you want GUI ScreenIO to remember the size, and position of panels from one run of your application you must supply this field as well as the one above. |
| © 2000-2019 Norcom, all rights reserved |