Note: A parameterless constructor is required for all derived classes.

This method is provided as a convenience, to simplify the serialization implementation for derived classes. The default implementation does nothing.

The AllowEdit property does not, by itself, determine the behavior exhibited when a cell is clicked with the mouse; the property also determines whether a cell can be activated and/or edited when it is clicked with the mouse.

Appearance of the object controls how the cell will appear. It is the most specific of the various cell-related appearances; the of the object controls the appearance for all cells in that column, and the of the object controls the appearance for all cells in all columns.

The Editor and properties both dictate which embeddable editor will be used to render data for the cell; the is exposed to provide a way to specify an editor through the designer. In the case where both properties are set to different values, the Editor property takes precedence.

The and EditorControl properties both dictate which embeddable editor will be used to render data for this cell; in the case where both properties are set to different values, the property takes precedence.

The Key property is always the same as that of the associated , and is not a settable property. Attempting to set the property will result in an exception being thrown.

The and EditorComponent properties both dictate which embeddable editor will be used to render data for this cell; in the case where both properties are set to different values, the property takes precedence.

This method is provided as a convenience, to simplify the serialization implementation for derived classes. The default implementation does nothing.

The class is not modifiable and as such always returns true from this method.

Note that not all styles are available on all operating systems. If the version of the OS that your program is running on does not support a particular border style, borders formatted with that style will be drawn using solid lines.

The parameterless overload of the PerformAutoResize method uses an effective value of 'VisibleNodes'. Use the more complex overload to auto-size columns differently.

This method is provided as a convenience, to simplify the serialization implementation for derived classes. The default implementation does nothing.

The ActiveCellAppearance property is also exposed by the and ) classes; setting it at the level will affect only cells displayed by this column.

The AllowCellEdit property is exposed by each of the column-related objects (, , and ), and the object exposes an property, which is named differently but functionally identical. The AllowCellEdit property is also exposed by the class; setting the property at that level affects only cell displayed by that node.

Cells can be disabled by setting the AllowCellEdit property to 'Disabled'.

The end user can be prevented from changing a cell's contents, while still being allowed to copy the cell's contents, by setting the AllowCellEdit property to 'ReadOnly'.

The AllowCellEdit property does not, by itself, determine the behavior exhibited when a cell is clicked with the mouse; the property also determines whether a cell can be activated and/or edited when it is clicked with the mouse.

CellAppearance of the object controls how cells in the columns of this column set will appear. It is the least specific of the various cell-related appearances; the of the object controls the appearance for cells in that column, and the of the object controls the appearance for that particular cell.

The DataType property is settable only for unbound columns; the data type of a bound column is determined by the underlying data column, and cannot be changed.

The Editor and properties both dictate which embeddable editor will be used to render data for the column; the is exposed to provide a way to specify an editor through the designer. In the case where both properties are set to different values, the Editor property takes precedence.

The and EditorControl properties both dictate which embeddable editor will be used to render data for the column; in the case where both properties are set to different values, the property takes precedence.

Note: The default value, 0, indicates that no limit is imposed.

In the case where the represents an underlying , and the value of the MaxLength property is left at its default, the MaxLength property of that DataColumn defines the effective value.

When relying on the MaxLength property of a DataColumn, be sure to set the MissingSchemaAction property of the associated DataAdapter to MissingSchemaAction.AddWithKey; neglecting to do this will result in unexpected behavior.

The Nullable property can be used to cause the to fire when the end user deactivates a cell whose contents are empty by setting the property's value to 'Disallow'. This is useful in scenarios where a cell's value cannot be empty. Setting the Nullable property to 'DbNull' or 'Nothing' causes empty cells to assume a value of DbNull.Value or null (Nothing in VB), respectively. Setting the Nullable property to 'EmptyString' causes the value of empty cells to be string.Empty rather than null. When the Nullable property is set to 'Automatic', the value of an empty cell is determined by the underlying , if the is data bound. In that case, the DataColumn's AllowDbNull property makes the determination of how empty values are handled.

When the Text property is left at its default value (string.Empty), the value of this 's Key property is displayed in the header instead.

The TipStyleCell property can also be set at the or levels to show or hide tooltips for all cells displayed by that , or all cells displayed the control, respectively.

A column will resolve to invisible when it is a Chaptered column.

