mirror of
git://git.code.sf.net/p/cdesktopenv/code
synced 2025-03-09 15:50:02 +00:00
661 lines
35 KiB
Text
661 lines
35 KiB
Text
<!-- $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 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, “Application Builder,”
|
|
the window manager menu, a minimize button, a maximize button, the name of
|
|
the current project (if one is open), and a “(Save Needed)“
|
|
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 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 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 “connected” 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 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 <$startrange></secondary></indexterm><indexterm><primary>Controls palette <$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 “ <!--Original XRef content: 'Chapter 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 “ <!--Original XRef content: '&xd2;Creating and Editing
|
|
Menus'--><xref role="SectionTitle" linkend="ABUG.crobj.mkr.11"> in
|
|
<!--Original XRef content: 'Chapter 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—if you have checked “ Editable ” 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 “choice” 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 “choice” 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
|
|
“radio button,“ 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 “choice” 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 “binary” (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
|
|
“scale” 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
|
|
“scale” 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 <$endrange></secondary></indexterm><indexterm><primary>Controls palette <$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 <$startrange></primary></indexterm></title>
|
|
<para>The object information area provides information about the object directly beneath the cursor—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 “width X, height Y.”</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 <$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 “.” (“dot,” 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> “undisplays” 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—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>“Makes” 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 & 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>
|