TreeNode.FromHandle(TreeView, IntPtr) Método

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);

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

Parâmetros

Devoluções

A TreeNode que representa o nó da árvore atribuído ao controlo especificado TreeView com o handle especificado.

Exemplos

O exemplo de código seguinte obtém o TreeNode que foi colapsado e cria uma cópia dele usando a sua Handle propriedade. O original TreeNode é removido do TreeNodeCollection, e a cópia é adicionada à coleção. Este exemplo exige que tenhas um Form com um TreeView controlo sobre ele. O TreeView controlo deve ter dois ou mais nós raiz, cada um com pelo menos um nó filho.

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

Observações

Quando um nó é adicionado à TreeView.Nodes coleção, o TreeView controlo envia uma notificação NM_CUSTOMDRAW antes de o handle do nó estar disponível. Se sobrescrever o WndProc método de fornecer TreeView um desenho personalizado em resposta a esta notificação, deve sempre verificar o valor de retorno deste método null antes de tentar aceder ao nó.

Ver também

• TreeView
• Handle