TreeNode::Checked Property


The .NET API Reference documentation has a new home. Visit the .NET API Browser on to see the new experience.

Gets or sets a value indicating whether the tree node is in a checked state.

Namespace:   System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)

property bool Checked {
	bool get();
	void set(bool value);

Property Value

Type: System::Boolean

true if the tree node is in a checked state; otherwise, false.

The following code example highlights any TreeNode objects a TreeView control that has its Checked property set to true by setting its BackColor property to Yellow. This code requires that you have a TreeView control on a Form with a collection of TreeNode objects.

   void HighlightCheckedNodes()
      int countIndex = 0;
      String^ selectedNode = "Selected customer nodes are : ";
      IEnumerator^ myEnum = myTreeView->Nodes[ 0 ]->Nodes->GetEnumerator();
      while ( myEnum->MoveNext() )
         TreeNode^ myNode = safe_cast<TreeNode^>(myEnum->Current);

         // Check whether the tree node is checked.
         if ( myNode->Checked )

            // Set the node's backColor.
            myNode->BackColor = Color::Yellow;
            selectedNode = String::Concat( selectedNode, myNode->Text, " " );
                  myNode->BackColor = Color::White;

      if ( countIndex > 0 )
            MessageBox::Show( selectedNode );
            MessageBox::Show( "No nodes are selected" );

.NET Framework
Available since 1.1
Return to top