<!-- $XConsortium: appa.sgm /main/10 1996/10/22 12:19:44 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. -->
<appendix id="ABUG.apWDB.div.1">
<title id="ABUG.apWDB.mkr.1">App Builder Windows and Dialog Boxes</title>
<para>This appendix describes the major windows and dialog boxes in App Builder,
including illustrations of the windows and dialog boxes and descriptions
of the window and dialog box elements</para>
<informaltable id="ABUG.apWDB.itbl.1" frame="All">
<tgroup cols="1">
<colspec colname="1" colwidth="4.0 in">
<tbody>
<row rowsep="1">
<entry><para><!--Original XRef content: 'App Builder Primary Window116'--><xref
role="JumpText" linkend="ABUG.apWDB.mkr.2"></para></entry></row>
<row rowsep="1">
<entry><para><!--Original XRef content: 'Windows Palette118'--><xref role="JumpText"
linkend="ABUG.apWDB.mkr.3"></para></entry></row>
<row rowsep="1">
<entry><para><!--Original XRef content: 'Panes Palette121'--><xref role="JumpText"
linkend="ABUG.apWDB.mkr.4"></para></entry></row>
<row rowsep="1">
<entry><para><!--Original XRef content: 'Controls Palette124'--><xref role="JumpText"
linkend="ABUG.apWDB.mkr.5"></para></entry></row>
<row rowsep="1">
<entry><para><!--Original XRef content: 'Project Organizer127'--><xref role="JumpText"
linkend="ABUG.apWDB.mkr.7"></para></entry></row>
<row rowsep="1">
<entry><para><!--Original XRef content: 'Module Browser128'--><xref role="JumpText"
linkend="ABUG.apWDB.mkr.8"></para></entry></row>
<row rowsep="1">
<entry><para><!--Original XRef content: 'Code Generator Window130'--><xref
role="JumpText" linkend="ABUG.apWDB.mkr.9"></para></entry></row></tbody></tgroup>
</informaltable>
<sect1 id="ABUG.apWDB.div.2">
<title id="ABUG.apWDB.mkr.2">App Builder Primary Window</title>
<!-- REVIEWERS - Following figure will be updated to include callouts -
same as in CDE1. -->
<graphic id="ABUG.apWDB.igrph.1" entityref="ABUG.apWDB.fig.1"></graphic>
<para><indexterm><primary>App Builder</primary><secondary>primary window</secondary>
</indexterm>The App Builder primary window is the starting point for building
a graphical user interface. The interface is created by dragging objects
from the App Builder object palettes (Windows, Panes, and Controls) to the
workspace, editing the properties of the resultant interface objects, and
adjusting the layout of the interface. See <!--Original XRef content: '&xd2;Overview
of the App Builder Process'--><xref role="SectionTitle" linkend="ABUG.intro.mkr.4">
in <!--Original XRef content: 'Chapter&numsp;1, &xd2;Getting Started'--><xref
role="ChapNumAndTitle" linkend="ABUG.intro.mkr.1">, for a summary
of the steps involved in creating an interface.</para>
<informaltable>
<tgroup cols="2" colsep="0" rowsep="0">
<colspec align="left" colwidth="100*">
<colspec align="left" colwidth="356*">
<tbody>
<row>
<entry><para>Title bar</para></entry>
<entry><para>Includes the name of the application, &ldquo;Application Builder,&rdquo;
the window manager menu, a minimize button, a maximize button, the name of
the current project (if one is open), and a &ldquo;(Save Needed)&ldquo;
indication if the current project has changed since being saved.<indexterm><primary>title bar</primary></indexterm>
</para></entry>
</row>
<row>
<entry><para>Mode bar</para></entry>
<entry><para>Includes Build, Test Shown Modules, and Test Project radio buttons
for specifying build and test modes.
<?Pub _newline>Build is for designing and building an interface.
<?Pub _newline>Test Shown Modules is for testing help, menus, and connections
in current, shown modules. All window objects will be shown, including those
for which the initial state is not set to Visible.
<?Pub _newline>Test Project is for testing help, menus, and connections in
the current project. Objects for which the initial state is not set to Visible
will not be shown.</para></entry></row>
<row>
<entry><para>Windows palette</para></entry>
<entry><para>Includes the three App Builder window objects: main window,
custom dialog, and file selection dialog. Window objects are dropped on the
workspace. See <!--Original XRef content: '&xd2;Windows Palette'--><xref
role="SectionTitle" linkend="abug.apwdb.mkr.3"> below for details.
</para></entry></row>
<row>
<entry><para>Panes palette</para></entry>
<entry><para>Includes the four App Builder pane objects: control pane, text
pane, draw area pane, and term pane. Pane objects are dropped on main windows,
custom dialogs, or other panes. See
<!--Original XRef content: '&xd2;Panes
Palette&xd3; on page&numsp;121'--><xref role="SecTitleAndPageNum" linkend="abug.apwdb.mkr.4">
for details.</para></entry></row>
<row>
<entry><para>Controls palette</para></entry>
<entry><para>Includes 14 App Builder control objects: button, menu button,
combo box, option menu, menu bar, radio box, check box, gauge, scale, separator,
text field, label, list, and spin box. Control objects are dropped on control
panes. See <!--Original XRef content: '&xd2;Controls Palette&xd3; on page&numsp;124'--><xref
role="SecTitleAndPageNum" linkend="abug.apwdb.mkr.5"> for details.</para></entry>
</row>
<row>
<entry><para>Object information area</para></entry>
<entry><para>Provides information about the object beneath the cursor. See
<!--Original XRef content: '&xd2;Object Information Area&xd3; on page&nums--><!--p;126'--><xref
role="SecTitleAndPageNum" linkend="abug.apwdb.mkr.6"> for details.</para></entry>
</row></tbody></tgroup></informaltable>
<sect2 id="ABUG.apWDB.div.3">
<title id="ABUG.apWDB.mkr.3">Windows Palette<indexterm><primary>Windows palette</primary></indexterm><indexterm><primary>palette</primary><secondary>Windows</secondary></indexterm></title>
<para>The Windows palette contains three objects: main window, custom dialog,
and file selection dialog.</para>
<sect3 id="ABUG.apWDB.div.4">
<title>Main Window</title>
<graphic id="ABUG.apWDB.igrph.2" entityref="ABUG.apWDB.fig.2"></graphic>
<para>A <emphasis>main window</emphasis> is the basic App Builder object.
It is created by dropping a main window icon on the workspace. The starting
point for a user interface is built in a main window. A main window has
a minimize button and therefore can be iconified.<indexterm><primary>main window</primary><secondary>definition of</secondary></indexterm><indexterm><primary>windows</primary><secondary>main</secondary></indexterm>
</para>
<para>The status region includes the name of the module the window is part
of and indicates when the window object is selected. It does not appear in
the compiled application.</para>
<para>Examples of main windows used in building App Builder itself are the
App Builder primary window, the Project Organizer, the Module Browser, and
the Code Generator.</para>
</sect3>
<sect3 id="ABUG.apWDB.div.5">
<title>Custom Dialog</title>
<graphic id="ABUG.apWDB.igrph.3" entityref="ABUG.apWDB.fig.3"></graphic>
<para>A <emphasis><indexterm><primary>custom dialog</primary><secondary>definition
of</secondary></indexterm>custom dialog</emphasis> is a window for displaying
information or providing a pop-up for a specific task within an interface.
It is created by dropping a custom dialog icon on the workspace. A custom
dialog might be &ldquo;connected&rdquo; to a button or a menu in a main window,
causing the pop-up dialog to be displayed when the button is clicked or a
menu item is chosen. A custom dialog cannot be closed to an icon.
</para>
<para>The status region includes the name of the module the dialog is part
of and indicates when the dialog object is selected. It does not appear in
the compiled application.</para>
<para>Examples of custom dialogs used in building App Builder include the
File Selection Dialog, the Project Name and Module Name dialog boxes, all
of the editors, and the message dialog boxes.</para>
</sect3>
<sect3 id="ABUG.apWDB.div.6">
<title>File Selection Dialog</title>
<graphic id="ABUG.apWDB.igrph.4" entityref="ABUG.apWDB.fig.4"></graphic>
<para>A <emphasis><indexterm><primary>file selection dialog</primary></indexterm>file
selection dialog</emphasis> is a specialized pop-up dialog for specifying
a file in an Open or Save operation. It is created by dropping a file selection
dialog icon on the workspace.</para>
<para>The status region includes the name of the module the dialog is part
of and indicates when the dialog object is selected. It does not appear in
the compiled application.</para>
</sect3>
</sect2>
<sect2 id="ABUG.apWDB.div.7">
<title id="ABUG.apWDB.mkr.4">Panes Palette<indexterm><primary>palette</primary><secondary>Panes</secondary></indexterm></title>
<para>The Panes palette contains four objects: control pane, text pane, draw
area pane, and term pane. All panes can be dropped on a main window, a custom
dialog, or another pane. If a pane is dropped on a pane, the dropped pane
will become a child of the first pane or a layered pane will be created.
See <!--Original XRef content: '&xd2;To
Create a Layered Pane'--><xref role="SectionTitle" linkend="abug.crobj.mkr.5">
in <!--Original
XRef content: 'Chapter&numsp;5, &xd2;Creating and
Editing Pan--><!--es, Menus, and
Messages'--><xref role="ChapNumAndTitle" linkend="abug.crobj.mkr.1"> for more
information.</para>
<sect3 id="ABUG.apWDB.div.8">
<title>Control Pane</title>
<graphic id="ABUG.apWDB.igrph.5" entityref="ABUG.apWDB.fig.5"></graphic>
<para>A <emphasis><indexterm><primary>control pane</primary></indexterm>control
pane</emphasis> is the drop site for App Builder controls. It is created by
dropping a control pane icon on a main window, a custom dialog, or another
pane. In the figure above, a control pane has been dropped on the top-left
corner of a main window, in anticipation of resizing it to fill the entire
canvas.</para>
<para>Examples of control panes used in building App Builder include the pane
on which the three panes palettes reside on the App Builder primary window
and the pane beneath the controls on each of the property editors.</para>
</sect3>
<sect3 id="ABUG.apWDB.div.9">
<title>Text Pane<indexterm><primary>text pane</primary><secondary>definitionof</secondary></indexterm><indexterm><primary>objects</primary><secondary>text pane</secondary></indexterm></title>
<graphic id="ABUG.apWDB.igrph.6" entityref="ABUG.apWDB.fig.6"></graphic>
<para>A <emphasis>text pane</emphasis> is a multi-line text-entry area in
the completed application. It is created by dropping a text pane icon on
a main window, custom dialog, or another pane.
</para>
<para>Examples of the use of text panes in building App Builder include the
Initial Value field in the Text Pane property editor and the Help Text field
in the Help Editor.</para>
</sect3>
<sect3 id="ABUG.apWDB.div.10">
<title>Draw Area Pane<indexterm><primary>draw area pane</primary></indexterm><indexterm><primary>objects</primary><secondary>draw area pane</secondary></indexterm></title>
<graphic id="ABUG.apWDB.igrph.7" entityref="ABUG.apWDB.fig.7"></graphic>
<para>A <emphasis>draw area pane</emphasis> is used as a drawing or display
area in the completed application. It is created by dropping a draw area
pane icon on a main window, custom dialog, or another pane.</para>
<para>Note the horizontal and vertical scroll bars, which enable you to view
objects outside the current view area.</para>
<para>Examples of the use of draw area panes in building App Builder include
the panes displaying modules and module objects in the Module Browser, and
the pane displaying modules in the Project Organizer.
</para>
</sect3>
<sect3 id="ABUG.apWDB.div.11">
<title>Term Pane<indexterm><primary>term pane</primary></indexterm><indexterm><primary>objects</primary><secondary>term pane</secondary></indexterm></title>
<graphic id="ABUG.apWDB.igrph.8" entityref="ABUG.apWDB.fig.8"></graphic>
<para>A <emphasis>term pane</emphasis> is a terminal emulation object which
accepts user input and echoes standard output. It is created by dropping
a term pane icon on a main window, custom dialog, or another pane.</para>
</sect3>
</sect2>
<sect2 id="ABUG.apWDB.div.12">
<title id="ABUG.apWDB.mkr.5">Controls Palette<indexterm><primary>palette</primary><secondary>Controls &lt;$startrange></secondary></indexterm><indexterm><primary>Controls palette &lt;$startrange></primary></indexterm></title>
<para>The Controls palette contains 14 objects, including buttons, lists,
text fields, and a menu bar. To find out how to edit the properties of these
objects, see &ldquo; <!--Original XRef content: 'Chapter&numsp;4, &xd2;Editing Properties
of Interface Objects'--><xref role="ChapNumAndTitle" linkend="ABUG.edprp.mkr.1">.
To find out how to create menus and submenus and attach them to objects,
see &ldquo; <!--Original XRef content: '&xd2;Creating and Editing
Menus'--><xref role="SectionTitle" linkend="ABUG.crobj.mkr.11"> in
<!--Original XRef content: 'Chapter&numsp;5, &xd2;Creating and Editing Panes,
Menus, and Messages'--><xref role="ChapNumAndTitle" linkend="ABUG.crobj.mkr.1">.
</para>
<informaltable>
<tgroup cols="2" colsep="0" rowsep="0">
<colspec align="left" colwidth="100*">
<colspec align="left" colwidth="356*">
<tbody>
<row>
<entry><para>Button</para></entry>
<entry><para><indexterm><primary>button control</primary></indexterm><indexterm>
<primary>controls</primary><secondary>button</secondary></indexterm><indexterm>
<primary>objects</primary><secondary>button</secondary></indexterm>A control
which, when clicked, performs a specified action. A button can be a push
button, a drawn button, or a menu button, settable in the Button property
editor. A drawn button, like a push button, performs a specific function
when clicked; the label on a drawn button, however, can change dynamically,
depending on the status of the application.
</para></entry></row>
<row>
<entry><para>Menu Button</para></entry>
<entry><para><indexterm><primary>controls</primary><secondary>menu button</secondary></indexterm><indexterm><primary>menu button control</primary>
</indexterm><indexterm><primary>objects</primary><secondary>menu button</secondary>
</indexterm>A specialized button, ready for attachment of a menu. Note that
there is no menu button property editor; edit the properties of a menu button
in the Button Property Editor.</para></entry></row>
<row>
<entry><para>Combo Box</para></entry>
<entry><para><indexterm><primary>combo box control</primary></indexterm><indexterm>
<primary>controls</primary><secondary>combo box</secondary></indexterm><indexterm>
<primary>objects</primary><secondary>combo box</secondary></indexterm>A combination
text field and option menu object. As with an option menu, you can select
an item from a pop-down menu, but you can also edit any of the items in
the list&mdash;if you have checked &ldquo; Editable &rdquo; in the property
editor, and if you write code to make it work.</para></entry></row>
<row>
<entry><para>Option Menu</para></entry>
<entry><para><indexterm><primary>controls</primary><secondary>option menu</secondary></indexterm><indexterm><primary>option menu control</primary>
</indexterm><indexterm><primary>objects</primary><secondary>option menu</secondary>
</indexterm>One of the three &ldquo;choice&rdquo; objects (option menu,
radio box, check box). When you click on an option menu, a menu is displayed,
providing a choice of items to choose from. The chosen item remains in the
option menu box and becomes the active choice. Examples of option menus
in App Builder are Object Type in the property editors and Source and Target
in the Connections Editor. An option menu is an exclusive- choice object.
</para></entry></row>
<row>
<entry><para>Radio Box</para></entry>
<entry><para><indexterm><primary>radio box control</primary></indexterm><indexterm>
<primary>controls</primary><secondary>radio box</secondary></indexterm><indexterm>
<primary>objects</primary><secondary>radio box</secondary></indexterm>One
of the three &ldquo;choice&rdquo; objects (option menu, radio box, check
box). A radio box is comprised of a label and two or more round buttons representing
application functions, only one of which can be selected (hence the term
&ldquo;radio button,&ldquo; named for the type of buttons on an automobile
radio). A radio box is an exclusive-choice object.
</para></entry></row>
<row>
<entry><para>Check Box</para></entry>
<entry><para><indexterm><primary>check box control</primary></indexterm><indexterm>
<primary>objects</primary><secondary>check box</secondary></indexterm><indexterm>
<primary>controls</primary><secondary>check box</secondary></indexterm>One
of the three &ldquo;choice&rdquo; objects (option menu, radio box, check
box). A check box is comprised of a label and one or more check boxes, each
with its own label. Each check box has a &ldquo;binary&rdquo; (on or off)
state, and each is independent of the other. A check box is a nonexclusive-choice
object.
</para></entry></row>
<row>
<entry><para>Gauge</para></entry>
<entry><para><indexterm><primary>gauge control</primary></indexterm><indexterm>
<primary>controls</primary><secondary>gauge</secondary></indexterm><indexterm>
<primary>objects</primary><secondary>gauge</secondary></indexterm>One of two
&ldquo;scale&rdquo; objects (gauge, scale). A gauge is used to indicate
a value.
</para></entry></row>
<row>
<entry><para>Scale</para></entry>
<entry><para><indexterm><primary>scale control</primary></indexterm><indexterm>
<primary>controls</primary><secondary>scale</secondary></indexterm><indexterm>
<primary>objects</primary><secondary>scale</secondary></indexterm>One of two
&ldquo;scale&rdquo; objects (gauge, scale). A scale, like a gauge, indicates
a value, but a user can modify the value of a scale by moving the slider.
</para></entry></row>
<row>
<entry><para>Separator</para></entry>
<entry><para><indexterm><primary>separator</primary></indexterm><indexterm>
<primary>controls</primary><secondary>separator</secondary></indexterm><indexterm>
<primary>objects</primary><secondary>separator</secondary></indexterm>A horizontal
or vertical line used to indicate separate functions in an application window.
</para></entry></row>
<row>
<entry><para>Menu Bar</para></entry>
<entry><para><indexterm><primary>menu bar control</primary></indexterm><indexterm>
<primary>controls</primary><secondary>menu bar</secondary></indexterm><indexterm>
<primary>objects</primary><secondary>menu bar</secondary></indexterm>A horizontal
bar of menu buttons arrayed across the top of a main window. The buttons
are cascade buttons, for attaching menus. The default menu bar includes
File, Edit, and Help topics. You can change, delete, or add to this group
of topics. Note that the menu bar is not strictly a control object: it is
a control pane with three buttons.
</para></entry></row>
<row>
<entry><para>Text Field</para></entry>
<entry><para><indexterm><primary>text field control</primary></indexterm><indexterm>
<primary>controls</primary><secondary>text field</secondary></indexterm><indexterm>
<primary>objects</primary><secondary>text field</secondary></indexterm>A single-line
text-entry area with a label (in contrast to a text <symbol role="Variable">pane</symbol>, which is a is a multi-line text-entry area).</para></entry>
</row>
<row>
<entry><para>Label</para></entry>
<entry><para><indexterm><primary>label control</primary></indexterm><indexterm>
<primary>controls</primary><secondary>label</secondary></indexterm><indexterm>
<primary>objects</primary><secondary>label</secondary></indexterm>A text string
or graphic icon which can be attached to an object for identification purposes.
</para></entry></row>
<row>
<entry><para>Scrolling List</para></entry>
<entry><para><indexterm><primary>scrolling list control</primary></indexterm><indexterm>
<primary>controls</primary><secondary>scrolling list</secondary></indexterm><indexterm>
<primary>objects</primary><secondary>scrolling list</secondary></indexterm>An
object for listing selectable options. A scrolling list is comprised of a
variable-length list with scroll bars and an optional label. A list can allow
single or multiple selections, and it can include a pop-up menu.
</para></entry></row>
<row>
<entry><para>Spin Box</para></entry>
<entry><para><indexterm><primary>spin box control</primary></indexterm><indexterm>
<primary>controls</primary><secondary>spin box</secondary></indexterm><indexterm>
<primary>objects</primary><secondary>spin box</secondary></indexterm>An object
for selecting from a number of choices, only one of which is visible at any
one time. A spin box is comprised of a text field, a label, and a set of
arrows for sequencing through the choices.<indexterm><primary>palette</primary>
<secondary>Controls &lt;$endrange></secondary></indexterm><indexterm><primary>Controls palette &lt;$endrange></primary></indexterm></para></entry>
</row>
</tbody></tgroup></informaltable>
</sect2>
<sect2 id="ABUG.apWDB.div.13">
<title id="ABUG.apWDB.mkr.6">Object Information Area<indexterm><primary>object information area &lt;$startrange></primary></indexterm></title>
<para>The object information area provides information about the object directly beneath the cursor&mdash;either on
one of the primary window palettes or in the user interface. It includes
the following information fields:</para>
<informaltable>
<tgroup cols="2" colsep="0" rowsep="0">
<colspec align="left" colwidth="100*">
<colspec align="left" colwidth="356*">
<tbody>
<row>
<entry><para>Object Type</para></entry>
<entry><para>The type of object beneath the cursor (main window, control
pane, text field, for example). This field is active in the App Builder primary
window, so you can use it to identify object types in the object palettes.
</para></entry></row>
<row>
<entry><para>Object Name</para></entry>
<entry><para>The name of the interface object beneath the cursor. This name,
in combination with the module name, uniquely identifies App Builder objects.
Palette objects do not have names, so the field will be blank if the cursor
is over the App Builder primary window. Note that all palette objects are
given unique names when they are instantiated in the interface; you can change
the name in the property editor for the object.</para></entry></row>
<row>
<entry><para>Position</para></entry>
<entry><para>The (x,y) pixel coordinates of the top-left corner of the object
beneath the cursor, measured in the coordinate system of the object that
contains it. If the object is a window object (main window, custom dialog,
or file selection dialog), the position will be relative to the top-left
corner of the monitor screen.
<?Pub _newline>If the object is a pane that was dropped on the top-left corner
of a window, its position will be 0,0, since 0,0 are the coordinates of the
top-left corner of the parent window. A pane that is dropped on another pane
and made a layered pane also has coordinates of 0,0.
<?Pub _newline>If the object is a control or a pane that has been made a child
of a control pane, its coordinates are measured from the top-left corner
of the parent object to the top- left corner of the child object.</para></entry>
</row>
<row>
<entry><para>Size</para></entry>
<entry><para>The size, in pixels, of the object beneath the cursor, in the
form &ldquo;width X, height Y.&rdquo;</para></entry></row>
<row>
<entry><para>Cursor Position</para></entry>
<entry><para>The (x,y) pixel coordinate location of the cursor, measured
in the coordinate system of the object that contains it. Every object, including
controls, has its own coordinate system. Some compound objects, comprised
of more than one widget, have multiple coordinate systems; a custom dialog,
for instance, includes a control pane, a tool bar, and buttons, each with
its own coordinate system.</para></entry></row>
<row>
<entry><para>Editing Module</para></entry>
<entry><para>The name of the module currently being edited. Any window dragged
from the Windows palette becomes part of that module. If more than one module
is shown on the workspace, you can change the current module by selecting
an object in another module.<indexterm><primary>object information area &lt;$endrange></primary></indexterm></para></entry>
</row>
</tbody></tgroup></informaltable>
</sect2>
</sect1>
<sect1 id="ABUG.apWDB.div.14">
<title id="ABUG.apWDB.mkr.7">Project Organizer<indexterm><primary>Project Organizer</primary></indexterm></title>
<para>The Project Organizer is used to open, save, or close a project, and
to save, show, hide, import, export, or remove modules.
</para>
<graphic id="ABUG.apWDB.igrph.9" entityref="ABUG.apWDB.fig.9"></graphic>
<informaltable>
<tgroup cols="2" colsep="0" rowsep="0">
<colspec align="left" colwidth="100*">
<colspec align="left" colwidth="356*">
<tbody>
<row>
<entry><para>Location</para></entry>
<entry><para>A control pane with Project Path and Module Path fields; indicates
the full-path location of the current project and the relative path to modules.
The module will normally be in the same folder as the project, and its
path will be noted as &ldquo;.&rdquo; (&ldquo;dot,&rdquo; signifying the
current folder).</para></entry></row>
<row>
<entry><para>Module Array</para></entry>
<entry><para>A draw area pane that depicts each of the modules in the current
project as a single icon with the module name beneath the App Builder icon.
</para></entry></row>
</tbody></tgroup></informaltable>
</sect1>
<sect1 id="ABUG.apWDB.div.15">
<title id="ABUG.apWDB.mkr.8">Module Browser<indexterm><primary>module browser</primary></indexterm><indexterm><primary>browser</primary></indexterm></title>
<para>The Module Browser (also called the browser) provides a hierarchical,
tree view of a module. Use it to view modules, edit the interface, group
or ungroup objects, create connections, and display object property editors
for editing. About the only things you can't do in the Browser that you can
do in the interface is move or align objects.
</para>
<para>To display the Browser, choose Module Browser from the View menu in
the App Builder primary window and select a module in the pull-right menu
displayed or select an object in the interface and Choose Browse from the
pop- up menu (displayed by pressing mouse button 3 in the interface).
</para>
<graphic id="ABUG.apWDB.igrph.10" entityref="ABUG.apWDB.fig.10"></graphic>
<informaltable>
<tgroup cols="2" colsep="0" rowsep="0">
<colspec align="left" colwidth="100*">
<colspec align="left" colwidth="356*">
<tbody>
<row>
<entry><para>Edit menu</para></entry>
<entry><para>Includes the same functions as the Edit menu in the App Builder
primary window: Undo, Cut, Copy, Paste, and Delete. If you select an object
or objects in the Browser and choose a menu item, the objects selected will
be selected in the interface and the function chosen will be performed in
the interface.</para></entry></row>
<row>
<entry><para>View menu</para></entry>
<entry><para><emphasis>Horizontal</emphasis> displays child objects to the
right of their parent object. Toggles with Vertical, which displays child
objects below their parent object. Vertical is the default view.
<?Pub _newline><emphasis>Hide Object Glyph</emphasis> hides the icons/glyphs
that represent the objects in the interface. Toggles with Show Object Glyph,
which is the default.
<?Pub _newline><emphasis>Show Object Type</emphasis> displays the object types
of objects in the interface. Toggles with Hide Object Type, which is the
default.
<?Pub _newline><emphasis>Collapse</emphasis> &ldquo;undisplays&rdquo; the
children of selected parent objects. This enables you to see more of the
interface in a smaller space.
<?Pub _newline><emphasis>Expand</emphasis> displays the children of selected
collapsed parent objects.
<?Pub _newline><emphasis>Expand All</emphasis> expands all collapsed parent
objects.
<?Pub _newline><emphasis>Module</emphasis> displays the module chosen from
the submenu.
<?Pub _newline><emphasis>Find</emphasis> displays a Find Object dialog box,
for finding objects by object name; if the object is found, the object is
selected and the canvas scrolls to show the object.
<?Pub _newline><emphasis>Tearoff Browser</emphasis> displays a new browser,
enabling you to view more than one module.</para></entry></row>
<row>
<entry><para>Module name</para></entry>
<entry><para>Indicates the module being viewed. Can be changed through the
View menu.</para></entry></row>
<row>
<entry><para>Top-level view</para></entry>
<entry><para>Shows all direct children of the module&mdash;windows, menus,
and messages. A detailed view of each of the objects selected here is shown
in the detailed tree view.</para></entry></row>
<row>
<entry><para>Detailed tree view</para></entry>
<entry><para>Shows a detailed view of the top-level objects selected. All
children of the selected top-level objects are shown.</para></entry></row>
</tbody></tgroup></informaltable>
<note>
<para>When you group objects or edit the interface in the Browser, be sure
to check the interface to see that you haven't obscured any objects. In particular,
if you group objects, the rectangular group created may hide an object behind
it.
</para>
</note>
</sect1>
<sect1 id="ABUG.apWDB.div.16">
<title id="ABUG.apWDB.mkr.9">Code Generator Window<indexterm><primary>Code Generator</primary></indexterm></title>
<para>The Code Generator window is used to generate code for the created interface
and to make and run the completed application. Display the window by choosing
Code Generator from the File menu of the App Builder primary window.
</para>
<graphic id="ABUG.apWDB.igrph.11" entityref="ABUG.apWDB.fig.11"></graphic>
<informaltable>
<tgroup cols="2" colsep="0" rowsep="0">
<colspec align="left" colwidth="100*">
<colspec align="left" colwidth="356*">
<tbody>
<row>
<entry><para>Path</para></entry>
<entry><para>Indicates the path to the current project, which is included
in the title bar at the top of the window.</para></entry></row>
<row>
<entry><para>Output Pane</para></entry>
<entry><para>Refers to the text pane below this label. The results when you
click on the buttons below the pane are displayed in this text pane. (The
functions of the buttons also appear as menu items in the File menu.)</para></entry>
</row>
<row>
<entry><para>Generate Code</para></entry>
<entry><para>Generates code for the current project. The output for this
action is displayed in the output pane.</para></entry></row>
<row>
<entry><para>Make</para></entry>
<entry><para>&ldquo;Makes&rdquo; the application for the current project.
The output for this action is displayed in the Output Pane.</para></entry>
</row>
<row>
<entry><para>Run</para></entry>
<entry><para>Runs the compiled application after generating code and making
the application. The output for this action is displayed in the Output Pane.
The primary window for the compiled application will be displayed.</para></entry>
</row>
<row>
<entry><para>Make &amp; Run</para></entry>
<entry><para>Combines the functions of the first three buttons (Generate
Code, Make, Run). The output for this action is displayed in the Output Pane.
The primary window for the compiled application will be displayed.</para></entry>
</row>
<row>
<entry><para>Abort</para></entry>
<entry><para>Aborts the currently running function. If the compiled application
is being run, clicking Abort quits the application.</para></entry></row>
<row>
<entry><para>Term Pane</para></entry>
<entry><para>Performs any terminal emulation functions.</para></entry></row>
</tbody></tgroup></informaltable>
<sect2 id="ABUG.apWDB.div.17">
<title>Code Generator Options Dialog Box<indexterm><primary>Code Generator Options dialog box</primary></indexterm></title>
<para>The Code Generator Options dialog box, accessible from the Options menu
in the Code Generator window, is used to set options that determine what
will happen when various Code Generator functions are performed.
</para>
<graphic id="ABUG.apWDB.igrph.12" entityref="ABUG.apWDB.fig.12"></graphic>
<informaltable>
<tgroup cols="2" colsep="0" rowsep="0">
<colspec align="left" colwidth="141*">
<colspec align="left" colwidth="387*">
<tbody>
<row>
<entry><para>Project</para></entry>
<entry><para>The name of the current project.</para></entry></row>
<row>
<entry><para>Generate Code For</para></entry>
<entry><para>Specifies whether code will be generated for Entire Project,
Main Only, Specific Modules Only, or Specific Modules and Main. If one of
the latter two choices is specified, the modules in the scrolling list are
active.</para></entry></row>
<row>
<entry><para>Don't Merge</para></entry>
<entry><para>Specifies whether user-written code will be merged into the
generated code; if you check Don't Merge, any user-written code will be discarded
when code is generated.</para></entry></row>
<row>
<entry><para>Report Normal Messages</para></entry>
<entry><para>Determines whether Normal Messages will
be displayed in the output pane when code is generated, whether no messages
will be generated (Be Silent), or whether all messages will be displayed
(Be Verbose).</para></entry></row>
<row>
<entry><para>Make Arguments</para></entry>
<entry><para>Specifies what arguments will be appended to the Make command
when it is run in the Code Generator.</para></entry></row>
<row>
<entry><para>Run Time Arguments</para></entry>
<entry><para>Specifies what arguments will be appended to the Run command
when it is run in the Code Generator.</para></entry></row>
<row>
<entry><para>Reset to Defaults</para></entry>
<entry><para>Resets all Code Generator Options settings to their default
values.</para></entry></row>
</tbody></tgroup></informaltable>
</sect2>
<sect2 id="ABUG.apWDB.div.18">
<title>Code Generator Environment Options Dialog Box<indexterm><primary>environment options, Code Generator</primary></indexterm><indexterm><primary>Code Generator</primary><secondary>environment options</secondary></indexterm></title>
<para>The Code Generator Environment Options dialog box, accessible from the
Options menu in the Code Generator window, is used for specifying a Variable
Name and a Value for the variable, which value will be used for functions
performed in the Code Generator window.
</para>
<graphic id="ABUG.apWDB.igrph.13" entityref="ABUG.apWDB.fig.13"></graphic>
<informaltable>
<tgroup cols="2" colsep="0" rowsep="0">
<colspec align="left" colwidth="100*">
<colspec align="left" colwidth="356*">
<tbody>
<row>
<entry><para>Variable Name</para></entry>
<entry><para>Specifies the name of an environment variable.</para></entry></row>
<row>
<entry><para>Value</para></entry>
<entry><para>Specifies a value for the variable specified in Variable Name.
This value is only set for the Code Generator window and has no effect on
the value of the variable outside of the Code Generator.</para></entry>
</row>
<row>
<entry><para>Get</para></entry>
<entry><para>Gets the current Code Generator value of Variable Name and displaying
it in the Value text field.</para></entry></row>
<row>
<entry><para>Set</para></entry>
<entry><para>Sets Variable Name to the value in Value. This value is set
for Code Generator window functions only.</para></entry></row>
<row>
<entry><para>Reset</para></entry>
<entry><para>Resets Value for Variable Name to its value as set outside of
the Code Generator.</para></entry></row>
<row>
<entry><para>Cancel</para></entry>
<entry><para>Cancels any changes made to Value and closes the Environment
Options dialog box.</para></entry>
</row></tbody></tgroup>
</informaltable>
</sect2>
</sect1>
</appendix>
<!--fickle 1.14 mif-to-docbook 1.7 01/02/96 10:11:44-->
<?Pub *0000042042>
