TreeView.BeforeCheck Ereignis
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Tritt auf, bevor das Kontrollkästchen "Strukturknoten" aktiviert ist.
public:
event System::Windows::Forms::TreeViewCancelEventHandler ^ BeforeCheck;public event System.Windows.Forms.TreeViewCancelEventHandler BeforeCheck;public event System.Windows.Forms.TreeViewCancelEventHandler? BeforeCheck;member this.BeforeCheck : System.Windows.Forms.TreeViewCancelEventHandler Public Custom Event BeforeCheck As TreeViewCancelEventHandler Ereignistyp
Beispiele
Im folgenden Codebeispiel werden alle untergeordneten Strukturknoten eines TreeNode Elements aktualisiert, wenn der Benutzer seinen aktivierten Zustand ändert. Dieser Code erfordert, dass Sie über ein FormTreeView Objekt verfügen, das TreeNode Objekte enthält TreeNodeCollection. Die TreeNodeCollection Strukturknoten sollten mit untergeordneten Knoten vorhanden sein.
// Updates all child tree nodes recursively.
void CheckAllChildNodes( TreeNode^ treeNode, bool nodeChecked )
{
IEnumerator^ myEnum = treeNode->Nodes->GetEnumerator();
while ( myEnum->MoveNext() )
{
TreeNode^ node = safe_cast<TreeNode^>(myEnum->Current);
node->Checked = nodeChecked;
if ( node->Nodes->Count > 0 )
{
// If the current node has child nodes, call the CheckAllChildsNodes method recursively.
this->CheckAllChildNodes( node, nodeChecked );
}
}
}
// NOTE This code can be added to the BeforeCheck event handler instead of the AfterCheck event.
// After a tree node's Checked property is changed, all its child nodes are updated to the same value.
void node_AfterCheck( Object^ /*sender*/, TreeViewEventArgs^ e )
{
// The code only executes if the user caused the checked state to change.
if ( e->Action != TreeViewAction::Unknown )
{
if ( e->Node->Nodes->Count > 0 )
{
/* Calls the CheckAllChildNodes method, passing in the current
Checked value of the TreeNode whose checked state changed. */
this->CheckAllChildNodes( e->Node, e->Node->Checked );
}
}
}
// Updates all child tree nodes recursively.
private void CheckAllChildNodes(TreeNode treeNode, bool nodeChecked)
{
foreach(TreeNode node in treeNode.Nodes)
{
node.Checked = nodeChecked;
if(node.Nodes.Count > 0)
{
// If the current node has child nodes, call the CheckAllChildsNodes method recursively.
this.CheckAllChildNodes(node, nodeChecked);
}
}
}
// NOTE This code can be added to the BeforeCheck event handler instead of the AfterCheck event.
// After a tree node's Checked property is changed, all its child nodes are updated to the same value.
private void node_AfterCheck(object sender, TreeViewEventArgs e)
{
// The code only executes if the user caused the checked state to change.
if(e.Action != TreeViewAction.Unknown)
{
if(e.Node.Nodes.Count > 0)
{
/* Calls the CheckAllChildNodes method, passing in the current
Checked value of the TreeNode whose checked state changed. */
this.CheckAllChildNodes(e.Node, e.Node.Checked);
}
}
}
' Updates all child tree nodes recursively.
Private Sub CheckAllChildNodes(treeNode As TreeNode, nodeChecked As Boolean)
Dim node As TreeNode
For Each node In treeNode.Nodes
node.Checked = nodeChecked
If node.Nodes.Count > 0 Then
' If the current node has child nodes, call the CheckAllChildsNodes method recursively.
Me.CheckAllChildNodes(node, nodeChecked)
End If
Next node
End Sub
' NOTE This code can be added to the BeforeCheck event handler instead of the AfterCheck event.
' After a tree node's Checked property is changed, all its child nodes are updated to the same value.
Private Sub node_AfterCheck(sender As Object, e As TreeViewEventArgs) Handles treeView1.AfterCheck
' The code only executes if the user caused the checked state to change.
If e.Action <> TreeViewAction.Unknown Then
If e.Node.Nodes.Count > 0 Then
' Calls the CheckAllChildNodes method, passing in the current
' Checked value of the TreeNode whose checked state changed.
Me.CheckAllChildNodes(e.Node, e.Node.Checked)
End If
End If
End Sub
Hinweise
Hinweis
Wenn Sie die TreeNode.Checked Eigenschaft innerhalb des BeforeCheck Ereignisses festlegen AfterCheck , wird das Ereignis mehrmals ausgelöst und kann zu unerwartetem Verhalten führen. Sie können beispielsweise die Checked Eigenschaft im Ereignishandler festlegen, wenn Sie die untergeordneten Knoten rekursiv aktualisieren, sodass der Benutzer nicht einzeln erweitert und überprüft werden muss. Um zu verhindern, dass das Ereignis mehrmals ausgelöst wird, fügen Sie dem Ereignishandler Logik hinzu, die nur den rekursiven Code ausführt, wenn die Action Eigenschaft des TreeViewEventArgs Ereignisses nicht auf " TreeViewAction.Unknown.
Weitere Informationen zum Behandeln von Ereignissen finden Sie unter Behandeln und Auslösen von Ereignissen.