The and EditorComponent properties both dictate which embeddable editor will be used to render data for the column; in the case where both properties are set to different values, the property takes precedence.

Note that not all styles are available on all operating systems. If the version of the OS that your program is running on does not support a particular border style, borders formatted with that style will be drawn using solid lines.

This method is provided as a convenience, to simplify the serialization implementation for derived classes. The default implementation does nothing.

The class is modifiable and as such always returns false from this method.

The class is not modifiable, and as such always returns true from this method.

The UltraTreeColumnSet class is analagous to the UltraGrid's UltraGridBand object in that it defines a set of columns.

The properties of the UltraTreeColumnSet class are applicable only when the control's is set to a value other than 'Standard'.

The UltraTreeColumnSettings class exposes a collection of objects, accessible via the collection; this collection defines the columns that are displayed by the control.

An object is referenced by the object's property, which defines the column structure when the control's property is set to 'OutlookExpress'. The object also exposes a property, which can be set so that a different column structure can be defined at different levels of the node hierarchy.

This method is provided as a convenience, to simplify the serialization implementation for derived classes. The default implementation does nothing.

The ActiveCellAppearance property is also exposed by the and ) classes; setting it at the level will affect all cells displayed by columns that belong to this instance's collection.

The AllowCellEdit property is exposed by each of the column-related objects (, , and ), and the object exposes an property, which is named differently but functionally identical. The AllowCellEdit property is also exposed by the class; setting the property at that level affects only cell displayed by that node.

Cells can be disabled by setting the AllowCellEdit property to 'Disabled'.

The end user can be prevented from changing a cell's contents, while still being allowed to copy the cell's contents, by setting the AllowCellEdit property to 'ReadOnly'.

The AllowCellEdit property does not, by itself, determine the behavior exhibited when a cell is clicked with the mouse; the property also determines whether a cell can be activated and/or edited when it is clicked with the mouse.

Note: Depending on the value of the property, the BorderStyleColumnHeader property may not affect the appearance of the column headers.

CellAppearance of the object controls how cells in the columns of this column set will appear. It is the least specific of the various cell-related appearances; the of the object controls the appearance for cells in that column, and the of the object controls the appearance for that particular cell.

ColumnHeaderAppearance of the object controls how headers for the columns in this column set will appear. The of the object controls the appearance for that particular column's header.

The property dictates whether cells in a particular column can display an expansion indicator. The cell that actually displays it is the first one in the visible order whose CanShowExpansionIndicator property resolves to true.

Note: The property, when not set to a specific value, resolves to true for columns whose property is set to the type .

Also note that the ExpansionIndicatorColumn property can return a null value (Nothing in VB); for example, if this 's collection is empty, or the CanShowExpansionIndicator property is specifically set to false for all of its members, no column is defined as the ExpansionIndicatorColumn and as such the property returns false. For this reason, it is important to check the return value from this property before accessing any of its members to ensure that it does not contain a null reference.

Also note that if the property for an 's effective Override is specifically set to false, the expansion indicator is not displayed for a cell within that node, regardless of the value of the property.

The TipStyleCell property can also be set at the level to show or hide tooltips only for cells displayed by that column.

This method is provided as a convenience, to simplify the serialization implementation for derived classes. The default implementation does nothing.

Note: This property is only used when returns true.

The class is modifiable and as such always returns false from this method.

The UltraTreeColumnSettings class exists mainly to organize the properties which apply to the control's multi-column functionality. Some of the properties exposed by the UltraTreeColumnSettings class are also exposed at other levels (for example, by the and classes); the properties of the UltraTreeColumnSettings class are applicable only to cells or columns that are not affected by a more specific setting. The UltraTreeColumnSettings object is typically used to apply a property setting that does not have to be different for each column; for example, setting the property on the object and at no other levels will affect the editability of all cells displayed by the control. regardless of what or the cell belongs to.

The properties of the UltraTreeColumnSettings class are applicable only when the control's is set to a value other than 'Standard'.

The UltraTreeColumnSettings class exposes a collection of objects, accessible via the collection; this collection is used as a repository in which to store instances. The also exposes properties which apply to the control's multi-column functionality.

The object is referenced by the control's property.

This method is provided as a convenience, to simplify the serialization implementation for derived classes. The default implementation does nothing.

