TreeNode.FromHandle メソッド

.NET Framework クラス ライブラリ リファレンス

TreeNode.FromHandle メソッド

指定されたハンドルを持ち、指定されたツリー ビュー コントロールに割り当てられているツリー ノードを返します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

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

Visual Basic (使用法)

Dim tree As TreeView
Dim handle As IntPtr
Dim returnValue As TreeNode

returnValue = TreeNode.FromHandle(tree, handle)

C#

public static TreeNode FromHandle (
    TreeView tree,
    IntPtr handle
)

C++

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

J#

public static TreeNode FromHandle (
    TreeView tree, 
    IntPtr handle
)

JScript

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

パラメータ

tree

ツリー ノードを格納している TreeView。

handle

ツリー ノードのハンドル。

戻り値
指定されたハンドルを持ち、指定された TreeView に割り当てられているツリー ノードを表す TreeNode。

解説

ノードを TreeView.Nodes コレクションに追加すると、TreeView コントロールから NM_CUSTOMDRAW 通知が送られ、ノードのハンドルが使用できるようになります。TreeView の WndProc メソッドをオーバーライドし、この通知に応答するカスタム描画を提供する場合、ノードへのアクセスを試行する前に、このメソッドの戻り値が null 参照 (Visual Basic では Nothing) かどうかを常に確認する必要があります。

使用例

折りたたまれた TreeNode を取得し、Handle プロパティを使用してそのコピーを作成するコード例を次に示します。元の TreeNode は TreeNodeCollection から削除され、コピーがコレクションに追加されます。この例では、TreeView コントロールが配置された Form が存在している必要があります。TreeView コントロールは 2 つ以上のルート ノードを持ち、各ルート ノードに 1 つ以上の子ノードを持っている必要があります。

Visual Basic

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 

C#

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

C++

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

J#

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

プラットフォーム

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

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
TreeNode クラス
TreeNode メンバ
System.Windows.Forms 名前空間
TreeView
Control.Handle プロパティ