{"id":3551,"date":"2011-11-23T11:06:00","date_gmt":"2011-11-23T19:06:00","guid":{"rendered":"http:\/\/www.sapien.com\/blog\/?p=3551"},"modified":"2011-11-23T15:03:14","modified_gmt":"2011-11-23T23:03:14","slug":"primalforms-2011-spotlight-on-the-treeview-control-part-2","status":"publish","type":"post","link":"https:\/\/dev.sapien.com\/blog\/2011\/11\/23\/primalforms-2011-spotlight-on-the-treeview-control-part-2\/","title":{"rendered":"PrimalForms 2011: Spotlight on the TreeView Control – Part 2"},"content":{"rendered":"

The \u201cSpotlight on Controls\u201d series focuses on a single WinForms control in PrimalForms 2011, details the important Properties, Methods, and Events of the control and demonstrates how to utilize the control. Most of the information about the controls is still applicable to previous versions of PrimalForms.<\/em><\/p>\n

In Part 1<\/a> of the Spotlight on the TreeView control, we looked at the TreeView properties, methods and event. Now we will focus on the TreeNodes and the TreeView\u2019s Nodes property.<\/p>\n

TreeView Nodes Property Revisited:<\/strong><\/p>\n

The TreeView keeps track of its nodes via the Nodes<\/strong> property, which consists of a collection of TreeNode objects. <\/p>\n

This property can be used to remove nodes and\/or add nodes to the root of the tree. <\/p>\n

Adding Nodes:<\/strong><\/p>\n

You can add nodes via the designer or dynamically via the script editor.<\/p>\n

Adding nodes in the designer:<\/em><\/strong><\/p>\n

Use the Property Pane to edit the nodes:<\/p>\n

\"Nodes<\/p>\n

Or you can access the TreeNode Editor via the designer menu:<\/p>\n

\"Nodes<\/p>\n

TreeNode Editor:<\/p>\n

The TreeNode Editor allows you to add or remove nodes as well as alter their properties. In addition, nodes can be moved up and down the tree to become roots or child nodes. <\/p>\n

\"TreeNode<\/a><\/p>\n

Adding Nodes in Script Editor:<\/em><\/strong><\/p>\n

The TreeView\u2019s Nodes<\/strong> property has several methods that allow you to add nodes dynamically:<\/p>\n

[TreeNode]<\/font> Add<\/font> ([string]<\/font> text)<\/p>\n

[TreeNode] <\/font>Add<\/font> ([TreeNode]<\/font> node)<\/p>\n

[TreeNode] <\/font>Add<\/font> ([string]<\/font> key, [string]<\/font> text)<\/p>\n

[TreeNode] <\/font>Add<\/font> ([string]<\/font> key, [string]<\/font>text, [int]<\/font> imageIndex)<\/p>\n

[TreeNode]<\/font> Add<\/font> ([string]<\/font> key, [string]<\/font> text, [string]<\/font> imageKey)<\/p>\n

[TreeNode] <\/font>Add<\/font> ([string]<\/font> key, [string]<\/font> text, [int]<\/font> imageIndex, [int] <\/font>selectedImageIndex)<\/p>\n

[TreeNode]<\/font> Add<\/font> ([string]<\/font> key, [string]<\/font> text, [string]<\/font> imageKey, [string]<\/font> selectedImageKey)<\/p>\n

Example:<\/p>\n

$buttonAddNode_Click<\/span>=<\/span>{\n    <\/span>#Add and Select Node<\/span>\n    <\/span>$treeview1<\/span>.SelectedNode <\/span>=<\/span> <\/span>$treeview1<\/span>.Nodes.Add(<\/span>'<\/span>New Node'<\/span><\/span>);\n}<\/span><\/pre>\n
You can also use the Insert method to insert a node into a particular position:<\/p>\n
[TreeNode] <\/font>Insert <\/font>([int]<\/font> index, [string]<\/font> text)<\/p>\n
[TreeNode] <\/font>Insert <\/font>([int]<\/font> index, [TreeNode]<\/font> node)<\/p>\n
[TreeNode] <\/font>Insert <\/font>([int]<\/font> index, [string]<\/font> key, [string]<\/font> text)<\/p>\n
[TreeNode] <\/font>Insert <\/font>([int]<\/font> index, [string]<\/font> key, [string]<\/font> text, [int]<\/font> imageIndex)<\/p>\n
[TreeNode] <\/font>Insert <\/font>([int]<\/font> index, [string]<\/font> key, [string]<\/font> text, [string]<\/font> imageKey)<\/p>\n
[TreeNode] <\/font>Insert <\/font>([int]<\/font> index, [string]<\/font> key, [string] <\/font>text, [int] <\/font>imageIndex, [int] <\/font>selectedImageIndex)<\/p>\n
[TreeNode]<\/font> Insert <\/font>([int]<\/font> index, [string]<\/font> key, [string]<\/font> text, [string]<\/font> imageKey, [string]<\/font> selectedImageKey)<\/p>\n
Example:<\/p>\n
$buttonAddNode_Click<\/span>=<\/span>{\n    <\/span>#Insert node to the top of the tree<\/span>\n    <\/span>$treeview1<\/span>.Nodes.Insert(<\/span>0<\/span>, <\/span>'New Node'<\/span><\/span>);\n}<\/span><\/pre>\n
All the add methods return the TreeNode which was added. Each parameter corresponds to a similarly named TreeNode property. The only exception is the Key parameter, which pertains to the Name property of the TreeNode.<\/p>\n
TIP:<\/strong> When making significant changes to the TreeView\u2019s nodes, it is recommended to use the TreeView\u2019s BeginUpdate<\/strong> and  EndUpdate<\/strong> methods. The BeginUpdate<\/strong> method prevents the TreeView from redrawing every time a node is added or removed.<\/p>\n
Example use of BeginUpdate<\/strong> and EndUpdate<\/strong> methods:<\/p>\n
#Disable Drawing<\/span>\n<\/span>$treeviewServices<\/span>.BeginUpdate()\n\n<\/span>$services<\/span> <\/span>=<\/span> <\/span>Get-Service<\/span>\n<\/span>$treeviewServices<\/span>.Nodes.Clear()\n\n<\/span>foreach<\/span>(<\/span>$service<\/span> <\/span>in<\/span> <\/span>$services<\/span>)\n{\n    <\/span>$node<\/span> <\/span>=<\/span> <\/span>$Root<\/span>.Nodes.Add(<\/span>$service<\/span>.DisplayName)    \n}\n<\/span>#Enable Drawing<\/span>\n<\/span>$treeviewServices<\/span>.EndUpdate()<\/span><\/pre>\n
 <\/p>\n
Removing Nodes:<\/em><\/strong><\/p>\n
Use the Remove method to remove any node:<\/p>\n
[void]<\/font> Remove <\/font>([TreeNode] <\/font>node)<\/p>\n
Example:<\/p>\n
$buttonRemoveNode_Click<\/span>=<\/span>{\n    <\/span>if<\/span>(<\/span>$treeview1<\/span>.SelectedNode <\/span>-ne<\/span> <\/span>$null<\/span>)\n    {\n        <\/span>#Remove the selected node<\/span>\n        <\/span>$treeview1<\/span>.Nodes.Remove(<\/span>$treeview1<\/span>.SelectedNode)    \n    }    \n}<\/span><\/pre>\n
The following method removes all the nodes in the tree:<\/p>\n
[void]<\/font> Clear <\/font>()<\/p>\n
Example:<\/p>\n
$buttonRemoveAllNode_Click<\/span>=<\/span>{\n    <\/span>$treeview1<\/span>.Nodes.Clear()\n}<\/span><\/pre>\n
Searching for Nodes:<\/em><\/strong><\/p>\n
If you wish to find a node in the tree, you can use the Nodes<\/strong> property\u2019s Find method:<\/p>\n
[TreeNode []]<\/font> Find <\/font>([string]<\/font> key, [bool]<\/font> searchAllChildren)<\/p>\n
Example:<\/p>\n
    <\/span>$foundNodes<\/span> <\/span>=<\/span> <\/span>$treeview1<\/span>.Nodes.Find(<\/span>\"Node\"<\/span>, <\/span>$true<\/span>)\n    \n    <\/span>foreach<\/span> (<\/span>$node<\/span> <\/span>in<\/span> <\/span>$foundNodes<\/span>) {\n        <\/span>Write-Host<\/span> <\/span>\"Found: \"<\/span> <\/span>$node<\/span>.Text\n    }<\/span><\/pre>\n
The Find method performs a case insensitive search of  the TreeNodes\u2019  Name property to find a match. Therefore it is important to note that it does not search the Text property, so if the Name property is empty, the method will not find the node.<\/p>\n
 <\/p>\n
Let\u2019s look at the TreeNode object and its important properties and methods:<\/p>\n
TreeNode <\/strong>[System.Windows.Forms.TreeNode]<\/span><\/p>\n
Represents a node of a TreeView.<\/p>\n
<\/font><\/span><\/strong><\/p>\n
Important Properties:<\/strong><\/font><\/span> <\/p>\n
Checked<\/strong> <\/p>\n
This property gets or sets a value indicating whether the tree node is in a checked state. In order to see the check box, the TreeView must have its CheckBoxes<\/strong> property set to True. <\/p>\n
To determine if a Checked property has changed, use the TreeView\u2019s AfterChecked event. The event can be useful for tracking checked nodes. Another method of determining which TreeNodes are checked is to iterate through all the TreeNodes and inspect the value of the Checked property. <\/p>\n
Sample Function that returns all the checked nodes:<\/p>\n
function<\/span> <\/span>Get-CheckedNodes<\/span> \n{\n    <\/span>param<\/span>(\n    [ValidateNotNull()]\n    [System.Windows.Forms.TreeNodeCollection] <\/span>$NodeCollection<\/span>,\n    [ValidateNotNull()]\n    [System.Collections.ArrayList]<\/span>$CheckedNodes<\/span>)\n    \n    <\/span>foreach<\/span>(<\/span>$Node<\/span> <\/span>in<\/span> <\/span>$NodeCollection<\/span>)\n    {\n        <\/span>if<\/span>(<\/span>$Node<\/span>.Checked)\n        {\n            [void]<\/span>$CheckedNodes<\/span>.Add(<\/span>$Node<\/span>)\n        }\n        <\/span>Get-CheckedNodes<\/span> <\/span>$Node<\/span>.Nodes <\/span>$CheckedNodes<\/span>\n    }\n}<\/span><\/pre>\n
 <\/p>\n
Calling the function:<\/p>\n
    <\/span>$CheckedNodes<\/span> <\/span>=<\/span> <\/span>New-Object<\/span> System.Collections.ArrayList\n    <\/span>Get-CheckedNodes<\/span> <\/span>$treeview1<\/span>.Nodes <\/span>$CheckedNodes<\/span>\n    \n    <\/span>foreach<\/span>(<\/span>$node<\/span> <\/span>in<\/span> <\/span>$CheckedNodes<\/span>)\n    {    \n        <\/span>Write-Host<\/span> <\/span>$node<\/span>.Text\n    }<\/span><\/pre>\n
 <\/p>\n
ContextMenuStrip<\/strong> <\/p>\n
This property gets or sets the shortcut menu associated with this tree node. <\/p>\n
Use this property to assign a specific ContextMenuStrip to each individual node.  Each node can share the same ContextMenuStrip or have a unique ContextMenuStrip assigned to it. <\/p>\n
FirstNode<\/strong> <\/p>\n
This property returns the first child tree node in the tree node collection. <\/p>\n
This property can be useful for navigating through the nodes. <\/p>\n
FullPath<\/strong> <\/p>\n
This property returns the path from the root tree node to the current tree node. This property can be useful for navigation purposes. <\/p>\n
Example: <\/p>\n
\"AfterSort\" <\/p>\n
Node \u201c1 Nodes\u201d FullPath is: \u201cRoot\\B Node\\1 Node” <\/p>\n
You can change the backslash character \u2018\\\u2019 to any other character or string by changing the TreeView\u2019s PathSeparator property. <\/p>\n
IsEditing<\/strong> <\/p>\n
This property gets a value indicating whether the tree node is in an editable state. <\/p>\n
IsExpanded<\/strong> <\/p>\n
This property gets a value indicating whether the tree node is in the expanded state. <\/p>\n
IsSelected<\/strong> <\/p>\n
This property gets a value indicating whether the tree node is in the selected state. <\/p>\n
Name<\/strong> <\/p>\n
This property gets or sets the name of the tree node.  Note: The Name property is not the same as the Text property. When using the Find method, it will use this property to perform the search. <\/p>\n
NextNode<\/strong> <\/p>\n
This property gets the next sibling tree node. <\/p>\n
This property can be useful for navigating through the nodes.<\/p>\n
$node<\/span> <\/span>=<\/span> <\/span>$treeView1<\/span>.Nodes[<\/span>0<\/span>]\n\n<\/span>while<\/span>(<\/span>$node<\/span> <\/span>-ne<\/span> <\/span>$null<\/span>)\n{\n    <\/span>Write-Host<\/span> <\/span>$node<\/span>.Name  \n    <\/span>$node<\/span> <\/span>=<\/span> <\/span>$node<\/span>.NextNode\n}<\/span><\/pre>\n
  <\/p>\n
Nodes<\/strong> <\/p>\n
This property get the collection of child TreeNode objects assigned to the current tree node.  <\/p>\n
This property is identical to the TreeView\u2019s Nodes property, but instead contains this node\u2019s children.  <\/p>\n
PrevNode<\/strong> <\/p>\n
This property gets the previous sibling tree node.  <\/p>\n
Like the NextNode property, this property can be useful for navigating through the nodes. <\/p>\n
ImageIndex<\/strong> <\/p>\n
This property gets or sets the image list index value of the image displayed when the tree node is in the unselected state. <\/p>\n
TreeView\u2019s ImageList property must be set for this property to function correctly. If not set, the node will use the default index determined by the TreeView\u2019s ImageIndex property. <\/p>\n
To remove the Image from the node, set the node\u2019s ImageIndex property to \u20131. <\/p>\n
SelectedImageIndex<\/strong> <\/p>\n
This property gets or sets the image list index value of the image that is displayed when the tree node is in the selected state. <\/p>\n
TreeView\u2019s ImageList property must be set for this property to function correctly. If not set, the node will use the default index determined by the TreeView\u2019s SelectedImageIndex property. <\/p>\n
To remove the Image from the node, set the node\u2019s SelectedImageIndex property to \u20131. <\/p>\n
StateImageIndex<\/strong> <\/p>\n
This property gets or sets the index of the image that is used to indicate the state of the TreeNode when the parent TreeView has its CheckBoxes property set to false. <\/p>\n
TreeView\u2019s StateImageList property must be set for this property to function correctly. To remove the Image from the node, set the node\u2019s StateImageList property to \u20131. <\/p>\n
Example: <\/p>\n
\"StateImageIndex\" <\/p>\n
In this example the StateImageIndex is used to signify a problem with a file. <\/p>\n
Warning: If the TreeView\u2019s CheckBoxes is set to True, the StateImage will be displayed instead of the CheckBox.  <\/p>\n
Tag<\/strong> <\/p>\n
This property gets or sets the object that contains data about the tree node. <\/p>\n
This property can be extremely useful for linking the Node to an actual object. By using the Tag property, you can easily reference the original object. For example, if the nodes of a TreeView consists of services and you want to start \/ stop a service by double clicking on the node, you can assign the service object to the node\u2019s Tag property and as a result it simplifies the event handling.<\/p>\n
$treeviewServices_NodeMouseDoubleClick<\/span>=<\/span>[System.Windows.Forms.TreeNodeMouseClickEventHandler]{\n<\/span>#Event Argument: $_ = [System.Windows.Forms.TreeNodeMouseClickEventArgs]<\/span>\n    <\/span>$service<\/span> <\/span>=<\/span> <\/span>$_<\/span>.Node.Tag\n    \n    <\/span>if<\/span>(<\/span>$service<\/span> <\/span>-ne<\/span> <\/span>$null<\/span>)#Is there is a service object?<\/span>\n    {\n        <\/span>if<\/span>(<\/span>$service<\/span>.Status <\/span>-eq<\/span> <\/span>'Running'<\/span>)\n        {\n            <\/span>if<\/span>(<\/span>$service<\/span>.CanPauseAndContinue)\n            {\n                <\/span>#$service.Pause()<\/span>\n                <\/span>Write-Host<\/span> <\/span>'Pause Service'<\/span>\n <\/span>           }\n            <\/span>else<\/span>\n            {\n                <\/span>#$service.Stop()<\/span>\n                <\/span>Write-Host<\/span> <\/span>'Stop Service'<\/span>\n<\/span>            }\n        }\n        <\/span>elseif<\/span>(<\/span>$service<\/span>.Status <\/span>-eq<\/span> <\/span>'Paused'<\/span>)\n        {\n            <\/span>#$service.Continue()<\/span>\n            <\/span>Write-Host<\/span> <\/span>'Continue Service'<\/span>\n<\/span>        }\n        <\/span>else<\/span>\n        {\n            <\/span>#$service.Start()    <\/span>\n            <\/span>Write-Host<\/span> <\/span>'Start Service'<\/span>\n<\/span>        }\n    }\n    \n}<\/span><\/pre>\n
<\/strong>  <\/p>\n
Text<\/strong> <\/p>\n
This property gets or sets the text displayed in the label of the tree node. <\/p>\n
ToolTipText<\/strong> <\/p>\n
This property gets or sets the text that appears when the mouse pointer hovers over a TreeNode. The TreeView\u2019s ShowNodeTooltips property must be set to True in order for the tooltips to display.<\/p>\n
$node<\/span>.ToolTipText <\/span>=<\/span> <\/span>'This node has a tooltip!'<\/span> <\/pre>\n
 <\/pre>\n
Methods:<\/font><\/strong> <\/p>\n
BeginEdit<\/strong> <\/p>\n
This method initiates the editing of the tree node label. <\/p>\n
$buttonRename_Click<\/span>=<\/span>{\n    <\/span>if<\/span>(<\/span>$treeview1<\/span>.SelectedNode <\/span>-ne<\/span> <\/span>$null<\/span>)\n    {\n        <\/span>$treeview1<\/span>.SelectedNode.BeginEdit()\n    }\n}<\/span><\/pre>\n
<\/strong>  <\/p>\n
Collapse<\/strong> <\/p>\n
This method collapses the TreeNode and optionally collapses its children. <\/p>\n
#Collapse All Children<\/span>\n<\/span>$treeview1<\/span>.SelectedNode.Collapse()\n\n<\/span>#Collapse only this node and leave children<\/span>\n<\/span>$treeview1<\/span>.SelectedNode.Collapse(<\/span>$false<\/span>)<\/span><\/pre>\n
EndEdit<\/strong> <\/p>\n
This method ends the editing of the tree node label. <\/p>\n
if<\/span>(<\/span>$treeview1<\/span>.SelectedNode.IsEditing)\n{\n    <\/span>$treeview1<\/span>.SelectedNode.EndEdit()    \n}<\/span><\/pre>\n
<\/strong>  <\/p>\n
EnsureVisible<\/strong> <\/p>\n
This method ensures that the tree node is visible, expanding tree nodes and scrolling the tree view control as necessary. <\/p>\n
$treeview1<\/span>.SelectedNode.EnsureVisible() <\/span><\/p>\n
Expand<\/strong> <\/p>\n
This method expands the tree node. <\/p>\n
$treeview1<\/span>.SelectedNode.Expand() <\/span><\/p>\n
ExpandAll<\/strong> <\/p>\n
This method expands all the child tree nodes. <\/p>\n
$treeview1<\/span>.SelectedNode.ExpandAll() <\/span><\/p>\n
Remove<\/strong> <\/p>\n
This method removes the current tree node from the tree view control. <\/p>\n
$treeview1<\/span>.SelectedNode.Remove() <\/span><\/p>\n
Toggle<\/strong> <\/p>\n
This method toggles the tree node to either the expanded or collapsed state. <\/p>\n
$treeview1<\/span>.SelectedNode.Toggle() <\/span><\/p>\n
  <\/p>\n
 <\/strong>Download the TreeView Samples<\/a> from the downloads<\/a> section.<\/p>\n","protected":false},"excerpt":{"rendered":"
The \u201cSpotlight on Controls\u201d series focuses on a single WinForms control in PrimalForms 2011, details the important Properties, Methods, and Events of the control and demonstrates how to utilize the control. Most of the information about the controls is still applicable to previous versions of PrimalForms. In Part 1 of the Spotlight on the TreeView […]<\/p>\n","protected":false},"author":10,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_monsterinsights_skip_tracking":false,"_monsterinsights_sitenote_active":false,"_monsterinsights_sitenote_note":"","_monsterinsights_sitenote_category":0,"footnotes":""},"categories":[509,575,644,25],"tags":[641,28,633,490,327],"class_list":["post-3551","post","type-post","status-publish","format-standard","hentry","category-primalforms-software-news","category-primalforms-2011-software-news","category-spotlight-on-controls","category-windows-powershell","tag-controls","tag-powershell","tag-primalforms-2011","tag-treeview","tag-winform"],"jetpack_featured_media_url":"","_links":{"self":[{"href":"https:\/\/dev.sapien.com\/blog\/wp-json\/wp\/v2\/posts\/3551","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/dev.sapien.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/dev.sapien.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/dev.sapien.com\/blog\/wp-json\/wp\/v2\/users\/10"}],"replies":[{"embeddable":true,"href":"https:\/\/dev.sapien.com\/blog\/wp-json\/wp\/v2\/comments?post=3551"}],"version-history":[{"count":12,"href":"https:\/\/dev.sapien.com\/blog\/wp-json\/wp\/v2\/posts\/3551\/revisions"}],"predecessor-version":[{"id":3600,"href":"https:\/\/dev.sapien.com\/blog\/wp-json\/wp\/v2\/posts\/3551\/revisions\/3600"}],"wp:attachment":[{"href":"https:\/\/dev.sapien.com\/blog\/wp-json\/wp\/v2\/media?parent=3551"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/dev.sapien.com\/blog\/wp-json\/wp\/v2\/categories?post=3551"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/dev.sapien.com\/blog\/wp-json\/wp\/v2\/tags?post=3551"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}