The ActiveCellAppearance property is also exposed at more specific levels (see , ); setting it at the level will affect all cells displayed by the UltraTree.

The AllowCellEdit property is exposed by each of the column-related objects (, , and ), and the object exposes an property, which is named differently but functionally identical. The AllowCellEdit property of the object is the least specific of all the levels, that is, applies to the most cells.

Cells can be disabled by setting the AllowCellEdit property to 'Disabled'.

The end user can be prevented from changing a cell's contents, while still being allowed to copy the cell's contents, by setting the AllowCellEdit property to 'ReadOnly'.

The AllowCellEdit property does not, by itself, determine the behavior exhibited when a cell is clicked with the mouse; the property also determines whether a cell can be activated and/or edited when it is clicked with the mouse.

Note: The AutoFitColumns property is only applicable when the 's property is set to 'OutlookExpress'.

Note: Depending on the value of the property, the BorderStyleColumnHeader property may not affect the appearance of the column headers.

CellAppearance of the object controls how cells in the columns of this column set will appear. It is the least specific of the various cell-related appearances; the of the object controls the appearance for cells in that column, and the of the object controls the appearance for that particular cell.

ColumnHeaderAppearance of the object controls how headers for all columns will appear. The of the object controls the appearance for that particular column's header.

To maintain compatibility with the Infragistics UltraGrid control, pressing the Shift key while clicking a sortable column header will prevent the collection from being cleared before the new column is added, effective extending the sort operation to include the clicked column.

Since there is no standard Windows keystroke for extending column sorting, the MultiSortModifierKey enables the end developer to specify any modifier key to be designated as the key which extends a column sorting operation.

The standard modifier keys (Alt, Control, and Shift) can be assigned to the MultiSortModifierKey property, but any other value will cause an exception to be thrown.

ShowBandNodes determines when to insert a node into a DataBound hierarchy of nodes to represent the band. Regardless of the setting of ShowBandNode, band nodes will always be created to separate siblling bands. In a case where a child band has no siblings, a band node will be created for it if ShowBandNodes is set to ShowBandNodes.Always.

Note: ShowBandNodes will not ariticially create nodes at the root level of the binding (i.e. the control-level or on the nodes collection whose SetDataBinding method was called).

The TabNavigation property enables the end developer to specify whether pressing the tab key should cause the next control in the tab order to be activated ('NextControl'), or navigate to the next cell ('NextCell'). When set to 'NextControlOnLastCell', pressing the tab key will result in the same behavior as the 'NextCell' setting, except when the last cell displayed by the control is active, or the first cell displayed by the control is active and the Shift key is depressed, in which case the next control in the tab order is activated.

The TipStyleCell property can also be set at the or levels to show or hide tooltips for a more specific set of cells.

The 'UseOverride' setting preserves legacy selection behavior, whereby no two nodes which belong to different Nodes collections can be selected concurrently.

Note: The 'None' setting of the property is honored for individual nodes when set on the property of a Nodes collection, or on a member of the collection. No other setting of the SelectionType property is honored when the 'ExtendedAcrossCollections' setting is in effect.

Note: An whose property resolves to false cannot be selected under any circumstances.

Note: The 'None' setting of the property is honored for individual nodes when set on the property of a Nodes collection, or on a member of the collection. No other setting of the SelectionType property is honored when the 'ExtendedAcrossCollections' setting is in effect.

Note: An whose property resolves to false cannot be selected under any circumstances.

Disabling an event will not affect the internal operation of the control. Disabling simply instructs the control not to call the event handler so that code the programmer entered is not fired.

For example, disabling the Click will not stop the control from changing the Active Node when it is clicked. It will only cause the Click Event not to fire when the control is clicked.

Disabling an event will not affect the internal operation of the control. Disabling simply instructs the control not to call the event handler so that code the programmer entered is not fired.

For example, disabling the CLick will not stop the control from changing the Active Node when it is clicked. It will only cause the Click Event not to fire when the control is clicked.

In the case where a range selection is performed and the control's property resolves to false, the NewSelections collection will not contain descendants of collapsed nodes.

The IncludeCollapsedDescendantsOnRangeSelection property is applicable only in the case where a range selection is being performed; extending a selection by clicking a node while pressing the Control key does not consitute a range selection.

The control also exposes an property. The value of the control-level property determines the initial value of this property. Changing the value of this property overrides the behavior dictated by the control-level property.

