GUI ScreenIO for Windows

 ScreenIO.com


Panel Properties

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.

Type of Panel

Return to top of 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. 

Appearance

Return to top of page

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.

Size/Pos + Copybook

Return to top of page

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:

Separate string definitions

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.

Runtime Behavior

Return to top of page

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

  • Never
  • Edit Controls
  • Always
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.

Status Bar Cells

Return to top of page

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. 

Property Sheet

Return to top of page

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.

Main Container

Return to top of page

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 

TOC

Send feedback to Norcom