Testing Menus, Help, and Connections
Many functions of your interface can be tested without generating code and
making the application. In both Test Shown Modules and Test Project mode, all
build windows except the App Builder primary window are closed, and the
App Builder primary window is inactive except for the Build button and the
Help menu.
If your project is small, you will probably want to test the entire project. If it is
large, you may want to test only selected modules, thus saving the time it takes
to load a large project. In Test Project mode the entire project is available.
Windows that are designated as not visible at startup (as are custom dialogs by
default, for instance) will not be visible.
See
for instructions if you are going to
use Test Shown Modules.
To Test a Project or Selected Modulesprojectstestingtestingprojects
Click Test Project or Test Shown Modules in the App Builder primary
window.
Depending on which button you selected, all modules in the current project
or only shown modules will be tested.
Test help, if appropriate.
See
for instructions.
Test menu displays, if appropriate.
See
for instructions.
Test connections, if appropriate.
See
for instructions.
Click Build to return to build mode.
To Test Help Volume Access
These instructions assume you have created a help menu and attached it to a
Help menu on the menu bar of a main window, as described in
.
Display the modules to be tested, if necessary.
If you are not going to test the entire project, you will need to show the
modules to be tested. See
for
instructions.
Click Test Shown Modules or Test Project, as appropriate.
Click Test Project to test the entire project. Click Test Shown Modules to test
selected modules.
Test help volume access by choosing one of the help volume chapters
(Overview, Tasks, Reference, for example) from the Help menu.
A help volume window with the appropriate help text will be displayed, if
the help viewer (dthelpview) is accessible and the proper connection has
been made to the compiled help volume. See
for instructions for creating help and making
connections to it. Dismiss the help window when you are finished with it.
Click Build to return to build mode.
To Test On Item Help
These instructions assume you have created a help menu and attached it to a
Help item on the menu bar of a main window, as described in
.
Display the modules to be tested, if necessary.
If you are not going to test the entire project, you will need to show the
modules to be tested. See
for
instructions.
Click Test Shown Modules or Test Project, as appropriate.
Click Test Project to test the entire project. Click Test Shown Modules to test
selected modules.
Test help volume access by choosing one of the help volume chapters
(Overview, Tasks, Reference, for example) from the Help menu.
A help volume window with the appropriate help text will be displayed, if
the help viewer (dthelpview) is accessible and the proper connection has
been made to the compiled help volume. See
for instructions for creating help and making
connections to it. Dismiss the help window when you are finished with it.
Test On Item help by choosing On Item from the Help menu.
The cursor will turn into an arrow and a question mark.
Move the cursor over an interface object and click.
If the object (or one of its parent objects) has help text, it will be displayed in
a quick help window.
Click the More button in the quick-help window, if it is active.
The help volume will be displayed, at the location specified in the Location
ID for the selected object in the Help Editor. Dismiss the help window when
you are finished with it.
Click the Close button in the quick help window to dismiss it.
Click Build to return to build mode.
To Test Menus in a Modulemenustestingtestingmenus
In Test Shown Modules mode, all windows in the currently-shown modules
will be displayed, including those whose initial state is not set Visible. See
if you want to test the entire
project, with not-Visible windows hidden.
Display the module to be tested, if necessary.
See
for instructions.
Click Test Shown Modules.
Click or press on the items in a menu bar, if appropriate.
The menus will be displayed. If you select a menu item that is connected to
certain predefined functions (Show or Hide a dialog, Access Help Volume,
Activate On Item Help, for example), the function will be performed.
Click each button menu, as appropriate.
The menus will be displayed. If you select a menu item that is connected to
certain predefined functions (Show or Hide a dialog, Access Help Volume,
Activate On Item Help, for example), the function will be performed.
Press mouse button 3 on a pane or list item to display a pop-up menu, if
appropriate.
The menus will be displayed. If you select a menu item that is connected to
certain predefined functions (Show or Hide a dialog, Access Help Volume,
Activate On Item Help, for example), the function will be performed.
Click Build to return to build mode.
To Test Connections in a Projectconnectionstestingtestingconnections
Display the modules to be tested, if necessary.
See
for instructions.
Click Test Project.
All build windows except the App Builder primary window will be closed,
and the primary window will be inactive except for the Build button and the
Help menu. Only windows in the project with an initial state set to Visible
will be displayed.
Click a button or choose a menu item that has a testable connection.
The following connections should work in test mode as they will work in
the compiled application:
Show
Hide
Set Value
Set Text
Access Help Volume
Activate On Item Help
Enable
Disable
If you connect a button to a custom dialog, for instance, specifying the
button as the source object, Activated as the When action, the custom dialog
as the target object, and Show as the Action Type, the custom dialog will be
displayed when you click the button.
Connections to Call Function and Execute Code will be noted by messages
to standard out.
Connections to Application Framework, ToolTalk, and message dialogs are
not supported in test mode.