Descendants of the last node in the range selection are not selected, i.e., the last node clicked or dragged to represents the last member of the selection.

Note: In the case where a column's header (otherwise referred to as label) has been resized, the Cell property will return null (Nothing in VB).

Note: In the case where a column's header (otherwise referred to as label) has been resized, the Node property will return null (Nothing in VB). Be sure to perform a null reference check before accessing the property.

Note: In the case where a column's header (otherwise referred to as label) has been resized, the Cell property will return null (Nothing in VB). Be sure to perform a null reference check before accessing the property.

Note: The property is exposed for informational purposes and cannot be changed. Use the property to override the size which results from the end user's action.

Note: The value of the NewSize property can be changed by the end developer to override the size which resulted from the user's action. The value of the property, however, is exposed for informational purposes and cannot be changed.

Note: In the case where a column's header (otherwise referred to as label) has been span resized, the Node property will return null (Nothing in VB). Be sure to perform a null reference check before accessing the property.

Note: In the case where a column's header (otherwise referred to as label) has been span resized, the Cell property will return null (Nothing in VB). Be sure to perform a null reference check before accessing the property.

Note: In the case where a column's header (otherwise referred to as label) has been span resized, the Cell property will return null (Nothing in VB).

Note: Accessing the Cell property will cause an instance to be created if one has not already been created.

Note: Accessing the Cell property will cause an instance to be created if one has not already been created.

Note: The IsValid property delegates to the editor's property.

Note: Accessing the CurrentValue property (which delegates to the editor's property) when the property returns false will result in an exception being thrown. For this reason, callers should always verify that the current value is valid before accessing the property by checking the return from the property.

This property does not automatically cause the items to be adjusted. Instead it will adjust items when a notification that a single column's visible or span property is changed.

This method is provided as a convenience, to simplify the serialization implementation for derived classes. The default implementation does nothing.

The LabelSpan property affects label spanning differently depending on the value of the property. When LabelPosition is set to Top or Bottom, the LabelSpan property is implied to denote a vertical value; when LabelPosition is set to Left or Right, the property is implied to denote a horizontal value.

This collection supports lazy creates. This means that items in the collection can be referenced without explicitly calling the Add Method and no error will be generated. The items will automatically be created as needed.

Each in the collection affects all nodes in the UltraTree whose level matches the Index of the item in the collection. So NodeLevelOverrides(0) applies to all root nodes, NodeLevelOverrides(1) applies to all children of the root, NodeLevelOverrides(2) applies to greanchildren of the root, and so on.

This collection is not limited by the actual nodes in the UltraTree. It is possible to create a NodeLevelOverride with an index higher than the number of levels in the UltraTree.

This collection supports lazy creates. This means that items in the collection can be referenced without explicitly calling the Add Method and no error will be generated. The items will automatically be created as needed.

This collection supports lazy creates. This means that items in the collection can be referenced without explicitly calling the Add Method and no error will be generated. The items will automatically be created as needed.

Each in the collection affects all nodes in the UltraTree whose level matches the Index of the item in the collection. So NodeLevelOverrides(0) applies to all root nodes, NodeLevelOverrides(1) applies to all children of the root, NodeLevelOverrides(2) applies to greanchildren of the root, and so on.

This collection is not limited by the actual nodes in the UltraTree. It is possible to create a NodeLevelOverride with an index higher than the number of levels in the UltraTree.

An Override object has properties which affect a node and it's behavior.

Each node determines it's Override properties by resolving all the Overrides which affect it. The Overrides that effect a node are (in order of precedence - highest to lowest):

1) The Override property of the node itself.

2) The Override property of the Nodes Collection of the node's parent.

3) The NodeLevelOverride whose Index is the same as the Level of the node.

4) The UltraTree control Override.

These are in order of precendence from highest to lowest.

Properties of the Override are resolved independently of each other. So a node may use one property from it's own Override and another from an Override on a parent object.

Note: Not all properties are supported on every Override. See the individual property topic for details.

When the ItemHeight is reset, the height of the node will automatically adjust based on the height of the text and the image or images on the node. It takes into account the font, LeftImages, RightImages, and any image currently applied to the node as part of an Appearance.

To reset the ItemHeight to the default value, call the ResetItemHeight method.

