<!-- $XConsortium: ch08.sgm /main/6 1996/09/08 19:48:56 rws $ -->
<!-- (c) Copyright 1995 Digital Equipment Corporation. -->
<!-- (c) Copyright 1995 Hewlett-Packard Company. -->
<!-- (c) Copyright 1995 International Business Machines Corp. -->
<!-- (c) Copyright 1995 Sun Microsystems, Inc. -->
<!-- (c) Copyright 1995 Novell, Inc. -->
<!-- (c) Copyright 1995 FUJITSU LIMITED. -->
<!-- (c) Copyright 1995 Hitachi. -->
<Chapter Id="ABUG.test.div.1">
<Title Id="ABUG.test.mkr.1">Testing Menus, Help, and Connections</Title>
<Para>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.</Para>
<Para>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.</Para>
<Para>See
<!--Original XRef content: '&xd2;To Show a Hidden Module&xd3; on page&numsp;18'--><XRef Role="SecTitleAndPageNum" Linkend="ABUG.proj.mkr.9"> for instructions if you are going to
use Test Shown Modules.</Para>
<InformalTable Id="ABUG.test.itbl.1" Frame="All">
<TGroup Cols="1">
<ColSpec Colname="1" Colwidth="4.0 in">
<TBody>
<Row Rowsep="1">
<Entry><Para><!--Original XRef content: 'To Test a Project or Selected Modules102'--><XRef Role="JumpText" Linkend="ABUG.test.mkr.2"></Para></Entry>
</Row>
<Row Rowsep="1">
<Entry><Para><!--Original XRef content: 'To Test Help Volume Access102'--><XRef Role="JumpText" Linkend="ABUG.test.mkr.3"></Para></Entry>
</Row>
<Row Rowsep="1">
<Entry><Para><!--Original XRef content: 'To Test On Item Help103'--><XRef Role="JumpText" Linkend="ABUG.test.mkr.4"></Para></Entry>
</Row>
<Row Rowsep="1">
<Entry><Para><!--Original XRef content: 'To Test Menus in a Module104'--><XRef Role="JumpText" Linkend="ABUG.test.mkr.5"></Para></Entry>
</Row>
<Row Rowsep="1">
<Entry><Para><!--Original XRef content: 'To Test Connections in a Project105'--><XRef Role="JumpText" Linkend="ABUG.test.mkr.6"></Para></Entry>
</Row>
</TBody>
</TGroup>
</InformalTable>
<Sect1 Id="ABUG.test.div.2" Role="Procedure">
<Title Id="ABUG.test.mkr.2">To Test a Project or Selected Modules<IndexTerm><Primary>projects</Primary><Secondary>testing</Secondary></IndexTerm><IndexTerm><Primary>testing</Primary><Secondary>projects</Secondary></IndexTerm></Title>
<OrderedList>
<ListItem>
<Para>Click Test Project or Test Shown Modules in the App Builder primary
window.</Para>
<Para>Depending on which button you selected, all modules in the current project
or only shown modules will be tested.</Para>
</ListItem>
<ListItem>
<Para>Test help, if appropriate.</Para>
<Para>See
<!--Original XRef content: '&xd2;To Test On Item Help&xd3; on page&numsp;103'--><XRef Role="SecTitleAndPageNum" Linkend="ABUG.test.mkr.4"> for instructions.</Para>
</ListItem>
<ListItem>
<Para>Test menu displays, if appropriate.</Para>
<Para>See
<!--Original XRef content: '&xd2;To Test Menus in a Module&xd3; on page&numsp;104'--><XRef Role="SecTitleAndPageNum" Linkend="ABUG.test.mkr.5"> for instructions.</Para>
</ListItem>
<ListItem>
<Para>Test connections, if appropriate.</Para>
<Para>See
<!--Original XRef content: '&xd2;To Test Connections in a Project&xd3; on page&numsp;105'--><XRef Role="SecTitleAndPageNum" Linkend="ABUG.test.mkr.6"> for instructions.</Para>
</ListItem>
<ListItem>
<Para>Click Build to return to build mode.</Para>
</ListItem>
</OrderedList>
<Sect2 Id="ABUG.test.div.3" Role="Procedure">
<Title Id="ABUG.test.mkr.3">To Test Help Volume Access</Title>
<Para>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
<!--Original XRef content: '&xd2;Creating Help
and Help Connections&xd3; on page&numsp;67'--><XRef Role="SecTitleAndPageNum" Linkend="ABUG.afunc.mkr.2">.</Para>
<OrderedList>
<ListItem>
<Para>Display the modules to be tested, if necessary.</Para>
<Para>If you are not going to test the entire project, you will need to show the
modules to be tested. See
<!--Original XRef content: '&xd2;To Show a Hidden Module&xd3; on page&numsp;18'--><XRef Role="SecTitleAndPageNum" Linkend="ABUG.proj.mkr.9"> for
instructions.</Para>
</ListItem>
<ListItem>
<Para>Click Test Shown Modules or Test Project, as appropriate.</Para>
<Para>Click Test Project to test the entire project. Click Test Shown Modules to test
selected modules.</Para>
</ListItem>
<ListItem>
<Para>Test help volume access by choosing one of the help volume chapters
(Overview, Tasks, Reference, for example) from the Help menu.</Para>
<Para>A help volume window with the appropriate help text will be displayed, if
the help viewer (<Command>dthelpview</Command>) is accessible and the proper connection has
been made to the compiled help volume. See
<!--Original XRef content: '&xd2;Creating Help and Help
Connections&xd3; on page&numsp;67'--><XRef Role="SecTitleAndPageNum" Linkend="ABUG.afunc.mkr.2"> for instructions for creating help and making
connections to it. Dismiss the help window when you are finished with it.</Para>
</ListItem>
<ListItem>
<Para>Click Build to return to build mode.</Para>
</ListItem>
</OrderedList>
</Sect2>
<Sect2 Id="ABUG.test.div.4" Role="Procedure">
<Title Id="ABUG.test.mkr.4">To Test On Item Help</Title>
<Para>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
<!--Original XRef content: '&xd2;Creating Help
and Help Connections&xd3; on page&numsp;67'--><XRef Role="SecTitleAndPageNum" Linkend="ABUG.afunc.mkr.2">.</Para>
<OrderedList>
<ListItem>
<Para>Display the modules to be tested, if necessary.</Para>
<Para>If you are not going to test the entire project, you will need to show the
modules to be tested. See
<!--Original XRef content: '&xd2;To Show a Hidden Module&xd3; on page&numsp;18'--><XRef Role="SecTitleAndPageNum" Linkend="ABUG.proj.mkr.9"> for
instructions.</Para>
</ListItem>
<ListItem>
<Para>Click Test Shown Modules or Test Project, as appropriate.</Para>
<Para>Click Test Project to test the entire project. Click Test Shown Modules to test
selected modules.</Para>
</ListItem>
<ListItem>
<Para>Test help volume access by choosing one of the help volume chapters
(Overview, Tasks, Reference, for example) from the Help menu.</Para>
<Para>A help volume window with the appropriate help text will be displayed, if
the help viewer (<Command>dthelpview</Command>) is accessible and the proper connection has
been made to the compiled help volume. See
<!--Original XRef content: '&xd2;Creating Help and Help
Connections&xd3; on page&numsp;67'--><XRef Role="SecTitleAndPageNum" Linkend="ABUG.afunc.mkr.2"> for instructions for creating help and making
connections to it. Dismiss the help window when you are finished with it.</Para>
</ListItem>
<ListItem>
<Para>Test On Item help by choosing On Item from the Help menu.</Para>
<Para>The cursor will turn into an arrow and a question mark.</Para>
</ListItem>
<ListItem>
<Para>Move the cursor over an interface object and click.</Para>
<Para>If the object (or one of its parent objects) has help text, it will be displayed in
a quick help window.</Para>
</ListItem>
<ListItem>
<Para>Click the More button in the quick-help window, if it is active.</Para>
<Para>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.</Para>
</ListItem>
<ListItem>
<Para>Click the Close button in the quick help window to dismiss it.</Para>
</ListItem>
<ListItem>
<Para>Click Build to return to build mode.</Para>
</ListItem>
</OrderedList>
</Sect2>
<Sect2 Id="ABUG.test.div.5" Role="Procedure">
<Title Id="ABUG.test.mkr.5">To Test Menus in a Module<IndexTerm><Primary>menus</Primary><Secondary>testing</Secondary></IndexTerm><IndexTerm><Primary>testing</Primary><Secondary>menus</Secondary></IndexTerm></Title>
<Para>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
<!--Original XRef content: '&xd2;To
Test a Project or Selected Modules&xd3; on page&numsp;102'--><XRef Role="SecTitleAndPageNum" Linkend="ABUG.test.mkr.2"> if you want to test the entire
project, with not-Visible windows hidden.</Para>
<OrderedList>
<ListItem>
<Para>Display the module to be tested, if necessary.</Para>
<Para>See
<!--Original XRef content: '&xd2;To Show a Hidden Module&xd3; on page&numsp;18'--><XRef Role="SecTitleAndPageNum" Linkend="ABUG.proj.mkr.9"> for instructions.</Para>
</ListItem>
<ListItem>
<Para>Click Test Shown Modules.</Para>
</ListItem>
<ListItem>
<Para>Click or press on the items in a menu bar, if appropriate.</Para>
<Para>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.</Para>
</ListItem>
<ListItem>
<Para>Click each button menu, as appropriate.</Para>
<Para>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.</Para>
</ListItem>
<ListItem>
<Para>Press mouse button 3 on a pane or list item to display a pop-up menu, if
appropriate.</Para>
<Para>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.</Para>
</ListItem>
<ListItem>
<Para>Click Build to return to build mode.</Para>
</ListItem>
</OrderedList>
</Sect2>
<Sect2 Id="ABUG.test.div.6" Role="Procedure">
<Title Id="ABUG.test.mkr.6">To Test Connections in a Project<IndexTerm><Primary>connections</Primary><Secondary>testing</Secondary></IndexTerm><IndexTerm><Primary>testing</Primary><Secondary>connections</Secondary></IndexTerm></Title>
<OrderedList>
<ListItem>
<Para>Display the modules to be tested, if necessary.</Para>
<Para>See
<!--Original XRef content: '&xd2;To Show a Hidden Module&xd3; on page&numsp;18'--><XRef Role="SecTitleAndPageNum" Linkend="ABUG.proj.mkr.9"> for instructions.</Para>
</ListItem>
<ListItem>
<Para>Click Test Project.</Para>
<Para>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.</Para>
</ListItem>
<ListItem>
<Para>Click a button or choose a menu item that has a testable connection.</Para>
<Para>The following connections should work in test mode as they will work in
the compiled application:</Para>
<ItemizedList Remap="Bullet2">
<ListItem>
<Para>Show</Para>
</ListItem>
<ListItem>
<Para>Hide</Para>
</ListItem>
<ListItem>
<Para>Set Value</Para>
</ListItem>
<ListItem>
<Para>Set Text</Para>
</ListItem>
<ListItem>
<Para>Access Help Volume</Para>
</ListItem>
<ListItem>
<Para>Activate On Item Help</Para>
</ListItem>
<ListItem>
<Para>Enable</Para>
</ListItem>
<ListItem>
<Para>Disable</Para>
<Para>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.</Para>
<Para>Connections to Call Function and Execute Code will be noted by messages
to standard out.</Para>
<Para>Connections to Application Framework, ToolTalk, and message dialogs are
not supported in test mode.</Para>
</ListItem>
</ItemizedList>
</ListItem>
</OrderedList>
</Sect2>
</Sect1>
</Chapter>
<!--fickle 1.14 mif-to-docbook 1.7 01/02/96 10:11:44-->
