TreeView.BeforeCheck Událost

Reference

Definice

Obor názvů:: System.Windows.Forms

Sestavení:: System.Windows.Forms.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Nastane před zaškrtnutím políčka uzel stromové struktury.

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

Event Type

TreeViewCancelEventHandler

Příklady

Následující příklad kódu aktualizuje všechny uzly podřízeného stromu objektu TreeNode , když uživatel změní svůj stav zaškrtnuté. Tento kód vyžaduje, abyste měli Form objekt s objektem TreeView , který obsahuje TreeNode objekty .TreeNodeCollection Uzel TreeNodeCollection by měl obsahovat uzly stromové struktury s podřízenými uzly.

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

Poznámky

Poznámka

TreeNode.Checked Nastavení vlastnosti v rámci BeforeCheck události nebo AfterCheck způsobí, že událost bude vyvolána vícekrát a může vést k neočekávanému chování. Například můžete nastavit Checked vlastnost v obslužné rutině události, když rekurzivně aktualizujete podřízené uzly, aby uživatel nemusel rozbalovat a kontrolovat každý zvlášť. Pokud chcete zabránit vícenásobnému vyvolání události, přidejte do obslužné rutiny události logiku, která spustí rekurzivní kód pouze v případě Action , že vlastnost objektu TreeViewEventArgs není nastavená na TreeViewAction.Unknownhodnotu .

Další informace o zpracování událostí najdete v tématu Zpracování a vyvolávání událostí.

Platí pro

Sdílet prostřednictvím