To ensure a clean display, the actual height of the node may vary from the specified value by up to one pixel.

ActiveNodeAppearance determines how the node appears when it is the .

ExpandedNodeAppearance determines how the node appears when it is .

HotTrackingNodeAppearance determines how the node appears when it is the .

SelectedNodeAppearance determines how the node appears when it is .

NodeAppearance determines how the node normally appears. This appearance will be overriden by any other appearance that applies, such as , , , and .

LabelEditAppearance determines how the node label appears while being edited.

SelectionType determines how selection is handled and what kind of selection is allowed for a group of nodes.

Regardless of SelectionType, no two nodes under different parents may ever be selected simultaneously.

The SelectionType proeprty of the is ignored.

NodeStyle determines how the node displays and functions within the UltraTree.

Clicking a CheckBox on a node will toggle the value between Checked and Unchecked.

Clicking a TriStateCheckBox will cycle the node's CheckState from Checked to Indeterminate to Unchecked and then back to Checked.

The OptionButton style allows the creation of a series of options which are mutually exclusive under the same parent. The CheckState of the currently selected option will be Checked. The other nodes CheckState will return Unchecked.

When the associated control's property is set a value other than ViewStyle.Standard, the NodeStyle property is not applicable, and behaves as if set to NodeStyle.Standard

If the image of the node is from an ImageList control, the ImageSize of the ImageList will be used and this property is ignored.

If the image is added directly to the Appearance of the node, then ImageSize will resize the image to the specified size. The Image will be stretched or shrunk to fit the ImageSize.

When LabelEdit resolves to true, clicking (or pressing F2) on the will automatically put the into LabelEdit mode.

When LabelEdit resolves to false, LabelEdit mode cannot be entered by user interaction.

To validate data entered into a node, use the event.

Note: The method can be used to programmatically place an into LabelEdit mode. In this case, the value of the LabelEdit property is not applicable.

Note: If the is bound to a data source, the LabelEdit property is not applicable unless the property resolves to true.

When true, nodes will reserve a space for a CheckBox.

When false, nodes without a checkbox will not leave a space.

When True, nodes that have an ImageBackground set will display them.

Note: By default, the ImageBackground is not displayed for nodes.

Note: The DrawImageBackground property applies only to node objects; If the ImageBackground property of the control's is set, it will be displayed regardless of the value of the DrawImageBackground property.

When true, nodes will reserve a space for an image.

When false, nodes without an image will not leave a space.

Note: This applies only to the image of a node as part of an Appearance. It does not apply to LeftImages or RightImages.

By default, nodes are sorted alphabetically by .

This behavior can be overriden by setting the property of the .

The Sort property of the is ignored.

The SortComparer determines how nodes are sorted.

The default SortComparer will sort nodes alphabetically based on the property of the node. The direction of the sort is determined by the property of the .

The SortComparer property can be set to any object which implements the System.Collections.IComparer interface. The x and y objects of the Compare method will be the two UltraTreeNodes being compared.

When creating a custom SortComparer, nodes should always be sorted Ascendingly. The UltraTree will reverse the order when is set to Descending.

The SortComparer property of the is ignored.

This property determines when a node will display an expansion indicator.

When set to the Default or CheckOnLoad, nodes will automatically determine whether an expansion indicator is necessary based on whether or not there are child nodes.

To load nodes "on demand", use the CheckOnExpand setting. With this setting, the node will show an expansion indicator until the first time it is expanded. At that time, the event will fire. If the event completes successfully and is not cancelled, then the node will determine if any child nodes were added. If child nodes were added, the node will expand normally and show an expansion indicator. If no children were added, the expansion indicator will disappear and the node will not expand.

To restore the expansion indicator of a node once it has disappeared, use the method of the UltraTree.

When loading nodes on demand, it is generally recommended to also set to ToggleExpansionWhenExpansionIndicatorVisible.

This property determins whether a node will expand or collapse automatically when double-clicked.

Regardless of the NodeDoubleClickAction, the DoubleClick event of the control will fire whenerv it is double-clicked.

For nodes whose children are being loaded on demand, it is generall recommended to use a NodeDoubleClickAction setting of ToggleExpansionWhenExpansionIndicatorVisible. This prevents the user from expanded a node whose expansion indicator has disappeared because it has no children.

