Infragistics logo
메뉴
.NET and JavaScript UI Controls
Version

GetNodeByKey Method

Returns the node that has the specified key.
Syntax
'Declaration
 
Public Function GetNodeByKey( _
   ByVal key As String _
) As UltraTreeNode
public UltraTreeNode GetNodeByKey( 
   string key
)

Parameters

key
The key to find.

Return Value

The node with the specified key (if it exists), or Nothing (if it does not).
Remarks

Returns a node with the specified key from anywhere in the control, if it exists. If the key is not found, Nothing is returned.

Note: All keys in the control must be unique, regardless of level or parent. This method is case-insensitive. If the control contains like-named node keys with different casing (e.g., 'ABC' and 'abc'), then the recommended approach is to loop through all nodes in the control recursively.

Example
The following sample code illustrates how to specify the appearance of nodes.

Imports Infragistics.Win
Imports Infragistics.Win.UltraWinTree

Private Sub button3_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles button3.Click

    ' Note: the Override objects are exposed as properties off
    ' the tree, the node and the nodes collection as well as
    ' items in the NodeLevelOverrides collection. This allows
    ' default settings to be specified for the tree, a node, 
    ' a node's children or for a level in the tree.

    ' Get the tree's Override property so we can
    ' set the default for all nodes.
    With Me.ultraTree1.Override

        ' Turn hot tracking on
        .HotTracking = DefaultableBoolean.True

        ' Set the borderstyle to solid but the border color
        ' to trasnparent so the borders don't show by default.
        .BorderStyleNode = UIElementBorderStyle.Solid
        .NodeAppearance.BorderColor = Color.Transparent

        ' Set default border colors for active, expanded,
        ' hot tracked and selected nodes.
        .ActiveNodeAppearance.BorderColor = Color.Red
        .ExpandedNodeAppearance.BorderColor = Color.Magenta
        .HotTrackingNodeAppearance.BorderColor = Color.Blue
        .SelectedNodeAppearance.BorderColor = Color.Black

    End With

    ' Set the default for nodes that are at level 2 
    ' (i.e. grandchild nodes of root modes).
    ' This overrides the default setting above.
    Me.ultraTree1.NodeLevelOverrides(2).ActiveNodeAppearance.BorderColor = Color.Violet

    ' Set the default for nodes at the root level. 
    ' This overrides the default settings above.
    Me.ultraTree1.Nodes.Override.ActiveNodeAppearance.BorderColor = Color.Aqua

    Dim node As UltraTreeNode

    ' Get a specific node by its key value. 
    ' Note: this will return the node that has that key
    ' from anywhere in the tree structure since keys are
    ' unique across the entire tree.
    node = Me.ultraTree1.GetNodeByKey("child node 1")

    ' Set the property for that specific node only.
    ' This overrides any default settings above.
    node.Override.ActiveNodeAppearance.BorderColor = Color.Cyan

    ' Set the property for that specific node's child nodes
    node.Nodes.Override.ActiveNodeAppearance.BorderColor = Color.Beige

End Sub
using Infragistics.Win;
using Infragistics.Win.UltraWinTree;


private void button3_Click(object sender, System.EventArgs e)
{

	// Note: the Override objects are exposed as properties off
	// the tree, the node and the nodes collection as well as
	// items in the NodeLevelOverrides collection. This allows
	// default settings to be specified for the tree, a node, 
	// a node's children or for a level in the tree.
 
	Infragistics.Win.UltraWinTree.Override ovr; 

	// Get the tree's Override property so we can
	// set the default for all nodes.
	ovr = this.ultraTree1.Override;

	// Turn hot tracking on
	ovr.HotTracking = DefaultableBoolean.True;

	// Set the borderstyle to solid but the border color
	// to trasnparent so the borders don't show by default.
	ovr.BorderStyleNode = UIElementBorderStyle.Solid;
	ovr.NodeAppearance.BorderColor = Color.Transparent;

	// Set default border colors for active, expanded,
	// hot tracked and selected nodes.
	ovr.ActiveNodeAppearance.BorderColor = Color.Red;
	ovr.ExpandedNodeAppearance.BorderColor = Color.Magenta;
	ovr.HotTrackingNodeAppearance.BorderColor = Color.Blue;
	ovr.SelectedNodeAppearance.BorderColor = Color.Black;
		
	// Set the default for nodes that are at level 2 
	// (i.e. grandchild nodes of root modes).
	// This overrides the default setting above.
	this.ultraTree1.NodeLevelOverrides[2].ActiveNodeAppearance.BorderColor = Color.Violet;

	// Set the default for nodes at the root level. 
	// This overrides the default settings above.
	this.ultraTree1.Nodes.Override.ActiveNodeAppearance.BorderColor = Color.Aqua;

	// Get a specific node by its key value. 
	// Note: this will return the node that has that key
	// from anywhere in the tree structure since keys are
	// unique across the entire tree.
	UltraTreeNode node = this.ultraTree1.GetNodeByKey("child node 1");

	// Set the property for that specific node only.
	// This overrides any default settings above.
	node.Override.ActiveNodeAppearance.BorderColor = Color.Cyan;

	// Set the property for that specific node's child nodes
	node.Nodes.Override.ActiveNodeAppearance.BorderColor = Color.Beige;
		
}
Requirements

Target Platforms: Windows 10, Windows 8.1, Windows 8, Windows 7, Windows Server 2012, Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

See Also