TreeNode.Toggle Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Toggles the tree node to either the expanded or collapsed state.
public:
void Toggle();public void Toggle ();member this.Toggle : unit -> unitPublic Sub Toggle ()Examples
The following code example removes a TreeNode when the user right-clicks the mouse over it and toggles it from expanded to collapsed when the user clicks the mouse wheel over it. This example requires that you have a Form with a TreeView control on it. The TreeView should have two or more root tree nodes, each having at least one child node.
private:
void treeView1_MouseDown( Object^ /*sender*/, MouseEventArgs^ e )
{
switch ( e->Button )
{
// Remove the TreeNode under the mouse cursor
// if the right mouse button was clicked.
case ::MouseButtons::Right:
treeView1->GetNodeAt( e->X, e->Y )->Remove();
break;
// Toggle the TreeNode under the mouse cursor
// if the middle mouse button (mouse wheel) was clicked.
case ::MouseButtons::Middle:
treeView1->GetNodeAt( e->X, e->Y )->Toggle();
break;
}
}
private void treeView1_MouseDown(object sender, MouseEventArgs e)
{
switch(e.Button)
{
// Remove the TreeNode under the mouse cursor
// if the right mouse button was clicked.
case MouseButtons.Right:
treeView1.GetNodeAt(e.X, e.Y).Remove();
break;
// Toggle the TreeNode under the mouse cursor
// if the middle mouse button (mouse wheel) was clicked.
case MouseButtons.Middle:
treeView1.GetNodeAt(e.X, e.Y).Toggle();
break;
}
}
Private Sub treeView1_MouseDown(sender As Object, _
e As MouseEventArgs) Handles treeView1.MouseDown
Select Case e.Button
' Remove the TreeNode under the mouse cursor
' if the right mouse button was clicked.
Case MouseButtons.Right
treeView1.GetNodeAt(e.X, e.Y).Remove()
' Toggle the TreeNode under the mouse cursor
' if the middle mouse button (mouse wheel) was clicked.
Case MouseButtons.Middle
treeView1.GetNodeAt(e.X, e.Y).Toggle()
End Select
End Sub
Remarks
The tree node is toggled to the state opposite its current state, either expanded or collapsed.
Note
The state of a TreeNode is persisted. For example, if the next level of child nodes was not collapsed previously, when the Expand method is called, the child nodes appear in their previously expanded state.