When true, if the user pressed the "Delete" key while the UltraTree has focus, the tree will automatically respond. By default, the tree will automatically display a confirmation dialog. If it is accepted, all selected nodes will be deleted. To change or remove this dialog, see the event.

When false, pressing 'Delete' will have no effect on the node.

This property determines whether a node will expand automatically when the mouse pointer hovers over it during a Drag operation.

The delay before the node is is controlled by the property of the control.

The default text editor doesn't have any buttons except if there is an UltraInkProvider component on the form whose Visible property is true. This is used on TabletPCs to capture ink when editing the text. Other editors may or may not have button elements.

If returns false this property is ignored.

When true, if the user pressed the "Ctrl+C" or "Shift+Insert" key combinations while the UltraTree has focus, the tree will automatically copy the selected nodes to the clipboard.

When true, if the user pressed the "Ctrl+X" or "Shift+Delete" key combinations while the UltraTree has focus, the tree will automatically cut the selected nodes to the clipboard.

When true, if the user pressed the "Ctrl+V" or "Shift+Insert" key combinations while the UltraTree has focus, the tree will automatically append nodes from the clipboard into the 's collection.

Unlike some of the other object properties of the , the ColumnSet property's get method does not automatically create an object when it is accessed. The property must be set before it can be accessed, or an exception will be thrown.

The columns that are displayed for an are obtained from the property of the most specific that applies to the node. The ShowColumns property provides the ability to interrupt this hierarchical resolution for any nodes affected by this Override.

The ShowColumns property is not applicable when the owning control's property resolves to ViewStyle.Standard, or when the all collections in the node's ancestor chain are empty.

The ShowColumns property is also not applicable when the owning control's property resolves to ViewStyle.OutlookExpress, since a column-driven display is necessary for that view style.

When CellClickAction is set to 'EditCell', clicking onto a cell activates the cell and immediately enters edit mode on the cell. Setting the property to 'EditCellSelectText' results in the same behavior as 'EditCell' except that the contents of the cell are selected after edit mode is entered. When set to 'ActivateCell', the cell is activated but not automatically placed into edit mode. When set to 'SelectNodeOnly', no cell is activated or placed into edit mode, but rather the node is activated and optionally selected (depending on the value of the property).

Note: The CellClickAction property is only applicable to nodes which display columns; nodes that do not display cells behave as if the property were set to 'SelectNode'

Also note that the CellClickAction property applies exclusively to mouse activity, and does not prevent the end user from accomplishing the same result by using the keyboard. For example, when CellClickAction is set to 'ActivateOnly', entering edit mode via the keyboard is not disallowed; edit mode can still be entered by pressing F2.

Calling this method will remove all nodes from the collection. This has the effect of deselecting all nodes.

By default, the nodes in the collection are in the order in which they were added to the collection. This generally means they are in the order in which they were .

Calling the SortByPosition method will sort the TreeNodes so that they are in the same order as they appear in the UltraTree.

The Selected property can be set on an individual node to programmatically select that node; doing this for large numbers of nodes, however, can have performance ramifications. Use the AddRange method to select multiple nodes in one atomic operation.

A node that cannot be part of an extended selection, i.e., one whose Override.SelectionType property does not resolve to 'Extended' or 'ExtendedAutoDrag', cannot be selected via the AddRange method. No exception is thrown in this scenario, but such nodes are excluded from the resulting selection.

The AddRange method is bound by the same selection rules as those enforced through the user interface. If, for example, selection across different Nodes collections is disallowed, and this method is called with an array containing one or more nodes from a different collection that the one that contains the current selection, the selection will not be changed, unless true is specified as the value of the parameter.

If selection across different Nodes collections is disallowed, and the specified array contains nodes from different Nodes collections, only the nodes that belong to the same collection as the first node in the array will be added to the selection.

The AddRange method causes the BeforeSelect and (assuming BeforeSelect is not canceled) AfterSelect events to fire once for each time the method is called.

The Selected property can be set on an individual node to programmatically select that node; doing this for large numbers of nodes, however, can have performance ramifications. Use the AddRange method to select multiple nodes in one atomic operation.

A node that cannot be part of an extended selection, i.e., one whose Override.SelectionType property does not resolve to 'Extended' or 'ExtendedAutoDrag', cannot be selected via the AddRange method. No exception is thrown in this scenario, but such nodes are excluded from the resulting selection.

