Go to Glossary Search VisualAge C++ Help Go to VisualAge C++ Help Home Page Go to WWW VisualAge C++ Site

Pop-Up Menus for the Composition Editor

Using pop-up menus available for the free-form surface, parts, and connections, you can add or make changes to various elements of part design, such as part properties, connections, and features.

If you select more than one part on the free-form surface, then only Open Settings, Edit part, Delete, and Layout appear in the pop-up menu. Depending on the elements you work with, the following pop-up menus are available:

Browse Connections

Select Browse Connections to show or hide connections to or from the part.

Menu choices

Show To
Displays the connections for which the part is the target.

Show From
Displays the connections for which the part is the source.

Show To/From
Displays the connections for which the part is either the target or source.

Show All
Displays all the connections among parts in the Composition Editor window

Hide To
Conceals the connections for which the part is the target.

Hide From
Conceals the connections for which the part is the source.

Hide To/From
Conceals the connections for which the part is either the target or source.

Hide All
Conceals all connections among parts in the Composition Editor window.

Browse Part Features

Select Browse part features to see the available features (attributes, actions, or events) for the free-form surface or for the selected part.


Related procedures
Browsing a Part's Features

Change Name

Select Change name to change the name of a part placed in the Composition Editor.

You can give parts descriptive names to more easily identify them. For example, you can change the default name "Pushbutton1" to "Delete." Change name does not change the label that appears parts such as push buttons.

When you change the name of any part, you change the partName property. This name appears in the status area at the bottom of the Composition Editor window as you make connections, and identifies the part in the parts list.

For a nonvisual part, the name also appears as text beneath the icon for the part on the free-form surface.


Related procedures
Renaming Parts in the Composition Editor

Change Template Arguments

Select Change Template Arguments to specify input arguments for template-based classes. These classes include the following:


Related concepts
About Implementing Custom Visual Parts

Related procedures
Setting Template Arguments

Change Type

Select Change type to change the class of a Variable on the free-form surface. The default class is IStandardNotifier.

Columns

Select Columns to add a column to a multicell canvas.

Menu choices


Related references
Rows

Add Column After

Select Add column after to add a column to a multicell canvas after the current column.


Related references
Add Column Before
Columns
Delete Column
IMultiCellCanvas

Add Column Before

Select Add column before to add a column to a multicell canvas before the current column.


Related references
Add Column After
Columns
Delete Column
IMultiCellCanvas

Connect

To make a connection between two parts, select Connect from the pop-up menu. When you select Connect, the list of preferred features associated with the part appears.

Select a feature from the Preferred features list. If the feature you want is not in the Preferred features list, select All Features. A connection window appears that lists the available features associated with the part.


Related concepts
Connections

Related procedures
Making Connections in the Composition Editor

Related references
All Features
Connection Windows

Defer Creation

Defer creation, which is initialized by default, delays the creation of any primary part or notebook page until it is referenced. If the part is referenced by a connection to the main user interface, it is created during initialization. If, for example, the deferred part is a notebook page that does not have a connection drawn to the main user interface, that page is created when the user selects the page tab. Enabling Defer creation improves the performance of your application by decreasing the initialization time.

Delete

Select Delete to delete a part and its connections, or just the part, or just the connections. You can delete multiple parts by selecting them.


Related concepts
About Adding Parts in the Composition Editor

Related procedures
Deleting Parts
Deleting Connections

Delete Column

Select Delete column to delete the currently selected column from a multicell canvas.


Related references
Add Column After
Add Column Before
Columns

Delete Row

Select Delete row to delete the currently selected row from a multicell canvas.

Menu choices

Edit part

Select Edit part to open the Composition Editor for the part you selected. If the selected part has embedded visual parts, the Composition Editor opens for the part. Otherwise, the Part Interface Editor opens. If it is a DAX part, DAX opens.

Layout

Select Layout to place parts on the free-form.

Distribute
Spaces visual parts evenly within a specified area.

Snap to grid
Aligns selected visual parts with the nearest grid intersections.

Menu choices


Related procedures
Positioning Parts

Related references
Snap to Grid

Distribute

Select Distribute to space visual parts evenly within a specified area.

Note: The Horizontally in bounding box and Vertically in bounding box choices appear only if three or more parts are selected.


Related procedures
Positioning Parts

Related references
Horizontally In Surface
Vertically In Surface
Horizontally In Bounding Box
Vertically In Bounding Box

Horizontally In Bounding Box

Select Horizontally in bounding box to space the selected parts evenly between the right and left edges of the bounding box they occupy. This item appears only if three or more parts are selected.


Related procedures
Spacing Parts within a Bounding Box
Positioning Parts

Related references
Horizontally In Surface
Positioning Parts
Vertically In Surface
Vertically In Bounding Box
Distribute

