TreeNode.Handle-Eigenschaft

Ruft das Handle des Strukturknotens ab.

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

Syntax

'Declaration
Public ReadOnly Property Handle As IntPtr
'Usage
Dim instance As TreeNode
Dim value As IntPtr

value = instance.Handle

public IntPtr Handle { get; }

public:
property IntPtr Handle {
    IntPtr get ();
}

/** @property */
public IntPtr get_Handle ()

public function get Handle () : IntPtr

Eigenschaftenwert

Das Handle des Strukturknotens.

Hinweise

Wenn noch kein Handle erstellt wurde, wird es beim Verweis auf die Handle-Eigenschaft erstellt.

Beispiel

Im folgenden Codebeispiel wird der reduzierte TreeNode abgerufen und mithilfe der Handle-Eigenschaft eine Kopie von diesem erstellt. Der ursprüngliche TreeNode wird aus der TreeNodeCollection entfernt, und die Kopie wird der Auflistung hinzugefügt. Für dieses Beispiel ist es erforderlich, dass ein Form mit einem TreeView-Steuerelement vorhanden ist. Das TreeView-Steuerelement muss mindestens zwei Stammknoten mit jeweils mindestens einem untergeordneten Knoten aufweisen.

Private Sub treeView1_AfterCollapse(sender As Object, _
  e As TreeViewEventArgs) Handles treeView1.AfterCollapse
   ' Create a copy of the e.Node from its Handle.
   Dim tn As TreeNode = TreeNode.FromHandle(e.Node.TreeView, e.Node.Handle)
   tn.Text += "Copy"
   ' Remove the e.Node so it can be replaced with tn.
   e.Node.Remove()
   ' Add tn to the TreeNodeCollection.
   treeView1.Nodes.Add(tn)
End Sub 

private void treeView1_AfterCollapse(object sender, TreeViewEventArgs e)
{
   // Create a copy of the e.Node from its Handle.
   TreeNode tn = TreeNode.FromHandle(e.Node.TreeView, e.Node.Handle);
   tn.Text += "Copy";
   // Remove the e.Node so it can be replaced with tn.
   e.Node.Remove();
   // Add tn to the TreeNodeCollection.
   treeView1.Nodes.Add(tn);
}

private:
   void treeView1_AfterCollapse( Object^ /*sender*/, TreeViewEventArgs^ e )
   {
      // Create a copy of the e.Node from its Handle.
      TreeNode^ tn = TreeNode::FromHandle( e->Node->TreeView, e->Node->Handle );
      tn->Text = String::Concat( tn->Text, "Copy" );

      // Remove the e.Node so it can be replaced with tn.
      e->Node->Remove();

      // Add tn to the TreeNodeCollection.
      treeView1->Nodes->Add( tn );
   }

private void treeView1_AfterCollapse(Object sender, TreeViewEventArgs e)
{
    // Create a copy of the e.Node from its Handle.
    TreeNode tn = TreeNode.FromHandle(e.get_Node().get_TreeView(), 
        e.get_Node().get_Handle());
    tn.set_Text(tn.get_Text() + "Copy");
    // Remove the e.Node so it can be replaced with tn.
    e.get_Node().Remove();
    // Add tn to the TreeNodeCollection.
    treeView1.get_Nodes().Add(tn);
} //treeView1_AfterCollapse

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

Siehe auch

Referenz

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