The AddRange method is bound by the same selection rules as those enforced through the user interface. If, for example, selection across different Nodes collections is disallowed, and this method is called with an array containing one or more nodes from a different collection that the one that contains the current selection, the selection will not be changed, unless true is specified as the value of the parameter.

If selection across different Nodes collections is disallowed, and the specified array contains nodes from different Nodes collections, only the nodes that belong to the same collection as the first node in the array will be added to the selection.

The AddRange method causes the BeforeSelect and (assuming BeforeSelect is not canceled) AfterSelect events to fire once for each time the method is called.

The is modifiable and as such always returns false from this method.

ActionCode determines what the UltraTree does when the KeyActionMapping is triggered.

This collection is automatically populated with a set of default TreeKeyActionMapping objects which describe standard keyboard behavior for the UltraTree.

TreeKeyActionMapping objects may be added, edited, or removed to change the keyboard behavior of the UltraTree.

The UltraTree may trigger more than one action for the same keyboard event. The TreeActionMappins are triggered in the order they exist in the collection.

This method will destroy and re-create the TreeKeyActionMapping collection to reset it back to the defaults.

The UltraTreeNode object can display text, images, and have several styles including CheckBox or Option Buttons.

Using Appearances, the UltraTreenode can display differently depending on it's state. See , , , , and .

To determine if an has a Next/Previous sibling, use the method.

This overload of the method will expand only nodes that have children. To Expand all nodes with or without children, use and specify Always.

When called with Always, this method expands each node by setting the proeprty to true. The node expansion may still be cancelled in the event."

If the node's ShowExpansionIndicator property is set to CheckOnExpand, the BeforeExpand event will fire normally and if nodes are added (or already present) the node will expand. If no children are present after the completion of the BeforeExpand event, the node will not expand and the expansion indicator will disappear as normal.

A node can be positioned relative to any other node in the same tree or even a different Control.

To reposition a node into an empty UltraTree, use .

Note: All of the descendants of the node will move along with it.

Note: A node cannot be repositioned to one of it's own Descendants.

Repositioning a node by will ensure that the node ends up at the specified. Because of this, depending on whether the node moves up or down, it may end up in a different position relative to it's siblings. Therefore, this override of the Reposition method should not be used to position a node relative to another node. To position a node relative to another node, use

Note: A node cannot be repositioned to one of it's own Descendants.

Note: All of the descendants of the node will move along with it.

Calling this method will ignore the property of the node's .

This method will ensure that the node is somewhere within the viewable area of the control, but the exact position of the node is unknown.

To position the node more precisely, use the property of the control.

This method will ensure that the node, and optionally its child nodes, are somewhere within the viewable area of the control, but the exact position of the node is unknown.

To position the node more precisely, use the property of the control.

Note: If the includeChildNodes parameter is true and the node and its child nodes won't fit in the viewable area then this node will become the top node.

This method gets called during paste and load operations.

The default implementation does nothing.

Note: The GetCellValue property can be used as an alternative to accessing the property of the object; accessing members of the object will cause the object to be created if one has not already been, whereas using the GetCellValue method will not cause an object to be created.

Note: The GetCellValue property can be used as an alternative to accessing the property of the object; accessing members of the object will cause the object to be created if one has not already been, whereas using the GetCellValue method will not cause an object to be created.

Returns Nothing if the node has no associated control.

If a height has been specified, it is returned.

Otherwise the calculated height is returned.

The handle is just an integer that uniquely identifies a node during a session, even across different tree controls.

However, be aware that this handle is only valid during the session and is therefore not persistable.

The Expanded property of a node is independent of whether or not the node has any children. If a node with no children has its Expanded property set to true, the node will act as though it is expanded. This means it will use the and if child nodes are added to it, they will display immediately without having to re-expand the parent.

Visible determines whether or not the control paints the node and it's children. A node whose Visible property is set to false will never displays.

Visible should not be confused with IsInView or BringIntoView, which affect if the node is within the viewable area of the control.

Returns true if the node is fully visible. This means that the node must be scrolled into view and it's parents (if any) must be .

Note: If any part of the node is not visible, this method returns false.

This method returns the next visible node in the tree ignoring levels and scrolling, but taking into account expansion of nodes. So a node whose parent is collapsed will not be returned by this method. But a node that is scrolled out of view will be returned.

