TreeNode.FromHandle-Methode

Artikel
08/20/2007

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

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

Syntax

'Declaration
Public Shared Function FromHandle ( _
    tree As TreeView, _
    handle As IntPtr _
) As TreeNode
'Usage
Dim tree As TreeView
Dim handle As IntPtr
Dim returnValue As TreeNode

returnValue = TreeNode.FromHandle(tree, handle)

public static TreeNode FromHandle (
    TreeView tree,
    IntPtr handle
)

public:
static TreeNode^ FromHandle (
    TreeView^ tree, 
    IntPtr handle
)

public static TreeNode FromHandle (
    TreeView tree, 
    IntPtr handle
)

public static function FromHandle (
    tree : TreeView, 
    handle : IntPtr
) : TreeNode

Parameter

tree
Die TreeView, die den Strukturknoten enthält.

handle
Das Handle des Strukturknotens.

Rückgabewert

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

Hinweise

Wenn der TreeView.Nodes-Auflistung ein Knoten hinzugefügt wird, sendet das TreeView-Steuerelement eine NM_CUSTOMDRAW-Benachrichtigung, bevor das Knotenhandle verfügbar ist. Wenn Sie die WndProc-Methode der TreeView überschreiben, um als Reaktion auf diese Benachrichtigung benutzerdefiniertes Zeichnen bereitzustellen, sollten Sie den Rückgabewert dieser Methode immer auf NULL (Nothing in Visual Basic) überprüfen, bevor Sie versuchen, auf den Knoten zuzugreifen.

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

Siehe auch

Referenz

TreeNode-Klasse
TreeNode-Member
System.Windows.Forms-Namespace
TreeView
Control.Handle-Eigenschaft

Freigeben über