CDE/cde/doc/C/help/AppBuilder/Ref.sgm

<!-- $XConsortium: Ref.sgm /main/8 1996/09/08 22:00:36 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. -->
<!--	Help Volume: Application Builder
	File Name: reference -->
<Chapter Id="ABReference">
<Title>App Builder Reference</Title>
<Para>&newline;&empty;</Para>
<ItemizedList Mark="&bull;" Role="tight">
<ListItem Id="H.REF.item.1">
<Para><XRef Linkend="ABWindowsDialogs"></Para>
</ListItem>
<ListItem Id="H.REF.item.2">
<Para><XRef Linkend="ABMenus"></Para>
</ListItem>
<ListItem Id="H.REF.item.3">
<Para><XRef Linkend="ABEditors"></Para>
</ListItem>
</ItemizedList>
<Sect1 Id="ABWindowsDialogs">
<Title>App Builder Windows and Dialog Boxes</Title>
<Para>&newline; &empty;</Para>
<ItemizedList Mark="&bull;" Role="tight">
<ListItem Id="H.REF.item.4">
<Para><XRef Linkend="ABMainWindow">
</Para>
</ListItem>
<ListItem Id="H.REF.item.5">
<Para><XRef Linkend="ABProjOrg">
</Para>
</ListItem>
<ListItem Id="H.REF.item.6">
<Para><XRef Linkend="ABBrowser">
</Para>
</ListItem>
<ListItem Id="H.REF.item.7">
<Para><XRef Linkend="ABCodeGenerator">
</Para>
</ListItem>
<ListItem Id="H.REF.item.8">
<Para><XRef Linkend="ABCodeGenOptionsDialog">
</Para>
</ListItem>
<ListItem Id="H.REF.item.9">
<Para><XRef Linkend="ABCodeGenEnvirOptionsDialog">
</Para>
</ListItem>
<ListItem Id="H.REF.item.10">
<Para><XRef Linkend="ABProjName">
</Para>
</ListItem>
<ListItem Id="H.REF.item.11">
<Para><XRef Linkend="ABModName">
</Para>
</ListItem>
<ListItem Id="H.REF.item.12">
<Para><XRef Linkend="ABFileSelDialog">
</Para>
</ListItem>
<ListItem Id="H.REF.item.13">
<Para><XRef Linkend="ABMessages">
</Para>
</ListItem>
<ListItem Id="H.REF.item.14">
<Para><XRef Linkend="ABColorChooser">
</Para>
</ListItem>
</ItemizedList>
<Procedure>
<Title>See Also</Title>
<Step>
<ItemizedList Mark="&bull;" Role="tight">
<ListItem Id="H.REF.item.15">
<Para><XRef Linkend="ABEditors">
</Para>
</ListItem>
</ItemizedList>
</Step>
</Procedure>
<Sect2 Id="ABMainWindow">
<Title>App Builder Primary Window</Title>
<IndexTerm>
<Primary>window, main</Primary>
</IndexTerm>
<IndexTerm>
<Primary>main window</Primary>
</IndexTerm>
<Para>&newline;&empty;</Para>
<Para>The App Builder primary window is the starting point for building a
graphical user interface (called an interface throughout this volume).
The interface is created by dragging objects from the App Builder
object palettes (Windows, Panes, and Controls) to the desktop, editing
the properties of the resultant interface objects, and adjusting the
layout of the interface. See <XRef Linkend="ABLayingOutInterface"> for a summary
of the steps involved in creating an interface.</Para>
<Para>&newline;&empty;
</Para>
<Graphic Entityref="MainWindowCallsFig" Id="H.REF.fig.1"></Graphic>
<IndexTerm>
<Primary>title bar</Primary>
</IndexTerm>
<IndexTerm>
<Primary>primary window title bar</Primary>
</IndexTerm>
<IndexTerm>
<Primary>menu bar</Primary>
</IndexTerm>
<IndexTerm>
<Primary>primary window menu bar</Primary>
</IndexTerm>
<IndexTerm>
<Primary>mode bar</Primary>
</IndexTerm>
<IndexTerm>
<Primary>primary window mode bar</Primary>
</IndexTerm>
<IndexTerm>
<Primary>object palettes</Primary>
</IndexTerm>
<IndexTerm>
<Primary>primary window object palettes</Primary>
</IndexTerm>
<Para>&newline; &empty;</Para>
<VariableList>
<VarListEntry>
<Term>Title bar</Term>
<ListItem>
<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.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Menu bar</Term>
<ListItem>
<Para>Includes File, Edit, View, Layout, Editors, and Help menus;
see <XRef Linkend="ABMenus"> for descriptions of each.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Mode bar</Term>
<ListItem>
<Para>Includes radio buttons for specifying build and test modes:</Para>
<ItemizedList Mark="&bull;" Role="tight">
<ListItem Id="H.REF.item.16">
<Para>Build - For designing and building an interface.</Para>
</ListItem>
<ListItem Id="H.REF.item.17">
<Para>Test Shown Modules - For testing help, menus, and connections
in current, shown modules. All objects will be shown, including those
for which the initial state is not set to Visible.</Para>
</ListItem>
<ListItem Id="H.REF.item.18">
<Para>Test Project - 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>
</ListItem>
</ItemizedList>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Windows Palette</Term>
<ListItem>
<Para>Includes the three App Builder window objects: main
window, custom dialog, and file selection dialog. Window objects are
dropped on the desktop. See <XRef Linkend="ABWindowsPalette"> for details.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Panes Palette</Term>
<ListItem>
<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 <XRef Linkend="ABPanesPalette"> for details.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Controls Palette</Term>
<ListItem>
<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 <XRef Linkend="ABControlsPalette"> for details.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Object Information Area</Term>
<ListItem>
<Para>Provides information about the object
beneath the cursor. See <XRef Linkend="ABObjectInfoArea"> for details.</Para>
</ListItem>
</VarListEntry>
</VariableList>
<Sect3 Id="ABWindowsPalette">
<Title>Windows Palette</Title>
<IndexTerm>
<Primary>palette, windows</Primary>
</IndexTerm>
<IndexTerm>
<Primary>windows palette</Primary>
</IndexTerm>
<IndexTerm>
<Primary>primary window windows palette</Primary>
</IndexTerm>
<Para>The Windows palette contains three objects: main window, custom
dialog, and file selection dialog. Click on an underlined object
type below for descriptions of each of the window or dialog objects.
</Para>
<Para><InlineGraphic Remap="graphic" Role="left" Entityref="WindowsPaletteFig"></InlineGraphic> &newline;&empty;&newline; &newline;&empty;&newline; <Link Type="jump" Linkend="ABPalMainWindow"> Main Window </Link>
&newline;&empty;&newline;&newline;&empty;&newline;&newline;<Link Type="jump" Linkend="ABCustomDialog"> Custom Dialog </Link>
&newline;&empty;&newline;&newline;&empty;&newline;&newline;<Link Type="jump" Linkend="ABFileSelDialogObj"> File Selection Dialog </Link>
</Para>
<Sect4 Id="ABPalMainWindow">
<Title>Main Window</Title>
<IndexTerm>
<Primary>main window object</Primary>
</IndexTerm>
<IndexTerm>
<Primary>object, main window</Primary>
</IndexTerm>
<Para><InlineGraphic Remap="graphic" Role="left" Entityref="MainWIconObjectFig"></InlineGraphic> &empty;</Para>
<Para>A main window is the basic App Builder object. It is created by
dropping a main window icon on the desktop. The starting point for a
user interface is built in a main window. A main window has a
minimize button and therefore can be closed to an icon.</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>
<Procedure>
<Title>See Also</Title>
<Step>
<ItemizedList Mark="&bull;" Role="tight">
<ListItem Id="H.REF.item.19">
<Para><XRef Linkend="ABLayingOutInterface"></Para>
</ListItem>
</ItemizedList>
</Step>
</Procedure>
</Sect4>
<Sect4 Id="ABCustomDialog">
<Title>Custom Dialog</Title>
<IndexTerm>
<Primary>custom dialog</Primary>
</IndexTerm>
<IndexTerm>
<Primary>object, custom dialog</Primary>
</IndexTerm>
<Para><InlineGraphic Remap="graphic" Role="left" Entityref="CustomDIconObjectFig"></InlineGraphic> &empty;</Para>
<Para>A custom dialog 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 desktop. 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>
</Sect4>
<Sect4 Id="ABFileSelDialogObj">
<Title>File Selection Dialog</Title>
<IndexTerm>
<Primary>file selection dialog</Primary>
</IndexTerm>
<IndexTerm>
<Primary>object, file selection dialog</Primary>
</IndexTerm>
<IndexTerm>
<Primary>object:file selection dialog</Primary>
</IndexTerm>
<Para><InlineGraphic Remap="graphic" Role="left" Entityref="FSDIconObjectFig"></InlineGraphic> &empty;</Para>
<Para>A file selection dialog 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 desktop.</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>
<Procedure>
<Title>See Also</Title>
<Step>
<ItemizedList Mark="&bull;" Role="tight">
<ListItem Id="H.REF.item.20">
<Para><XRef Linkend="ABFileSelDialog">
</Para>
</ListItem>
</ItemizedList>
</Step>
</Procedure>
</Sect4>
</Sect3>
<Sect3 Id="ABPanesPalette">
<Title>Panes Palette</Title>
<IndexTerm>
<Primary>palette, panes</Primary>
</IndexTerm>
<IndexTerm>
<Primary>panes palette</Primary>
</IndexTerm>
<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 <XRef Linkend="ABCreateLayeredPane"> for more
information.</Para>
<Para><InlineGraphic Remap="graphic" Role="left" Entityref="PanesPaletteFig"></InlineGraphic> &newline;&empty;&newline; &newline;&empty;&newline; <Link Type="jump" Linkend="ABControlPane"> Control Pane </Link>
&newline;&empty;&newline;&newline;&empty;&newline;&newline;<Link Type="jump" Linkend="ABTextPane"> Text Pane </Link>
&newline;&empty;&newline;&newline;&empty;&newline;&newline;<Link Type="jump" Linkend="ABDrawAreaPane"> Draw Area Pane </Link>
&newline;&empty;&newline;&newline;&empty;&newline;&newline;<Link Type="jump" Linkend="ABTermPane"> Term Pane </Link>
</Para>
<Procedure>
<Title>See Also</Title>
<Step>
<ItemizedList Mark="&bull;" Role="tight">
<ListItem Id="H.REF.item.21">
<Para><XRef Linkend="ABLayingOutInterface"></Para>
</ListItem>
</ItemizedList>
</Step>
</Procedure>
<Sect4 Id="ABControlPane">
<Title>Control Pane</Title>
<IndexTerm>
<Primary>object, control pane</Primary>
</IndexTerm>
<IndexTerm>
<Primary>control pane object</Primary>
</IndexTerm>
<Para><InlineGraphic Remap="graphic" Role="left" Entityref="ControlPaneIconObjFig"></InlineGraphic> &empty;</Para>
<Para>A control pane 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>
<Procedure>
<Title>See Also</Title>
<Step>
<ItemizedList Mark="&bull;" Role="tight">
<ListItem Id="H.REF.item.22">
<Para><XRef Linkend="ABDnDMainWindow"></Para>
</ListItem>
</ItemizedList>
</Step>
</Procedure>
</Sect4>
<Sect4 Id="ABTextPane">
<Title>Text Pane</Title>
<IndexTerm>
<Primary>object, text pane</Primary>
</IndexTerm>
<IndexTerm>
<Primary>text pane object</Primary>
</IndexTerm>
<Para><InlineGraphic Remap="graphic" Role="left" Entityref="TextPaneIconObjFig"></InlineGraphic> &empty;</Para>
<Para>A text pane 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>
</Sect4>
<Sect4 Id="ABDrawAreaPane">
<Title>Draw Area Pane</Title>
<IndexTerm>
<Primary>object:draw area pane</Primary>
</IndexTerm>
<IndexTerm>
<Primary>draw area pane object</Primary>
</IndexTerm>
<Para><InlineGraphic Remap="graphic" Role="left" Entityref="DrawAreaIconObjFig"></InlineGraphic> &empty;</Para>
<Para>A draw area pane 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>
</Sect4>
<Sect4 Id="ABTermPane">
<Title>Term Pane</Title>
<IndexTerm>
<Primary>object:term pane</Primary>
</IndexTerm>
<IndexTerm>
<Primary>term pane object</Primary>
</IndexTerm>
<Para><InlineGraphic Remap="graphic" Role="left" Entityref="TermPaneIconObjFig"></InlineGraphic> &empty;</Para>
<Para>A term pane 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>
</Sect4>
</Sect3>
<Sect3 Id="ABControlsPalette">
<Title>Controls Palette</Title>
<IndexTerm>
<Primary>controls palette</Primary>
</IndexTerm>
<IndexTerm>
<Primary>palette, controls</Primary>
</IndexTerm>
<IndexTerm>
<Primary>button</Primary>
</IndexTerm>
<IndexTerm>
<Primary>menu button</Primary>
</IndexTerm>
<IndexTerm>
<Primary>combo box</Primary>
</IndexTerm>
<IndexTerm>
<Primary>option menu</Primary>
</IndexTerm>
<IndexTerm>
<Primary>radio box</Primary>
</IndexTerm>
<IndexTerm>
<Primary>check box</Primary>
</IndexTerm>
<IndexTerm>
<Primary>gauge</Primary>
</IndexTerm>
<IndexTerm>
<Primary>scale</Primary>
</IndexTerm>
<IndexTerm>
<Primary>separator</Primary>
</IndexTerm>
<IndexTerm>
<Primary>menu bar</Primary>
</IndexTerm>
<IndexTerm>
<Primary>text field</Primary>
</IndexTerm>
<IndexTerm>
<Primary>label</Primary>
</IndexTerm>
<IndexTerm>
<Primary>scrolling list</Primary>
</IndexTerm>
<IndexTerm>
<Primary>spin box</Primary>
</IndexTerm>
<Para>The Controls palette contains 14 objects, including buttons, lists,
text fields, and a menu bar.
</Para>
<Graphic Entityref="ControlsPaletteFig" Id="H.REF.fig.2"></Graphic>
<Para><InlineGraphic Remap="graphic" Role="left" Entityref="ButtonIconFig"></InlineGraphic> Button: 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.
&newline; &empty;
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>
<Para><InlineGraphic Remap="graphic" Role="left" Entityref="MenuButtonIconFig"></InlineGraphic> Menu Button: A
specialized button, ready for attachment of a menu. See <XRef Linkend="ABCreateMenu"> and <XRef Linkend="ABAttachMenu"> for instructions for
creating menus and attaching them to menu buttons. Note that there is
no menu button property editor; edit the properties of a menu button
in the Button Property Editor.</Para>
<Para><InlineGraphic Remap="graphic" Role="left" Entityref="ComboBoxIconFig"></InlineGraphic> Combo Box: 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. See <XRef Linkend="ABEditProps"> for instructions.</Para>
<Para><InlineGraphic Remap="graphic" Role="left" Entityref="OptionMenuIconFig"></InlineGraphic> Option Menu: 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.</Para>
<Para><InlineGraphic Remap="graphic" Role="left" Entityref="RadioBoxIconFig"></InlineGraphic> Radio Box: 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. See <XRef Linkend="ABEditProps"> for instructions.</Para>
<Para><InlineGraphic Remap="graphic" Role="left" Entityref="CheckBoxIconFig"></InlineGraphic> Check Box: 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. See <XRef Linkend="ABEditProps"> for instructions.</Para>
<Para><InlineGraphic Remap="graphic" Role="left" Entityref="GaugeIconFig"></InlineGraphic> Gauge: One of two "scale"
objects (gauge, scale). A gauge is used to indicate a value. See <XRef Linkend="ABEditProps"> for instructions.</Para>
<Para><InlineGraphic Remap="graphic" Role="left" Entityref="ScaleIconFig"></InlineGraphic> Scale: 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. See <XRef Linkend="ABEditProps"> for instructions.</Para>
<Para><InlineGraphic Remap="graphic" Role="left" Entityref="SeparatorIconFig"></InlineGraphic> Separator: A horizontal or
vertical line used to indicate separate functions in an application
window. See <XRef Linkend="ABEditProps"> for instructions.</Para>
<Para><InlineGraphic Remap="graphic" Role="left" Entityref="MenuBarIconFig"></InlineGraphic> Menu Bar: 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. See <XRef Linkend="ABCreateMenu"> and <XRef Linkend="ABAttachMenu"> for instructions for creating menus and attaching
them to menu buttons.</Para>
<Para><InlineGraphic Remap="graphic" Role="left" Entityref="TextFieldIconFig"></InlineGraphic> Text Field: A single-line
text-entry area with a label (compare to <XRef Linkend="ABTextPane">). See <XRef Linkend="ABEditProps"> for instructions.</Para>
<Para><InlineGraphic Remap="graphic" Role="left" Entityref="LabelIconFig"></InlineGraphic> Label: A text string or
graphic icon which can be attached to an object for identification
purposes. See <XRef Linkend="ABEditProps"> for instructions.</Para>
<Para><InlineGraphic Remap="graphic" Role="left" Entityref="ScrollListIconFig"></InlineGraphic> Scrolling List: 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. See <XRef Linkend="ABEditProps"> for instructions.</Para>
<Para><InlineGraphic Remap="graphic" Role="left" Entityref="SpinBoxIconFig"></InlineGraphic> Spin Box: 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. See <XRef Linkend="ABEditProps"> for instructions.</Para>
<Procedure>
<Title>See Also</Title>
<Step>
<ItemizedList Mark="&bull;" Role="tight">
<ListItem Id="H.REF.item.23">
<Para><XRef Linkend="ABPropsEditor">
</Para>
</ListItem>
<ListItem Id="H.REF.item.24">
<Para><XRef Linkend="ABLayingOutInterface"></Para>
</ListItem>
</ItemizedList>
</Step>
</Procedure>
</Sect3>
<Sect3 Id="ABObjectInfoArea">
<Title>Object Information Area</Title>
<IndexTerm>
<Primary>object information area</Primary>
</IndexTerm>
<IndexTerm>
<Primary>information area, object</Primary>
</IndexTerm>
<Para>&newline; &empty;
</Para>
<Graphic Entityref="ObjInfoAreaFig" Id="H.REF.fig.3"></Graphic>
<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>
<VariableList>
<VarListEntry>
<Term>Object Type</Term>
<ListItem>
<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>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Object Name</Term>
<ListItem>
<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>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Position</Term>
<ListItem>
<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.</Para>
<Para>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.</Para>
<Para>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>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Size</Term>
<ListItem>
<Para>The size, in pixels, of the object beneath the cursor, in the
form "width X, height Y."</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Cursor Position</Term>
<ListItem>
<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>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Editing Module</Term>
<ListItem>
<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 desktop, you can change the
current module by selecting an object in another module. See <XRef Linkend="ABModOpenNew"> for instructions for opening a new module.</Para>
</ListItem>
</VarListEntry>
</VariableList>
</Sect3>
</Sect2>
<Sect2 Id="ABProjOrg">
<Title>Project Organizer</Title>
<Para>The Project Organizer is used to open, save, or close a project, and
to save, show, hide, import, export, or remove modules.
&newline; &empty;
</Para>
<Graphic Entityref="ProjectOrgFig" Id="H.REF.fig.4"></Graphic>
<VariableList>
<VarListEntry>
<Term>Menu Bar</Term>
<ListItem>
<Para>A menu bar which includes Project, Module, and Help
menus.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Location</Term>
<ListItem>
<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>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Module Array</Term>
<ListItem>
<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>
</ListItem>
</VarListEntry>
</VariableList>
<Para>See <XRef Linkend="ABManagingProject"> for more about the Project Organizer and
its use.</Para>
<Procedure>
<Title>See Also</Title>
<Step>
<ItemizedList Mark="&bull;" Role="tight">
<ListItem Id="H.REF.item.25">
<Para><XRef Linkend="ABProjOrgProjMenu">
</Para>
</ListItem>
<ListItem Id="H.REF.item.26">
<Para><XRef Linkend="ABProjOrgModMenu">
</Para>
</ListItem>
<ListItem Id="H.REF.item.27">
<Para><XRef Linkend="ABFileMenu">
</Para>
</ListItem>
<ListItem Id="H.REF.item.28">
<Para><XRef Linkend="ABEditMenu">
</Para>
</ListItem>
<ListItem Id="H.REF.item.29">
<Para><XRef Linkend="ABBrowser">
</Para>
</ListItem>
</ItemizedList>
</Step>
</Procedure>
</Sect2>
<Sect2 Id="ABBrowser">
<Title>Module Browser</Title>
<IndexTerm>
<Primary>browser</Primary>
</IndexTerm>
<IndexTerm>
<Primary>module browser</Primary>
</IndexTerm>
<Para>The Module Browser (also called the browser) provides a hierarchical,
tree view of a module. The browser has the following components.
&newline; &empty;
</Para>
<Graphic Entityref="BrowserMWFig" Id="H.REF.fig.5"></Graphic>
<VariableList>
<VarListEntry>
<Term>Menu Bar</Term>
<ListItem>
<Para>Includes Edit, View, and Help menus. See <XRef Linkend="ABMenus"> for
descriptions.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Module Name</Term>
<ListItem>
<Para>Indicates the module being viewed. Can be changed
through the View menu.
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Top-level View</Term>
<ListItem>
<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>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Detailed Tree View</Term>
<ListItem>
<Para>Shows a detailed view of the top-level objects
selected. All children of the top-level objects are shown.
</Para>
</ListItem>
</VarListEntry>
</VariableList>
</Sect2>
<Sect2 Id="ABCodeGenerator">
<Title>Code Generator Window</Title>
<IndexTerm>
<Primary>code generator</Primary>
</IndexTerm>
<IndexTerm>
<Primary>generating code</Primary>
</IndexTerm>
<Para>&newline;&empty;</Para>
<Para>The Code Generator Window is used to generate code for the created
interface and to make and run the completed application.</Para>
<Para>&newline; &empty;
</Para>
<Graphic Entityref="CodeGenFig" Id="H.REF.fig.6"></Graphic>
<VariableList>
<VarListEntry>
<Term>Menu Bar</Term>
<ListItem>
<Para>Includes File, Options, and Help menus; see <XRef Linkend="ABMenus">for descriptions. Note that the File menu includes choices that
correspond to each of the push buttons at the bottom of the Output
Pane.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Path</Term>
<ListItem>
<Para>Indicates the path to the current project, which is included in
the title bar at the top of the window.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Output Pane</Term>
<ListItem>
<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.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Generate Code</Term>
<ListItem>
<Para>A push button for generating code for the current
project The output for this action is displayed in the Output Pane.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Make</Term>
<ListItem>
<Para>A push button for "making" the application for the current
project. The output for this action is displayed in the Output Pane.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Run</Term>
<ListItem>
<Para>A push button for running 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>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Make & Run</Term>
<ListItem>
<Para>A push button for combining 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>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Abort</Term>
<ListItem>
<Para>A push button for aborting the currently-running function. If
the compiled application is being run, clicking Abort quits the
application.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Term Pane</Term>
<ListItem>
<Para>A term pane for performing any terminal-emulation
functions.</Para>
</ListItem>
</VarListEntry>
</VariableList>
<Procedure>
<Title>See Also</Title>
<Step>
<ItemizedList Mark="&bull;" Role="tight">
<ListItem Id="H.REF.item.30">
<Para><XRef Linkend="ABBuildandRun">
</Para>
</ListItem>
</ItemizedList>
</Step>
</Procedure>
</Sect2>
<Sect2 Id="ABCodeGenOptionsDialog">
<Title>Code Generator Options Dialog Box</Title>
<IndexTerm>
<Primary>options dialog, code generator</Primary>
</IndexTerm>
<IndexTerm>
<Primary>code generator options dialog</Primary>
</IndexTerm>
<IndexTerm>
<Primary>generate code for</Primary>
</IndexTerm>
<IndexTerm>
<Primary>don't merge</Primary>
</IndexTerm>
<IndexTerm>
<Primary>report normal messages</Primary>
</IndexTerm>
<IndexTerm>
<Primary>make arguments</Primary>
</IndexTerm>
<IndexTerm>
<Primary>run time arguments</Primary>
</IndexTerm>
<IndexTerm>
<Primary>reset to defaults</Primary>
</IndexTerm>
<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.
&newline; &empty;
</Para>
<Graphic Entityref="CodeGenOptionsFig" Id="H.REF.fig.7"></Graphic>
<VariableList>
<VarListEntry>
<Term>Project</Term>
<ListItem>
<Para>The name of the current project.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Generate Code For</Term>
<ListItem>
<Para>Radio buttons and a scrolling list for specifying
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>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Don't Merge</Term>
<ListItem>
<Para>A check box for specifying 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>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Report Normal Messages</Term>
<ListItem>
<Para>An option menu for choosing 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>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Make Arguments</Term>
<ListItem>
<Para>A text field for specifying what arguments will be
appended to the Make command when it is run in the Code Generator.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Run Time Arguments</Term>
<ListItem>
<Para>A text field for specifying what arguments will be
appended to the Run command when it is run in the Code Generator.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Reset to Defaults</Term>
<ListItem>
<Para>A push button for resetting all Code Generator
Options settings to their default values.</Para>
</ListItem>
</VarListEntry>
</VariableList>
<Para>See <XRef Linkend="ABCommonButtons"> for descriptions of the five buttons at the
bottom of the dialog box.</Para>
<Procedure>
<Title>See Also</Title>
<Step>
<ItemizedList Mark="&bull;" Role="tight">
<ListItem Id="H.REF.item.31">
<Para><XRef Linkend="ABCodeGenEnvirOptionsDialog"></Para>
</ListItem>
<ListItem Id="H.REF.item.32">
<Para><XRef Linkend="ABSetCodeGenOptions">
</Para>
</ListItem>
</ItemizedList>
</Step>
</Procedure>
</Sect2>
<Sect2 Id="ABCodeGenEnvirOptionsDialog">
<Title>Code Generator Environment Options Dialog Box</Title>
<IndexTerm>
<Primary>code generator environment options</Primary>
</IndexTerm>
<IndexTerm>
<Primary>environment options, code generator</Primary>
</IndexTerm>
<IndexTerm>
<Primary>variable name, code generator</Primary>
</IndexTerm>
<IndexTerm>
<Primary>value, code generator</Primary>
</IndexTerm>
<IndexTerm>
<Primary>get, code generator value</Primary>
</IndexTerm>
<IndexTerm>
<Primary>set, code generator value</Primary>
</IndexTerm>
<IndexTerm>
<Primary>reset, code generator value</Primary>
</IndexTerm>
<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.
&newline; &empty;
</Para>
<Graphic Entityref="CodeGenEnvirOptionsFig" Id="H.REF.fig.8"></Graphic>
<VariableList>
<VarListEntry>
<Term>Variable Name</Term>
<ListItem>
<Para>A text field for typing the name of an environment
variable.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Value</Term>
<ListItem>
<Para>A text field for specifying 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>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Get</Term>
<ListItem>
<Para>A push button for getting the current Code Generator value of
Variable Name and displaying it in the Value text field.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Set</Term>
<ListItem>
<Para>A push button for setting Variable Name to the value in Value.
This value is set for Code Generator window functions only.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Reset</Term>
<ListItem>
<Para>A push button for resetting Value for Variable Name to its
value as set outside of the Code Generator.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Cancel</Term>
<ListItem>
<Para>A push button for cancelling any changes made to Value and
closing the Environment Options dialog box.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Help</Term>
<ListItem>
<Para>A push button for displaying on-item help for the dialog box.</Para>
</ListItem>
</VarListEntry>
</VariableList>
<Procedure>
<Title>See Also</Title>
<Step>
<ItemizedList Mark="&bull;" Role="tight">
<ListItem Id="H.REF.item.33">
<Para><XRef Linkend="ABCodeGenOptionsDialog"></Para>
</ListItem>
<ListItem Id="H.REF.item.34">
<Para><XRef Linkend="ABSetEnvironmentOptions">
</Para>
</ListItem>
</ItemizedList>
</Step>
</Procedure>
</Sect2>
<Sect2 Id="ABProjName">
<Title>Project Name Dialog Box</Title>
<Para>The Project Name dialog box is displayed when you choose New Project
from the File menu of the App Builder primary window or when you
choose New from the Module menu of the Project Organizer.</Para>
<Para>Type a name in the text field and click Apply.</Para>
<Para>Note that <Link Type="Definition" Linkend="ABProjectDef"> project </Link> names should
be all lower case.</Para>
<Para>&newline; &empty;
</Para>
<Graphic Entityref="NameProjectFig" Id="H.REF.fig.9"></Graphic>
</Sect2>
<Sect2 Id="ABModName">
<Title>Module Name Dialog Box</Title>
<Para>The Module Name dialog box is displayed when you select New Module from
the File menu or when you drag and drop a window on the desktop when
there is no current <Link Type="Definition" Linkend="ABModuleDef"> module</Link>.
Type a name in the text field and click Apply.</Para>
<Para>&newline; &empty;
</Para>
<Graphic Entityref="NameModuleFig" Id="H.REF.fig.10"></Graphic>
</Sect2>
<Sect2 Id="ABFileSelDialog">
<Title>File Selection Dialog Box</Title>
<Para>The File Selection dialog box title varies, depending on what function
is being performed (open, save, import, export), and different buttons
may be available, but the fields are the same on all file selection
dialog boxes.
&newline; &empty;
</Para>
<Graphic Entityref="FSDOpenProjectFig" Id="H.REF.fig.11"></Graphic>
<VariableList>
<VarListEntry>
<Term>Enter path or folder name</Term>
<ListItem>
<Para>A text field that indicates the current
folder (directory). If you change this field, it is updated when the
Update button is activated.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Filter</Term>
<ListItem>
<Para>A text field for specifying the filter to be applied to file
names. The filter for a project file, for example, is *.bi[px], which
means that only files that end in .bip or .bix will be lised in the
Files field. If you change this field, it is updated when the
Update button is activated.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Folders</Term>
<ListItem>
<Para>A scrolling list that lists the folders in the current
folder, which is displayed in the Enter path or folder name field. The
current folder is changed if you double-click on a folder name in the
Folders list or if you select a folder name and click Update. Note
that ".." is the UNIX designation for the folder level above the
current folder.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Files</Term>
<ListItem>
<Para>A scrolling list for selecting one of the files in
the current folder that pass the Filter test (all end in .bip in this
case). The selected file name is displayed in the Enter file name
field.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Enter file name</Term>
<ListItem>
<Para>is a text field for typing the name of the file
you wish to open, save, import, or export. If a file is selected in
the Files list, the file name is displayed here.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Open</Term>
<ListItem>
<Para>(or Save, Import, or Export) performs the specified action and
closes the file selection dialog box.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Update</Term>
<ListItem>
<Para>updates the fields in the file selection dialog box after you
have made changes; clicking Return when Update is the selected button
does the same thing.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Cancel</Term>
<ListItem>
<Para>closes the file selection dialog box.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Help</Term>
<ListItem>
<Para>displays on-line help information, if any, about the file
selection dialog box.</Para>
</ListItem>
</VarListEntry>
</VariableList>
<Procedure>
<Title>See Also</Title>
<Step>
<ItemizedList Mark="&bull;" Role="tight">
<ListItem Id="H.REF.item.35">
<Para><XRef Linkend="ABFSDFileSelect"></Para>
</ListItem>
</ItemizedList>
<!-- Start Comment; not clear if Message Dialogs is wanted. Should it
be included even if it is not comprehensive? If it includes only a
small percentage of all messages? Could all common and/or important
messages be determined and included? End Comment -->
</Step>
</Procedure>
</Sect2>
<Sect2 Id="ABMessages">
<Title>Message Dialog Boxes</Title>
<Para>Message dialog boxes are displayed in a number of circumstances, most
often serving as notification or warning about what will happen if a
specified action is performed.
</Para>
<Graphic Entityref="MsgProjUnsavedFig" Id="H.REF.fig.12"></Graphic>
<Para>In this example, you have attempted to close the current project
without saving some changes to the project.</Para>
<VariableList>
<VarListEntry>
<Term>Discard Changes</Term>
<ListItem>
<Para>A push button for specifying that you want to
discard any changes made to the current project and continue the Close
Project function.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Cancel</Term>
<ListItem>
<Para>A push button for specifying that you want to cancel the
Close Project operation.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Help</Term>
<ListItem>
<Para>A push button for requesting on-item help explaining the
message, if help is available.</Para>
</ListItem>
</VarListEntry>
</VariableList>
</Sect2>
<Sect2 Id="ABColorChooser">
<Title>Color Chooser Dialog Box</Title>
<IndexTerm>
<Primary>color chooser</Primary>
</IndexTerm>
<IndexTerm>
<Primary>background color</Primary>
</IndexTerm>
<IndexTerm>
<Primary>foreground color</Primary>
</IndexTerm>
<Para>The Color Chooser dialog is displayed when you choose Color Chooser
from the Color [Background or Foreground] options menu in a property
editor.</Para>
<Para>&newline; &empty;
</Para>
<Graphic Entityref="ColorChooserFig" Id="H.REF.fig.13"></Graphic>
<VariableList>
<VarListEntry>
<Term>[palette of colors]</Term>
<ListItem>
<Para>Drawn push buttons for selecting the background
or foreground color for the selected object in the property editor.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Color Name</Term>
<ListItem>
<Para>A label indicating the name of the color selected in the
palette of colors. This name also appears in the Color [Background or
Foreground] text field of the property editor.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>OK</Term>
<ListItem>
<Para>A push button for applying the selection of the selected color
and dismissing the Color Chooser dialog box.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Cancel</Term>
<ListItem>
<Para>A push button for cancelling the selection of a color and
dismissing the Color Chooser dialog box.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Help</Term>
<ListItem>
<Para>A push button for requesting on-item help explaining the
Color Chooser, if help is available.</Para>
</ListItem>
</VarListEntry>
</VariableList>
</Sect2>
</Sect1>
<Sect1 Id="ABMenus">
<Title>App Builder Menus</Title>
<ItemizedList Mark="&bull;" Role="tight">
<ListItem Id="H.REF.item.36">
<Para><XRef Linkend="ABFileMenu">
</Para>
</ListItem>
<ListItem Id="H.REF.item.37">
<Para><XRef Linkend="ABEditMenu">
</Para>
</ListItem>
<ListItem Id="H.REF.item.38">
<Para><XRef Linkend="ABViewMenu">
</Para>
</ListItem>
<ListItem Id="H.REF.item.39">
<Para><XRef Linkend="ABLayoutMenu">
</Para>
</ListItem>
<ListItem Id="H.REF.item.40">
<Para><XRef Linkend="ABEditorsMenu">
</Para>
</ListItem>
<ListItem Id="H.REF.item.41">
<Para><XRef Linkend="ABHelpMenu">
</Para>
</ListItem>
<ListItem Id="H.REF.item.42">
<Para><XRef Linkend="ABPopupMenu">
</Para>
</ListItem>
<ListItem Id="H.REF.item.43">
<Para><XRef Linkend="ABPopupMenuBrowser">
</Para>
</ListItem>
<ListItem Id="H.REF.item.44">
<Para><XRef Linkend="ABProjOrgProjMenu">
</Para>
</ListItem>
<ListItem Id="H.REF.item.45">
<Para><XRef Linkend="ABProjOrgModMenu">
</Para>
</ListItem>
<ListItem Id="H.REF.item.46">
<Para><XRef Linkend="ABBrowserEditMenu">
</Para>
</ListItem>
<ListItem Id="H.REF.item.47">
<Para><XRef Linkend="ABBrowserViewMenu">
</Para>
</ListItem>
<ListItem Id="H.REF.item.48">
<Para><XRef Linkend="ABCodeGenFileMenu">
</Para>
</ListItem>
<ListItem Id="H.REF.item.49">
<Para><XRef Linkend="ABCodeGenOptionsMenu">
</Para>
</ListItem>
</ItemizedList>
<Sect2 Id="ABFileMenu">
<Title>App Builder File Menu</Title>
<Para>&newline;&empty;
</Para>
<Para><InlineGraphic Remap="graphic" Role="left" Entityref="FileMenuFig"></InlineGraphic> &empty;
&newline; &empty; &newline; &empty; &newline; &empty;
<GlossTerm Role="nogloss">New Project</GlossTerm> opens a new
project. &newline;<GlossTerm Role="nogloss"> Open Project</GlossTerm> opens an existing project. &newline;<GlossTerm Role="nogloss"> Save Project</GlossTerm> saves the current project &newline;<GlossTerm Role="nogloss"> Save Project As</GlossTerm> saves the current project
using a different name or in a different folder; use also to
encapsulate a project into a single file. &newline;<GlossTerm Role="nogloss"> New Module</GlossTerm> creates a new module within the
current project. &newline;<GlossTerm Role="nogloss"> Import Module</GlossTerm> imports an existing module into
the current project. &newline;<GlossTerm Role="nogloss"> Export Module</GlossTerm> saves the selected module as a
standalone file in either BIL or UIL format, unconnected to the
current project. &newline;<GlossTerm Role="nogloss"> Code Generator</GlossTerm> opens the Code
Generator window. &newline;<GlossTerm Role="nogloss"> Project Organizer</GlossTerm> opens the Project
Organizer. &newline;<GlossTerm Role="nogloss"> Close Project</GlossTerm> closes the current
project. &newline;<GlossTerm Role="nogloss"> Exit</GlossTerm> quits App Builder.</Para>
<!-- Include xrefs to all tasks?
<link SaveEncap>  <\link> -->
<Procedure>
<Title>See Also</Title>
<Step>
<ItemizedList Mark="&bull;" Role="tight">
<ListItem Id="H.REF.item.50">
<Para><XRef Linkend="ABTasks">
</Para>
</ListItem>
</ItemizedList>
</Step>
</Procedure>
</Sect2>
<Sect2 Id="ABEditMenu">
<Title>App Builder Edit Menu</Title>
<Para>&newline; &empty;
The edit functions in the Edit menu, shown below, are also available
from the pop-up menus in the user interface and in the browser.</Para>
<Para><InlineGraphic Remap="graphic" Role="left" Entityref="EditMenuFig"></InlineGraphic>&newline; &empty; &newline; &empty; &newline; &empty;
<GlossTerm Role="nogloss">Undo</GlossTerm> undoes the last action in App Builder.
Actions that can be undone are: cut, delete, paste, group, ungroup,
move (object), and resize (object).
&newline;
<GlossTerm Role="nogloss"> Cut</GlossTerm> cuts the selected object and places it on the
App Builder clipboard. &newline;
<GlossTerm Role="nogloss"> Copy</GlossTerm> copies the selected object and places it
on the App Builder clipboard. &newline;
<GlossTerm Role="nogloss"> Paste</GlossTerm> pastes the object on the App Builder clipboard in the
selected window or pane if the selected window or pane is a
legitimate target. &newline;
<GlossTerm Role="nogloss"> Delete</GlossTerm> deletes the selected object; the object
is not placed on the App Builder clipboard. &newline;</Para>
<Procedure>
<Title>See Also</Title>
<Step>
<ItemizedList Mark="&bull;">
<ListItem Id="H.REF.item.51">
<Para><XRef Linkend="ABPopupMenu">
</Para>
</ListItem>
<ListItem Id="H.REF.item.52">
<Para><XRef Linkend="ABPopupMenuBrowser">
</Para>
</ListItem>
</ItemizedList>
</Step>
</Procedure>
</Sect2>
<Sect2 Id="ABViewMenu">
<Title>App Builder View Menu</Title>
<Para>&newline; &empty;
</Para>
<Para><InlineGraphic Remap="graphic" Role="left" Entityref="ViewMenuFig"></InlineGraphic>&newline; &empty; &newline; &empty; &newline; &empty;
<GlossTerm Role="nogloss">Module Browser</GlossTerm> brings up the Module Browser
to view modules hierarchically. Each of the shown current modules is
included in the submenu. The one you choose will be displayed
in the browser. &newline;<GlossTerm Role="nogloss">Next Layer</GlossTerm> displays the layer beneath the current
layer, if any. This item is inactive unless a layered pane is
selected. &newline;</Para>
<Procedure>
<Title>See Also</Title>
<Step>
<ItemizedList Mark="&bull;" Role="tight">
<ListItem Id="H.REF.item.53">
<Para><XRef Linkend="ABBrowser">
</Para>
</ListItem>
</ItemizedList>
</Step>
</Procedure>
</Sect2>
<Sect2 Id="ABLayoutMenu">
<Title>App Builder Layout Menu</Title>
<Para>&newline; &empty;</Para>
<Para><InlineGraphic Remap="graphic" Role="left" Entityref="LayoutMenuFig"></InlineGraphic>&newline; &empty; &newline; &empty; &newline; &empty;</Para>
<Para><GlossTerm Role="nogloss">Align</GlossTerm> displays an alignment tool; use to
temporarily align two or more selected control objects horizontally or
vertically. See<XRef Linkend="ABAlignObj"> for instructions. This item is
inactive if no control object is selected. &newline;<GlossTerm Role="nogloss">Distribute</GlossTerm> displays a tool for temporarily
adjusting the space between interface objects. See <XRef Linkend="ABDistObj">for instructions. This item is inactive if no control object is
selected. &newline;<GlossTerm Role="nogloss">Group</GlossTerm> combines two or more selected control
objects for a variety of purposes, including interface layout. See
<XRef Linkend="ABMakeGroup"> for instructions. This item is inactive if no
control object is selected. &newline;
<GlossTerm Role="nogloss">Ungroup</GlossTerm> ungroups the objects in the selected
group. See <XRef Linkend="ABUnGroupObj"> for instructions. This item is inactive
if no group is selected. &newline;<GlossTerm Role="nogloss">Make Paned Window</GlossTerm> makes a single, paned window
out of two or more selected panes. See <XRef Linkend="ABMakePanedWindow"> for
instructions. This item is inactive if no pane is selected. &newline;
<GlossTerm Role="nogloss">Unmake Paned Window</GlossTerm> "unmakes" a paned window,
leaving its constituent panes as separate objects. See <XRef Linkend="ABUnmakePanedWindow"> for instructions. This item is inactive if a
paned window is not selected. &newline;</Para>
<Procedure>
<Title>See Also</Title>
<Step>
<ItemizedList Mark="&bull;">
<ListItem Id="H.REF.item.54">
<Para><XRef Linkend="ABPopupMenu">
</Para>
</ListItem>
<ListItem Id="H.REF.item.55">
<Para><XRef Linkend="ABAlignObj"></Para>
</ListItem>
</ItemizedList>
</Step>
</Procedure>
</Sect2>
<Sect2 Id="ABEditorsMenu">
<Title>App Builder Editors Menu</Title>
<Para>&newline; &empty;
</Para>
<Para><InlineGraphic Remap="graphic" Role="left" Entityref="EditorsMenuFig"></InlineGraphic>&newline; &empty; &newline; &empty; &newline; &empty;
<GlossTerm Role="nogloss">Properties</GlossTerm> displays the <XRef Linkend="ABPropsEditor"> --
for changing properties of objects. &newline;<GlossTerm Role="nogloss"> Help</GlossTerm> displays the <XRef Linkend="ABHelpEditor"> -- for writing help
for objects in an interface. &newline;<GlossTerm Role="nogloss"> Menus</GlossTerm> displays the <XRef Linkend="ABMenusEditor"> -- for creating
menus. &newline;<GlossTerm Role="nogloss"> Connections</GlossTerm> displays the <XRef Linkend="ABConnectionsEditor"> --
for establishing programmatic connections between objects in an interface. &newline;<GlossTerm Role="nogloss"> Messages</GlossTerm> displays the <XRef Linkend="ABMessagesEditor"> -- for
creating pop-up message dialog boxes for error and other conditions. &newline;<GlossTerm Role="nogloss"> Groups</GlossTerm> displays the <XRef Linkend="ABGroupsEditor"> --
for grouping interface objects for layout purposes. &newline;<GlossTerm Role="nogloss"> Attachments</GlossTerm> displays the <XRef Linkend="ABAttachmentsEditor"> --
for attaching objects in an interface to each other for layout
purposes. &newline;<GlossTerm Role="nogloss"> Drag and Drop</GlossTerm> displays the <XRef Linkend="ABDragDropEditor">-- for establishing drag-and-drop behavior for interface objects. &newline;<GlossTerm Role="nogloss"> Application Framework</GlossTerm> displays the <XRef Linkend="ABAppFrameworkEditor"> -- for establishing settings for
Internationalization, Generated Code, Session Management, and
ToolTalk. &newline;</Para>
<Procedure>
<Title>See Also</Title>
<Step>
<ItemizedList Mark="&bull;">
<ListItem Id="H.REF.item.56">
<Para><XRef Linkend="ABEditors">
</Para>
</ListItem>
<ListItem Id="H.REF.item.57">
<Para><XRef Linkend="ABEditingProperties"></Para>
</ListItem>
</ItemizedList>
</Step>
</Procedure>
</Sect2>
<Sect2 Id="ABHelpMenu">
<Title>App Builder Help Menu</Title>
<Para>&newline; &empty;
</Para>
<Para><InlineGraphic Remap="graphic" Role="left" Entityref="HelpMenuFig"></InlineGraphic>&newline; &empty;
&newline; &empty;
&newline; &empty;
<GlossTerm Role="nogloss">Overview</GlossTerm> displays introductory information
about App Builder.&newline;<GlossTerm Role="nogloss">Tasks</GlossTerm> displays instructions for using App Builder.&newline;<GlossTerm Role="nogloss">Reference</GlossTerm> displays descriptive information about
App Builder components.&newline;<GlossTerm Role="nogloss">On Item</GlossTerm> changes the pointer to a question mark; click the
question mark pointer on an App Builder object for its description.&newline;<GlossTerm Role="nogloss">Using Help</GlossTerm> displays information about using Help.&newline;<GlossTerm Role="nogloss">About Application Builder</GlossTerm> displays version and copyright
information about App Builder.</Para>
</Sect2>
<Sect2 Id="ABPopupMenu">
<Title>App Builder User Interface Pop-up Menu</Title>
<Para>&newline; &empty;
The user interface pop-up menu, which is displayed when mouse button 3
is clicked or pressed in an interface window, is shown below.</Para>
<Para>&newline; &empty;
</Para>
<Para><InlineGraphic Remap="graphic" Role="left" Entityref="PopupMenuUIFig"></InlineGraphic>&newline; &empty;
<GlossTerm Role="nogloss">Props</GlossTerm> displays a property editor -- revolving or
fixed, depending on which item in the submenu you choose --
with the object selected in the interface selected in the property
editor. This item is inactive if no object or more than one
object is selected in the interface. &newline;<GlossTerm Role="nogloss">Browse</GlossTerm> displays the <XRef Linkend="ABBrowser">, with the objects
selected in the interface -- if any -- selected in the browser.&newline;
<GlossTerm Role="nogloss">Undo, Cut, Copy, Paste, Delete</GlossTerm>; see <XRef Linkend="ABEditMenu">.&newline;<GlossTerm Role="nogloss">Align</GlossTerm> displays an alignment tool; use to
temporarily align two or more selected control objects
horizontally or vertically. See<XRef Linkend="ABAlignObj"> for instructions.
This item is inactive if no control object is selected. &newline;
<GlossTerm Role="nogloss">Distribute</GlossTerm> displays a tool for temporarily
adjusting the space between interface objects. See <XRef Linkend="ABDistObj"> for
instructions. This item is inactive if no control object is selected. &newline;
<GlossTerm Role="nogloss">Group</GlossTerm> combines two or more selected control
objects for a variety of purposes, including interface layout. See
<XRef Linkend="ABMakeGroup"> for instructions. This item is inactive if no
control object is selected. &newline;
<GlossTerm Role="nogloss">Ungroup</GlossTerm> ungroups the objects in the selected group. See
<XRef Linkend="ABUnGroupObj"> for instructions. This item is inactive if no
group is selected. &newline;
<GlossTerm Role="nogloss">Make Paned Window</GlossTerm> makes a single, paned window
out of two or more selected panes. See <XRef Linkend="ABMakePanedWindow"> for
instructions. This item is inactive if no pane is selected. &newline;
<GlossTerm Role="nogloss">Unmake Paned Window</GlossTerm> "unmakes" a paned window,
leaving its constituent panes as separate objects. See <XRef Linkend="ABUnmakePanedWindow"> for instructions. This item is inactive if a
paned window is not selected. &newline;
<GlossTerm Role="nogloss">Attachments</GlossTerm> displays the <XRef Linkend="ABAttachmentsEditor">-- for attaching objects in an interface to each other for layout
purposes. This item is inactive if a window object is selected. &newline;
<GlossTerm Role="nogloss">NextLayer</GlossTerm> displays the next layer in a layered
pane; this item is inactive unless one of the panes of a layered pane
is selected. See <XRef Linkend="ABLayeredPaneNext">. &newline;</Para>
<Procedure>
<Title>See Also</Title>
<Step>
<ItemizedList Mark="&bull;">
<ListItem Id="H.REF.item.58">
<Para><XRef Linkend="ABPropsEditor">
</Para>
</ListItem>
<ListItem Id="H.REF.item.59">
<Para><XRef Linkend="ABMenus">
</Para>
</ListItem>
<ListItem Id="H.REF.item.60">
<Para><XRef Linkend="ABEditMenu">
</Para>
</ListItem>
<ListItem Id="H.REF.item.61">
<Para><XRef Linkend="ABMakeGroup">
</Para>
</ListItem>
<ListItem Id="H.REF.item.62">
<Para><XRef Linkend="ABMakePanedWindow">
</Para>
</ListItem>
</ItemizedList>
</Step>
</Procedure>
</Sect2>
<Sect2 Id="ABPopupMenuBrowser">
<Title>App Builder Module Browser Pop-up Menu</Title>
<Para>&newline; &empty;
The browser interface pop-up menu, which is displayed when mouse button 3
is clicked or pressed in the Module Browser, is shown below.</Para>
<Para>&newline; &empty;
</Para>
<Para><InlineGraphic Remap="graphic" Role="left" Entityref="PopupMenuBrowserFig"></InlineGraphic>&empty;
&newline; &empty; &newline; &empty;
<GlossTerm Role="nogloss">Props</GlossTerm> displays the property editor for the module
being displayed in the browser. &newline;<GlossTerm Role="nogloss">Tearoff Browser</GlossTerm> displays a new browser, enabling
you to view more than one module. &newline;
<GlossTerm Role="nogloss">Undo, Cut, Copy, Paste, Delete</GlossTerm>; see <XRef Linkend="ABEditMenu">. &newline;
<GlossTerm Role="nogloss">Group</GlossTerm> combines two or more selected control
objects for a variety of purposes, including interface layout. See
<XRef Linkend="ABMakeGroup"> for instructions. This item is inactive if no
control object is selected.&newline;
<GlossTerm Role="nogloss">Ungroup</GlossTerm> ungroups the objects in the selected group. See
<XRef Linkend="ABUnGroupObj"> for instructions. This item is inactive if no
group is selected. &newline;
<GlossTerm Role="nogloss">Make Paned Window</GlossTerm> makes a single, paned window
out of two or more selected panes. See <XRef Linkend="ABMakePanedWindow"> for
instructions. This item is inactive if no pane is selected. &newline;
<GlossTerm Role="nogloss">Unmake Paned Window</GlossTerm> "unmakes" a paned window,
leaving its constituent panes as separate objects. See <XRef Linkend="ABUnmakePanedWindow"> for instructions. This item is inactive if a
paned window is not selected. &newline;
<GlossTerm Role="nogloss">Attachments</GlossTerm> displays the <XRef Linkend="ABAttachmentsEditor">-- for attaching objects in an interface to each other for layout
purposes. This item is inactive if a window object is selected. &newline;
<GlossTerm Role="nogloss">Expand</GlossTerm> displays the children of selected
collapsed parent objects. &newline;
<GlossTerm Role="nogloss">Expand All</GlossTerm> expands all collapsed parent objects. &newline;
<GlossTerm Role="nogloss">Collapse</GlossTerm> "undisplays" the children of selected
parent object. This enables you to see more of the interface in a smaller
space. &newline;</Para>
</Sect2>
<Sect2 Id="ABProjOrgProjMenu">
<Title>App Builder Project Organizer Project Menu</Title>
<Para><InlineGraphic Remap="graphic" Role="left" Entityref="ProjOrgProjMenuFig"></InlineGraphic>&empty;
&newline; &empty; &newline; &empty; &newline; &empty;
<GlossTerm Role="nogloss">Open</GlossTerm> opens an existing project; same as Open
Project in App Builder primary window File menu. &newline;
<GlossTerm Role="nogloss">New</GlossTerm> creates a new project; same as New Project in App Builder
primary window File menu. &newline;<GlossTerm Role="nogloss">Save</GlossTerm> saves the current project; same as Save
Project in App Builder primary window File menu.&newline;
<GlossTerm Role="nogloss">Save As</GlossTerm> saves the current project
using a different name or in a different folder; use also to
encapsulate a project into a single file. Same as Save Project As in
App Builder primary window File menu. &newline;
<GlossTerm Role="nogloss">Close Project</GlossTerm> closes the current project; same as
Save Project As in App Builder primary window File menu. &newline;
<GlossTerm Role="nogloss">Close</GlossTerm> closes the Project Organizer.&newline;</Para>
</Sect2>
<Sect2 Id="ABProjOrgModMenu">
<Title>App Builder Project Organizer Module Menu</Title>
<Para><InlineGraphic Remap="graphic" Role="left" Entityref="ProjOrgModMenuFig"></InlineGraphic>&empty;
&newline; &empty; &newline; &empty; &newline; &empty;
<GlossTerm Role="nogloss">New</GlossTerm> creates a new module within the current
project; same as New Module in App Builder primary window File
menu.&newline;<GlossTerm Role="nogloss">Save</GlossTerm> saves the selected module if it has changed
since the last time it was saved. &newline;
<GlossTerm Role="nogloss">Save As</GlossTerm> renames the selected module. &newline;
<GlossTerm Role="nogloss">Show</GlossTerm> displays the interface for the selected
modules. &newline;
<GlossTerm Role="nogloss">Hide</GlossTerm> hides the interface for the selected
modules. &newline;
<GlossTerm Role="nogloss">Browse</GlossTerm> displays the Module Browser for the
selected modules. If more than one module is selected, a separate
browser is displayed for each selected module.&newline;
<GlossTerm Role="nogloss">Import</GlossTerm> imports an existing module into the
current project; same as Import Module in App Builder primary window
File menu. &newline;
<GlossTerm Role="nogloss">Export</GlossTerm> saves the selected module as a standalone
file in either BIL or UIL format, unconnected to the current project;
same as Export Module in App Builder primary window File menu.
&newline;<GlossTerm Role="nogloss">Remove</GlossTerm> removes the selected modules from the
current project. &newline;</Para>
<Procedure>
<Title>See Also</Title>
<Step>
<ItemizedList Mark="&bull;" Role="tight">
<ListItem Id="H.REF.item.63">
<Para><XRef Linkend="ABModOpenNew">
</Para>
</ListItem>
</ItemizedList>
</Step>
</Procedure>
</Sect2>
<Sect2 Id="ABBrowserEditMenu">
<Title>App Builder Module Browser Edit Menu</Title>
<Para>This is the same as the Edit menu in the App Builder primary window.
Objects can be selected in the Module Browser and edited just as they are in
the interface.
</Para>
<Para><InlineGraphic Remap="graphic" Role="left" Entityref="BrowserEditMenuFig"></InlineGraphic>&empty;
&newline; &empty; &newline; &empty;&newline; &empty;
<GlossTerm Role="nogloss">Undo</GlossTerm> undoes the last action in App Builder;
actions that can be undone are: cut, delete, paste, group, ungroup,
move (object), and resize (object).
&newline;
<GlossTerm Role="nogloss"> Cut</GlossTerm> cuts the selected object and places it on the
App Builder clipboard. &newline;
<GlossTerm Role="nogloss"> Copy</GlossTerm> copies the selected object and places it
on the App Builder clipboard. &newline;
<GlossTerm Role="nogloss"> Paste</GlossTerm> pastes the object on the App Builder clipboard in the
selected window or pane if the selected window or pane is a
legitimate target. &newline;
<GlossTerm Role="nogloss"> Delete</GlossTerm> deletes the selected object; the object
is not placed on the App Builder clipboard. &newline;</Para>
</Sect2>
<Sect2 Id="ABBrowserViewMenu">
<Title>App Builder Module Browser View Menu</Title>
<Para><InlineGraphic Remap="graphic" Role="left" Entityref="BrowserViewMenuFig"></InlineGraphic>&empty;
&newline; &empty; &newline; &empty; &newline; &empty;
<GlossTerm Role="nogloss">Horizontal</GlossTerm> 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. &newline;<GlossTerm Role="nogloss">Hide Object Glyph</GlossTerm> hides the icons/glyphs that
represent the objects in the interface. Toggles with Show Object
Glyph, which is the default. &newline;
<GlossTerm Role="nogloss">Show Object Type</GlossTerm> displays the object types of
objects in the interface. Toggles with Hide Object Type, which is the
default. &newline;
<GlossTerm Role="nogloss">Collapse</GlossTerm> "undisplays" the children of selected
parent objects. This enables you to see more of the interface in a smaller
space.&newline;
<GlossTerm Role="nogloss">Expand</GlossTerm> displays the children of selected
collapsed parent objects. &newline;
<GlossTerm Role="nogloss">Expand All</GlossTerm> expands all collapsed parent objects. &newline;
<GlossTerm Role="nogloss">Module</GlossTerm> displays the module chosen from the
submenu. &newline;
<GlossTerm Role="nogloss">Find</GlossTerm> 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. &newline;
<GlossTerm Role="nogloss">Tearoff Browser</GlossTerm> displays a new browser, enabling
you to view more than one module. &newline;</Para>
</Sect2>
<Sect2 Id="ABCodeGenFileMenu">
<Title>App Builder Code Generator File Menu</Title>
<Para>&newline; &empty;
</Para>
<Para><InlineGraphic Remap="graphic" Role="left" Entityref="CodeGenFileMenuFig"></InlineGraphic>&newline; &empty; &newline; &empty; &newline; &empty;
<GlossTerm Role="nogloss">Make & Run</GlossTerm> <Emphasis>makes</Emphasis> the project
according to the <ComputerOutput>Makefile</ComputerOutput> in the project folder
and runs the executable. Creates a <ComputerOutput>Makefile</ComputerOutput> if
none exists&newline;<GlossTerm Role="nogloss">Generate Code</GlossTerm> generates C code for the entire
project, if Entire Project submenu item is selected, or for
whatever is specified in the Code Generator Options dialog box, if
According to Options submenu item is selected. &newline; <GlossTerm Role="nogloss">Make</GlossTerm> <Emphasis>makes</Emphasis> the project according to the
<ComputerOutput>Makefile</ComputerOutput> in the project folder. Creates a
<ComputerOutput>Makefile</ComputerOutput> if none exists. &newline;<GlossTerm Role="nogloss">Run</GlossTerm> runs the executable for the current project,
if it exists. If it does not exist, a message dialog box is displayed, giving
you the option of cancelling the Run operation or to build the
application and then Run. If you click Build, the project will be
compiled and run, just as if you had selected Make & Run. &newline;
<GlossTerm Role="nogloss">Abort</GlossTerm> aborts the current process. Abort is
inactive if no Code Generator process is running. &newline;
<GlossTerm Role="nogloss">CD to Project</GlossTerm> changes the folder (directory)
location in the Term Pane at the bottom of the Code Generator window
to location of the current project. Used when the current project is
in a different folder than the folder in which App Builder was opened.
&newline;
<GlossTerm Role="nogloss">Close</GlossTerm> closes the Code Generator window. &newline;</Para>
</Sect2>
<Sect2 Id="ABCodeGenOptionsMenu">
<Title>App Builder Code Generator Options Menu</Title>
<Para>&newline; &empty;
</Para>
<Para><InlineGraphic Remap="graphic" Role="left" Entityref="CodeGenOptionsMenuFig"></InlineGraphic>&newline; &empty; &newline; &empty; &newline; &empty;
<GlossTerm Role="nogloss">Generator</GlossTerm> displays the Code Generator Options
dialog, for specifying what code is generated when Generate Code is
selected in the Code Generator window, whether code is merged,
and what arguments should be included when Make or Run are selected.
&newline;
<GlossTerm Role="nogloss">Environment</GlossTerm> displays the Environment Options
dialog box, used to set variables to be used when performing functions in
the Code Generator window. &newline;</Para>
<Procedure>
<Title>See Also</Title>
<Step>
<ItemizedList Mark="&bull;" Role="tight">
<ListItem Id="H.REF.item.64">
<Para><XRef Linkend="ABSetCodeGenOptions"></Para>
</ListItem>
<ListItem Id="H.REF.item.65">
<Para><XRef Linkend="ABSetEnvironmentOptions"></Para>
</ListItem>
</ItemizedList>
</Step>
</Procedure>
</Sect2>
</Sect1>
<Sect1 Id="ABEditors">
<Title>App Builder Editors</Title>
<IndexTerm>
<Primary>editors</Primary>
</IndexTerm>
<Para>&newline;&empty;</Para>
<ItemizedList Mark="&bull;" Role="tight">
<ListItem Id="H.REF.item.66">
<Para><XRef Linkend="ABPropsEditor">
</Para>
</ListItem>
<ListItem Id="H.REF.item.67">
<Para><XRef Linkend="ABIndPropertyEditors">
</Para>
</ListItem>
<ListItem Id="H.REF.item.68">
<Para><XRef Linkend="ABHelpEditor"></Para>
</ListItem>
<ListItem Id="H.REF.item.69">
<Para><XRef Linkend="ABMenusEditor"></Para>
</ListItem>
<ListItem Id="H.REF.item.70">
<Para><XRef Linkend="ABConnectionsEditor"></Para>
</ListItem>
<ListItem Id="H.REF.item.71">
<Para><XRef Linkend="ABMessagesEditor"></Para>
</ListItem>
<ListItem Id="H.REF.item.72">
<Para><XRef Linkend="ABGroupsEditor"></Para>
</ListItem>
<ListItem Id="H.REF.item.73">
<Para><XRef Linkend="ABAttachmentsEditor"></Para>
</ListItem>
<ListItem Id="H.REF.item.74">
<Para><XRef Linkend="ABDragDropEditor"></Para>
</ListItem>
<ListItem Id="H.REF.item.75">
<Para><XRef Linkend="ABAppFrameworkEditor"></Para>
</ListItem>
</ItemizedList>
<Sect2 Id="ABPropsEditor">
<Title>Revolving Property Editor</Title>
<Para>&newline; &empty; Used to edit the <Emphasis>properties</Emphasis> (look and
functionality) of interface objects, property editors enable you to
customize your application interface. The property editor for a
separator, which includes the properties common to almost all property
editors, is shown below. See <XRef Linkend="ABCommonProps"> for descriptions of
these common properties. Note that the Group and Menu property editors
are described in this section, even though they are included in the
Editors menu of the App Builder primary window.</Para>
<Para>&newline; &empty;
</Para>
<Graphic Entityref="PropEdSepFig" Id="H.REF.fig.14"></Graphic>
<Procedure>
<Title>See Also</Title>
<Step>
<ItemizedList Mark="&bull;" Role="tight">
<ListItem Id="H.REF.item.76">
<Para><XRef Linkend="ABCommonProps">
</Para>
</ListItem>
<ListItem Id="H.REF.item.77">
<Para><XRef Linkend="ABOtherCommonProps">
</Para>
</ListItem>
<ListItem Id="H.REF.item.78">
<Para><XRef Linkend="ABCommonButtons">
</Para>
</ListItem>
<ListItem Id="H.REF.item.79">
<Para><XRef Linkend="ABIndPropertyEditors">
</Para>
</ListItem>
</ItemizedList>
</Step>
</Procedure>
<Sect3 Id="ABCommonProps">
<Title>Property Editor: Universal Properties</Title>
<IndexTerm>
<Primary>object type</Primary>
</IndexTerm>
<IndexTerm>
<Primary>objects list</Primary>
</IndexTerm>
<IndexTerm>
<Primary>object name</Primary>
</IndexTerm>
<IndexTerm>
<Primary>initial state</Primary>
</IndexTerm>
<IndexTerm>
<Primary>color chooser</Primary>
</IndexTerm>
<IndexTerm>
<Primary>background color</Primary>
</IndexTerm>
<IndexTerm>
<Primary>foreground color</Primary>
</IndexTerm>
<IndexTerm>
<Primary>active initial state</Primary>
</IndexTerm>
<IndexTerm>
<Primary>inactive initial state</Primary>
</IndexTerm>
<IndexTerm>
<Primary>invisible initial state</Primary>
</IndexTerm>
<IndexTerm>
<Primary>visible initial state</Primary>
</IndexTerm>
<Para>The property editor for each of the App Builder objects is unique, but
there are a number of properties common to almost all of them.
</Para>
<VariableList>
<VarListEntry>
<Term>Object Type</Term>
<ListItem>
<Para>An option menu for choosing the type of property editor
to be displayed. Properties change depending on which object type is
chosen.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Objects [list]</Term>
<ListItem>
<Para>Lists the objects of the selected type in
the current project. The list displays the full, unique name for each
object, which is comprised of the name of the module in which the object
exists, two colons, and the Object Name.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Object Name</Term>
<ListItem>
<Para>Displays the default name or the name
given by you to the object selected in the Objects list.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Initial State, Visible</Term>
<ListItem>
<Para>Specifies whether the
selected object is visible when the application starts up; all objects
except a custom dialog are visible by default.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Initial State, Active</Term>
<ListItem>
<Para>A check box for specifying whether the object
selected is "active" when the application starts up. An inactive
object is not functional: it is dimmed and no functions can be
activated from the object.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Color &sigspace;-- &sigspace; Background</Term>
<ListItem>
<Para>Specifies the background
color of the selected object. You can either type in a known color
name or choose Color Chooser from the menu and select a color from the
palette displayed.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Color &sigspace; -- &sigspace; Foreground</Term>
<ListItem>
<Para>Specifies the foreground
color of the selected object. You can either type in a known color
name or choose Color Chooser from the menu and select a color from the
palette displayed.</Para>
</ListItem>
</VarListEntry>
</VariableList>
<Procedure>
<Title>See Also</Title>
<Step>
<ItemizedList Mark="&bull;" Role="tight">
<ListItem Id="H.REF.item.80">
<Para><XRef Linkend="ABOtherCommonProps">
</Para>
</ListItem>
<ListItem Id="H.REF.item.81">
<Para><XRef Linkend="ABCommonButtons">
</Para>
</ListItem>
<ListItem Id="H.REF.item.82">
<Para><XRef Linkend="ABIndPropertyEditors">
</Para>
</ListItem>
</ItemizedList>
</Step>
</Procedure>
</Sect3>
<Sect3 Id="ABOtherCommonProps">
<Title>Property Editor: Common Properties</Title>
<IndexTerm>
<Primary>border frame</Primary>
</IndexTerm>
<IndexTerm>
<Primary>geometry</Primary>
</IndexTerm>
<IndexTerm>
<Primary>graphic filename</Primary>
</IndexTerm>
<IndexTerm>
<Primary>items, property editor</Primary>
</IndexTerm>
<IndexTerm>
<Primary>label</Primary>
</IndexTerm>
<IndexTerm>
<Primary>label position</Primary>
</IndexTerm>
<IndexTerm>
<Primary>label type</Primary>
</IndexTerm>
<IndexTerm>
<Primary>menu title</Primary>
</IndexTerm>
<IndexTerm>
<Primary>pop-up menu</Primary>
</IndexTerm>
<IndexTerm>
<Primary>position, label</Primary>
</IndexTerm>
<IndexTerm>
<Primary>position, xy</Primary>
</IndexTerm>
<IndexTerm>
<Primary>scroll bars</Primary>
</IndexTerm>
<IndexTerm>
<Primary>size policy</Primary>
</IndexTerm>
<IndexTerm>
<Primary>size, W,H</Primary>
</IndexTerm>
<Para>The following properties are common to three or more property editors.
</Para>
<VariableList>
<VarListEntry>
<Term>Border Frame</Term>
<ListItem>
<Para>Determines the type of border, if any,
around certain objects. Choices are None, Shadow Out, Shadow In,
Etched Out, and Etched In.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Geometry</Term>
<ListItem>
<Para>Indicates the X and Y location of the selected
object, and the W(idth) and H(eight) of the object. X and Y values
specify the position of the selected object in relation to its
parent. The values are in pixels and are measured from the top-left
corner of the parent object to the top-left corner of the child
object. W and H values are in pixels.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Graphic Filename</Term>
<ListItem>
<Para>Indicates the name of the pixmap
(.pm) or bitmap (.bm) file that contains the graphic to be used as the
label for the selected object or item. This property is available only
if Label Type or Item Label Type is "Graphic."</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Item Label Type</Term>
<ListItem>
<Para>Specifies the type of label
(String or Graphic) for the selected item in the Items list. If
Graphic is chosen, "Label" becomes "Graphic Filename."</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Item State, Active</Term>
<ListItem>
<Para>Specifies whether the selected
item will be active when the compiled application is
opened.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Items</Term>
<ListItem>
<Para>Lists the labels that represent the items in the
list. When an item is selected in the Items list, its label is
displayed in the Label or Graphic Filename field.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Label</Term>
<ListItem>
<Para>Specifies the label for the selected object or
item. "Label" becomes "Graphic Filename" if Graphic Label Type is
chosen. Label is inactive in the Button property editor if Arrow Label
Type is chosen.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Label Type</Term>
<ListItem>
<Para>Specifies the type of label (String, Graphic, or Arrow)
for the selected object. If Graphic is chosen, "Label" becomes
"Graphic Filename." If you choose Arrow, the label in the Button
property editor becomes an arrow and the Arrow Direction property
becomes active.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Menu Title</Term>
<ListItem>
<Para>Specifies the (optional) title of the
pop-up menu, if any.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Popup or Pulldown Menu</Term>
<ListItem>
<Para>A menu button and a text field for creating,
attaching, de-attaching, or editing a pop-up or pull-down menu for the
selected object. When the Menus button is clicked, a menu with four
choices (None, Create New Menu, Menus, Edit Current) is displayed.
Menus and Edit Current are inactive if no menus exist in the current
project. If a menu is already attached to the selected object, the
menu name will be displayed in the text field.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Position [Label]</Term>
<ListItem>
<Para>Specifies the position (Left
or Above) of the label in relation to the selected object. This
Position option menu is next to the Label Type option menu.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Position [XY]</Term>
<ListItem>
<Para>Indicates the X and Y location of the selected
object in relation to its parent. The values are in pixels and are
measured from the top-left corner of the parent object to the top-left
corner of the child object.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Scrollbars</Term>
<ListItem>
<Para>Specifies when scroll bars should be
attached to the selected pane. The choices are Never and Always for a
term pane or a text pane, and Never, When Needed, and Always for a
draw area pane.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Size</Term>
<ListItem>
<Para>Specifies the absolute W(idth) and H(eight) of the window or
pane. These values change if you resize the window or pane manually in
the interface. For a term pane or a text pane, there is an option menu
for choosing Characters or Pixels as the unit value.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Size Policy</Term>
<ListItem>
<Para>Specifies whether the selected
object should retain a fixed size or if it should become bigger or
smaller depending on the contents of the object. The choices are Size
of Label and Fixed for buttons and labels, Fit Contents and Fixed for
main windows and custom dialogs.</Para>
</ListItem>
</VarListEntry>
</VariableList>
<Procedure>
<Title>See Also</Title>
<Step>
<ItemizedList Mark="&bull;" Role="tight">
<ListItem Id="H.REF.item.83">
<Para><XRef Linkend="ABCommonProps">
</Para>
</ListItem>
<ListItem Id="H.REF.item.84">
<Para><XRef Linkend="ABCommonButtons">
</Para>
</ListItem>
<ListItem Id="H.REF.item.85">
<Para><XRef Linkend="ABIndPropertyEditors">
</Para>
</ListItem>
</ItemizedList>
</Step>
</Procedure>
</Sect3>
<Sect3 Id="ABCommonButtons">
<Title>Property Editor: Common Buttons</Title>
<IndexTerm>
<Primary>tear-off property editor</Primary>
</IndexTerm>
<IndexTerm>
<Primary>attachments editor button</Primary>
</IndexTerm>
<IndexTerm>
<Primary>help editor button</Primary>
</IndexTerm>
<IndexTerm>
<Primary>connections button</Primary>
</IndexTerm>
<IndexTerm>
<Primary>ok button</Primary>
</IndexTerm>
<IndexTerm>
<Primary>apply button</Primary>
</IndexTerm>
<IndexTerm>
<Primary>reset button</Primary>
</IndexTerm>
<IndexTerm>
<Primary>cancel button</Primary>
</IndexTerm>
<IndexTerm>
<Primary>help button</Primary>
</IndexTerm>
<Para>The following functional push buttons or menu buttons are common to
many property editors. The buttons at the bottom of the property
editors (OK, Apply, Reset, Cancel, and Help) are common to other
editors and dialog boxes.
</Para>
<VariableList>
<VarListEntry>
<Term>Tear-off</Term>
<ListItem>
<Para>Displays a property editor of the selected type; use this
when you want to edit a specific object type while viewing other types
of objects in the Revolving Property Editor.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Add Item</Term>
<ListItem>
<Para>Adds an item after the selected item in
the Items list. Added items are given default names starting with
"Item1" and incrementing, as needed. By default, items are added after
the selected item.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Edit</Term>
<ListItem>
<Para>Performs edit functions (Add After, Add
Before, Change, Cut, Copy, Paste, Delete) in a list. Add After and Add
Before add an item to the list either after or before the selected
item. Change applies the change that you have made. Cut, Copy, Paste
and Delete act on the selected item, in the normal way: Cut and Copy
place the selected item in a buffer, ready for Paste. Delete removes
the item, but does not place it in a buffer.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Attachments</Term>
<ListItem>
<Para>Displays the <XRef Linkend="ABAttachmentsEditor">; there is no
Attachments button on the Main Window, Menubar, Custom Dialog, and
Paned Window property editors.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Help Text</Term>
<ListItem>
<Para>Displays the <XRef Linkend="ABHelpEditor">.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Connections</Term>
<ListItem>
<Para>Displays the <XRef Linkend="ABConnectionsEditor">.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>OK</Term>
<ListItem>
<Para>Applies the changes made to the selected object and
dismisses the editor; changes made are marked with change
bars at the left side of the editor.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Apply</Term>
<ListItem>
<Para>Applies the changes made to the selected object,
but does not dismiss the editor.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Reset</Term>
<ListItem>
<Para>Resets all changes made since the last Apply.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Cancel</Term>
<ListItem>
<Para>Resets all changes made since the last Apply and dismisses the
editor.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Help</Term>
<ListItem>
<Para>Displays on-item help for the editor.</Para>
</ListItem>
</VarListEntry>
</VariableList>
<Procedure>
<Title>See Also</Title>
<Step>
<ItemizedList Mark="&bull;" Role="tight">
<ListItem Id="H.REF.item.86">
<Para><XRef Linkend="ABCommonProps">
</Para>
</ListItem>
<ListItem Id="H.REF.item.87">
<Para><XRef Linkend="ABOtherCommonProps">
</Para>
</ListItem>
<ListItem Id="H.REF.item.88">
<Para><XRef Linkend="ABIndPropertyEditors">
</Para>
</ListItem>
</ItemizedList>
</Step>
</Procedure>
</Sect3>
</Sect2>
<Sect2 Id="ABIndPropertyEditors">
<Title>Individual Property Editors</Title>
<Para>An individual property editor is displayed by double-clicking on an
object in the interface or the browser, by selecting an object of the
desired type and choosing Properties from the Editors menu on the App
Builder primary window or choosing Props from the interface or browser
pop-up menu, or by choosing the desired object type from the options
menu at the top of the Revolving Property Editor.
</Para>
<ItemizedList Mark="&bull;" Role="tight">
<ListItem Id="H.REF.item.89">
<Para><XRef Linkend="ABPropEdButton">
</Para>
</ListItem>
<ListItem Id="H.REF.item.90">
<Para><XRef Linkend="ABPropEdChoice">
</Para>
</ListItem>
<ListItem Id="H.REF.item.91">
<Para><XRef Linkend="ABPropEdCombobox">
</Para>
</ListItem>
<ListItem Id="H.REF.item.92">
<Para><XRef Linkend="ABPropEdControlPane">
</Para>
</ListItem>
<ListItem Id="H.REF.item.93">
<Para><XRef Linkend="ABPropEdCustomDialog">
</Para>
</ListItem>
<ListItem Id="H.REF.item.94">
<Para><XRef Linkend="ABPropEdDrawAreaPane">
</Para>
</ListItem>
<ListItem Id="H.REF.item.95">
<Para><XRef Linkend="ABPropEdFileSelection">
</Para>
</ListItem>
<ListItem Id="H.REF.item.96">
<Para><XRef Linkend="ABGroupsEditor">
</Para>
</ListItem>
<ListItem Id="H.REF.item.97">
<Para><XRef Linkend="ABPropEdLabel">
</Para>
</ListItem>
<ListItem Id="H.REF.item.98">
<Para><XRef Linkend="ABPropEdList">
</Para>
</ListItem>
<ListItem Id="H.REF.item.99">
<Para><XRef Linkend="ABPropEdMainWindow">
</Para>
</ListItem>
<ListItem Id="H.REF.item.100">
<Para><XRef Linkend="ABMenusEditor">
</Para>
</ListItem>
<ListItem Id="H.REF.item.101">
<Para><XRef Linkend="ABPropEdMenubar">
</Para>
</ListItem>
<ListItem Id="H.REF.item.102">
<Para><XRef Linkend="ABPropEdPanedWindow">
</Para>
</ListItem>
<ListItem Id="H.REF.item.103">
<Para><XRef Linkend="ABPropEdScale">
</Para>
</ListItem>
<ListItem Id="H.REF.item.104">
<Para><XRef Linkend="ABPropEdSeparator">
</Para>
</ListItem>
<ListItem Id="H.REF.item.105">
<Para><XRef Linkend="ABPropEdSpinbox">
</Para>
</ListItem>
<ListItem Id="H.REF.item.106">
<Para><XRef Linkend="ABPropEdTermPane">
</Para>
</ListItem>
<ListItem Id="H.REF.item.107">
<Para><XRef Linkend="ABPropEdTextField">
</Para>
</ListItem>
<ListItem Id="H.REF.item.108">
<Para><XRef Linkend="ABPropEdTextPane"></Para>
</ListItem>
</ItemizedList>
<Procedure>
<Title>See Also</Title>
<Step>
<ItemizedList Mark="&bull;" Role="tight">
<ListItem Id="H.REF.item.109">
<Para><XRef Linkend="ABCommonProps">
</Para>
</ListItem>
<ListItem Id="H.REF.item.110">
<Para><XRef Linkend="ABOtherCommonProps">
</Para>
</ListItem>
</ItemizedList>
</Step>
</Procedure>
<Sect3 Id="ABPropEdButton">
<Title>Button Property Editor</Title>
<IndexTerm>
<Primary>button property editor</Primary>
</IndexTerm>
<IndexTerm>
<Primary>drawn button property editor</Primary>
</IndexTerm>
<IndexTerm>
<Primary>menu button property editor</Primary>
</IndexTerm>
<IndexTerm>
<Primary>push button property editor</Primary>
</IndexTerm>
<IndexTerm>
<Primary>property editor</Primary>
</IndexTerm>
<IndexTerm>
<Primary>button type</Primary>
</IndexTerm>
<IndexTerm>
<Primary>button: drawn, menu, push</Primary>
</IndexTerm>
<IndexTerm>
<Primary>drawn button</Primary>
</IndexTerm>
<IndexTerm>
<Primary>menu button</Primary>
</IndexTerm>
<IndexTerm>
<Primary>push button</Primary>
</IndexTerm>
<IndexTerm>
<Primary>label alignment</Primary>
</IndexTerm>
<IndexTerm>
<Primary>arrow direction</Primary>
</IndexTerm>
<IndexTerm>
<Primary>pull-down menu</Primary>
</IndexTerm>
<Para>Only properties unique to a button object are described here. See <XRef Linkend="ABCommonProps"> for descriptions of Object Type, Objects, Object Name,
Initial State, and Color. See <XRef Linkend="ABOtherCommonProps"> for
descriptions of Label Type, Label, Size Policy, and Geometry.</Para>
<VariableList>
<VarListEntry>
<Term>Button Type</Term>
<ListItem>
<Para>Specifies what kind of button (Push,
Drawn, Menu) the selected button should be. Push button is the
default. Selecting Menu transforms the push button into a menu button,
as if you had dragged and dropped a menu button from the controls
palette. The Pulldown Menu property becomes active if you select Menu. See
<XRef Linkend="ABControlsPalette"> for descriptions of button types.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Label Alignment</Term>
<ListItem>
<Para>Specifies the alignment (Left,
Right, Centered) of the button label within the button border frame.
Label Alignment is relevant only if Fixed is selected as Size Policy.
This menu is inactive if Arrow Label Type is chosen.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Arrow Direction</Term>
<ListItem>
<Para>Specifies which direction (Up,
Down, Left, Right) the arrow should point if Arrow Label Type is
chosen.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Pulldown Menu</Term>
<ListItem>
<Para>A menu button (labelled "Menus") and a text field for
creating, attaching, de-attaching, or editing a menu for the selected
button. Active only if Menu Button Type is chosen. When the Menus
button is clicked, a menu with four choices (None, Create New Menu,
Menus, Edit Current) is displayed. Menus and Edit Current items are
inactive if no menus exist in the current project. If a menu is
already attached to the selected button, the menu name will be
displayed in the text field.</Para>
</ListItem>
</VarListEntry>
</VariableList>
<Procedure>
<Title>See Also</Title>
<Step>
<ItemizedList Mark="&bull;" Role="tight">
<ListItem Id="H.REF.item.111">
<Para><XRef Linkend="ABControlsPalette">
</Para>
</ListItem>
<ListItem Id="H.REF.item.112">
<Para><XRef Linkend="ABCommonProps">
</Para>
</ListItem>
<ListItem Id="H.REF.item.113">
<Para><XRef Linkend="ABOtherCommonProps">
</Para>
</ListItem>
<ListItem Id="H.REF.item.114">
<Para><XRef Linkend="ABCommonButtons">
</Para>
</ListItem>
<ListItem Id="H.REF.item.115">
<Para><XRef Linkend="ABCreateMenu">
</Para>
</ListItem>
</ItemizedList>
</Step>
</Procedure>
</Sect3>
<Sect3 Id="ABPropEdChoice">
<Title>Choice Property Editor</Title>
<IndexTerm>
<Primary>choice property editor</Primary>
</IndexTerm>
<IndexTerm>
<Primary>option menu property editor</Primary>
</IndexTerm>
<IndexTerm>
<Primary>radio box property editor</Primary>
</IndexTerm>
<IndexTerm>
<Primary>property editor</Primary>
</IndexTerm>
<IndexTerm>
<Primary>property editor, combo box</Primary>
</IndexTerm>
<IndexTerm>
<Primary>property editor, option menu</Primary>
</IndexTerm>
<IndexTerm>
<Primary>property editor, radio box</Primary>
</IndexTerm>
<IndexTerm>
<Primary>choice type</Primary>
</IndexTerm>
<IndexTerm>
<Primary>rows/columns</Primary>
</IndexTerm>
<IndexTerm>
<Primary>columns, choice property editor</Primary>
</IndexTerm>
<IndexTerm>
<Primary>item state, choice property editor</Primary>
</IndexTerm>
<IndexTerm>
<Primary>active item</Primary>
</IndexTerm>
<IndexTerm>
<Primary>selected item</Primary>
</IndexTerm>
<IndexTerm>
<Primary>item, active</Primary>
</IndexTerm>
<IndexTerm>
<Primary>item, selected</Primary>
</IndexTerm>
<Para>Only properties unique to a choice object (Radio Box, Check Box,
Option Menu) are described here. See <XRef Linkend="ABCommonProps"> for
descriptions of Object Type, Objects, Object Name, Initial State, and
Color. See <XRef Linkend="ABOtherCommonProps"> for descriptions of Label Type,
[Label] Position, Label, Items, [Item] Label, Item State (Active), and
Position [XY].</Para>
<VariableList>
<VarListEntry>
<Term>Choice Type</Term>
<ListItem>
<Para>Specifies which type of choice
object (Radio Box, Check Box, or Option Menu) the selected object
should be. The object changes form depending on which you choose. Note
that there is a control object for each of the choice types in the
Controls palette. See <XRef Linkend="ABControlsPalette"> for descriptions of
choice types.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Rows/Columns</Term>
<ListItem>
<Para>Specifies whether the radio box or check box should be
laid out in rows or columns, and how many rows or columns there should
be. Not relevant for an option menu.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Item State, Selected</Term>
<ListItem>
<Para>Specifies whether the
selected item will be selected when the compiled application is
opened. Only one item can be selected. For a check box or a radio box
object, the selected item will be marked as selected; for an option
menu, the label for the selected object will be displayed in the
option menu when the application is opened.</Para>
</ListItem>
</VarListEntry>
</VariableList>
<Procedure>
<Title>See Also</Title>
<Step>
<ItemizedList Mark="&bull;" Role="tight">
<ListItem Id="H.REF.item.116">
<Para><XRef Linkend="ABControlsPalette">
</Para>
</ListItem>
<ListItem Id="H.REF.item.117">
<Para><XRef Linkend="ABCommonProps">
</Para>
</ListItem>
<ListItem Id="H.REF.item.118">
<Para><XRef Linkend="ABOtherCommonProps">
</Para>
</ListItem>
<ListItem Id="H.REF.item.119">
<Para><XRef Linkend="ABCommonButtons">
</Para>
</ListItem>
</ItemizedList>
</Step>
</Procedure>
</Sect3>
<Sect3 Id="ABPropEdCombobox">
<Title>Combo Box Property Editor</Title>
<IndexTerm>
<Primary>combo box property editor</Primary>
</IndexTerm>
<IndexTerm>
<Primary>property editor</Primary>
</IndexTerm>
<IndexTerm>
<Primary>combo box type</Primary>
</IndexTerm>
<IndexTerm>
<Primary>static combo box type</Primary>
</IndexTerm>
<IndexTerm>
<Primary>editable combo box type</Primary>
</IndexTerm>
<IndexTerm>
<Primary>label selected, combo box</Primary>
</IndexTerm>
<IndexTerm>
<Primary>selected label, combo box</Primary>
</IndexTerm>
<Para>Only properties unique to a combo box are described here. See <XRef Linkend="ABCommonProps"> for descriptions of Object Type, Objects, Object Name,
Initial State, and Color. See <XRef Linkend="ABOtherCommonProps"> for
descriptions of Label Type, [Label] Position, Label, Items, [Item]
Label, and Position [XY].</Para>
<VariableList>
<VarListEntry>
<Term>Combo Box Type</Term>
<ListItem>
<Para>Specifies whether the text field
for the selected combo box will be Static or Editable in the compiled
application. If Editable is selected, code must be written to
implement the edit functionality.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>[Label] Selected</Term>
<ListItem>
<Para>Specifies which item will be
selected when the compiled application is opened.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Width</Term>
<ListItem>
<Para>Specifies whether the combo box shrinks or
grows to accommodate the Longest Item in the list, or if the W(idth) of
the box is Fixed. If Fixed is selected, the W(idth) value can be edited.</Para>
</ListItem>
</VarListEntry>
</VariableList>
<Procedure>
<Title>See Also</Title>
<Step>
<ItemizedList Mark="&bull;" Role="tight">
<ListItem Id="H.REF.item.120">
<Para><XRef Linkend="ABControlsPalette">
</Para>
</ListItem>
<ListItem Id="H.REF.item.121">
<Para><XRef Linkend="ABCommonProps">
</Para>
</ListItem>
<ListItem Id="H.REF.item.122">
<Para><XRef Linkend="ABOtherCommonProps">
</Para>
</ListItem>
<ListItem Id="H.REF.item.123">
<Para><XRef Linkend="ABCommonButtons">
</Para>
</ListItem>
</ItemizedList>
</Step>
</Procedure>
</Sect3>
<Sect3 Id="ABPropEdControlPane">
<Title>Control Pane Property Editor</Title>
<IndexTerm>
<Primary>control pane property editor</Primary>
</IndexTerm>
<IndexTerm>
<Primary>property editor</Primary>
</IndexTerm>
<Para>There are no properties unique to a control pane. See <XRef Linkend="ABCommonProps"> for descriptions of Object Type, Objects, Object Name,
Initial State, and Color. See <XRef Linkend="ABOtherCommonProps"> for
descriptions of Border Frame, Size Policy, Geometry, Popup Menu, and
Menu Title.</Para>
<Procedure>
<Title>See Also</Title>
<Step>
<ItemizedList Mark="&bull;" Role="tight">
<ListItem Id="H.REF.item.124">
<Para><XRef Linkend="ABControlPane">
</Para>
</ListItem>
<ListItem Id="H.REF.item.125">
<Para><XRef Linkend="ABCommonProps">
</Para>
</ListItem>
<ListItem Id="H.REF.item.126">
<Para><XRef Linkend="ABOtherCommonProps">
</Para>
</ListItem>
<ListItem Id="H.REF.item.127">
<Para><XRef Linkend="ABCommonButtons">
</Para>
</ListItem>
</ItemizedList>
</Step>
</Procedure>
</Sect3>
<Sect3 Id="ABPropEdCustomDialog">
<Title>Custom Dialog Property Editor</Title>
<IndexTerm>
<Primary>custom dialog property editor</Primary>
</IndexTerm>
<IndexTerm>
<Primary>property editor</Primary>
</IndexTerm>
<IndexTerm>
<Primary>dialog title</Primary>
</IndexTerm>
<IndexTerm>
<Primary>window parent</Primary>
</IndexTerm>
<IndexTerm>
<Primary>dialog areas</Primary>
</IndexTerm>
<IndexTerm>
<Primary>default button, custom dialog</Primary>
</IndexTerm>
<IndexTerm>
<Primary>help button</Primary>
</IndexTerm>
<Para>Only properties unique to a custom dialog object are described here.
See <XRef Linkend="ABCommonProps"> for descriptions of Object Type, Objects,
Object Name, Initial State, and Color. See <XRef Linkend="ABOtherCommonProps">for descriptions of Size Policy and Size.</Para>
<VariableList>
<VarListEntry>
<Term>Dialog Title</Term>
<ListItem>
<Para>The title that appears at the top of the custom dialog.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Window Parent</Term>
<ListItem>
<Para>An option menu for specifying a parent main window
for the selected custom dialog. Choices are None and any main window
in the project. If a main window is specified as a window parent, the
custom dialog will be iconified and de-iconified with the main window.
Note that this functionality does not work in test mode, but it does in
the compiled application.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>User Resize Mode</Term>
<ListItem>
<Para>Specifies whether the window is Fixed or Adjustable
(whether it can be resized in the compiled application).</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Dialog Areas</Term>
<ListItem>
<Para>Specifies whether a custom dialog
includes a Button Panel (three buttons, by default) and a Footer area.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Default Button</Term>
<ListItem>
<Para>Specifies one of the dialog
buttons as the selected button, by default. The function represented
by the selected button will be performed if you press Return while the
mouse cursor is in the custom dialog in the compiled application.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Help Button</Term>
<ListItem>
<Para>Specifies one of the dialog buttons
as the help button. See <XRef Linkend="ABHelpEditor"> for a description of the
Help Editor and <XRef Linkend="ABCreateHelp"> for instructions for creating help.</Para>
</ListItem>
</VarListEntry>
</VariableList>
<Procedure>
<Title>See Also</Title>
<Step>
<ItemizedList Mark="&bull;" Role="tight">
<ListItem Id="H.REF.item.128">
<Para><XRef Linkend="ABCustomDialog">
</Para>
</ListItem>
<ListItem Id="H.REF.item.129">
<Para><XRef Linkend="ABCommonProps">
</Para>
</ListItem>
<ListItem Id="H.REF.item.130">
<Para><XRef Linkend="ABOtherCommonProps">
</Para>
</ListItem>
<ListItem Id="H.REF.item.131">
<Para><XRef Linkend="ABCommonButtons">
</Para>
</ListItem>
</ItemizedList>
</Step>
</Procedure>
</Sect3>
<Sect3 Id="ABPropEdDrawAreaPane">
<Title>Draw Area Pane Property Editor</Title>
<IndexTerm>
<Primary>draw area pane property editor</Primary>
</IndexTerm>
<IndexTerm>
<Primary>property editor</Primary>
</IndexTerm>
<IndexTerm>
<Primary>canvas size, draw area pane</Primary>
</IndexTerm>
<IndexTerm>
<Primary>total canvas size, draw area pane</Primary>
</IndexTerm>
<Para>Only properties unique to a draw area pane object are described here.
See <XRef Linkend="ABCommonProps"> for descriptions of Object Type, Objects,
Object Name, Initial State, and Color. See <XRef Linkend="ABOtherCommonProps">for descriptions of Scrollbars, Border Frame, Geometry, Popup Menu,
and Menu Title.</Para>
<VariableList>
<VarListEntry>
<Term>Total Canvas Size</Term>
<ListItem>
<Para>Specifies the W(idth) and
H(eight) of the draw area canvas. Note that only a portion of the
canvas will be visible if the draw area pane's size is smaller than
the canvas size (400 by 400 pixels, by default). You can use the
scroll bars to view other parts of the canvas.</Para>
</ListItem>
</VarListEntry>
</VariableList>
<Procedure>
<Title>See Also</Title>
<Step>
<ItemizedList Mark="&bull;" Role="tight">
<ListItem Id="H.REF.item.132">
<Para><XRef Linkend="ABCommonProps">
</Para>
</ListItem>
<ListItem Id="H.REF.item.133">
<Para><XRef Linkend="ABOtherCommonProps">
</Para>
</ListItem>
<ListItem Id="H.REF.item.134">
<Para><XRef Linkend="ABCommonButtons">
</Para>
</ListItem>
</ItemizedList>
</Step>
</Procedure>
</Sect3>
<Sect3 Id="ABPropEdFileSelection">
<Title>File Selection Dialog Property Editor</Title>
<IndexTerm>
<Primary>file selection dialog property editor</Primary>
</IndexTerm>
<IndexTerm>
<Primary>property editor</Primary>
</IndexTerm>
<IndexTerm>
<Primary>window parent, file selection dialog</Primary>
</IndexTerm>
<IndexTerm>
<Primary>main window parent</Primary>
</IndexTerm>
<IndexTerm>
<Primary>initial folder</Primary>
</IndexTerm>
<IndexTerm>
<Primary>folder, initial</Primary>
</IndexTerm>
<IndexTerm>
<Primary>initial directory</Primary>
</IndexTerm>
<IndexTerm>
<Primary>search pattern</Primary>
</IndexTerm>
<IndexTerm>
<Primary>OK button label</Primary>
</IndexTerm>
<IndexTerm>
<Primary>popdown behavior</Primary>
</IndexTerm>
<IndexTerm>
<Primary>OK button</Primary>
</IndexTerm>
<Para>Only properties unique to a file selection dialog object are described
here. See <XRef Linkend="ABCommonProps"> for descriptions of Object Type,
Objects, Object Name, Initial State, and Color.</Para>
<VariableList>
<VarListEntry>
<Term>Window Parent</Term>
<ListItem>
<Para>Specifies the main window parent of
the file selection dialog. When displayed, the file selection dialog
will appear over its main window. By default, the Primary Main Window is
the parent of all file selection dialogs. See <XRef Linkend="ABAppFrameworkEditor">.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Dialog Title</Term>
<ListItem>
<Para>Specifies the title that appears in
the title bar at the top of the file selection dialog.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Initial Directory</Term>
<ListItem>
<Para>Specifies the folder (directory)
set as the starting value in the Path field of the file selection
dialog.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Search Pattern Type</Term>
<ListItem>
<Para>Specifies whether files,
directories (folders), or both will be listed in the Files list of the
file selection dialog.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Search Pattern</Term>
<ListItem>
<Para>Specifies the value of the Filter
field in the file selection dialog. The Filter value limits the files
that will be listed in the Files field. The default value is *
(star), which means all files in the current folder will be
listed. The Filter value for the Import Module file selection dialog
in App Builder is *.bil, which means that only files that end in .bil
will be listed.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>OK Button Label</Term>
<ListItem>
<Para>Specifies the label that will
appear on the button in the left-most position at the bottom of the
file selection dialog, normally labelled "OK." Clicking this button
completes the file selection process and dismisses the file selection
dialog. This button is labelled "Import" for the Import Module file
selection dialog in App Builder.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Popdown Behavior</Term>
<ListItem>
<Para>Specifies whether the file selection dialog will be
sutomatically dismissed (the default) when the OK button is clicked.</Para>
</ListItem>
</VarListEntry>
</VariableList>
<Procedure>
<Title>See Also</Title>
<Step>
<ItemizedList Mark="&bull;" Role="tight">
<ListItem Id="H.REF.item.135">
<Para><XRef Linkend="ABCommonProps">
</Para>
</ListItem>
<ListItem Id="H.REF.item.136">
<Para><XRef Linkend="ABOtherCommonProps">
</Para>
</ListItem>
<ListItem Id="H.REF.item.137">
<Para><XRef Linkend="ABCommonButtons">
</Para>
</ListItem>
</ItemizedList>
</Step>
</Procedure>
</Sect3>
<Sect3 Id="ABGroupsEditor">
<Title>Group Property Editor</Title>
<IndexTerm>
<Primary>group property editor</Primary>
</IndexTerm>
<IndexTerm>
<Primary>property editor</Primary>
</IndexTerm>
<IndexTerm>
<Primary>group name</Primary>
</IndexTerm>
<IndexTerm>
<Primary>layout type, group</Primary>
</IndexTerm>
<IndexTerm>
<Primary>rows layout</Primary>
</IndexTerm>
<IndexTerm>
<Primary>column layout</Primary>
</IndexTerm>
<IndexTerm>
<Primary>layout, rows or columns</Primary>
</IndexTerm>
<IndexTerm>
<Primary>group layout</Primary>
</IndexTerm>
<IndexTerm>
<Primary>vertical alignment, group</Primary>
</IndexTerm>
<IndexTerm>
<Primary>horizontal alignment, group</Primary>
</IndexTerm>
<IndexTerm>
<Primary>alignment, group</Primary>
</IndexTerm>
<IndexTerm>
<Primary>spacing, group</Primary>
</IndexTerm>
<IndexTerm>
<Primary>group spacing</Primary>
</IndexTerm>
<Para>Used to modify the layout and framing of groups, the Group Property
Editor can be displayed by choosing Groups from the Editors menu of
the App Builder primary window or by choosing Group from the Revolving
Property Editor Object Type option menu. A group, unlike most of the
objects edited in the Revolving Property Editor, is a created object
and is not available from an object palette. See <XRef Linkend="ABMakeGroup">for instructions.</Para>
<Para>Only properties unique to a group object are described here. See <XRef Linkend="ABCommonProps"> for descriptions of Object Type, Objects, Initial
State, and Color. See <XRef Linkend="ABOtherCommonProps"> for descriptions of
Border Frame and Position.</Para>
<Para>Note that choosing Groups from the Editors menu in the App Builder primary
window is the same as clicking the Tear-off button in the Revolving
Property Editor when the Object Type is Group.</Para>
<VariableList>
<VarListEntry>
<Term>Group Name</Term>
<ListItem>
<Para>Displays the default name or the name
given by you to the group selected in the Objects list.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Layout Type</Term>
<ListItem>
<Para>Specifies As-Is, Vertical,
Horizontal, or Row/Column layout of the objects in the selected group.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Rows Columns</Term>
<ListItem>
<Para>Specifies whether the primary layout will be by rows
(vertical layout) or columns (horizontal layout), and how many rows or
columns to display. Active only if Layout Type is Row/Column.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Vert Alignment</Term>
<ListItem>
<Para>Specifies left-edge, colon/label,
center-line, or right-edge alignment of the objects in the selected
group. Active only if Layout Type is Vertical or Row/Column.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Spacing</Term>
<ListItem>
<Para>Specifies the number of pixels separating
the objects in the selected group. Vert[ical] Alignment Spacing is
active only if Layout Type is Vertical or Row/Column. Horiz[ontal]
Alignment Spacing is active only if Layout Type is Horizontal or
Row/Column.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Horiz Alignment</Term>
<ListItem>
<Para>Specifies top-edge, center-line,
or bottom-edge alignment of the objects in the selected group. Active
only if Layout Type is Horizontal or Row/Column.</Para>
</ListItem>
</VarListEntry>
</VariableList>
<Procedure>
<Title>See Also</Title>
<Step>
<ItemizedList Mark="&bull;" Role="tight">
<ListItem Id="H.REF.item.138">
<Para><XRef Linkend="ABMakeGroup">
</Para>
</ListItem>
<ListItem Id="H.REF.item.139">
<Para><XRef Linkend="ABEditGroup">
</Para>
</ListItem>
<ListItem Id="H.REF.item.140">
<Para><XRef Linkend="ABUnGroupObj">
</Para>
</ListItem>
<ListItem Id="H.REF.item.141">
<Para><XRef Linkend="ABAlignObj">
</Para>
</ListItem>
<ListItem Id="H.REF.item.142">
<Para><XRef Linkend="ABDistObj">
</Para>
</ListItem>
<ListItem Id="H.REF.item.143">
<Para><XRef Linkend="ABAttachObj">
</Para>
</ListItem>
</ItemizedList>
</Step>
</Procedure>
</Sect3>
<Sect3 Id="ABPropEdLabel">
<Title>Label Property Editor</Title>
<IndexTerm>
<Primary>label property editor</Primary>
</IndexTerm>
<IndexTerm>
<Primary>property editor</Primary>
</IndexTerm>
<IndexTerm>
<Primary>label alignment</Primary>
</IndexTerm>
<IndexTerm>
<Primary>label, border</Primary>
</IndexTerm>
<Para>Only properties unique to a label object are described here. See
<XRef Linkend="ABCommonProps"> for descriptions of Object Type, Objects, Object
Name, Initial State, and Color. See <XRef Linkend="ABOtherCommonProps"> for
descriptions of Label Type, Label, Size Policy, and Geometry.</Para>
<Para>Note that no border appears around a label in the compiled
application. See <XRef Linkend="ABCreateBorder"> if you want a border around a
label.</Para>
<Para>&newline; &empty;
</Para>
<VariableList>
<VarListEntry>
<Term>Label Alignment</Term>
<ListItem>
<Para>Specifies the alignment (Left, Right, Centered) of
the label within its margins. Label Alignment is relevant only if
Fixed is selected as Size Policy.</Para>
</ListItem>
</VarListEntry>
</VariableList>
<Procedure>
<Title>See Also</Title>
<Step>
<ItemizedList Mark="&bull;" Role="tight">
<ListItem Id="H.REF.item.144">
<Para><XRef Linkend="ABCommonProps">
</Para>
</ListItem>
<ListItem Id="H.REF.item.145">
<Para><XRef Linkend="ABOtherCommonProps">
</Para>
</ListItem>
<ListItem Id="H.REF.item.146">
<Para><XRef Linkend="ABCommonButtons">
</Para>
</ListItem>
<ListItem Id="H.REF.item.147">
<Para><XRef Linkend="ABCreateBorder">
</Para>
</ListItem>
</ItemizedList>
</Step>
</Procedure>
</Sect3>
<Sect3 Id="ABPropEdList">
<Title>List Property Editor</Title>
<IndexTerm>
<Primary>list property editor</Primary>
</IndexTerm>
<IndexTerm>
<Primary>property editor</Primary>
</IndexTerm>
<IndexTerm>
<Primary>selection mode</Primary>
</IndexTerm>
<IndexTerm>
<Primary>browse select</Primary>
</IndexTerm>
<IndexTerm>
<Primary>single select</Primary>
</IndexTerm>
<IndexTerm>
<Primary>multiple select</Primary>
</IndexTerm>
<IndexTerm>
<Primary>browse multiple select</Primary>
</IndexTerm>
<IndexTerm>
<Primary>height, list property editor</Primary>
</IndexTerm>
<IndexTerm>
<Primary>width, list property edit</Primary>
</IndexTerm>
<IndexTerm>
<Primary>item selected</Primary>
</IndexTerm>
<IndexTerm>
<Primary>selected item, list</Primary>
</IndexTerm>
<IndexTerm>
<Primary>list, selected item</Primary>
</IndexTerm>
<Para>Only properties unique to a list object are described here. See <XRef Linkend="ABCommonProps"> for descriptions of Object Type, Objects, Object Name,
Initial State, and Color. See <XRef Linkend="ABOtherCommonProps"> for
descriptions of Label Type, [Label] Position, Label, Items, [Item]
Label, Position [XY], Popup Menu, and Menu Title.</Para>
<VariableList>
<VarListEntry>
<Term>Selection Mode</Term>
<ListItem>
<Para>Specifies how objects can be
selected in a scrolling list. Choices are Single Select, Browse
Select, Multiple Select, and Browse Multiple Select.</Para>
<Para>In Single Select mode, only one item can be selected, by clicking
mouse button 1.</Para>
<Para>In Browse Select mode, one item can be selected, but you can press
mouse button 1 and drag through the list until the item you want is
selected.</Para>
<Para>In Multiple Select mode, you can make multiple, discontiguous
selections with mouse button 1.</Para>
<Para>In Browse Multiple Select mode, you can drag the cursor over items to
make multiple, contiguous selections, and you can make a multiple,
contiguous selection between a selected item and the cursor location
with BSelect (Shift-mouse button 1).</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>[Item] Selected</Term>
<ListItem>
<Para>Specifies whether an item will be
selected at application startup.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Width</Term>
<ListItem>
<Para>Specifies whether the list object shrinks or grows to
accommodate the Longest Item in the list, or if the W(idth) of the box
is Fixed. If Fixed is selected, the W(idth) value can be edited.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Height</Term>
<ListItem>
<Para>Specifies the number of text Lines or Pixels high the list
is.</Para>
</ListItem>
</VarListEntry>
</VariableList>
<Procedure>
<Title>See Also</Title>
<Step>
<ItemizedList Mark="&bull;" Role="tight">
<ListItem Id="H.REF.item.148">
<Para><XRef Linkend="ABCommonProps">
</Para>
</ListItem>
<ListItem Id="H.REF.item.149">
<Para><XRef Linkend="ABOtherCommonProps">
</Para>
</ListItem>
<ListItem Id="H.REF.item.150">
<Para><XRef Linkend="ABCommonButtons">
</Para>
</ListItem>
</ItemizedList>
</Step>
</Procedure>
</Sect3>
<Sect3 Id="ABPropEdMainWindow">
<Title>Main Window Property Editor</Title>
<IndexTerm>
<Primary>main window property editor</Primary>
</IndexTerm>
<IndexTerm>
<Primary>property editor window</Primary>
</IndexTerm>
<IndexTerm>
<Primary>window title</Primary>
</IndexTerm>
<IndexTerm>
<Primary>icon file</Primary>
</IndexTerm>
<IndexTerm>
<Primary>icon mask file</Primary>
</IndexTerm>
<IndexTerm>
<Primary>icon label</Primary>
</IndexTerm>
<IndexTerm>
<Primary>window areas</Primary>
</IndexTerm>
<Para>Only properties unique to a main window object are described here. See
<XRef Linkend="ABCommonProps"> for descriptions of Object Type, Objects, Object
Name, Initial State (Visible), and Color. See <XRef Linkend="ABOtherCommonProps"> for descriptions of Size Policy and Size.</Para>
<VariableList>
<VarListEntry>
<Term>Window Title</Term>
<ListItem>
<Para>Specifies the title that appears at the top of the main
window.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Icon File</Term>
<ListItem>
<Para>Specifies the name of the graphics file that
contains the graphical representation of the application icon -- the
object that is displayed when the application is "iconified" by
clicking on the minimize button in the title bar.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Icon Mask File</Term>
<ListItem>
<Para>Specifies the name of the graphics file
that contains the bitmap that determines the shape of the visible
representation of the icon beneath the icon mask. The icon mask acts
like a stencil, allowing only the pixels in the icon that correspond
to pixels in the mask to be visible.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Icon Label</Term>
<ListItem>
<Para>Specifies the text label that appears beneath the
application icon.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>User Resize Mode</Term>
<ListItem>
<Para>Specifies whether the window size is Fixed or
Adjustable (whether it can be resized in the compiled application).</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Window Areas</Term>
<ListItem>
<Para>Specifies whether the main window will have a menu bar,
a tool bar, or a footer.</Para>
<Para>Note that a tool bar or a footer will show up as a control pane object
in the Revolving Property Editor. You will probably want to add
controls, such as the radio buttons in the App Builder primary window
Build/Test tool bar, to a tool bar, and to make connections between
the controls and programmatic functions. Code will have to be
written to make a tool bar or footer functional.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Initial State, Iconic</Term>
<ListItem>
<Para>Specifies whether the window
is displayed as a window or an icon when the compiled application is
opened.</Para>
</ListItem>
</VarListEntry>
</VariableList>
<Procedure>
<Title>See Also</Title>
<Step>
<ItemizedList Mark="&bull;" Role="tight">
<ListItem Id="H.REF.item.151">
<Para><XRef Linkend="ABMainWindow">
</Para>
</ListItem>
<ListItem Id="H.REF.item.152">
<Para><XRef Linkend="ABCommonProps">
</Para>
</ListItem>
<ListItem Id="H.REF.item.153">
<Para><XRef Linkend="ABOtherCommonProps">
</Para>
</ListItem>
<ListItem Id="H.REF.item.154">
<Para><XRef Linkend="ABCommonButtons">
</Para>
</ListItem>
</ItemizedList>
</Step>
</Procedure>
</Sect3>
<Sect3 Id="ABMenusEditor">
<Title>Menu Property Editor</Title>
<IndexTerm>
<Primary>menu property editor</Primary>
</IndexTerm>
<IndexTerm>
<Primary>property editor</Primary>
</IndexTerm>
<IndexTerm>
<Primary>editor, menu</Primary>
</IndexTerm>
<IndexTerm>
<Primary>created object, menu</Primary>
</IndexTerm>
<IndexTerm>
<Primary>menu object</Primary>
</IndexTerm>
<IndexTerm>
<Primary>add new menu</Primary>
</IndexTerm>
<IndexTerm>
<Primary>new menu, add</Primary>
</IndexTerm>
<IndexTerm>
<Primary>tearoff menu</Primary>
</IndexTerm>
<IndexTerm>
<Primary>menu, tearoff</Primary>
</IndexTerm>
<IndexTerm>
<Primary>item label type</Primary>
</IndexTerm>
<IndexTerm>
<Primary>item mnemonic</Primary>
</IndexTerm>
<IndexTerm>
<Primary>mnemonic, menu item</Primary>
</IndexTerm>
<IndexTerm>
<Primary>accelerator</Primary>
</IndexTerm>
<IndexTerm>
<Primary>menu item accelerator</Primary>
</IndexTerm>
<IndexTerm>
<Primary>line style, menu item separator</Primary>
</IndexTerm>
<IndexTerm>
<Primary>separator, menu item label type</Primary>
</IndexTerm>
<IndexTerm>
<Primary>menu item label type</Primary>
</IndexTerm>
<IndexTerm>
<Primary>label type, menu item</Primary>
</IndexTerm>
<IndexTerm>
<Primary>item submenu</Primary>
</IndexTerm>
<IndexTerm>
<Primary>submenu, item</Primary>
</IndexTerm>
<Para>Used to create menus, the Menu Property Editor can be displayed by
choosing Menus from the Editors menu of the App Builder primary window,
by choosing Menu from the Revolving Property Editor Object Type option
menu, or by choosing Create New Menu from the Popup Menu option menu
in a property editor. A menu, unlike most of the objects edited in
the Revolving Property Editor, is a created object and is not
available from an object palette.</Para>
<Para>Only properties unique to a menu object are described here. See <XRef Linkend="ABCommonProps"> for descriptions of Object Type, Objects, Object Name,
and Color. See <XRef Linkend="ABOtherCommonProps"> for descriptions of Items,
Label, and Item State (Active).</Para>
<Para>Note that choosing Menus from the Editors menu in the App Builder
primary window is the same as clicking the Tear-off button in the
Revolving Property Editor when the Object Type is Menu.</Para>
<VariableList>
<VarListEntry>
<Term>Add New Menu</Term>
<ListItem>
<Para>Adds a new menu to the list of menus.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Edit</Term>
<ListItem>
<Para>Performs edit functions (Cut, Copy, Paste, Delete) on the
selected item in the list of menu objects. Cut and Copy place the
selected item in a buffer, ready for Paste. Delete removes the item,
but does not place it in a buffer.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Tearoff</Term>
<ListItem>
<Para>Specifies whether Tearoff is Enabled or Disabled -- whether
the selected menu will be "postable." That is, will the menu be
displayed "permanently" if you click on the Tearoff indicator (a
dotted line)?</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Item Label Type</Term>
<ListItem>
<Para>Specifies the type of label
(String, Graphic, or Separator) for the item selected in the Items
list. If Graphic is chosen, "Label" becomes "Graphic Filename." If
Separator is chosen, Label or Graphic Filename becomes inactive and
Line Style becomes active. A Separator menu item is used to create a
visual division in a menu, such as that seen in the Editors menu of
the App Builder primary window.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Item Mnemonic</Term>
<ListItem>
<Para>Specifies one of the letters in the selected item as a
keyboard shortcut for choosing the item when the menu is posted. The
letter specified will be underlined. Pressing the mnemonic letter when
the menu is posted will cause that item to be chosen. Note that case
is significant and that a particular letter can be used as a mnemonic
only once within a menu.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>[Item] Accelerator</Term>
<ListItem>
<Para>Specifies a keyboard shortcut for choosing the
selected item. An accelerator is comprised of a prefix (Ctrl, Alt,
Meta, or Shift) plus &lt;Key> plus a letter (upper or lower case). To
make Control-X an accelerator, for instance, type the following:</Para>
<Para>Ctrl&lt;Key>x</Para>
<Para>When you display the menu in test mode or in the compiled application,
"Ctrl+x" will be included to the right of the menu item label. If you
press the Control key and type x with the cursor in the window that
contains the menu, the specified action will be performed.</Para>
<Para>You can combine the Shift key with one of the other keys to form a
compound prefix, if you wish. To make Shift Control-X an accelerator,
type the following:</Para>
<Para>Shift Ctrl&lt;Key>x</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Line Style</Term>
<ListItem>
<Para>Specifies the type of line style for the selected
separator item; active only when Item Label Type is Separator. Choices
are None, Etched In, Etched Out, Etched In Dash, Etched Out Dash,
Single Line, Double Line, Single Dashed Line, and Double Dashed Line.
A separator of the chosen line style will be displayed in the menu
instead of a graphic or text label.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Item SubMenu</Term>
<ListItem>
<Para>A menu button and a text field for attaching,
de-attaching, creating, or editing a sub-menu for the selected item in
the Items list. If a sub-menu is attached to the selected item, the
name of the sub-menu will be displayed in the text field.</Para>
</ListItem>
</VarListEntry>
</VariableList>
</Sect3>
<Sect3 Id="ABPropEdMenuButton">
<Title>Menu Button Property Editor</Title>
<Para>A menu button is a special type of button; see <XRef Linkend="ABPropEdButton">.
</Para>
<Procedure>
<Title>See Also</Title>
<Step>
<ItemizedList Mark="&bull;" Role="tight">
<ListItem Id="H.REF.item.155">
<Para><XRef Linkend="ABMenusEditor">
</Para>
</ListItem>
</ItemizedList>
</Step>
</Procedure>
</Sect3>
<Sect3 Id="ABPropEdMenubar">
<Title>Menubar Property Editor</Title>
<IndexTerm>
<Primary>menubar property editor</Primary>
</IndexTerm>
<IndexTerm>
<Primary>property editor</Primary>
</IndexTerm>
<IndexTerm>
<Primary>item mnemonic</Primary>
</IndexTerm>
<IndexTerm>
<Primary>mnemonic, menu item</Primary>
</IndexTerm>
<IndexTerm>
<Primary>help menu</Primary>
</IndexTerm>
<Para>Only properties unique to a menubar object are described here. See <XRef Linkend="ABCommonProps"> for descriptions of Object Type, Objects, Object Name,
Initial State, and Color. See <XRef Linkend="ABOtherCommonProps"> for
descriptions of Items, Item Label Type, Label, Pulldown Menu, and Item
State (Active).</Para>
<VariableList>
<VarListEntry>
<Term>Item Mnemonic</Term>
<ListItem>
<Para>Specifies one of the letters in the selected item as a
keyboard shortcut for displaying the menu. The letter specified will
be underlined in the menu bar. In test mode and in the compiled
application, the menu will be displayed if you hold down the Alt key
and press the mnemonic letter while the mouse cursor is over the
window that contains the menu bar.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Item State, Is Help Item</Term>
<ListItem>
<Para>Specifies that the selected item is the
Help menu. The Help menu appears at the right edge of the menu bar and
has a built-in connection to the online help mechanism. The item
labelled "Help" is the help button, by default.</Para>
</ListItem>
</VarListEntry>
</VariableList>
<Procedure>
<Title>See Also</Title>
<Step>
<ItemizedList Mark="&bull;" Role="tight">
<ListItem Id="H.REF.item.156">
<Para><XRef Linkend="ABCommonProps">
</Para>
</ListItem>
<ListItem Id="H.REF.item.157">
<Para><XRef Linkend="ABOtherCommonProps">
</Para>
</ListItem>
<ListItem Id="H.REF.item.158">
<Para><XRef Linkend="ABCommonButtons">
</Para>
</ListItem>
<ListItem Id="H.REF.item.159">
<Para><XRef Linkend="ABMenusEditor">
</Para>
</ListItem>
<ListItem Id="H.REF.item.160">
<Para><XRef Linkend="ABCreateMenu">
</Para>
</ListItem>
</ItemizedList>
</Step>
</Procedure>
</Sect3>
<Sect3 Id="ABPropEdPanedWindow">
<Title>Paned Window Property Editor</Title>
<IndexTerm>
<Primary>paned window property editor</Primary>
</IndexTerm>
<IndexTerm>
<Primary>property editor</Primary>
</IndexTerm>
<IndexTerm>
<Primary>pane geometry, paned window</Primary>
</IndexTerm>
<IndexTerm>
<Primary>pane height, paned window</Primary>
</IndexTerm>
<Para>A paned window, unlike most of the objects edited in the Revolving
Property Editor, is a created object and is not available from an
object palette; see <XRef Linkend="ABMakePanedWindow"> for instructions for
creating a paned window.</Para>
<Para>Only properties unique to a paned window object are described here.
See <XRef Linkend="ABCommonProps"> for descriptions of Object Type, Objects,
Object Name, and Initial State.</Para>
<VariableList>
<VarListEntry>
<Term>Panes</Term>
<ListItem>
<Para>Lists the panes that comprise the paned window.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Pane Geometry</Term>
<ListItem>
<Para>Displays the W(idth) and H(eight) of the pane selected
in the Panes list.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Pane Height</Term>
<ListItem>
<Para>Specifies the Min(imum) and Max(imum) height (in pixels)
of the selected pane. These values determine the limits for the panes
when you move the sash between panes.</Para>
</ListItem>
</VarListEntry>
</VariableList>
<Procedure>
<Title>See Also</Title>
<Step>
<ItemizedList Mark="&bull;" Role="tight">
<ListItem Id="H.REF.item.161">
<Para><XRef Linkend="ABCommonProps">
</Para>
</ListItem>
<ListItem Id="H.REF.item.162">
<Para><XRef Linkend="ABOtherCommonProps">
</Para>
</ListItem>
<ListItem Id="H.REF.item.163">
<Para><XRef Linkend="ABCommonButtons">
</Para>
</ListItem>
<ListItem Id="H.REF.item.164">
<Para><XRef Linkend="ABMakePanedWindow">
</Para>
</ListItem>
</ItemizedList>
</Step>
</Procedure>
</Sect3>
<Sect3 Id="ABPropEdScale">
<Title>Scale Property Editor</Title>
<IndexTerm>
<Primary>scale property editor</Primary>
</IndexTerm>
<IndexTerm>
<Primary>property editor</Primary>
</IndexTerm>
<IndexTerm>
<Primary>gauge property editor</Primary>
</IndexTerm>
<IndexTerm>
<Primary>property editor, gauge</Primary>
</IndexTerm>
<IndexTerm>
<Primary>scale type</Primary>
</IndexTerm>
<IndexTerm>
<Primary>orientation, scale</Primary>
</IndexTerm>
<IndexTerm>
<Primary>scale orientation</Primary>
</IndexTerm>
<IndexTerm>
<Primary>orientation, gauge</Primary>
</IndexTerm>
<IndexTerm>
<Primary>gauge orientation</Primary>
</IndexTerm>
<IndexTerm>
<Primary>direction, gauge or scale</Primary>
</IndexTerm>
<IndexTerm>
<Primary>scale direction</Primary>
</IndexTerm>
<IndexTerm>
<Primary>gauge direction</Primary>
</IndexTerm>
<IndexTerm>
<Primary>value range, gauge or scale</Primary>
</IndexTerm>
<IndexTerm>
<Primary>decimal points, gauge or scale</Primary>
</IndexTerm>
<IndexTerm>
<Primary>show value, gauge or scale</Primary>
</IndexTerm>
<Para>Only properties unique to a scale or gauge object are described here.
See <XRef Linkend="ABCommonProps"> for descriptions of Object Type, Objects,
Object Name, Initial State, and Color. See <XRef Linkend="ABOtherCommonProps">for descriptions of Label Type, [Label] Position, and Label.</Para>
<VariableList>
<VarListEntry>
<Term>Scale Type</Term>
<ListItem>
<Para>Specifies Scale or Gauge. A scale
includes a slider and is modifiable by a user (in the compiled
application or in test mode). A gauge indicates a
value, does not include a slider, and is not modifiable by a user.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Orientation</Term>
<ListItem>
<Para>Specifies whether the scale object
will be displayed in Horizontal or Vertical orientation.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Direction</Term>
<ListItem>
<Para>Specifies Left to Right or Right to
Left incrementing of value for a horizontal scale object, Bottom to
Top or Top to Bottom incrementing of value for a vertical scale
object.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Value Range</Term>
<ListItem>
<Para>Specifies Min(imum), Max(imum, and Incr(ement) values
for a scale object. All values must be integers. The increment value
is used when you click with the mouse at either end of the scale
object (in the compiled application or in test mode). See Decimal
Points.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Decimal Points</Term>
<ListItem>
<Para>Specifies the number of decimal places to shift the
scale value when displaying it (if Show Value is checked). For
example, a scale value of 250 with a Decimal Points value of 1 would
display as 25.0; a scale value of 250 with a Decimal Points value of 2
would display as 2.50.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Show Value</Term>
<ListItem>
<Para>Specifies whether the numerical value of the scale
position will be displayed. See Decimal Points above.</Para>
</ListItem>
</VarListEntry>
</VariableList>
<Procedure>
<Title>See Also</Title>
<Step>
<ItemizedList Mark="&bull;" Role="tight">
<ListItem Id="H.REF.item.165">
<Para><XRef Linkend="ABCommonProps">
</Para>
</ListItem>
<ListItem Id="H.REF.item.166">
<Para><XRef Linkend="ABOtherCommonProps">
</Para>
</ListItem>
<ListItem Id="H.REF.item.167">
<Para><XRef Linkend="ABCommonButtons">
</Para>
</ListItem>
</ItemizedList>
</Step>
</Procedure>
</Sect3>
<Sect3 Id="ABPropEdSeparator">
<Title>Separator Property Editor</Title>
<IndexTerm>
<Primary>separator property editor</Primary>
</IndexTerm>
<IndexTerm>
<Primary>property editor</Primary>
</IndexTerm>
<IndexTerm>
<Primary>orientation, separator</Primary>
</IndexTerm>
<IndexTerm>
<Primary>line style, separator</Primary>
</IndexTerm>
<IndexTerm>
<Primary>separator line style</Primary>
</IndexTerm>
<IndexTerm>
<Primary>separator orientation</Primary>
</IndexTerm>
<Para>Only properties unique to a separator object are described here.
See <XRef Linkend="ABCommonProps"> for descriptions of Object Type, Objects,
Object Name, Initial State, and Color. See <XRef Linkend="ABOtherCommonProps">for a description of Geometry.</Para>
<VariableList>
<VarListEntry>
<Term>Orientation</Term>
<ListItem>
<Para>Specifies whether the separator object will be
displayed in Horizontal or Vertical orientation.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Line Style</Term>
<ListItem>
<Para>Specifies the type of line style for the separator.
Choices are None, Etched In, Etched Out, Etched In Dash, Etched Out
Dash, Single Line, Double Line, Single Dashed Line, and Double Dashed
Line.</Para>
</ListItem>
</VarListEntry>
</VariableList>
<Procedure>
<Title>See Also</Title>
<Step>
<ItemizedList Mark="&bull;" Role="tight">
<ListItem Id="H.REF.item.168">
<Para><XRef Linkend="ABCommonProps">
</Para>
</ListItem>
<ListItem Id="H.REF.item.169">
<Para><XRef Linkend="ABOtherCommonProps">
</Para>
</ListItem>
<ListItem Id="H.REF.item.170">
<Para><XRef Linkend="ABCommonButtons">
</Para>
</ListItem>
</ItemizedList>
</Step>
</Procedure>
</Sect3>
<Sect3 Id="ABPropEdSpinbox">
<Title>Spin Box Property Editor</Title>
<IndexTerm>
<Primary>spin box property editor</Primary>
</IndexTerm>
<IndexTerm>
<Primary>property editor</Primary>
</IndexTerm>
<IndexTerm>
<Primary>spin box type</Primary>
</IndexTerm>
<IndexTerm>
<Primary>numeric spin box</Primary>
</IndexTerm>
<IndexTerm>
<Primary>string list spin box</Primary>
</IndexTerm>
<IndexTerm>
<Primary>arrow style, spin box</Primary>
</IndexTerm>
<IndexTerm>
<Primary>spin box arrow style</Primary>
</IndexTerm>
<IndexTerm>
<Primary>value range, spin box</Primary>
</IndexTerm>
<IndexTerm>
<Primary>spin box value range</Primary>
</IndexTerm>
<IndexTerm>
<Primary>decimal points, spin box</Primary>
</IndexTerm>
<Para>Only properties unique to a spin box object are described here.
See <XRef Linkend="ABCommonProps"> for descriptions of Object Type, Objects,
Object Name, Initial State, and Color. See <XRef Linkend="ABOtherCommonProps">for descriptions of Label Type, [Label] Position, Label, Items, [Item]
Label, and Geometry.</Para>
<VariableList>
<VarListEntry>
<Term>Spin Box Type</Term>
<ListItem>
<Para>Specifies the type of spin box. If Numeric is chosen,
the Items, Label, Add Item, Edit, and Selected properties are
inactive. If String List is chosen, the Value Range, Initial Value,
and Decimal Points properties are inactive.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Arrow Style</Term>
<ListItem>
<Para>Specifies the style of arrow to be displayed on the spin
box. Choices are Flat Beginning, Flat End, Beginning, End, and Split.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Value Range</Term>
<ListItem>
<Para>Specifies Min(imum), Max(imum, and Incr(ement) values
for a spin box object. All values must be integers. The increment
value is used when you click with the mouse on one of the spin box
arrows (in the compiled application or in test mode). Value Range is
inactive if Spin Box Type is String List. See Decimal Points.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Initial Value</Term>
<ListItem>
<Para>Specifies the starting value in the spin box in the
compiled application. Initial Value is inactive if Spin Box Type is
String List.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Decimal Points</Term>
<ListItem>
<Para>Specifies the number of decimal places to shift the
spin box value when displaying it. For example, a spin box value of
250 with a Decimal Points value of 1 would display as 25.0; a spin box
value of 250 with a Decimal Points value of 2 would display as 2.50.
Decimal Points is inactive if Spin Box Type is String List.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>[Item], Selected</Term>
<ListItem>
<Para>Specifies whether the selected item will be
selected when the compiled application is opened. Only one item can be
selected. Selected is inactive if Spin Box Type is Numeric.</Para>
</ListItem>
</VarListEntry>
</VariableList>
<Procedure>
<Title>See Also</Title>
<Step>
<ItemizedList Mark="&bull;" Role="tight">
<ListItem Id="H.REF.item.171">
<Para><XRef Linkend="ABCommonProps">
</Para>
</ListItem>
<ListItem Id="H.REF.item.172">
<Para><XRef Linkend="ABOtherCommonProps">
</Para>
</ListItem>
<ListItem Id="H.REF.item.173">
<Para><XRef Linkend="ABCommonButtons">
</Para>
</ListItem>
</ItemizedList>
</Step>
</Procedure>
</Sect3>
<Sect3 Id="ABPropEdTermPane">
<Title>Term Pane Property Editor</Title>
<IndexTerm>
<Primary>term pane property editor</Primary>
</IndexTerm>
<IndexTerm>
<Primary>property editor</Primary>
</IndexTerm>
<IndexTerm>
<Primary>scroll bars, term pane</Primary>
</IndexTerm>
<IndexTerm>
<Primary>term pane scroll bars</Primary>
</IndexTerm>
<IndexTerm>
<Primary>process string, term pane</Primary>
</IndexTerm>
<IndexTerm>
<Primary>term pane process string</Primary>
</IndexTerm>
<Para>Only properties unique to a term pane object are described here. See
<XRef Linkend="ABCommonProps"> for descriptions of Object Type, Objects, Object
Name, Initial State, and Color. See <XRef Linkend="ABOtherCommonProps"> for
descriptions of Scrollbars, Border Frame, Position [XY], Size, Popup
Menu, and Menu Title.</Para>
<VariableList>
<VarListEntry>
<Term>Process String</Term>
<ListItem>
<Para>A text field for specifying the process (command)
that will be run in the term pane in the compiled application. The
default value is <ComputerOutput>/bin/csh.</ComputerOutput>
</Para>
</ListItem>
</VarListEntry>
</VariableList>
<Procedure>
<Title>See Also</Title>
<Step>
<ItemizedList Mark="&bull;" Role="tight">
<ListItem Id="H.REF.item.174">
<Para><XRef Linkend="ABCommonProps">
</Para>
</ListItem>
<ListItem Id="H.REF.item.175">
<Para><XRef Linkend="ABOtherCommonProps">
</Para>
</ListItem>
<ListItem Id="H.REF.item.176">
<Para><XRef Linkend="ABCommonButtons">
</Para>
</ListItem>
</ItemizedList>
</Step>
</Procedure>
</Sect3>
<Sect3 Id="ABPropEdTextField">
<Title>Text Field Property Editor</Title>
<IndexTerm>
<Primary>text field property editor</Primary>
</IndexTerm>
<IndexTerm>
<Primary>property editor</Primary>
</IndexTerm>
<IndexTerm>
<Primary>operation, text field</Primary>
</IndexTerm>
<IndexTerm>
<Primary>text field, editable or read-only</Primary>
</IndexTerm>
<IndexTerm>
<Primary>text field, read-only or editable</Primary>
</IndexTerm>
<IndexTerm>
<Primary>text field, maximum chars</Primary>
</IndexTerm>
<IndexTerm>
<Primary>maximum chars, text field</Primary>
</IndexTerm>
<IndexTerm>
<Primary>characters, maximum, text field</Primary>
</IndexTerm>
<IndexTerm>
<Primary>text field, initial value</Primary>
</IndexTerm>
<IndexTerm>
<Primary>initial value, text field</Primary>
</IndexTerm>
<Para>Only properties unique to a text field object are described here.
See <XRef Linkend="ABCommonProps"> for descriptions of Object Type, Objects,
Object Name, Initial State, and Color. See <XRef Linkend="ABOtherCommonProps">for descriptions of Label Type, [Label] Position, Label, Position
[XY], and Width.</Para>
<VariableList>
<VarListEntry>
<Term>Operation</Term>
<ListItem>
<Para>Specifies whether the text field in the compiled
application and in test mode will be Editable or Read-Only.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Maximum Chars</Term>
<ListItem>
<Para>Specifies the maximum number of characters that can be
typed in the text field. This field is independent of the W(idth)
field, which specifies the width of the displayed text.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Initial Value</Term>
<ListItem>
<Para>Specifies the initial value to be displayed in the
text field in the compiled application or in test mode.</Para>
</ListItem>
</VarListEntry>
</VariableList>
<Procedure>
<Title>See Also</Title>
<Step>
<ItemizedList Mark="&bull;" Role="tight">
<ListItem Id="H.REF.item.177">
<Para><XRef Linkend="ABCommonProps">
</Para>
</ListItem>
<ListItem Id="H.REF.item.178">
<Para><XRef Linkend="ABOtherCommonProps">
</Para>
</ListItem>
<ListItem Id="H.REF.item.179">
<Para><XRef Linkend="ABCommonButtons">
</Para>
</ListItem>
</ItemizedList>
</Step>
</Procedure>
</Sect3>
<Sect3 Id="ABPropEdTextPane">
<Title>Text Pane Property Editor</Title>
<IndexTerm>
<Primary>text pane property editor</Primary>
</IndexTerm>
<IndexTerm>
<Primary>property editor</Primary>
</IndexTerm>
<IndexTerm>
<Primary>operation, text pane</Primary>
</IndexTerm>
<IndexTerm>
<Primary>text pane, editable or read-only</Primary>
</IndexTerm>
<IndexTerm>
<Primary>text pane, read-only or editable</Primary>
</IndexTerm>
<IndexTerm>
<Primary>text pane, initial value</Primary>
</IndexTerm>
<IndexTerm>
<Primary>initial value, text pane</Primary>
</IndexTerm>
<IndexTerm>
<Primary>word wrap, text pane</Primary>
</IndexTerm>
<IndexTerm>
<Primary>text pane, word wrap</Primary>
</IndexTerm>
<Para>Only properties unique to a text pane object are described here. See
<XRef Linkend="ABCommonProps"> for descriptions of Object Type, Objects, Object
Name, Initial State, and Color. See <XRef Linkend="ABOtherCommonProps"> for
descriptions of Border Frame, Position [XY], Size, Popup Menu, and
Menu Title.</Para>
<VariableList>
<VarListEntry>
<Term>Operation</Term>
<ListItem>
<Para>Specifies whether the text pane in the compiled
application and in test mode will be Editable or Read-Only.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Word Wrap</Term>
<ListItem>
<Para>Specifies whether words will be wrapped to the following
line when the Size W(idth) value is reached.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Initial Value</Term>
<ListItem>
<Para>Specifies the initial value to be displayed in the
text pane in the compiled application or in test mode.</Para>
</ListItem>
</VarListEntry>
</VariableList>
<Procedure>
<Title>See Also</Title>
<Step>
<ItemizedList Mark="&bull;" Role="tight">
<ListItem Id="H.REF.item.180">
<Para><XRef Linkend="ABCommonProps">
</Para>
</ListItem>
<ListItem Id="H.REF.item.181">
<Para><XRef Linkend="ABOtherCommonProps">
</Para>
</ListItem>
<ListItem Id="H.REF.item.182">
<Para><XRef Linkend="ABCommonButtons">
</Para>
</ListItem>
</ItemizedList>
</Step>
</Procedure>
</Sect3>
</Sect2>
<Sect2 Id="ABHelpEditor">
<Title>Help Editor</Title>
<IndexTerm>
<Primary>help editor</Primary>
</IndexTerm>
<IndexTerm>
<Primary>editor, help</Primary>
</IndexTerm>
<IndexTerm>
<Primary>help text</Primary>
</IndexTerm>
<IndexTerm>
<Primary>volume name, help editor</Primary>
</IndexTerm>
<IndexTerm>
<Primary>location ID, help editor</Primary>
</IndexTerm>
<Para>Used to create on-item help for interface objects and to specify the
name and location of a help volume. The Help Editor
is described below the figure.
&newline; &empty;
</Para>
<Graphic Entityref="HelpEditorFig" Id="H.REF.fig.15"></Graphic>
<VariableList>
<VarListEntry>
<Term>Object Type</Term>
<ListItem>
<Para>Specifies the type of object for which on-item help is
to be written.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Objects</Term>
<ListItem>
<Para>Lists all of the objects of the type chosen as Object Type.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Help Text</Term>
<ListItem>
<Para>The on-item help text for the object selected in the
Objects list.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Volume Name</Term>
<ListItem>
<Para>Specifies the name of the HelpTag help
volume to be accessed if the More button is clicked in the on-item
help window displayed for the selected object. Note that on-item Help
Text and Location ID are required.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Location ID</Term>
<ListItem>
<Para>Specifies a HelpTag location ID in the help volume named
in Volume Name; this field is required if Volume Name is included.</Para>
</ListItem>
</VarListEntry>
</VariableList>
<Para>See <XRef Linkend="ABCommonButtons"> for descriptions of the buttons at the
bottom of the editor.</Para>
<Procedure>
<Title>See Also</Title>
<Step>
<ItemizedList Mark="&bull;" Role="tight">
<ListItem Id="H.REF.item.183">
<Para><XRef Linkend="ABCreateHelp">
</Para>
</ListItem>
</ItemizedList>
</Step>
</Procedure>
</Sect2>
<Sect2 Id="ABMenusEdRef">
<Title>Menus Editor</Title>
<Para>The Menus Editor is a property editor; see <XRef Linkend="ABMenusEditor">.</Para>
</Sect2>
<Sect2 Id="ABConnectionsEditor">
<Title>Connections Editor</Title>
<IndexTerm>
<Primary>connections editor</Primary>
</IndexTerm>
<IndexTerm>
<Primary>editor, connections</Primary>
</IndexTerm>
<IndexTerm>
<Primary>source, connections editor</Primary>
</IndexTerm>
<IndexTerm>
<Primary>target, connections editor</Primary>
</IndexTerm>
<IndexTerm>
<Primary>when action, connections editor</Primary>
</IndexTerm>
<IndexTerm>
<Primary>action type, connections editor</Primary>
</IndexTerm>
<IndexTerm>
<Primary>activated, when action</Primary>
</IndexTerm>
<IndexTerm>
<Primary>created, when action</Primary>
</IndexTerm>
<IndexTerm>
<Primary>destroyed, when action</Primary>
</IndexTerm>
<IndexTerm>
<Primary>dragged from, when action</Primary>
</IndexTerm>
<IndexTerm>
<Primary>dropped on, when action</Primary>
</IndexTerm>
<IndexTerm>
<Primary>hidden, when action</Primary>
</IndexTerm>
<IndexTerm>
<Primary>shown, when action</Primary>
</IndexTerm>
<IndexTerm>
<Primary>resized, when action</Primary>
</IndexTerm>
<IndexTerm>
<Primary>repaint needed, when action</Primary>
</IndexTerm>
<IndexTerm>
<Primary>cancel activated, when action</Primary>
</IndexTerm>
<IndexTerm>
<Primary>ok activated, when action</Primary>
</IndexTerm>
<IndexTerm>
<Primary>double-clicked on, when action</Primary>
</IndexTerm>
<IndexTerm>
<Primary>popped down, when action</Primary>
</IndexTerm>
<IndexTerm>
<Primary>popped up, when action</Primary>
</IndexTerm>
<IndexTerm>
<Primary>action1 activated</Primary>
</IndexTerm>
<IndexTerm>
<Primary>action2 activated</Primary>
</IndexTerm>
<IndexTerm>
<Primary>action3 activated</Primary>
</IndexTerm>
<IndexTerm>
<Primary>dragged, when action</Primary>
</IndexTerm>
<IndexTerm>
<Primary>value changed, when action</Primary>
</IndexTerm>
<IndexTerm>
<Primary>text changed, when action</Primary>
</IndexTerm>
<IndexTerm>
<Primary>before text changed, when action</Primary>
</IndexTerm>
<IndexTerm>
<Primary>predefined, action type</Primary>
</IndexTerm>
<IndexTerm>
<Primary>call function, action type</Primary>
</IndexTerm>
<IndexTerm>
<Primary>execute code, action type</Primary>
</IndexTerm>
<IndexTerm>
<Primary>activate on-item help</Primary>
</IndexTerm>
<IndexTerm>
<Primary>access help volume, action type</Primary>
</IndexTerm>
<IndexTerm>
<Primary>action, predefined</Primary>
</IndexTerm>
<IndexTerm>
<Primary>disable, predefined action</Primary>
</IndexTerm>
<IndexTerm>
<Primary>enable, predefined action</Primary>
</IndexTerm>
<IndexTerm>
<Primary>hide, predefined action</Primary>
</IndexTerm>
<IndexTerm>
<Primary>show, predefined action</Primary>
</IndexTerm>
<IndexTerm>
<Primary>set label, predefined action</Primary>
</IndexTerm>
<IndexTerm>
<Primary>set value, predefined action</Primary>
</IndexTerm>
<IndexTerm>
<Primary>set text, predefined action</Primary>
</IndexTerm>
<IndexTerm>
<Primary>view, connections editor</Primary>
</IndexTerm>
<IndexTerm>
<Primary>connect button</Primary>
</IndexTerm>
<IndexTerm>
<Primary>change button, connections editor</Primary>
</IndexTerm>
<IndexTerm>
<Primary>delete button, connections editor</Primary>
</IndexTerm>
<IndexTerm>
<Primary>function, connections editor</Primary>
</IndexTerm>
<IndexTerm>
<Primary>execute code editor</Primary>
</IndexTerm>
<IndexTerm>
<Primary>code, connections editor</Primary>
</IndexTerm>
<IndexTerm>
<Primary>volume, connections editor</Primary>
</IndexTerm>
<IndexTerm>
<Primary>location, connections editor</Primary>
</IndexTerm>
<Para>Used to make programmatic connections between interface objects. The
Connections Editor is described below the figure.
&newline; &empty;
</Para>
<Graphic Entityref="ConnectEdFig" Id="H.REF.fig.16"></Graphic>
<VariableList>
<VarListEntry>
<Term>Source</Term>
<ListItem>
<Para>Specifies a source type and a source object for a connection.
Source types are primarily App Builder objects (Button, Choice,
Control Pane, for example) and object items (Choice Item, Menu Item,
Menubar Item). In addition, there is a Source type called Application,
which is relevant for Session Management and ToolTalk functions. See
the description of When actions below.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Target</Term>
<ListItem>
<Para>Specifies a target type and a target object for a connection.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>When</Term>
<ListItem>
<Para>Specifies which When action on the Source object causes the
action specified in Action Type to be performed on the Target object.
Available When actions, which vary depending on the Source object
type, include Action1/2/3 Activated, Activated, Before Text Changed,
Cancel Activated, Created, Destroyed, Double-Clicked On, Dragged,
Dragged From, Dropped On, Hidden, Item Selected, OK Activated, Popped
Down, Popped Up, Repaint Needed, Resized, Shown, Text Changed, and
Value Changed.</Para>
<Para>If Application is chosen as the Source, available When actions are
Session Save, Session Restore, ToolTalk Do Command, ToolTalk Get
Status, ToolTalk Pause/Resume, and ToolTalk Quit. See <XRef Linkend="ABAppFrameworkEditor"> for more about Session Management and ToolTalk.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Action Type</Term>
<ListItem>
<Para>Specifies one of five choices: Predefined, Call
Function, Execute Code, Activate On-Item Help, or Access Help Volume.
Note that the specified connections are not made until you click on
the Connect button at the bottom of the Connections Editor.</Para>
<Para>If Predefined is chosen, a second option menu is activated, for choosing
what predefined action is to be performed on the Target object;
choices are Disable, Enable, Hide, Show, Set Label, Set Text, and Set
Value. For the "Set" actions the Argument text field is active, for
typing text or values to be set when the When function is performed.</Para>
<Para>If Call Function is chosen, a text field labelled "Function" is
activated, for typing the name of a function to be called when the
When action is executed in the compiled application; this function
name will be included in the .bil file as a connection, with an
action-type of "call-function." Note that a Call Function action will
not work in test mode.</Para>
<Para>If Execute Code is chosen, the Execute Code Editor will be displayed,
for typing in C code to be performed when the When action is executed
in the compiled application; this code will be included in the .bil
file as a connection, with an action-type of "execute-code." Note that
an Execute Code action will not work in test mode.</Para>
<Para>If Activate On-Item Help is chosen, a connection will be included in
the .bil file, with an action-type of "on-item-help." Note that the
Connect button will be inactive unless a menu item is selected in the
Source list.</Para>
<Para>If Access Help Volume is chosen, text fields labelled "Volume" and
"Location" are activated, for typing in the volume name and location
ID for displaying a help volume.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>View</Term>
<ListItem>
<Para>An option menu and a scrolling list for choosing what type of
source connections to view and for selecting a connection to edit or
delete. View types are primarily App Builder objects (Button, Choice,
Control Pane, etc.) and object items (Choice Item, Menu Item, Menubar
Item). In addition, there is a View type called Application, which is
relevant for Session Management and ToolTalk functions, and a View
type called Source Object, for viewing connections for the object
selected in the Source scrolling list.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Connect</Term>
<ListItem>
<Para>A push button for creating a connection between the Source
and Target objects, according to the When and Action Type choices. The
connection is displayed in the View scrolling list.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Change</Term>
<ListItem>
<Para>A push button for applying changes made to the connection
selected in the View scrolling list.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Delete</Term>
<ListItem>
<Para>A push button for deleting the connection selected in the View
scrolling list.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Cancel</Term>
<ListItem>
<Para>A push button to cancel any changes made in the Connections
Editor since the last time Connect was clicked; this alos closes the editor.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Help</Term>
<ListItem>
<Para>A push button to display on-item help for the Connections
Editor.</Para>
</ListItem>
</VarListEntry>
</VariableList>
</Sect2>
<Sect2 Id="ABMessagesEditor">
<Title>Message Editor</Title>
<IndexTerm>
<Primary>message editor</Primary>
</IndexTerm>
<IndexTerm>
<Primary>dialog title, message editor</Primary>
</IndexTerm>
<IndexTerm>
<Primary>message type</Primary>
</IndexTerm>
<IndexTerm>
<Primary>error message</Primary>
</IndexTerm>
<IndexTerm>
<Primary>information message</Primary>
</IndexTerm>
<IndexTerm>
<Primary>working message</Primary>
</IndexTerm>
<IndexTerm>
<Primary>question message</Primary>
</IndexTerm>
<IndexTerm>
<Primary>warning message</Primary>
</IndexTerm>
<IndexTerm>
<Primary>action buttons, message editor</Primary>
</IndexTerm>
<Para>Used to create various types of messages to be displayed at
appropriate times in the compiled application; the Message Editor
is described below. See <XRef Linkend="ABMessageExample"> for a discussion of
how to connect messages to the functions that cause them to be
displayed, with examples.</Para>
<Graphic Entityref="MessageEditorFig" Id="H.REF.fig.17"></Graphic>
<VariableList>
<VarListEntry>
<Term>Messages</Term>
<ListItem>
<Para>A scrolling list displaying all messages for the current
project; the module name precedes the message name in the list.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>[Module option menu]</Term>
<ListItem>
<Para>An option menu below the Messages list for
selecting the module for which you wish to add a new message. The
module name precedes the message name in the list.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Add Message</Term>
<ListItem>
<Para>A push button for adding a new message to the Messages
list -- to the module selected in the module option menu.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Delete Message</Term>
<ListItem>
<Para>A push button for deleting the currently-selected
message.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Name</Term>
<ListItem>
<Para>A text field for specifying the name of the current message;
messages are given names such as "message," "message2," "message3," by
default.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Dialog Title</Term>
<ListItem>
<Para>A text field for specifying the title that will appear
at the top of the message dialog box.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Type</Term>
<ListItem>
<Para>An option menu for specifying the type of message to be
created; the choices, which appear above the message text pane, are
Error, Information, Working, Question, and Warning. The appropriate
message icon also appears in the message dialog box.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>[Message text pane</Term>
<ListItem>
<Para>A text pane for entering the text of the message.
Note that you need to press Return when you want the text to start
a new line. The label above the text pane varies, depending on what
type of message you have chosen.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>[Button check boxes]</Term>
<ListItem>
<Para>Check boxes for specifying which buttons will
be included at the bottom of the message dialog box. Each message type
has a different set of buttons specified by default; these default
choices can be changed. The Action1, Action2, Action3, and Cancel
buttons are used in the Connections Editor; see <XRef Linkend="ABCreateMessage">for detailed instructions.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Connections [button]</Term>
<ListItem>
<Para>A push button for displaying the Connections
Editor to specify what functions to call for each of the Action
buttons and the Cancel button.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Help Text</Term>
<ListItem>
<Para>A push button for displaying the Help Editor and writing
help text to be displayed when the Help button is clicked in the
message dialog box.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Show Dialog</Term>
<ListItem>
<Para>A push button for displaying the selected message in a
message dialog box that looks like the actual dialog box in the
compiled application. Click on one of the buttons other than Help to
dismiss the dialog box.</Para>
</ListItem>
</VarListEntry>
</VariableList>
<Para>See <XRef Linkend="ABCommonButtons"> for descriptions of the buttons at the
bottom of the editor.</Para>
<Procedure>
<Title>See Also</Title>
<Step>
<ItemizedList Mark="&bull;" Role="tight">
<ListItem Id="H.REF.item.184">
<Para><XRef Linkend="ABCreateMessage">
</Para>
</ListItem>
<ListItem Id="H.REF.item.185">
<Para><XRef Linkend="ABConnectionsEditor">
</Para>
</ListItem>
<ListItem Id="H.REF.item.186">
<Para><XRef Linkend="ABMessageExample">
</Para>
</ListItem>
</ItemizedList>
</Step>
</Procedure>
</Sect2>
<Sect2 Id="ABGroupEdRef">
<Title>Groups Editor</Title>
<Para>The Groups Editor is a property editor; see <XRef Linkend="ABGroupsEditor">.</Para>
</Sect2>
<Sect2 Id="ABAttachmentsEditor">
<Title>Attachments Editor</Title>
<Para>Used to attach objects to each other for layout purposes, the
Attachments Editor is described below. See <XRef Linkend="ABAttachObj"> for
instructions. See <XRef Linkend="ABCommonButtons"> for descriptions of the
buttons at the bottom of the editor.</Para>
<Graphic Entityref="AttachEditorFig" Id="H.REF.fig.18"></Graphic>
<VariableList>
<VarListEntry>
<Term>Object Type</Term>
<ListItem>
<Para>An option menu for choosing the type of object for which
you wish to make attachments. Some object types (custom dialog, file
selection dialog, main window) do not have parents and are not
included in the menu.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Objects</Term>
<ListItem>
<Para>A scrolling list for selecting the object for which you wish
to make attachments.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Parent</Term>
<ListItem>
<Para>A text field that indicates the parent of the selected
object.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Children</Term>
<ListItem>
<Para>A scrolling list that lists the children of the Parent
object.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Parent attachments / Attachments in child</Term>
<ListItem>
<Para>Radio buttons for
displaying the attachments of the parent of the selected object or the
attachments of the children of the selected object.</Para>
<!-- Some objects (draw area pane, term pane, text pane) cannot have
children and may be children of a main window or custom dialog; thus,
neither Parent attachments nor Attachments in child will be active. If
the pane is a child of another pane, though, or if it is part of a
layered pane, Parent attachments will be active. -->
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Attach To</Term>
<ListItem>
<Para>Option menus for choosing the type of attachment for the
selected object and what to attach the object to, and text fields for
specifying the Offset (in pixels) from the selected object and its
parent or sibling and for specifying the Percentage offset of the
selected object from its parent. The option menu below "Attach To:" is
for choosing which sibling to attach to and is active only for sibling
attachments (two small squares). The Offset text field is active for
absolute (pixel) attachments only; the Percentage text field is active
for percentage attachments only.</Para>
<Para>The selected object is shown in the center of its four possible
attachments. The attachments, starting at the top and going clockwise,
are top edge of selected object, right edge of selected object, bottom
edge of selected object, and left edge of selected object. Each of the
possible types of attachments is described below; by default an object
is attached at its top and left edges to the top and left edges of its
parent. The selected object (the object at the center of the four
Attach To boxes) is the <Emphasis>controlling</Emphasis> object: if you move
this controlling object, the pixel or percentage offset is changed;
click Reset to see current values after moving an attached object.</Para>
</ListItem>
</VarListEntry>
</VariableList>
<Para><InlineGraphic Remap="graphic" Role="left" Entityref="AttachTopFig"></InlineGraphic> An ascending line from the top
edge of a small square to the top edge of its surrounding box
represents an absolute (pixel offset) attachment of the top edge of
the selected object to the top edge of its parent. If the parent
object is resized, the selected object will retain its pixel offset
from the top edge of its parent. The offset will change if the
selected object is moved.</Para>
<Para><InlineGraphic Remap="graphic" Role="left" Entityref="AttachBottomFig"></InlineGraphic> A descending line from the
top edge of a small square to the bottom edge of its surrounding box
represents an absolute (pixel offset) attachment of the top edge of
the selected object to the bottom edge of its parent. The offset will
change if the selected object is moved. This value will be negative,
since x values are positive as they ascend and negative as they
descend.</Para>
<Para><InlineGraphic Remap="graphic" Role="left" Entityref="AttachTwoFig"></InlineGraphic> Two vertically-aligned
squares connected by a vertical line represents an absolute (pixel
offset) attachment of the top edge of the selected object to the
bottom edge of its sibling (a sibling is another object with the same
parent). The offset will change if the selected object is moved. This
icon is inactive if the selected object has no siblings. This value
will be negative if the top edge of the selected object is above the
bottom edge of its sibling.</Para>
<Para><InlineGraphic Remap="graphic" Role="left" Entityref="AttachCentersFig"></InlineGraphic> Two horizontally-aligned
squares connected by a horizontal line to the centers of their top
edges represents an absolute (pixel offset) attachment of the vertical
center of the selected object to the vertical center of its sibling (a
sibling is another object with the same parent). The offset will
change if the selected object is moved. This icon is inactive if the
selected object has no siblings. This value will be negative if the
center of the selected object is above the center of its sibling.</Para>
<Para><InlineGraphic Remap="graphic" Role="left" Entityref="AttachPercentTopFig"></InlineGraphic> A square with a
two-headed arrow and a percentage sign above it represents a
percentage offset attachment of the top edge of the selected object to
the top edge of its parent. The offset will change if the selected
object is moved. If the parent object is resized, the selected object
will retain its percentage offset from the top edge of the parent.</Para>
<Para><InlineGraphic Remap="graphic" Role="left" Entityref="AttachPercentCenterFig"></InlineGraphic> A square with a
percentage sign above it and a two-headed arrow between the center
line of the square and the top of the surrounding box represents a
percentage offset attachment of the center of the selected object to
the top edge of its parent. The offset will change if the selected
object is moved. If the parent object is resized, the selected object
will retain its percentage offset from the top edge of the parent.</Para>
<Para><InlineGraphic Remap="graphic" Role="left" Entityref="AttachNoneFig"></InlineGraphic> A circle with a diagonal
line through it represents no attachment from the edge (top, left,
bottom, or right) to another object. By default a dropped object has
no right or bottom edge attachments.</Para>
<Para>Note: descriptions of the attachments to the right, bottom, and left
edges of the selected object are correlatives of the descriptions of
the top-edge attachments above. Substitute "bottom" for "top" and
"top" for "bottom" for bottom-edge attachments. Substitute "right" for
"top" and "left" for "bottom" for right-edge attachments. Substitute
"left" for "top" and "right" for "bottom" for left-edge attachments.</Para>
<Procedure>
<Title>See Also</Title>
<Step>
<ItemizedList Mark="&bull;" Role="tight">
<ListItem Id="H.REF.item.187">
<Para><XRef Linkend="ABAttachObj"></Para>
</ListItem>
<ListItem Id="H.REF.item.188">
<Para><XRef Linkend="ABMakeGroup">
</Para>
</ListItem>
<ListItem Id="H.REF.item.189">
<Para><XRef Linkend="ABCommonButtons">
</Para>
</ListItem>
<ListItem Id="H.REF.item.190">
<Para><XRef Linkend="ABAboutAttachments">
</Para>
</ListItem>
</ItemizedList>
</Step>
</Procedure>
</Sect2>
<Sect2 Id="ABDragDropEditor">
<Title>Drag and Drop Editor</Title>
<Para>Used to establish drag and drop behavior, the Drag and Drop Editor is
described below. See <XRef Linkend="ABCommonButtons"> for descriptions of the
buttons at the bottom of the editor.</Para>
<Graphic Entityref="DragandDropEditorFig" Id="H.REF.fig.19"></Graphic>
<VariableList>
<VarListEntry>
<Term>Object Type</Term>
<ListItem>
<Para>An option menu for choosing the type of object (Control
Pane, Custom Dialog, Draw Area Pane, Label, or Main Window) for which
you wish to establish drag and drop behavior.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Objects</Term>
<ListItem>
<Para>A scrolling list for selecting a specific object for which
you wish to establish drag and drop behavior.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Drag Operations</Term>
<ListItem>
<Para>Check boxes for specifying which types of operations
(Copy, Move, Link) will be legal for the selected object.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Cursor Filename</Term>
<ListItem>
<Para>A text field for typing the name of the graphics
file that contains the graphical representation of the cursor that
will be displayed as a drag from the selected object is being
performed.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Cursor Mask Filename</Term>
<ListItem>
<Para>A text field for typing the name of the
graphics file that contains the bitmap which determines the shape of
the visible representation of the cursor beneath the cursor mask. The
cursor mask acts like a stencil, allowing only the pixels in the
cursor that correspond to pixels in the mask to be visible.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Data Types</Term>
<ListItem>
<Para>Check boxes for specifying Text, Filename, and User
Defined as legal data types for drag operations.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Drag Connection</Term>
<ListItem>
<Para>A push button to display the Connections Editor for
creating the Call Function connection that makes the dragged-from
operation functional.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Drop Operations</Term>
<ListItem>
<Para>Check boxes for specifying which types of operations
(Copy, Move, Link) will be legal for the selected object.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Data Types</Term>
<ListItem>
<Para>Check boxes for specifying Text, Filename, User
Defined, and Any Other Type as legal data types for drop operations.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Drop on Children</Term>
<ListItem>
<Para>A check box for specifying whether a child of the
selected object will be a legal drop site; this is relevant only if
the child object is specified as a legal drop site.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Drop Connection</Term>
<ListItem>
<Para>A push button to display the Connections Editor for
creating the Call Function connection that makes the dropped-on
operation functional.</Para>
</ListItem>
</VarListEntry>
</VariableList>
<Procedure>
<Title>See Also</Title>
<Step>
<ItemizedList Mark="&bull;" Role="tight">
<ListItem Id="H.REF.item.191">
<Para><XRef Linkend="ABMakeDragandDrop">
</Para>
</ListItem>
<ListItem Id="H.REF.item.192">
<Para><XRef Linkend="ABConnectionsEditor">
</Para>
</ListItem>
</ItemizedList>
</Step>
</Procedure>
</Sect2>
<Sect2 Id="ABAppFrameworkEditor">
<Title>Application Framework Editor</Title>
<Para>Use to specify basic functionality in the application being built
with App Builder. Each section of the Application Framework Editor is
described below.
&newline; &empty;
</Para>
<Graphic Entityref="AppFrameworkEdFig" Id="H.REF.fig.20"></Graphic>
<VariableList>
<VarListEntry>
<Term>Application Vendor Name</Term>
<ListItem>
<Para>A text field for typing an optional string,
which will be stored in the source code. Used in the call to
initialize ToolTalk (if ToolTalk is enabled).</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Application Version</Term>
<ListItem>
<Para>A text field for typing an optional string,
which will be stored in the source code. Used in the call to
initialize ToolTalk.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Application Primary Main Window</Term>
<ListItem>
<Para>An option menu fo specifying the
primary main window of the application being developed. An application
may have more than one main window, but only one primary window. This
window is typically the window which is first displayed when the
application is opened. By default the first main window dropped on
the desktop in a new project is the primary window.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Internationalization Enabled</Term>
<ListItem>
<Para>A check box for specifying whether
internationalization is enabled; if checked, turns on XPG4-compliant
internationalization in the generated code for the project. In the
[module]_ui.c file, all labels and strings for objects are generated,
enclosed by the catgets(3C) call, which is used to fetch the
appropriate localized version of the string at runtime. If
internationalization is turned on, dtcodegen will also automatically
generate and maintain the message catalog ([project].msg) which maps
to the generated catgets(3C) calls.</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Generated Code</Term>
<ListItem>
<Para>Check boxes for specifying which categories of object
attributes (which map to Xt Resources) should be written into a
Resource file instead of placing them directly in the [module]_ui.c
file -- which is the default. Any attribute (resource) which is
specified in a Resource file -- and not directly in the code -- can be
modified without recompiling the application. The Attribute categories
are as follows:</Para>
<ItemizedList Mark="&bull;" Role="tight">
<ListItem Id="H.REF.item.193">
<Para>Colors: Background, Foreground
</Para>
</ListItem>
<ListItem Id="H.REF.item.194">
<Para>Label Strings: Label String, Title
</Para>
</ListItem>
<ListItem Id="H.REF.item.195">
<Para>Initial Values: Initial Value
</Para>
</ListItem>
<ListItem Id="H.REF.item.196">
<Para>Geometry: X, Y, Width, Height, all attachment
attributes
</Para>
</ListItem>
<ListItem Id="H.REF.item.197">
<Para>Other Strings
</Para>
</ListItem>
<ListItem Id="H.REF.item.198">
<Para>Other</Para>
</ListItem>
</ItemizedList>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>Session Management Method</Term>
<ListItem>
<Para>An option menu for specifying the method
of session management (None, Command Line, Session File, or Both), and
two push buttons (Session Save Connection, Session Restore Connection)
for displaying the Connections Editor and making appropriate
connections.</Para>
<!-- xxx? -->
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>ToolTalk Desktop Message Handling</Term>
<ListItem>
<Para>An option menu for specifying what
level of the ToolTalk Desktop Message Alliance protocol the
application will participate in, and a push button (Advanced ToolTalk
Connections) for displaying the Connections Editor. The ToolTalk
desktop protocol is a set of predefined ToolTalk messages which
communicate desktop-type events or requests to a running application.
App Builder support for ToolTalk is provided at three levels: None,
Basic, or Advanced, as described below.</Para>
<ItemizedList Mark="&bull;" Role="tight">
<ListItem Id="H.REF.item.199">
<Para>None. There is no participation in the ToolTalk Desktop
Protocol; no ToolTalk code is generated.</Para>
</ListItem>
<ListItem Id="H.REF.item.200">
<Para>Basic. The ToolTalk library responds to Desktop messages in
categories 1-3 in a predefined and standard way. Code is generated in
main() which initializes ToolTalk and calls the function which tells
ToolTalk to handles these messages. At this level, you do not need to
write any special application code.</Para>
</ListItem>
<ListItem Id="H.REF.item.201">
<Para>Advanced. The ToolTalk library responds to messages in
categories 1 and 2, but the application is notified (via callback)
when messages in categories 3 & 4 are received.</Para>
<Para>If you choose Advanced, you must use the Connections Editor to
identify which messages the application wishes to handle. If you
click the Advanced ToolTalk Connections button, the Connections Editor
will be displayed with Application as the Source object type. The When
option menu lists four ToolTalk choices: ToolTalk Do Command, ToolTalk
Get Status, ToolTalk Pause/Resume, and ToolTalk Quit. The only valid
action a ToolTalk connection is Call Function; your callback function
will be called when the ToolTalk message is received.</Para>
<Para>At this level code is generated in [project].c:main() which
initializes ToolTalk and sets up the Desktop Protocol so that the
callbacks defined in the Connections Editor will be called when the
corresponding message is received. Each user-defined callback
contains descriptive comments describing what the application is
expected to do in response to the message. These callbacks are also
generated in [project].c.</Para>
</ListItem>
</ItemizedList>
</ListItem>
</VarListEntry>
</VariableList>
<Para>See <XRef Linkend="ABCommonButtons"> for descriptions of the buttons at the
bottom of the editor.</Para>
<Procedure>
<Title>See Also</Title>
<Step>
<ItemizedList Mark="&bull;" Role="tight">
<ListItem Id="H.REF.item.202">
<Para><XRef Linkend="ABMakeAppFramework">
</Para>
</ListItem>
<ListItem Id="H.REF.item.203">
<Para><XRef Linkend="ABConnectionsEditor">
</Para>
</ListItem>
</ItemizedList>
<!-- EOF -->
</Step>
</Procedure>
</Sect2>
</Sect1>
</Chapter>
<!--fickle 1.15 help-to-docbook 1.4 01/17/96 17:37:35-->