cdesktopenv/cde/doc/C/guides/builderGuide/appb.sgm

1579 lines
66 KiB
Plaintext

<!-- $XConsortium: appb.sgm /main/9 1996/10/22 12:19:54 rws $ -->
<!-- (c) Copyright 1995 Digital Equipment Corporation. -->
<!-- (c) Copyright 1995 Hewlett-Packard Company. -->
<!-- (c) Copyright 1995 International Business Machines Corp. -->
<!-- (c) Copyright 1995 Sun Microsystems, Inc. -->
<!-- (c) Copyright 1995 Novell, Inc. -->
<!-- (c) Copyright 1995 FUJITSU LIMITED. -->
<!-- (c) Copyright 1995 Hitachi. -->
<Appendix Id="ABUG.apRPE.div.1">
<Title Id="ABUG.apRPE.mkr.1">Revolving Property Editor</Title>
<Para>Used to edit the <Emphasis>properties</Emphasis> (the look or functionality) of interface objects, the
Revolving Property Editor customizes your application interface. This
appendix describes the properties common to all property editors, and the
properties and the buttons common to a number of property editors. It also
describes the individual property editors for each object.</para>
<InformalTable Id="ABUG.apRPE.itbl.1" Frame="All">
<TGroup Cols="1">
<ColSpec Colname="1" Colwidth="4.0 in">
<TBody>
<Row Rowsep="1">
<Entry><Para><!--Original XRef content: 'Property Editor: Universal Properties136'--><XRef Role="JumpText" Linkend="ABUG.apRPE.mkr.2"></Para></Entry>
</Row>
<Row Rowsep="1">
<Entry><Para><!--Original XRef content: 'Property Editor: Common Properties137'--><XRef Role="JumpText" Linkend="ABUG.apRPE.mkr.3"></Para></Entry>
</Row>
<Row Rowsep="1">
<Entry><Para><!--Original XRef content: 'Property Editor: Common Buttons139'--><XRef Role="JumpText" Linkend="ABUG.apRPE.mkr.4"></Para></Entry>
</Row>
<Row Rowsep="1">
<Entry><Para><!--Original XRef content: 'Individual Property Editors140'--><XRef Role="JumpText" Linkend="ABUG.apRPE.mkr.5"></Para></Entry>
</Row>
</TBody>
</TGroup>
</InformalTable>
<Para>The property editor for a separator, which includes the properties common to
almost all property editors, is shown below, with common elements noted.</Para>
<!-- REVIEWERS - Following figure will be updated to include callouts -
same as in CDE1. -->
<Graphic Entityref="ABUG.apRPE.fig.1" Id="ABUG.apRPE.igrph.1"></Graphic>
<Sect1 Id="ABUG.apRPE.div.2">
<Title Id="ABUG.apRPE.mkr.2">Property Editor: Universal Properties</Title>
<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.<IndexTerm>
<Primary>Revolving Property Editor</Primary>
<Secondary>universal properties in &lt;$startrange></Secondary>
</IndexTerm>
</Para>
<informaltable>
<tgroup cols="2" colsep="0" rowsep="0">
<colspec align="left" colwidth="100*">
<colspec align="left" colwidth="356*">
<tbody>
<Row>
<Entry><Para>Object Type</para></Entry>
<Entry><Para>Not a property. Object Type is an option menu for
choosing the type of property editor to be displayed.
Properties change depending on which object type is
chosen.</para></Entry></Row>
<Row>
<Entry><Para>Objects</para></Entry>
<Entry><Para>Not a property. Objects lists the objects of the selected
object 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></Entry>
</Row>
<Row>
<Entry><Para>Object Name</para></Entry>
<Entry><Para>Displays the default name or the name given by you to
the object selected in the Objects list.</para></Entry>
</Row>
<Row>
<Entry><Para><IndexTerm>
<Primary>Initial State property</Primary>
<Secondary>Visible</Secondary>
</IndexTerm>Initial State, Visible</para></Entry>
<Entry><Para>Specifies whether the selected object is visible when the
application starts up; all objects except a custom dialog
are visible by default.</Para></Entry>
</Row>
<Row>
<Entry><Para><IndexTerm>
<Primary>Initial State property</Primary>
<Secondary>active</Secondary>
</IndexTerm>Initial State, Active</para></Entry>
<Entry><Para>A check box for specifying whether the object selected
is &ldquo;active&rdquo; when the application starts up. An inactive
object is not functional: it is dimmed and no functions
can be activated from the object.</Para></Entry>
</Row>
<Row>
<Entry><Para><IndexTerm>
<Primary>color</Primary>
<Secondary>background</Secondary>
</IndexTerm><IndexTerm>
<Primary>color</Primary>
<Secondary>foreground</Secondary>
</IndexTerm><IndexTerm>
<Primary>foreground color</Primary>
</IndexTerm><IndexTerm>
<Primary>background color</Primary>
</IndexTerm>Color: Background</para></Entry>
<Entry><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></Entry>
</Row>
<Row>
<Entry><Para>Color: Foreground</para></Entry>
<Entry><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.<IndexTerm>
<Primary>Revolving Property Editor</Primary>
<Secondary>universal properties in &lt;$endrange></Secondary>
</IndexTerm>
</Para></Entry>
</Row>
</TBody>
</TGroup>
</InformalTable>
</Sect1>
<Sect1 Id="ABUG.apRPE.div.3">
<Title Id="ABUG.apRPE.mkr.3">Property Editor: Common Properties</Title>
<Para>The following properties are common to three or more property editors.<IndexTerm>
<Primary>Revolving Property Editor</Primary>
<Secondary>common properties in &lt;$startrange></Secondary>
</IndexTerm>
</Para>
<informaltable>
<tgroup cols="2" colsep="0" rowsep="0">
<colspec align="left" colwidth="100*">
<colspec align="left" colwidth="356*">
<tbody>
<Row>
<Entry><Para><IndexTerm>
<Primary>Border Frame property</Primary>
</IndexTerm><IndexTerm>
<Primary>border</Primary>
<Secondary>types of</Secondary>
</IndexTerm>Border Frame</para></Entry>
<Entry><Para>Determines the type of border, if any, around certain
objects. Choices are None, Shadow Out, Shadow In,
Etched Out, and Etched In.</Para></Entry>
</Row>
<Row>
<Entry><Para>Geometry</para></Entry>
<Entry><Para><IndexTerm>
<Primary>Geometry property</Primary>
</IndexTerm><IndexTerm>
<Primary>objects</Primary>
<Secondary>XY location of</Secondary>
</IndexTerm><IndexTerm>
<Primary>objects</Primary>
<Secondary>width and height values of</Secondary>
</IndexTerm>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></Entry>
</Row>
<Row>
<Entry><Para>Graphic Filename</para></Entry>
<Entry><Para><IndexTerm>
<Primary>Graphic Filename property</Primary>
</IndexTerm>Indicates the name of the pixmap (<Filename>.pm</Filename>) or bitmap
(<Filename>.bm</Filename>) 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
&ldquo;Graphic.&rdquo;</Para></Entry>
</Row>
<Row>
<Entry><Para>Item Label Type</para></Entry>
<Entry><Para><IndexTerm>
<Primary>Item Label Type property</Primary>
</IndexTerm>Specifies the type of label (String or Graphic) for the
selected item in the Items list. If Graphic is chosen,
&ldquo;Label&rdquo; becomes &ldquo;Graphic Filename.&rdquo;</para></Entry>
</Row>
<Row>
<Entry><Para>Item State, Active</para></Entry>
<Entry><Para><IndexTerm>
<Primary>Item State property</Primary>
</IndexTerm>Specifies whether the selected item will be active
when the compiled application is opened.</para></Entry>
</Row>
<Row>
<Entry><Para>Items</para></Entry>
<Entry><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></Entry>
</Row>
<Row>
<Entry><Para>Label (Object/Item)</para></Entry>
<Entry><Para><IndexTerm>
<Primary>objects</Primary>
<Secondary>label setting for</Secondary>
</IndexTerm><IndexTerm>
<Primary>Label property</Primary>
</IndexTerm>Specifies the label for the selected object or item.
&ldquo;Label&rdquo; becomes &ldquo;Graphic Filename&rdquo; if Graphic Label
Type is chosen. Label is inactive in the Button
property editor if Arrow Label Type is chosen.</para></Entry>
</Row>
<Row>
<Entry><Para>Label Type</para></Entry>
<Entry><Para><IndexTerm>
<Primary>Label Type property</Primary>
</IndexTerm><IndexTerm>
<Primary>objects</Primary>
<Secondary>label type for</Secondary>
</IndexTerm>Specifies the type of label (String, Graphic, or Arrow)
for the selected object. If Graphic is chosen, &ldquo;Label&rdquo;
becomes &ldquo;Graphic Filename.&rdquo; If you choose Arrow,
the label in the Button property editor becomes an
arrow and the Arrow Direction property becomes
active.</Para></Entry>
</Row>
<Row>
<Entry><Para>Menu Title</para></Entry>
<Entry><Para><IndexTerm>
<Primary>Menu Title property</Primary>
</IndexTerm><IndexTerm>
<Primary>menus</Primary>
<Secondary>setting title for pop-up</Secondary>
</IndexTerm>Specifies the (optional) title of the pop-up menu, if
any.</para></Entry>
</Row>
<Row>
<Entry><Para>Popup, Pulldown Menu</para></Entry>
<Entry><Para><IndexTerm>
<Primary>menus</Primary>
<Secondary>property for attaching</Secondary>
</IndexTerm><IndexTerm>
<Primary>submenus</Primary>
<Secondary>property for attaching</Secondary>
</IndexTerm>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></Entry>
</Row>
<Row>
<Entry><Para>Position (Label)</para></Entry>
<Entry><Para><IndexTerm>
<Primary>Position property</Primary>
</IndexTerm><IndexTerm>
<Primary>labels</Primary>
<Secondary>position setting for</Secondary>
</IndexTerm>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></Entry>
</Row>
<Row>
<Entry><Para>Position [XY]</para></Entry>
<Entry><Para><IndexTerm>
<Primary>objects</Primary>
<Secondary>position in relation to parent</Secondary>
</IndexTerm><IndexTerm>
<Primary>Position property</Primary>
</IndexTerm>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></Entry>
</Row>
<Row>
<Entry><Para>Scrollbars</para></Entry>
<Entry><Para><IndexTerm>
<Primary>Scrollbars setting</Primary>
</IndexTerm><IndexTerm>
<Primary>panes</Primary>
<Secondary>attaching a scroll bar to</Secondary>
</IndexTerm>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></Entry>
</Row>
<Row>
<Entry><Para>Size</para></Entry>
<Entry><Para><IndexTerm>
<Primary>Size property</Primary>
</IndexTerm><IndexTerm>
<Primary>windows</Primary>
<Secondary>setting absolute width and height for</Secondary>
</IndexTerm><IndexTerm>
<Primary>panes</Primary>
<Secondary>setting absolute width and height for</Secondary>
</IndexTerm>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></Entry>
</Row>
<Row>
<Entry><Para>Size Policy</para></Entry>
<Entry><Para><IndexTerm>
<Primary>Size Policy property</Primary>
</IndexTerm><IndexTerm>
<Primary>windows</Primary>
<Secondary>setting size of</Secondary>
</IndexTerm><IndexTerm>
<Primary>objects</Primary>
<Secondary>setting fixed size</Secondary>
</IndexTerm><IndexTerm>
<Primary>objects</Primary>
<Secondary>setting size to fit contents</Secondary>
</IndexTerm><IndexTerm>
<Primary>size</Primary>
<Secondary>to fit contents</Secondary>
</IndexTerm>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.<IndexTerm>
<Primary>Revolving Property Editor</Primary>
<Secondary>common properties in &lt;$endrange></Secondary>
</IndexTerm>
</Para></Entry>
</Row>
</TBody>
</TGroup>
</InformalTable>
<Note>
<Para><Literal>List item editing</Literal>: once you have the appropriate number of items in
the list, the easiest way to perform item editing in those property editors that
have an item list* is to select the first item in the list, thus selecting it in the
label text field. Type a new name for the item and click Return. The new name
will be displayed in the item list and the next item in the list will be selected.
Continue down the list with this select, type, Return sequence until all items
are completed.
*Property editors with item lists include the choice objects (Radio Box, Check
Box, Option Menu), Combo Box, List, Menu, Menubar, and Spin Box.</Para>
</Note>
</Sect1>
<Sect1 Id="ABUG.apRPE.div.4">
<Title Id="ABUG.apRPE.mkr.4">Property Editor: Common Buttons</Title>
<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.<IndexTerm>
<Primary>Revolving Property Editor</Primary>
<Secondary>common buttons in &lt;$startrange></Secondary>
</IndexTerm>
</Para>
<informaltable>
<tgroup cols="2" colsep="0" rowsep="0">
<colspec align="left" colwidth="100*">
<colspec align="left" colwidth="356*">
<tbody>
<Row>
<Entry><Para>Tear-off</para></Entry>
<Entry><Para><IndexTerm>
<Primary>Tear-off button</Primary>
</IndexTerm><IndexTerm>
<Primary>editor</Primary>
<Secondary>retaining on workspace</Secondary>
</IndexTerm>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></Entry>
</Row>
<Row>
<Entry><Para>Add Item</para></Entry>
<Entry><Para><IndexTerm>
<Primary>Add Item button</Primary>
</IndexTerm><IndexTerm>
<Primary>adding</Primary>
<Secondary>items to Items list</Secondary>
</IndexTerm>Adds an item after the selected item in the Items list.
Added items are given default names starting with
&ldquo;Item1&rdquo; and incrementing, as needed. By default, items
are added after the selected item.</para></Entry>
</Row>
<Row>
<Entry><Para>Edit</para></Entry>
<Entry><Para><IndexTerm>
<Primary>Edit button</Primary>
</IndexTerm>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></Entry>
</Row>
<Row>
<Entry><Para>Attachments</para></Entry>
<Entry><Para><IndexTerm>
<Primary>Attachments button</Primary>
</IndexTerm>Displays the Attachments Editor; there is no
Attachments button on the Main Window, Menubar,
Custom Dialog, or Paned Window property editors.</para></Entry>
</Row>
<Row>
<Entry><Para>Help Text</para></Entry>
<Entry><Para><IndexTerm>
<Primary>Help Text button</Primary>
</IndexTerm>Displays the Help Editor.</Para></Entry>
</Row>
<Row>
<Entry><Para>Connections</para></Entry>
<Entry><Para>Displays the Connections<IndexTerm>
<Primary>Connections button</Primary>
</IndexTerm>
Editor.</para></Entry>
</Row>
<Row>
<Entry><Para>OK</para></Entry>
<Entry><Para>Applies the changes made to the selected object and
dismisses the editor; changes to properties are marked
with change bars at the left side of the editor.<IndexTerm>
<Primary>OK button</Primary>
</IndexTerm>
</Para></Entry>
</Row>
<Row>
<Entry><Para>Apply</para></Entry>
<Entry><Para><IndexTerm>
<Primary>Apply button</Primary>
</IndexTerm>Applies the changes made to the selected object, but
does not dismiss the editor.</Para></Entry>
</Row>
<Row>
<Entry><Para>Reset</para></Entry>
<Entry><Para><IndexTerm>
<Primary>Reset button</Primary>
</IndexTerm>Resets all changes made since the last Apply.</Para></Entry>
</Row>
<Row>
<Entry><Para>Cancel</para></Entry>
<Entry><Para><IndexTerm>
<Primary>Cancel button</Primary>
</IndexTerm>Resets all changes made since the last Apply and
dismisses the editor.</Para></Entry>
</Row>
<Row>
<Entry><Para>Help</para></Entry>
<Entry><Para>Displays help for the editor. See
<!--Original XRef content: '&xd2;Creating Help and
Help Connections&xd3; on page&numsp;67'--><XRef Role="SecTitleAndPageNum" Linkend="ABUG.afunc.mkr.2"> for information about
App Builder help.<IndexTerm><Primary>Revolving Property Editor</Primary><Secondary>common buttons in &lt;$endrange></Secondary></IndexTerm>
</Para></Entry>
</Row>
</TBody>
</TGroup>
</InformalTable>
</Sect1>
<Sect1 Id="ABUG.apRPE.div.5">
<Title Id="ABUG.apRPE.mkr.5">Individual Property Editors</Title>
<Para>An individual property editor is displayed by:</Para>
<ItemizedList Remap="Bullet1">
<ListItem>
<Para>Double-clicking an object in the interface or the Module Browser.</Para>
</ListItem>
<ListItem>
<Para><Emphasis>Or</Emphasis>, selecting an object of the desired type and choosing Properties from the
Editors menu on the App Builder primary window.</Para>
</ListItem>
<ListItem>
<Para><Emphasis>Or</Emphasis>, choosing Props from the interface or Browser pop-up menu.</Para>
</ListItem>
<ListItem>
<Para><Emphasis>Or</Emphasis>, choosing the desired object type from the Object Type options menu at
the top of the Revolving Property Editor.</Para>
</ListItem>
</ItemizedList>
<Para>The individual property editors are described in the following sections.</Para>
<Sect2 Id="ABUG.apRPE.div.6">
<Title>Button Property Editor<IndexTerm><Primary>Button property editor</Primary></IndexTerm><IndexTerm><Primary>property editor</Primary><Secondary>Button</Secondary></IndexTerm></Title>
<Para>Only properties unique to a button object are described here. See
<!--Original XRef content: '&xd2;Property
Editor: Universal Properties&xd3; on page&numsp;136'--><XRef Role="SecTitleAndPageNum" Linkend="ABUG.apRPE.mkr.2"> for descriptions of Object Type,
Objects, Object Name, Initial State, and Color. See
<!--Original XRef content: '&xd2;Property Editor: Common
Properties&xd3; on page&numsp;137'--><XRef Role="SecTitleAndPageNum" Linkend="ABUG.apRPE.mkr.3"> for descriptions of Label Type, Label, Pulldown Menu,
Size Policy, and Geometry.</para>
<informaltable>
<tgroup cols="2" colsep="0" rowsep="0">
<colspec align="left" colwidth="100*">
<colspec align="left" colwidth="356*">
<tbody>
<Row>
<Entry><Para>Button Type</para></Entry>
<Entry><Para><IndexTerm>
<Primary>button control</Primary>
<Secondary>properties of &lt;$startrange></Secondary>
</IndexTerm>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 &ldquo;
<!--Original XRef content: '&xd2;Controls Palette'--><XRef Role="SectionTitle" Linkend="ABUG.apWDB.mkr.5"> in
<!--Original XRef content: 'Appendix&numsp;A, &xd2;App Builder
Windows and Dialog Boxes'--><XRef Role="AppendixNumAndTitle" Linkend="ABUG.apRPE.mkr.1">, for descriptions of button
types.</Para></Entry>
</Row>
<Row>
<Entry><Para>Label Alignment</para></Entry>
<Entry><Para><IndexTerm>
<Primary>button control</Primary>
<Secondary>properties of &lt;$endrange></Secondary>
</IndexTerm><IndexTerm>
<Primary>labels</Primary>
<Secondary>for buttons</Secondary>
</IndexTerm>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></Entry>
</Row>
<Row>
<Entry><Para>Arrow Direction</para></Entry>
<Entry><Para><IndexTerm>
<Primary>Arrow Direction property</Primary>
</IndexTerm><IndexTerm>
<Primary>labels</Primary>
<Secondary>arrow direction for</Secondary>
</IndexTerm>Specifies which direction (Up, Down, Left, Right) the
arrow should point if Arrow Label Type is chosen.</para></Entry>
</Row>
</TBody>
</TGroup>
</InformalTable>
</Sect2>
<Sect2 Id="ABUG.apRPE.div.7">
<Title>Choice Property Editor<IndexTerm><Primary>Choice property editor</Primary></IndexTerm><IndexTerm><Primary>property editor</Primary><Secondary>Choice</Secondary></IndexTerm></Title>
<Para>Only properties unique to a choice object (Radio Box, Check Box, Option
Menu) are described here. See &ldquo;
<!--Original XRef content: '&xd2;Property Editor: Universal Properties&xd3; on
page&numsp;136'--><XRef Role="SecTitleAndPageNum" Linkend="ABUG.apRPE.mkr.2"> for descriptions of Object Type, Objects, Object Name, Initial State,
and Color. See &ldquo;
<!--Original XRef content: '&xd2;Property Editor: Common Properties&xd3; on page&numsp;137'--><XRef Role="SecTitleAndPageNum" Linkend="ABUG.apRPE.mkr.3"> for
descriptions of Label Type, Label Position, Label (Object), Items, Item Label
Type, Label (Item), Item State (Active), and Position [XY].<IndexTerm><Primary>editor</Primary><Secondary>&lt;Emphasis>See also&lt;Default Para Font> property editor&lt;$nopage>[editor aa]</Secondary></IndexTerm>
</Para>
<informaltable>
<tgroup cols="2" colsep="0" rowsep="0">
<colspec align="left" colwidth="100*">
<colspec align="left" colwidth="356*">
<tbody>
<Row>
<Entry><Para>Choice Type</para></Entry>
<Entry><Para><IndexTerm>
<Primary>objects</Primary>
<Secondary>choice</Secondary>
</IndexTerm><IndexTerm>
<Primary>choice objects</Primary>
</IndexTerm>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 &ldquo;
<!--Original XRef content: '&xd2;Controls
Palette'--><XRef Role="SectionTitle" Linkend="ABUG.apWDB.mkr.5"> in
<!--Original XRef content: 'Appendix&numsp;A, &xd2;App Builder Windows and
Dialog Boxes'--><XRef Role="AppendixNumAndTitle" Linkend="ABUG.apRPE.mkr.1">, for descriptions of choice types.</para></Entry>
</Row>
<Row>
<Entry><Para>Rows/Columns</para></Entry>
<Entry><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></Entry>
</Row>
<Row>
<Entry><Para>Item State, Selected</Para></Entry>
<Entry><Para><IndexTerm>
<Primary>choice objects</Primary>
</IndexTerm>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></Entry>
</Row>
</TBody>
</TGroup>
</InformalTable>
</Sect2>
<Sect2 Id="ABUG.apRPE.div.8">
<Title>Combo Box Property Editor<IndexTerm><Primary>Combo Box property editor</Primary></IndexTerm><IndexTerm><Primary>property editor</Primary><Secondary>Combo Box</Secondary></IndexTerm></Title>
<Para>Only properties unique to a combo box are described here. See
<!--Original XRef content: '&xd2;Property
Editor: Universal Properties&xd3; on page&numsp;136'--><XRef Role="SecTitleAndPageNum" Linkend="ABUG.apRPE.mkr.2"> for descriptions of Object Type,
Objects, Object Name, Initial State, and Color. See
<!--Original XRef content: '&xd2;Property Editor: Common
Properties&xd3; on page&numsp;137'--><XRef Role="SecTitleAndPageNum" Linkend="ABUG.apRPE.mkr.3"> for descriptions of Label Type, Label Position, Label,
Items, Item Label, and Position [XY].</para>
<informaltable>
<tgroup cols="2" colsep="0" rowsep="0">
<colspec align="left" colwidth="100*">
<colspec align="left" colwidth="356*">
<tbody>
<Row>
<Entry><Para>Combo Box Type</para></Entry>
<Entry><Para><IndexTerm>
<Primary>combo box control</Primary>
</IndexTerm>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></Entry>
</Row>
<Row>
<Entry><Para>Selected</para></Entry>
<Entry><Para>Specifies which item will be selected when the
compiled application is opened.</para></Entry>
</Row>
<Row>
<Entry><Para>Width</para></Entry>
<Entry><Para><IndexTerm>
<Primary>size</Primary>
<Secondary>setting for combo box</Secondary>
</IndexTerm>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></Entry>
</Row>
</TBody>
</TGroup>
</InformalTable>
</Sect2>
<Sect2 Id="ABUG.apRPE.div.9">
<Title>Control Pane Property Editor<IndexTerm><Primary>property editor</Primary><Secondary>Control Pane</Secondary></IndexTerm><IndexTerm><Primary>Control Pane property editor</Primary></IndexTerm></Title>
<Para>There are no properties unique to a control pane. See
<!--Original XRef content: '&xd2;Property Editor:
Universal Properties&xd3; on page&numsp;136'--><XRef Role="SecTitleAndPageNum" Linkend="ABUG.apRPE.mkr.2"> for descriptions of Object Type, Objects,
Object Name, Initial State, and Color. See
<!--Original XRef content: '&xd2;Property Editor: Common
Properties&xd3; on page&numsp;137'--><XRef Role="SecTitleAndPageNum" Linkend="ABUG.apRPE.mkr.3"> for descriptions of Border Frame, Size Policy,
Geometry, Popup Menu, and Menu Title.</Para>
</Sect2>
<Sect2 Id="ABUG.apRPE.div.10">
<Title>Custom Dialog Property Editor<IndexTerm><Primary>property editor</Primary><Secondary>Custom Dialog</Secondary></IndexTerm><IndexTerm><Primary>Custom Dialog property editor</Primary></IndexTerm></Title>
<Para>Only properties unique to a custom dialog object are described here. See
<!--Original XRef content: '&xd2;Property Editor: Universal Properties&xd3; on page&numsp;136'--><XRef Role="SecTitleAndPageNum" Linkend="ABUG.apRPE.mkr.2"> for descriptions of Object
Type, Objects, Object Name, Initial State, and Color. See
<!--Original XRef content: '&xd2;Property Editor:
Common Properties&xd3; on page&numsp;137'--><XRef Role="SecTitleAndPageNum" Linkend="ABUG.apRPE.mkr.3"> for descriptions of Size Policy and Size.</Para>
<informaltable>
<tgroup cols="2" colsep="0" rowsep="0">
<colspec align="left" colwidth="100*">
<colspec align="left" colwidth="356*">
<tbody>
<Row>
<Entry><Para>Dialog Title</para></Entry>
<Entry><Para><IndexTerm>
<Primary>naming</Primary>
<Secondary>custom dialog</Secondary>
</IndexTerm><IndexTerm>
<Primary>custom dialog</Primary>
<Secondary>properties of &lt;$startrange></Secondary>
</IndexTerm>The title that appears at the top of the custom dialog.</Para></Entry>
</Row>
<Row>
<Entry><Para>Window Parent</para></Entry>
<Entry><Para><IndexTerm>
<Primary>custom dialog</Primary>
<Secondary>parent main window for</Secondary>
</IndexTerm><IndexTerm>
<Primary>windows</Primary>
<Secondary>parent for custom dialog</Secondary>
</IndexTerm>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></Entry>
</Row>
<Row>
<Entry><Para>User Resize Mode</para></Entry>
<Entry><Para>Specifies whether the window is Fixed or Adjustable
(whether it can be resized in the compiled application).</Para></Entry>
</Row>
<Row>
<Entry><Para>Dialog Areas</para></Entry>
<Entry><Para><IndexTerm>
<Primary>custom dialog</Primary>
<Secondary>properties of &lt;$endrange></Secondary>
</IndexTerm>Specifies whether a custom dialog includes a Button
Panel (three buttons, by default) and a Footer area.</Para></Entry>
</Row>
<Row>
<Entry><Para>Default Button</para></Entry>
<Entry><Para><IndexTerm>
<Primary>custom dialog</Primary>
<Secondary>default buttons in</Secondary>
</IndexTerm><IndexTerm>
<Primary>default buttons</Primary>
<Secondary>for custom dialog</Secondary>
</IndexTerm>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></Entry>
</Row>
<Row>
<Entry><Para>Help Button</para></Entry>
<Entry><Para>Specifies one of the dialog buttons as the help button.
See
<!--Original XRef content: '&xd2;Creating Help and Help Connections&xd3; on
page&numsp;67'--><XRef Role="SecTitleAndPageNum" Linkend="ABUG.afunc.mkr.2">, for a description of the Help Editor and
instructions for creating help.</para></Entry>
</Row>
</TBody>
</TGroup>
</InformalTable>
</Sect2>
<Sect2 Id="ABUG.apRPE.div.11">
<Title>Draw Area Pane Property Editor<IndexTerm><Primary>Draw Area Pane property editor</Primary></IndexTerm><IndexTerm><Primary>property editor</Primary><Secondary>Draw Area Pane</Secondary></IndexTerm></Title>
<Para>Only the one property unique to a draw area pane object is described here. See
<!--Original XRef content: '&xd2;Property Editor: Universal Properties&xd3; on page&numsp;136'--><XRef Role="SecTitleAndPageNum" Linkend="ABUG.apRPE.mkr.2"> for descriptions of Object
Type, Objects, Object Name, Initial State, and Color. See
<!--Original XRef content: '&xd2;Property Editor:
Common Properties&xd3; on page&numsp;137'--><XRef Role="SecTitleAndPageNum" Linkend="ABUG.apRPE.mkr.3"> for descriptions of Scrollbars, Border Frame,
Geometry, Popup Menu, and Menu Title.</para>
<informaltable>
<tgroup cols="2" colsep="0" rowsep="0">
<colspec align="left" colwidth="100*">
<colspec align="left" colwidth="356*">
<tbody>
<Row>
<Entry><Para>Total Canvas Size</para></Entry>
<Entry><Para><IndexTerm>
<Primary>draw area pane</Primary>
<Secondary>size of canvas in</Secondary>
</IndexTerm><IndexTerm>
<Primary>size</Primary>
<Secondary>of draw area canvas</Secondary>
</IndexTerm>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></Entry>
</Row>
</TBody>
</TGroup>
</InformalTable>
</Sect2>
<Sect2 Id="ABUG.apRPE.div.12">
<Title>File Selection Dialog Property Editor<IndexTerm><Primary>property editor</Primary><Secondary>File Selection Dialog</Secondary></IndexTerm><IndexTerm><Primary>File Selection Dialog property editor</Primary></IndexTerm></Title>
<Para>Only properties unique to a file selection dialog object are described here. See
<!--Original XRef content: '&xd2;Property Editor: Universal Properties&xd3; on page&numsp;136'--><XRef Role="SecTitleAndPageNum" Linkend="ABUG.apRPE.mkr.2"> for descriptions of Object
Type, Objects, Object Name, Initial State, and Color.</para>
<informaltable>
<tgroup cols="2" colsep="0" rowsep="0">
<colspec align="left" colwidth="153*">
<colspec align="left" colwidth="375*">
<tbody>
<Row>
<Entry><Para>Window Parent</para></Entry>
<Entry><Para><IndexTerm>
<Primary>file selection dialog</Primary>
<Secondary>properties of &lt;$startrange></Secondary>
</IndexTerm>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.</para></Entry>
</Row>
<Row>
<Entry><Para>Dialog Title</para></Entry>
<Entry><Para>Specifies the title that appears in the title bar at the top
of the file selection dialog.</Para></Entry>
</Row>
<Row>
<Entry><Para>Initial Directory</para></Entry>
<Entry><Para>Specifies the folder (directory) set as the starting value
in the Path field of the file selection dialog.</Para></Entry>
</Row>
<Row>
<Entry><Para>Search Pattern Type</para></Entry>
<Entry><Para>Specifies whether files, directories (folders), or both
will be listed in the Files list of the file selection dialog.</para></Entry>
</Row>
<Row>
<Entry><Para>Search Pattern</para></Entry>
<Entry><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 * (asterisk),
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 <Filename>*.bil</Filename>, which means
that only files that end in <Filename>.bil</Filename> will be listed.</Para></Entry>
</Row>
<Row>
<Entry><Para>OK Button Label</para></Entry>
<Entry><Para><IndexTerm>
<Primary>labels</Primary>
<Secondary>for OK button in file selection dialog</Secondary>
</IndexTerm>Specifies the label that will appear on the button in the
left-most position at the bottom of the file selection
dialog, normally labelled &ldquo;OK.&rdquo; Clicking this button
completes the file selection process and dismisses the
file selection dialog. This button is labelled &ldquo;Import&rdquo; for
the Import Module file selection dialog in App Builder.</Para></Entry>
</Row>
<Row>
<Entry><Para>Popdown Behavior</para></Entry>
<Entry><Para>Specifies whether the file selection dialog will be
automatically dismissed (the default) when the OK
button is clicked.<IndexTerm>
<Primary>file selection dialog</Primary>
<Secondary>properties of &lt;$endrange></Secondary>
</IndexTerm>
</Para></Entry>
</Row>
</TBody>
</TGroup>
</InformalTable>
</Sect2>
<Sect2 Id="ABUG.apRPE.div.13">
<Title Id="ABUG.apRPE.mkr.6">Group Property Editor<IndexTerm><Primary>property editor</Primary><Secondary>Group</Secondary></IndexTerm><IndexTerm><Primary>Group Property Editor</Primary></IndexTerm></Title>
<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
<!--Original XRef content: '&xd2;Grouping Objects&xd3; on page&numsp;90'--><XRef Role="SecTitleAndPageNum" Linkend="ABUG.group.mkr.2">, for instructions.</para>
<Para>Only properties unique to a group object are described here. See
<!--Original XRef content: '&xd2;Property
Editor: Universal Properties&xd3; on page&numsp;136'--><XRef Role="SecTitleAndPageNum" Linkend="ABUG.apRPE.mkr.2"> for descriptions of Object Type,
Objects, Initial State, and Color. See
<!--Original XRef content: '&xd2;Property Editor: Common Properties&xd3; on
page&numsp;137'--><XRef Role="SecTitleAndPageNum" Linkend="ABUG.apRPE.mkr.3"> for descriptions of Border Frame and Position.</Para>
<Para><IndexTerm>
<Primary>groups</Primary>
<Secondary>properties for &lt;$startrange></Secondary>
</IndexTerm>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>
<informaltable>
<tgroup cols="2" colsep="0" rowsep="0">
<colspec align="left" colwidth="100*">
<colspec align="left" colwidth="356*">
<tbody>
<Row>
<Entry><Para>Group Name</para></Entry>
<Entry><Para><IndexTerm>
<Primary>naming</Primary>
<Secondary>groups</Secondary>
</IndexTerm>Displays the default name or the name given by you to
the group selected in the Objects list.</para></Entry>
</Row>
<Row>
<Entry><Para>Layout Type</para></Entry>
<Entry><Para>Specifies As-Is, Vertical, Horizontal, or Row/Column
layout of the objects in the selected group.</Para></Entry>
</Row>
<Row>
<Entry><Para>Rows Columns</para></Entry>
<Entry><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></Entry>
</Row>
<Row>
<Entry><Para>Vert Alignment</para></Entry>
<Entry><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></Entry>
</Row>
<Row>
<Entry><Para>Spacing</para></Entry>
<Entry><Para>Specifies the number of pixels separating the objects in
the selected group. Vert Alignment Spacing is active
only if Layout Type is Vertical or Row/Column. Horiz
Alignment Spacing is active only if Layout Type is
Horizontal or Row/Column.</para></Entry>
</Row>
<Row>
<Entry><Para>Horiz Alignment</para></Entry>
<Entry><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.<IndexTerm>
<Primary>groups</Primary>
<Secondary>properties for &lt;$endrange></Secondary>
</IndexTerm>
</Para></Entry>
</Row>
</TBody>
</TGroup>
</InformalTable>
</Sect2>
<Sect2 Id="ABUG.apRPE.div.14">
<Title>Label Property Editor<IndexTerm><Primary>property editor</Primary><Secondary>Label</Secondary></IndexTerm><IndexTerm><Primary>Label property editor</Primary></IndexTerm></Title>
<Para>Only the property unique to a label object is described here. See
<!--Original XRef content: '&xd2;Property
Editor: Universal Properties&xd3; on page&numsp;136'--><XRef Role="SecTitleAndPageNum" Linkend="ABUG.apRPE.mkr.2"> for descriptions of Object Type,
Objects, Object Name, Initial State, and Color. See
<!--Original XRef content: '&xd2;Property Editor: Common
Properties&xd3; on page&numsp;137'--><XRef Role="SecTitleAndPageNum" Linkend="ABUG.apRPE.mkr.3"> 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
&ldquo;<!--Original XRef content: '&xd2;To Create a Border around an Object'-->
<XRef Role="SectionTitle" Linkend="ABUG.group.mkr.6"> in
&ldquo;<!--Original XRef content: 'Chapter&numsp;7, &xd2;Grouping and Attaching
Objects'-->
<XRef Role="ChapNumAndTitle" Linkend="ABUG.group.mkr.1">, if you want a border around a label.</Para>
<informaltable>
<tgroup cols="2" colsep="0" rowsep="0">
<colspec align="left" colwidth="100*">
<colspec align="left" colwidth="356*">
<tbody>
<Row>
<Entry><Para>Label Alignment</para></Entry>
<Entry><Para><IndexTerm>
<Primary>label control</Primary>
<Secondary>alignment of</Secondary>
</IndexTerm>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></Entry>
</Row>
</TBody>
</TGroup>
</InformalTable>
</Sect2>
<Sect2 Id="ABUG.apRPE.div.15">
<Title>List Property Editor</Title>
<Para>Only properties unique to a list object are described here. See
<!--Original XRef content: '&xd2;Property Editor:
Universal Properties&xd3; on page&numsp;136'--><XRef Role="SecTitleAndPageNum" Linkend="ABUG.apRPE.mkr.2"> for descriptions of Object Type, Objects,
Object Name, Initial State, and Color. See
<!--Original XRef content: '&xd2;Property Editor: Common
Properties&xd3; on page&numsp;137'--><XRef Role="SecTitleAndPageNum" Linkend="ABUG.apRPE.mkr.3"> for descriptions of Label Type, Position (Label), Label,
Items, Item Label, Position [XY], Popup Menu, and Menu Title.<IndexTerm><Primary>property editor</Primary><Secondary>List</Secondary></IndexTerm><IndexTerm><Primary>List property editor</Primary></IndexTerm>
</Para>
<informaltable>
<tgroup cols="2" colsep="0" rowsep="0">
<colspec align="left" colwidth="100*">
<colspec align="left" colwidth="356*">
<tbody>
<Row>
<Entry><Para>Selection Mode</para></Entry>
<Entry><Para>Specifies how objects can be selected in a scrolling list.
Choices are Single Select, Browse Select, Multiple
Select, and Browse Multiple Select.
<?Pub _newline>In Single Select mode, only one item can be selected, by
clicking mouse button 1.
<?Pub _newline>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.
<?Pub _newline>In Multiple Select mode, you can make multiple,
discontiguous selections with mouse button 1.
<?Pub _newline>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 Shift-mouse button 1.</Para></Entry>
</Row>
<Row>
<Entry><Para>Selected</para></Entry>
<Entry><Para>Specifies whether an item will be selected at
application startup.<IndexTerm><Primary>lists, properties of</Primary></IndexTerm>
</para></Entry>
</Row>
<Row>
<Entry><Para>Width</para></Entry>
<Entry><Para><IndexTerm>
<Primary>size</Primary>
<Secondary>of lists</Secondary>
</IndexTerm>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></Entry>
</Row>
<Row>
<Entry><Para>Height</para></Entry>
<Entry><Para>Specifies the number of text Lines in the list or its
Pixels height.</Para></Entry>
</Row>
</TBody>
</TGroup>
</InformalTable>
</Sect2>
<Sect2 Id="ABUG.apRPE.div.16">
<Title>Main Window Property Editor</Title>
<Para>Only properties unique to a main window object are described here. See
<!--Original XRef content: '&xd2;Property Editor: Universal Properties&xd3; on page&numsp;136'--><XRef Role="SecTitleAndPageNum" Linkend="ABUG.apRPE.mkr.2"> for descriptions of Object
Type, Objects, Object Name, Initial State (Visible), and Color. See
<!--Original XRef content: '&xd2;Property
Editor: Common Properties&xd3; on page&numsp;137'--><XRef Role="SecTitleAndPageNum" Linkend="ABUG.apRPE.mkr.3"> for descriptions of Size Policy and
Size.<IndexTerm><Primary>Main Window property editor</Primary></IndexTerm><IndexTerm><Primary>property editor</Primary><Secondary>Main Window</Secondary></IndexTerm>
</Para>
<informaltable>
<tgroup cols="2" colsep="0" rowsep="0">
<colspec align="left" colwidth="100*">
<colspec align="left" colwidth="356*">
<tbody>
<Row>
<Entry><Para>Window Title</para></Entry>
<Entry><Para><IndexTerm>
<Primary>naming</Primary>
<Secondary>windows</Secondary>
</IndexTerm><IndexTerm>
<Primary>windows</Primary>
<Secondary>naming</Secondary>
</IndexTerm>Specifies the title that appears at the top of the main
window.</Para></Entry>
</Row>
<Row>
<Entry><Para>Icon File</para></Entry>
<Entry><Para>Specifies the name of the graphics file that contains the
graphical representation of the application icon&mdash;the
object that is displayed when the application is
&ldquo;iconified&rdquo; by clicking on the minimize button in the
title bar.</Para></Entry>
</Row>
<Row>
<Entry><Para>Icon Mask File</para></Entry>
<Entry><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></Entry>
</Row>
<Row>
<Entry><Para>Icon Label</para></Entry>
<Entry><Para><IndexTerm>
<Primary>naming</Primary>
<Secondary>application icon</Secondary>
</IndexTerm>Specifies the text label that appears beneath the
application icon.</Para></Entry>
</Row>
<Row>
<Entry><Para>User Resize Mode</para></Entry>
<Entry><Para><IndexTerm>
<Primary>size</Primary>
<Secondary>of window</Secondary>
</IndexTerm>Specifies whether the window size is Fixed or
Adjustable (whether it can be resized in the compiled
application).</Para></Entry>
</Row>
<Row>
<Entry><Para>Window Areas</para></Entry>
<Entry><Para>Specifies whether the main window will have a menu
bar, a tool bar, or a footer.<IndexTerm><Primary>windows</Primary><Secondary>adding tool bar</Secondary></IndexTerm><IndexTerm><Primary>windows</Primary><Secondary>adding menu bar</Secondary></IndexTerm><IndexTerm><Primary>windows</Primary><Secondary>adding footer</Secondary></IndexTerm><IndexTerm><Primary>adding</Primary><Secondary>tool bar to window</Secondary></IndexTerm><IndexTerm><Primary>adding</Primary><Secondary>menu bar to window</Secondary></IndexTerm><IndexTerm><Primary>adding</Primary><Secondary>footer to window</Secondary></IndexTerm>
<?Pub _newline>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></Entry>
</Row>
<Row>
<Entry><Para>Initial State, Iconic</para></Entry>
<Entry><Para>Specifies whether the window is displayed as a
window or an icon when the compiled application is
opened.</Para></Entry>
</Row>
</TBody>
</TGroup>
</InformalTable>
</Sect2>
<Sect2 Id="ABUG.apRPE.div.17">
<Title>Menu Property Editor</Title>
<Para>Used to create menus, the Menu Property Editor can be displayed by:<IndexTerm><Primary>property editor</Primary><Secondary>Menu</Secondary></IndexTerm><IndexTerm><Primary>Menu Property Editor</Primary></IndexTerm>
</Para>
<ItemizedList Remap="Bullet1">
<ListItem>
<Para>Choosing Menus from the Editors menu of the App Builder primary
window</Para>
<Note>
<Para>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>
</Note>
</ListItem>
<ListItem>
<Para><Emphasis>Or</Emphasis>, choosing Menu from the Revolving Property Editor Object Type option
menu</Para>
</ListItem>
<ListItem>
<Para><Emphasis>Or</Emphasis>, choosing Create New Menu from the Popup Menu option menu in a
property editor.</Para>
</ListItem>
</ItemizedList>
<Para>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
<!--Original XRef content: '&xd2;Property
Editor: Universal Properties&xd3; on page&numsp;136'--><XRef Role="SecTitleAndPageNum" Linkend="ABUG.apRPE.mkr.2"> for descriptions of Object Type,
Objects, Object Name, and Color. See
<!--Original XRef content: '&xd2;Property Editor: Common Properties&xd3;
on page&numsp;137'--><XRef Role="SecTitleAndPageNum" Linkend="ABUG.apRPE.mkr.3"> for descriptions of Items, Label, and Item State (Active).<IndexTerm>
<Primary>menus</Primary>
<Secondary>properties of &lt;$startrange></Secondary>
</IndexTerm>
</Para>
<informaltable>
<tgroup cols="2" colsep="0" rowsep="0">
<colspec align="left" colwidth="100*">
<colspec align="left" colwidth="356*">
<tbody>
<Row>
<Entry><Para>Add New Menu</para></Entry>
<Entry><Para><IndexTerm>
<Primary>adding</Primary>
<Secondary>menu to list of menus</Secondary>
</IndexTerm>Adds a new menu to the list of menus.</Para></Entry>
</Row>
<Row>
<Entry><Para>Edit</para></Entry>
<Entry><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></Entry>
</Row>
<Row>
<Entry><Para>Tearoff</para></Entry>
<Entry><Para><IndexTerm>
<Primary>menus</Primary>
<Secondary>Tearoff property</Secondary>
</IndexTerm>Specifies whether tearoff is Enabled or Disabled. If
tearoff is enabled the selected menu will be &ldquo;postable.&rdquo;
That is, the menu will be displayed until you explicitly
dismiss it if you click on the Tearoff indicator (a dotted
line).<IndexTerm>
<Primary>Tearoff menu property</Primary>
</IndexTerm>
</Para></Entry>
</Row>
<Row>
<Entry><Para>Item Label Type</para></Entry>
<Entry><Para>Specifies the type of label (String, Graphic, or
Separator) for the item selected in the Items list. If
Graphic is chosen, &ldquo;Label&rdquo; becomes &ldquo;Graphic
Filename.&rdquo; 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></Entry>
</Row>
<Row>
<Entry><Para>Item Mnemonic</para></Entry>
<Entry><Para><IndexTerm>
<Primary>mnemonic</Primary><Secondary>&lt;Emphasis>See&lt;Default Para Font> item mnemonic&lt;$nopage></Secondary>
</IndexTerm>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.<IndexTerm>
<Primary>item mnemonic</Primary>
</IndexTerm>
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></Entry>
</Row>
<Row>
<Entry><Para>Accelerator</para></Entry>
<Entry><Para><IndexTerm>
<Primary>accelerator for menu item</Primary>
</IndexTerm>Specifies a keyboard shortcut for choosing the selected
item. An accelerator is comprised of a prefix (Ctrl, Alt,
Meta, or Shift), <Filename>&lt;key></Filename>, and a letter (upper or lower
case). To make Control-x an accelerator, for instance,
type: <Filename>Ctrl&lt;key>x</Filename>
<?Pub _newline>When you display the menu in test mode or in the
compiled application, &ldquo;Ctrl+x&rdquo; 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.
<?Pub _newline>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:
<Command>Shift Ctrl&lt;key>x</Command>
</Para></Entry>
</Row>
<Row>
<Entry><Para>Line Style</para></Entry>
<Entry><Para><IndexTerm>
<Primary>line style for separator</Primary>
</IndexTerm>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, Single Line, Double Line, Etched Out Dash,
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></Entry>
</Row>
<Row>
<Entry><Para>Item SubMenu</para></Entry>
<Entry><Para>A menu button and a text field for attaching, de-
attaching, creating, or editing a submenu for the
selected item in the Items list. If a submenu is attached
to the selected item, the name of the submenu will be
displayed in the text field.<IndexTerm>
<Primary>menus</Primary>
<Secondary>properties of &lt;$endrange></Secondary>
</IndexTerm>
</Para></Entry>
</Row>
</TBody>
</TGroup>
</InformalTable>
</Sect2>
<Sect2 Id="ABUG.apRPE.div.18">
<Title>Menubar Property Editor</Title>
<Para>Only properties unique to a menu bar object are described here. See
<!--Original XRef content: '&xd2;Property
Editor: Universal Properties&xd3; on page&numsp;136'--><XRef Role="SecTitleAndPageNum" Linkend="ABUG.apRPE.mkr.2"> for descriptions of Object Type,
Objects, Object Name, Initial State, and Color. See
<!--Original XRef content: '&xd2;Property Editor: Common
Properties&xd3; on page&numsp;137'--><XRef Role="SecTitleAndPageNum" Linkend="ABUG.apRPE.mkr.3"> for descriptions of Items, Item Label Type, Label,
Pulldown Menu, and Item State (Active).<IndexTerm><Primary>property editor</Primary><Secondary>Menubar</Secondary></IndexTerm><IndexTerm><Primary>Menubar property editor</Primary></IndexTerm>
</Para>
<informaltable>
<tgroup cols="2" colsep="0" rowsep="0">
<colspec align="left" colwidth="100*">
<colspec align="left" colwidth="356*">
<tbody>
<Row>
<Entry><Para>Item Mnemonic</para></Entry>
<Entry><Para><IndexTerm>
<Primary>item mnemonic</Primary>
</IndexTerm>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 (case is irrelevant) while the
window that contains the menu bar has focus.</Para></Entry>
</Row>
<Row>
<Entry><Para>Item State, Is Help Item</para></Entry>
<Entry><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 &ldquo;Help&rdquo; is the help
button, by default.<IndexTerm>
<Primary>help</Primary>
<Secondary>specifying menu bar item as</Secondary>
</IndexTerm><IndexTerm>
<Primary>menu bar control</Primary>
<Secondary>properties of</Secondary>
</IndexTerm>
</Para></Entry>
</Row>
</TBody>
</TGroup>
</InformalTable>
</Sect2>
<Sect2 Id="ABUG.apRPE.div.19">
<Title>Paned Window Property Editor</Title>
<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
<!--Original XRef content: '&xd2;To
Create a Paned Window&xd3; on page&numsp;43'--><XRef Role="SecTitleAndPageNum" Linkend="ABUG.crobj.mkr.8"> for instructions for creating a paned
window.<IndexTerm><Primary>property editor</Primary><Secondary>Paned Window</Secondary></IndexTerm><IndexTerm><Primary>Paned Window property editor</Primary></IndexTerm>
</Para>
<Para>Only properties unique to a paned window object are described here. See
<!--Original XRef content: '&xd2;Property Editor: Universal Properties&xd3; on page&numsp;136'--><XRef Role="SecTitleAndPageNum" Linkend="ABUG.apRPE.mkr.2"> for descriptions of Object
Type, Objects, Object Name, and Initial State.<IndexTerm><Primary>paned windows</Primary><Secondary>properties of</Secondary></IndexTerm>
</Para>
<informaltable>
<tgroup cols="2" colsep="0" rowsep="0">
<colspec align="left" colwidth="100*">
<colspec align="left" colwidth="356*">
<tbody>
<Row>
<Entry><Para>Panes</para></Entry>
<Entry><Para>Lists the panes that comprise the paned window.</Para></Entry>
</Row>
<Row>
<Entry><Para>Pane Geometry</para></Entry>
<Entry><Para>Displays the W(idth) and H(eight) of the pane selected
in the Panes list.</Para></Entry>
</Row>
<Row>
<Entry><Para>Pane Height</para></Entry>
<Entry><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.<IndexTerm>
<Primary>size</Primary>
<Secondary>of pane in paned window</Secondary>
</IndexTerm>
</Para></Entry>
</Row>
</TBody>
</TGroup>
</InformalTable>
</Sect2>
<Sect2 Id="ABUG.apRPE.div.20">
<Title>Scale Property Editor</Title>
<Para>Only properties unique to a scale or gauge object are described here. See
<!--Original XRef content: '&xd2;Property Editor: Universal Properties&xd3; on page&numsp;136'--><XRef Role="SecTitleAndPageNum" Linkend="ABUG.apRPE.mkr.2"> for descriptions of Object
Type, Objects, Object Name, Initial State, and Color. See
<!--Original XRef content: '&xd2;Property Editor:
Common Properties&xd3; on page&numsp;137'--><XRef Role="SecTitleAndPageNum" Linkend="ABUG.apRPE.mkr.3"> for descriptions of Label Type, Position
(Label), Label, and Geometry.<IndexTerm><Primary>property editor</Primary><Secondary>Scale</Secondary></IndexTerm><IndexTerm><Primary>Scale property editor</Primary></IndexTerm>
</Para>
<informaltable>
<tgroup cols="2" colsep="0" rowsep="0">
<colspec align="left" colwidth="100*">
<colspec align="left" colwidth="356*">
<tbody>
<Row>
<Entry><Para>Scale Type</para></Entry>
<Entry><Para><IndexTerm>
<Primary>scale control</Primary>
<Secondary>properties of</Secondary>
</IndexTerm><IndexTerm>
<Primary>gauge control</Primary>
<Secondary>properties of</Secondary>
</IndexTerm>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></Entry>
</Row>
<Row>
<Entry><Para>Orientation</para></Entry>
<Entry><Para>Specifies whether the scale object will be displayed in
Horizontal or Vertical orientation.</Para></Entry>
</Row>
<Row>
<Entry><Para>Direction</para></Entry>
<Entry><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></Entry>
</Row>
<Row>
<Entry><Para>Value Range</para></Entry>
<Entry><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></Entry>
</Row>
<Row>
<Entry><Para>Decimal Points</para></Entry>
<Entry><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></Entry>
</Row>
<Row>
<Entry><Para>Initial Value</para></Entry>
<Entry><Para>Specifies the initial numerical value setting for the
scale.</Para></Entry>
</Row>
<Row>
<Entry><Para>Show Value</para></Entry>
<Entry><Para>Specifies whether the numerical value of the scale
position will be displayed. See Decimal Points and
Initial Value above.</Para></Entry>
</Row>
</TBody>
</TGroup>
</InformalTable>
</Sect2>
<Sect2 Id="ABUG.apRPE.div.21">
<Title>Separator Property Editor</Title>
<Para>Only properties unique to a separator object are described here. See
<!--Original XRef content: '&xd2;Property
Editor: Universal Properties&xd3; on page&numsp;136'--><XRef Role="SecTitleAndPageNum" Linkend="ABUG.apRPE.mkr.2"> for descriptions of Object Type,
Objects, Object Name, Initial State, and Color. See
<!--Original XRef content: '&xd2;Property Editor: Common
Properties&xd3; on page&numsp;137'--><XRef Role="SecTitleAndPageNum" Linkend="ABUG.apRPE.mkr.3"> for a description of Geometry.<IndexTerm><Primary>separator</Primary><Secondary>properties of</Secondary></IndexTerm><IndexTerm><Primary>property editor</Primary><Secondary>Separator</Secondary></IndexTerm><IndexTerm><Primary>Separator property editor</Primary></IndexTerm>
</Para>
<informaltable>
<tgroup cols="2" colsep="0" rowsep="0">
<colspec align="left" colwidth="100*">
<colspec align="left" colwidth="356*">
<tbody>
<Row>
<Entry><Para>Orientation</para></Entry>
<Entry><Para>Specifies whether the separator object will be displayed
in Horizontal or Vertical orientation.</Para></Entry>
</Row>
<Row>
<Entry><Para>Line Style</para></Entry>
<Entry><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></Entry>
</Row>
</TBody>
</TGroup>
</InformalTable>
</Sect2>
<Sect2 Id="ABUG.apRPE.div.22">
<Title>Spin Box Property Editor</Title>
<Para>Only properties unique to a spin box object are described here. See
<!--Original XRef content: '&xd2;Property
Editor: Universal Properties&xd3; on page&numsp;136'--><XRef Role="SecTitleAndPageNum" Linkend="ABUG.apRPE.mkr.2"> for descriptions of Object Type,
Objects, Object Name, Initial State, and Color. See
<!--Original XRef content: '&xd2;Property Editor: Common
Properties&xd3; on page&numsp;137'--><XRef Role="SecTitleAndPageNum" Linkend="ABUG.apRPE.mkr.3"> for descriptions of Label Type, Position (Label), Label,
Items, Item Label, and Geometry.<IndexTerm><Primary>property editor</Primary><Secondary>Spin Box</Secondary></IndexTerm><IndexTerm><Primary>Spin Box property editor</Primary></IndexTerm>
</Para>
<informaltable>
<tgroup cols="2" colsep="0" rowsep="0">
<colspec align="left" colwidth="100*">
<colspec align="left" colwidth="356*">
<tbody>
<Row>
<Entry><Para>Spin Box Type</para></Entry>
<Entry><Para><IndexTerm>
<Primary>spin box control</Primary>
<Secondary>properties of &lt;$startrange></Secondary>
</IndexTerm>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></Entry>
</Row>
<Row>
<Entry><Para>Arrow Style</para></Entry>
<Entry><Para>Specifies the style of arrow to be displayed on the spin
box. Choices are Flat Beginning, Flat End, Beginning,
End, and Split.</Para></Entry>
</Row>
<Row>
<Entry><Para>Value Range</para></Entry>
<Entry><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></Entry>
</Row>
<Row>
<Entry><Para>Initial Value</para></Entry>
<Entry><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></Entry>
</Row>
<Row>
<Entry><Para>Decimal Points</para></Entry>
<Entry><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></Entry>
</Row>
<Row>
<Entry><Para>Selected</para></Entry>
<Entry><Para>Specifies whether the item selected in the Items list will
be selected when the compiled application is opened.
Only one item can be selected. Selected is inactive if
Spin Box Type is Numeric.<IndexTerm>
<Primary>spin box control</Primary>
<Secondary>properties of &lt;$endrange></Secondary>
</IndexTerm>
</Para></Entry>
</Row>
</TBody>
</TGroup>
</InformalTable>
</Sect2>
<Sect2 Id="ABUG.apRPE.div.23">
<Title>Term Pane Property Editor</Title>
<Para>Only properties unique to a term pane object are described here. See
<!--Original XRef content: '&xd2;Property
Editor: Universal Properties&xd3; on page&numsp;136'--><XRef Role="SecTitleAndPageNum" Linkend="ABUG.apRPE.mkr.2"> for descriptions of Object Type,
Objects, Object Name, Initial State, and Color. See
<!--Original XRef content: '&xd2;Property Editor: Common
Properties&xd3; on page&numsp;137'--><XRef Role="SecTitleAndPageNum" Linkend="ABUG.apRPE.mkr.3"> for descriptions of Scrollbars, Border Frame, Position
[XY], Size, Popup Menu, and Menu Title.<IndexTerm><Primary>Term Pane property editor</Primary></IndexTerm><IndexTerm><Primary>property editor</Primary><Secondary>Term Pane</Secondary></IndexTerm>
</Para>
<informaltable>
<tgroup cols="2" colsep="0" rowsep="0">
<colspec align="left" colwidth="100*">
<colspec align="left" colwidth="356*">
<tbody>
<Row>
<Entry><Para>Process String</para></Entry>
<Entry><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 <Filename><IndexTerm>
<Primary>term pane</Primary>
<Secondary>process string for</Secondary>
</IndexTerm>/bin/csh</Filename>.</para></Entry>
</Row>
</TBody>
</TGroup>
</InformalTable>
</Sect2>
<Sect2 Id="ABUG.apRPE.div.24">
<Title>Text Field Property Editor</Title>
<Para>Only properties unique to a text field object are described here. See
<!--Original XRef content: '&xd2;Property
Editor: Universal Properties&xd3; on page&numsp;136'--><XRef Role="SecTitleAndPageNum" Linkend="ABUG.apRPE.mkr.2"> for descriptions of Object Type,
Objects, Object Name, Initial State, and Color. See
<!--Original XRef content: '&xd2;Property Editor: Common
Properties&xd3; on page&numsp;137'--><XRef Role="SecTitleAndPageNum" Linkend="ABUG.apRPE.mkr.3"> for descriptions of Label Type, Position (Label), Label,
Position [XY], and Width.<IndexTerm><Primary>property editor</Primary><Secondary>Text Field</Secondary></IndexTerm><IndexTerm><Primary>Text Field property editor</Primary></IndexTerm>
</Para>
<informaltable>
<tgroup cols="2" colsep="0" rowsep="0">
<colspec align="left" colwidth="100*">
<colspec align="left" colwidth="356*">
<tbody>
<Row>
<Entry><Para>Operation</para></Entry>
<Entry><Para><IndexTerm>
<Primary>text field control</Primary>
<Secondary>properties of</Secondary>
</IndexTerm>Specifies whether the text field in the compiled
application and in test mode will be Editable or Read-
Only.</Para></Entry>
</Row>
<Row>
<Entry><Para>Maximum Chars</para></Entry>
<Entry><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></Entry>
</Row>
<Row>
<Entry><Para>Initial Value</para></Entry>
<Entry><Para>Specifies the initial value to be displayed in the text
field in the compiled application or in test mode.</Para></Entry>
</Row>
</TBody>
</TGroup>
</InformalTable>
</Sect2>
<Sect2 Id="ABUG.apRPE.div.25">
<Title>Text Pane Property Editor</Title>
<Para>Only properties unique to a text pane object are described here. See
<!--Original XRef content: '&xd2;Property
Editor: Universal Properties&xd3; on page&numsp;136'--><XRef Role="SecTitleAndPageNum" Linkend="ABUG.apRPE.mkr.2"> for descriptions of Object Type,
Objects, Object Name, Initial State, and Color. See
<!--Original XRef content: '&xd2;Property Editor: Common
Properties&xd3; on page&numsp;137'--><XRef Role="SecTitleAndPageNum" Linkend="ABUG.apRPE.mkr.3"> for descriptions of Border Frame, Position [XY], Size,
Popup Menu, and Menu Title.<IndexTerm><Primary>Text Pane property editor</Primary></IndexTerm><IndexTerm><Primary>property editor</Primary><Secondary>Text Pane</Secondary></IndexTerm>
</Para>
<informaltable>
<tgroup cols="2" colsep="0" rowsep="0">
<colspec align="left" colwidth="100*">
<colspec align="left" colwidth="356*">
<tbody>
<Row>
<Entry><Para>Operation</para></Entry>
<Entry><Para><IndexTerm>
<Primary>text pane</Primary>
<Secondary>properties of</Secondary>
</IndexTerm>Specifies whether the text pane in the compiled
application and in test mode will be Editable or Read-
Only.</Para></Entry>
</Row>
<Row>
<Entry><Para>Word Wrap</para></Entry>
<Entry><Para>Specifies whether words will be wrapped to the
following line when the Size W(idth) value is reached.</Para></Entry>
</Row>
<Row>
<Entry><Para>Initial Value</para></Entry>
<Entry><Para>Specifies the initial value to be displayed in the text
pane in the compiled application or in test mode.</Para></Entry>
</Row>
</TBody>
</TGroup>
</InformalTable>
</Sect2>
</Sect1>
</Appendix>
<!--fickle 1.14 mif-to-docbook 1.7 01/02/96 10:11:44-->