TreeNode.FromHandle(TreeView, IntPtr) Methode

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Gibt den Strukturknoten zurück, dem das angegebene Handle zugeordnet ist und der dem angegebenen Strukturansicht-Steuerelement zugewiesen ist.

public:
 static System::Windows::Forms::TreeNode ^ FromHandle(System::Windows::Forms::TreeView ^ tree, IntPtr handle);

public static System.Windows.Forms.TreeNode FromHandle (System.Windows.Forms.TreeView tree, IntPtr handle);

static member FromHandle : System.Windows.Forms.TreeView * nativeint -> System.Windows.Forms.TreeNode

Public Shared Function FromHandle (tree As TreeView, handle As IntPtr) As TreeNode

Parameter

tree

TreeView

Die TreeView, die den Strukturknoten enthält.

handle

IntPtr

nativeint

Das Handle des Strukturknotens.

Gibt zurück

TreeNode

Ein TreeNode, der den Strukturknoten mit dem angegebenen Handle darstellt, der dem angegebenen TreeView-Steuerelement zugewiesen ist.

Beispiele

Im folgenden Codebeispiel wird das Objekt reduziert und eine Kopie erstellt, die TreeNode die Handle Eigenschaft verwendet. Das Original TreeNode wird aus der TreeNodeCollectionSammlung entfernt, und die Kopie wird der Auflistung hinzugefügt. In diesem Beispiel ist erforderlich, dass Sie über ein Form TreeView Steuerelement verfügen. Das TreeView Steuerelement sollte zwei oder mehrere Stammknoten aufweisen, wobei mindestens ein untergeordneter Knoten vorhanden ist.

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

Hinweise

Wenn ein Knoten der TreeView.Nodes Auflistung hinzugefügt wird, sendet das TreeView Steuerelement eine NM_CUSTOMDRAW Benachrichtigung, bevor der Knotenhandpunkt verfügbar ist. Wenn Sie die Methode TreeView der WndProc benutzerdefinierten Zeichnung als Reaktion auf diese Benachrichtigung außer Kraft setzen, sollten Sie immer den Rückgabewert dieser Methode null überprüfen, bevor Sie versuchen, auf den Knoten zuzugreifen.

Siehe auch

• TreeView
• Handle