If there is no next visible node, this method returns Nothing.

For a root node, the return value is Nothing

This method returns the to which it belongs.

This method returns the previous visible node in the tree ignoring levels and scrolling, but taking into account expansion of nodes. So a node whose parent is collapsed will not be returned by this method. But a node that is scrolled out of view will be returned.

If there is no previous visible node, this method returns Nothing.

The on the level takes precendence over all other objects.

This property only applies to a node whose is CheckBox, CheckBoxTriState, or OptionButton.

A disabled node can never be or Activated

A disabled node cannot be or collapsed by the user, but the property can still be set programmatically.

Note: To disable cells without disabling the node itself, set the property to 'Disabled'.



Also note that if any ancestor node of this is disabled, this node is effectively disabled as well; whether this is the case can be determined by the property. The property returns false for all nodes when the control is disabled.

An is treated as disabled if the node's property, or the Enabled property of any of its ancestor nodes or its control, is set to false.

A disabled node cannot be edited, selected or activated; nor can its state be changed via the user interface.

Setting the Selected state of a node will automatically update the collection.

LeftImages is a collection of images that will appear to the left of the of the node. These images are separate from any image applied to the node by an Appearance property, and the will appear to the right of any such image.

To add images to the right of the node's , use the collection.

Each item added to this collection may be an image or (if the property of the control has been set) an Index of an image in the associated .

By default, this property returns true if the has been allocated and has at least 1 item in the collection. A derived UltraTreeNode that overrides should return a value appropriate to that class. Also, a derived UltraTreeNode class that does not override should override this property and return the value of the method.

RightImages is a collection of images that will appear to the right of the of the node. These images are separate from any image applied to the node by an Appearance property.

To add images to the left of the node's , use the collection.

Each item added to this collection may be an image or (if the property of the control has been set) an Index of an image in the associated .

By default, this property returns true if the has been allocated and has at least 1 item in the collection. A derived UltraTreeNode that overrides should return a value appropriate to that class. Also, a derived UltraTreeNode class that does not override should override this property and return the value of the method.

Root nodes are level 0. Children of the root are Level 1, etc.

The resolved is the actual of the based on all the objects affecting the node.

When the associated control's property is set to a value other than ViewStyle.Standard, the property is not applicable, and as such, this property always returns NodeStyle.Standard.

The resolved is the actual of the based on all the objects affecting the node.

The resolved is the actual of the based on all the objects affecting the node.

The resolved is the actual of the based on all the objects affecting the node.

The resolved is the actual of the based on all the objects affecting the node.

The resolved is the actual of the based on all the objects affecting the node.

The resolved is the actual of the based on all the objects affecting the node.

The resolved is the actual of the based on all the objects affecting the node.

The resolved is the actual of the based on all the objects affecting the node.

Keys must be unique throughout the UltraTree control.

Any node with a key can be referenced anywhere in the UltraTree control by calling the method.

DataKey is essentially an additional Tag property of a node which can be used for storing key information for relational data. It is intended for use when the property of a node is set to CheckOnDisplay.

The resolved is the actual of the based on all the objects affecting the node.

The default text editor doesn't have any buttons except if there is an UltraInkProvider component on the form whose Visible property is true. This is used on TabletPCs to capture ink when editing the text. Other editors may or may not have button elements.

If returns false this property is ignored.

The resolved is the actual of the based on all the objects affecting the node.

The resolved is the actual of the based on all the objects affecting the node.

The resolved is the actual of the based on all the objects affecting the node.

When no specific value has been set anywhere in the resolution hierarchy, this property returns true, unless the collection of every in this node's resolution hierarchy is empty, in which case it returns false.

The Cells collection contains instances of the object. Accessing a member of the Cells collection will cause an object to be created for the associated . In the interest of memory conservation, UltraTree's internal logic does not cause any objects to be create unnecessarily. The end developer can use alternative methods to get or set a cell's value (see , ) so that the performance impact caused by creating large numbers of objects can be avoided.

Note: Cells are only displayed by nodes that have an assigned to the instance which governs behavior for the node (see property). As with all properties of the object, the property can be set at several different levels; to determine the which dictates the column structure for a particular node, use the property.



Note: A node will display cells if the referenced by the property has visible columns, but this can be prevented by setting the property to DefaultableBoolean.False.