Horizontally In Surface

Use Horizontally in surface to space the selected parts evenly between the right and left edges of the part on which they were dropped. If the selected parts sit directly on the free-form surface, VisualAge distributes them across the entire scrollable width of the free-form surface.


Related references
Positioning Parts
Distribute
Vertically In Surface
Horizontally In Bounding Box
Vertically In Bounding Box

Vertically In Bounding Box

Use Vertically in bounding box to space the selected parts evenly between the top and bottom edges of the bounding box they occupy. This item appears only if three or more parts are selected.


Related procedures
Spacing Parts within a Bounding Box
Positioning Parts

Related references
Horizontally In Surface
Vertically In Surface
Horizontally In Bounding Box
Distribute

Vertically In Surface

Use Vertically in surface to space the selected parts evenly between the top and bottom edges of the part on which they were dropped. If the selected parts sit directly on the free-form surface, VisualAge distributes them across the entire scrollable height of the free-form surface.


Related procedures
Positioning Parts

Related references
Distribute
Horizontally In Surface
Horizontally In Bounding Box
Vertically In Bounding Box

Snap To Grid

Select Snap to grid to align the upper left edges of one or more selected parts to the nearest grid lines . You do not have to display the grid to use Snap to grid.


Related procedures
Positioning Parts

Related references
Toggle Grid
Snap to Grid
Set Grid Spacing Window

Open Settings

Select Open Settings to display the property sheet for the part you selected. The property sheet displays the attributes and their initial values for the part. If you selected several parts before selecting Open Settings, a property sheet for each selected part opens in a different window.


Related concepts
Property Sheets

Related procedures
Editing Part Properties
Opening the Property Sheet for a Part

Promote Part Feature

If you plan to embed the current part into a composite part and want access to features of an embedded part, you must promote the features of the embedded part to the composite part interface. To do this, select Promote part feature.


Related procedures
About Promoting Part Features

Related references
Promote Features Window

Reorder Connections From

Select Reorder Connections From to change the order in which the connections are executed.

Since the connections from an object with the same notification id run in the order in which they are made, you must use Reorder Connections From to place the connections in the order that want them to occur.


Related procedures
Reordering Connections
Making Connections in the Composition Editor

Related references
Reorder Connections Window

Reset to Default Size

Select Reset to default size to reset the part to its default size. If you set the minimum size or change the default size of the part, these will be reset to their defaults. Doing this for a push button, for example, would resize the push button to fit around the current text for the push button.

Restore Shape

Use Restore shape to redraw the selected connections in their original shape.


Related procedures
Changing the Shape of a Connection

Set Grid Spacing

Select Set Grid Spacing to specify the distance between the lines of the grid in the selected window. You can specify the horizontal and vertical distance in pixels between the grid lines using the Set Grid Spacing window.

Specify a value of 0 if you do not want lines in the grid.


Related procedures
Positioning Parts

Related references
Toggle Grid
Snap to Grid

Set tabbing

Select Set tabbing to specify the tabbing order for parts that support tabbing. The tabbing order determines the sequence in which parts receive focus when the user presses the Tab, backtab, or cursor movement keys. Set tabbing includes these options:

Tab stop
Include parts you wish to receive input focus.

Group
Include groups of related parts, such as check boxes within a group or outline box.

The check next to the option indicates if Tab stop or Group are enabled. You can also access these options through the style option of the property sheet.


Related concepts
About Setting Groups and Tab Stops

Related procedures
Setting Tab Stops and Groups

Related references
Common Tasks for Control Parts

Tear-Off Attribute

Select Tear-off attribute to work with an attribute as if it were a stand-alone part. The torn-off attribute is a variable representing the attribute and not actually a separate part.

When you select Tear-off attribute, VisualAge displays the list of attributes for the part you are tearing from. After you select an attribute from the list, you can drop the torn-off attribute on the free-form surface. VisualAge creates a connection (represented by a blue double-headed arrow) between the original part and the torn-off attribute. You can then form other connections to or from the torn-off attribute.


Related concepts
About Tearing Off Attributes

Related procedures
Tearing Off Attributes

View Parts List

Use parts list to display a list of the parts dropped on the selected part. When first opened, the parts list displays only immediate embedded parts of the selected composite part. An expansion icon appears next to each part that contains embedded parts of its own. To see those parts, select oceexp the expansion icon.

Parts are initially listed in the order in which they were dropped. If you have tabbing set and rearrange the tabbing order, VisualAge rearranges the list to reflect the changes.

Within the parts list window, you can perform the following actions on selected parts through the window's pop-up menu:

If more than one part is selected, Change name does not appear.


Related procedures
Listing Parts within a Composite Part
Editing Part Properties
Editing Part Labels Directly
Renaming Parts in the Composition Editor
Deleting Parts