TreeView.BeforeCheck Zdarzenie

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Windows.Forms
Zestaw:
System.Windows.Forms.dll

Występuje przed zaznaczeniem pola wyboru węzła drzewa.

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

Typ zdarzenia

TreeViewCancelEventHandler

Przykłady

Poniższy przykład kodu aktualizuje wszystkie węzły drzewa podrzędnego TreeNode obiektu, gdy użytkownik zmieni jego stan zaewidencjonowany. Ten kod wymaga obiektu Form z obiektem zawierającym TreeViewTreeNode obiekty w obiekcie TreeNodeCollection. Element TreeNodeCollection powinien mieć węzły drzewa z węzłami podrzędnymi.

// 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

Uwagi

Uwaga

TreeNode.Checked Ustawienie właściwości z poziomu BeforeCheck zdarzenia lub AfterCheck powoduje wielokrotne wywoływanie zdarzenia i może spowodować nieoczekiwane zachowanie. Można na przykład ustawić Checked właściwość w procedurze obsługi zdarzeń podczas cyklicznego aktualizowania węzłów podrzędnych, aby użytkownik nie musiał rozszerzać i sprawdzać każdego z nich pojedynczo. Aby zapobiec wielokrotnemu wywoływaniu zdarzenia, dodaj logikę do procedury obsługi zdarzeń, która wykonuje kod cyklisywny tylko wtedy, gdy Action właściwość TreeViewEventArgs obiektu nie jest ustawiona na TreeViewAction.Unknownwartość .

Aby uzyskać więcej informacji na temat obsługi zdarzeń, zobacz Obsługa i podnoszenie zdarzeń.

Dotyczy

Zobacz też