TreeNode.Checked-Eigenschaft

Ruft einen Wert ab, der angibt, ob der Strukturknoten aktiviert ist, oder legt diesen fest.

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

Syntax

'Declaration
Public Property Checked As Boolean
'Usage
Dim instance As TreeNode
Dim value As Boolean

value = instance.Checked

instance.Checked = value

public bool Checked { get; set; }

public:
property bool Checked {
    bool get ();
    void set (bool value);
}

/** @property */
public boolean get_Checked ()

/** @property */
public void set_Checked (boolean value)

public function get Checked () : boolean

public function set Checked (value : boolean)

Eigenschaftenwert

true, wenn der Strukturknoten aktiviert ist, andernfalls false.

Beispiel

Im folgenden Codebeispiel werden alle TreeNode-Objekte eines TreeView-Steuerelements hervorgehoben, dessen Checked-Eigenschaft auf true festgelegt ist, indem dessen BackColor-Eigenschaft auf Yellow festgelegt wird. Für diesen Code ist es erforderlich, dass ein TreeView-Steuerelement in einem Form mit einer Auflistung von TreeNode-Objekten vorhanden ist.

Public Sub HighlightCheckedNodes()
   Dim countIndex As Integer = 0
   Dim selectedNode As String = "Selected customer nodes are : "
   Dim myNode As TreeNode
   For Each myNode In  myTreeView.Nodes(0).Nodes
      ' Check whether the tree node is checked.
      If myNode.Checked Then
         ' Set the node's backColor.
         myNode.BackColor = Color.Yellow
         selectedNode += myNode.Text + " "
         countIndex += 1
      Else
         myNode.BackColor = Color.White
      End If
   Next myNode

   If countIndex > 0 Then
      MessageBox.Show(selectedNode)
   Else
      MessageBox.Show("No nodes are selected")
   End If
End Sub

public void HighlightCheckedNodes()
{
   int countIndex = 0;
   string selectedNode = "Selected customer nodes are : ";
   foreach (TreeNode myNode in myTreeView.Nodes[0].Nodes)
   {
      // Check whether the tree node is checked.
      if(myNode.Checked)
      {
         // Set the node's backColor.
         myNode.BackColor = Color.Yellow;
         selectedNode += myNode.Text+" ";
         countIndex++;
      }
      else
         myNode.BackColor = Color.White;
   }

   if(countIndex > 0)
      MessageBox.Show(selectedNode);
   else
      MessageBox.Show("No nodes are selected");
}

public:
   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, " " );
            countIndex++;
         }
         else
                  myNode->BackColor = Color::White;
      }

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

public void HighlightCheckedNodes()
{
    int countIndex = 0;
    String selectedNode = "Selected customer nodes are : ";
    for (int iCtr = 0; iCtr < myTreeView.get_Nodes().get_Item(0).
        get_Nodes().get_Count(); iCtr++) {
        TreeNode myNode = myTreeView.get_Nodes().get_Item(0).
            get_Nodes().get_Item(iCtr);
        // Check whether the tree node is checked.
        if (myNode.get_Checked()) {
            // Set the node's backColor.
            myNode.set_BackColor(Color.get_Yellow());
            selectedNode += myNode.get_Text() + " ";
            countIndex++;
        }
        else {
            myNode.set_BackColor(Color.get_White());
        }
    }
    if (countIndex > 0) {
        MessageBox.Show(selectedNode); 
    }
    else {
        MessageBox.Show("No nodes are selected");
    }
} //HighlightCheckedNodes

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

TreeNode-Klasse
TreeNode-Member
System.Windows.Forms-Namespace
CheckBoxes