mirror of
git://git.code.sf.net/p/cdesktopenv/code
synced 2025-03-09 15:50:02 +00:00
258 lines
12 KiB
Text
258 lines
12 KiB
Text
<!-- $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 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 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 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 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 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 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 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 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 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 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 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 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 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-->
|