TreeView.BeforeCollapse 事件

定义

命名空间:

System.Windows.Forms

程序集:

System.Windows.Forms.dll

Source:

TreeView.cs

在折叠树节点前发生。

C#

public event System.Windows.Forms.TreeViewCancelEventHandler? BeforeCollapse;

事件类型

TreeViewCancelEventHandler

示例

下面的代码示例演示如何更改 的 TreeView 折叠状态，以便所有选中的节点都可见。 首先，展开所有节点，并为 事件添加 BeforeCollapse 处理程序。 接下来，将折叠所有节点。 事件处理程序 BeforeCollapse 确定给定节点是否具有已检查的子节点。 如果某个节点已选中子节点，则会取消该节点的折叠。 为了在单击节点旁边的减号时允许标准节点折叠， BeforeCollapse 然后删除事件处理程序。

还可以通过处理 BeforeExpand 事件来实现此行为，如该主题的示例所示。

有关完整示例，请参阅 TreeView 构造函数参考主题。

C#

private void showCheckedNodesButton_Click(object sender, EventArgs e)
{
    // Disable redrawing of treeView1 to prevent flickering 
    // while changes are made.
    treeView1.BeginUpdate();

    // Collapse all nodes of treeView1.
    treeView1.ExpandAll();

    // Add the checkForCheckedChildren event handler to the BeforeExpand event.
    treeView1.BeforeCollapse += checkForCheckedChildren;

    // Expand all nodes of treeView1. Nodes without checked children are 
    // prevented from expanding by the checkForCheckedChildren event handler.
    treeView1.CollapseAll();

    // Remove the checkForCheckedChildren event handler from the BeforeExpand 
    // event so manual node expansion will work correctly.
    treeView1.BeforeCollapse -= checkForCheckedChildren;

    // Enable redrawing of treeView1.
    treeView1.EndUpdate();
}

// Prevent collapse of a node that has checked child nodes.
private void CheckForCheckedChildrenHandler(object sender, 
    TreeViewCancelEventArgs e)
{
    if (HasCheckedChildNodes(e.Node)) e.Cancel = true;
}

// Returns a value indicating whether the specified 
// TreeNode has checked child nodes.
private bool HasCheckedChildNodes(TreeNode node)
{
    if (node.Nodes.Count == 0) return false;
    foreach (TreeNode childNode in node.Nodes)
    {
        if (childNode.Checked) return true;
        // Recursively check the children of the current child node.
        if (HasCheckedChildNodes(childNode)) return true;
    }
    return false;
}

注解

有关如何处理事件的详细信息，请参阅 处理和引发事件。

适用于

另请参阅

• OnBeforeCollapse(TreeViewCancelEventArgs)
• AfterCollapse
• OnAfterCollapse(TreeViewEventArgs)