The Browser Edit menu allows you to cut, copy, add an interface object to the Palette, paste, delete, raise or lowerinstances on the display, resize an instance to its natural size, make an instance larger, align multiply-selected widget instances, make (and unmake) classes, and designate a widget instance in a class as a receptor.
Select Edit from the Browser menu bar to display the following menu:
You can also select several object instances, and execute Cut, Copy, Paste, or Delete on that group as if it were a single widget instance.
Removes the selected instance and its descendants from the display and places them along with their resources in the instance paste buffer, overwriting any existing contents of the buffer. Use Cut with Paste to move the new instance or collection to a new location. You may Cut and Paste an object from one work space to another.
Use drag and drop to Cut and Paste objects in the object instance hierarchy tree. Dropping instance name A on top of instance name B will Cut instance A and all of its descendants, along with their resources, from the interface and Paste them as descendants of widget B.
Dropping an instance name on an empty portion of the object instance hierarchy in the Browser display will Cut the instance and all of its descendants, along with their resources, from the interface and Paste the instance as the first child of a new topLevelShell. Dragging and dropping in this manner does not affect the instance paste buffer.
To cut several instances, you can save time by selecting those instances as a group and cutting the entire group, instead of cutting each individual instance.
When you cut multiple widget instances, each widget and its descendents are placed in the cut buffer. If the widgets are all from different widget trees (for example, different top level shells), they are placed in the buffer in the order selected. When you Paste a group of instances, those instances are pasted in the same order in which you selected them.
You can drag and drop either a single widget instance or a group of widget instances.
Places a copy of the selected instance and its descendants, along with their resources, in the instance paste buffer, overwriting any existing contents of the buffer. Use Copy with Paste to copy the contents of the instance paste buffer in a new location. You may Copy an instance from one work space to another.
Use one of the following drag and drop methods to copy and paste objects in the instance hierarchy displayed as a tree:
· Drop instance name A on top of instance name B while depressing the Ctrl key to copy instance A and all of its descendants (along with their resources) from the interface, and Paste them as descendants of instance B.
· Drop an instance name on an empty portion of the object instance hierarchy while depressing the Ctrl key to Copy the instance as the first child of a new topLevelShell.
These drag and drop operations do not affect the instance paste buffer.
To save time, you can select several widget instances and then copy the entire group. Just as when you cut a group, each widget instance and its descendents are placed in the cut buffer. If the widgets are all from different widget trees, they are placed in the buffer in the order selected.
Copies the selected instance and all of its descendants, along with their resources, to the User Collections group on the Palette.
Instances and collections which are copied to the Palette will persist, with all their resources, from session to session until specifically removed.
You can also add instances and collections to the Palette using drag and drop, as follows:
1. Position the cursor over either the instance or its instance name on the Browser.
3. While continuing to hold down the mouse button, drag the object to the Palette and drop it onto the desired group.
Places the contents of the instance paste buffer. An outline of the contents of the instance paste buffer appears. Add this collection to the interface by placing the collection in the desired position. Use Paste in conjunction with Copy to copy an object, or with Cut to move an object.
When you paste a group of widget instances, each instance (and its descendents) is pasted in the order in which you selected it. The result is the same as cutting and pasting each instance separately.
Permanently removes the selected instance and all of its descendants. Delete does not copy the object to the instance paste buffer. By default, a confirmation box is displayed for the Delete operation. To turn the confirm delete prompt off, use the User Preference option from the Browser Options menu. See Behavior for more detailed information about this option.
When you delete a group of widget instances, each instance (and its descendents) is deleted in the order in which you selected it. The result is the same as deleting each instance separately.
Reverts the UIL file to a previously saved version, or the last autosaved version.
Moves the selected instance above the sibling directly above it. Use Raise to change the order of menu items, or items in row column or radio boxes.
Moves the selected instance below the sibling directly below it. Use Lower to change the order of menu items, or items in row column or radio boxes.
Removes the height and width resources for the selected instance, causing the instance to calculate its own geometry. (In the placement option menu, None is selected for the height and width resources.) For example, if you change the font size of a label, the widget instance will resize to accommodate that change.
Increases the size of the selected instance. Each time you select Enlarge for an instance, it increments in size.
Displays a menu of the following secondary choices:
Aligns the left edges of all selected objects with the left edge of the left-most selected object.
Aligns the right edges of all selected objects with the right edge of the right-most selected object.
Aligns the bottom edges of all selected objects with the bottom edge of the bottom-most selected object.
Distributes the centers of all selected objects between the center of the left-most selected object and the center of the right-most selected object.
Distributes the centers of all selected objects between the center of the top-most selected object and the center of the bottom-most selected object.
Displays the Alignment Editor, which allows you to align and distribute multiply-selected objects.
The following table describes how to align objects:
Midpoint between horizontal centers of left-most and right-most selected widgets. |
||
Midpoint between vertical centers of top-most and bottom-most selected widgets. |
||
The following table describes how to distribute objects:
When you select Edge Gap, the Spacing Between Edges text field is displayed. Enter both the number and the unit in this field. The following table lists valid units for defining the edge gap:
If you do not specify a unit for Edge Gap, the default unit is pixels. For example:
When you click on an option, the sample alignment on the Alignment Editor shows you what the option does. The sample alignment always has the same four widget outlines.
When you enter a name and press return or click the OK button, Builder Xcessory creates a new class comprised of the currently selected object and all of its descendants. The class is represented on the Browser as a single element, with the Class Instance Icon to the left of the class instance name.
When you enter a name and press return or click the OK button, Builder Xcessory creates a new class comprised of the currently-selected class. The subclass is represented on the Browser as a single element, with the Class Icon to the left of the subclass name. The class from which the subclass was made is displayed as a single element to the right of the subclass on the Browser. A colon appears before the class name, indicating that it has been subclassed.
When you create subclasses, designate one widget instance on the superclass as a receptor (see the next section, Make/Unmake Receptor (Ctrl+T) ). You can then add widget and/or class instances to the subclass. Any instances you add to the subclass appears on the Browser as children of the element representing the class from which the subclass was created.
Designates one container widget instance within a class as the receptor of that class. Any subclass of this class can accept children parented to this receptor widget. When you add a widget to the subclass, the new widget is placed automatically as the child of the receptor, regardless of where you place the widget.
To designate a container widget instance as that class's receptor:
1. Set the Browser to Classes (instead of Instances) view. The object hierarchy of that class is now displayed in the Browser.
2. Select the container that you want to designate as the receptor.
3. Select Make Receptor from the Browser Edit menu. A square-within-a-square icon indicates which container widget instance has been designated as the receptor.
When you select a receptor widget, this menu option changes to Unmake Receptor. If you then select Unmake Receptor, the selected widget will no longer be the receptor widget for this class. If any subclasses of this class have used this receptor widget (for example, if you have added children to this widget), you cannot unmake the widget.