ComponentOne List 8.0 for ActiveX
Using the property tree context menu

Right-click any node to display the property tree context menu, which enables you to navigate the object hierarchy, access context-sensitive help, and copy values from one property to another. You can also use the context menu to apply the value of a column or split property to all other members within the collection.

In this illustration, the context menu is opened on the selected property node. However, if you right-click a node that is not selected, the context menu is opened on that node, and neither the selection nor the input control set to the right of the property tree are changed. In other words, left-clicking changes the selection; right-clicking does not.

The context menu may contain some or all of the following commands, depending upon the data type of the property that was clicked and the state of the property tree itself.

Help

This command displays the online help for the target property or object (that is, the node that was right-clicked). It is unavailable for nodes that represent collection members.

Copy

This command copies the current value of the target property into an internal buffer (not the Clipboard), overwriting the previous contents of the buffer. It is especially useful for copying complex values such as fonts or colors. This command is not displayed for object nodes unless the node represents a named style property.

Paste

This command sets the value of the target property equal to the value stored in the internal buffer used by the Copy command. If the target node is also the selected node, then the stored value is used to set the input controls to the right of the property tree, but the list itself is not updated until you commit the change. If the target node is not the selected node, then the stored value is applied to the list immediately.

This command is unavailable if the internal buffer is empty. It is not displayed for object nodes unless the node represents a named style property.

Selected

This command scrolls the selected node into view. It is not displayed if the selected node is currently visible within the property tree.

Set All collection-name

This command applies the value of the selected property to all sibling objects within the collection. The input controls to the right of the property tree determine which value is used, even if the value has not yet been committed to the list itself. For example, if the WrapText property is selected for the fourth column of the second split, and the True option button is selected, then this command is displayed in the context menu as Set All Columns, and executing it sets the WrapText property of all columns in the second split to True.

This command is only displayed if the parent of the selected node is a member of a collection, and the target node is also the selected node. It is unavailable if the collection in question contains only one member.

Next

This command navigates to the next object in the current collection. If the target node is the selected node, then this command selects the next occurrence of the target property or object and scrolls it into view. If the target node is not the selected node, then the next occurrence of the target property or object is scrolled into view but is not selected.

This command is only displayed if the parent of the target node is a member of a collection. It is unavailable if the parent node represents the last object of the collection.

Previous

This command navigates to the previous object in the current collection. If the target node is the selected node, then this command selects the previous occurrence of the target property or object and scrolls it into view. If the target node is not the selected node, then the previous occurrence of the target property or object is scrolled into view but is not selected.

This command is only displayed if the parent of the target node is a member of a collection. It is unavailable if the parent node represents the first object of the collection.

True, False

For Boolean properties, these commands set the value of the target property. If the target node is also the selected node, then the selected command is used to set the appropriate option button to the right of the property tree, but the list itself is not updated until you commit the change. If the target node is not the selected node, then the selected command is applied to the list immediately.

Enumerated values

For enumerated properties, the context menu also contains a command for each enumerated value. When selected, these commands set the value of the target property. If the target node is also the selected node, then the selected command is used to select the appropriate list item to the right of the property tree, but the list itself is not updated until you commit the change. If the target node is not the selected node, then the selected command is applied to the list immediately.

 

 


Copyright (c) GrapeCity, inc. All rights reserved.

Product Support Forum  |  Documentation Feedback