TreeNode.EnsureVisible メソッド

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

TreeNode.EnsureVisible メソッド

ツリー ノードが確実に表示されるようにします。必要に応じてツリー ノードを展開し、ツリー ビュー コントロールをスクロールします。

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

Visual Basic (宣言)

Public Sub EnsureVisible

Visual Basic (使用法)

Dim instance As TreeNode

instance.EnsureVisible

C#

public void EnsureVisible ()

C++

public:
void EnsureVisible ()

J#

public void EnsureVisible ()

JScript

public function EnsureVisible ()

解説

EnsureVisible メソッドが呼び出されると、現在のツリー ノードが TreeView 内に確実に表示されるように、ツリーが展開およびスクロールされます。このメソッドは、特定の基準に基づいてコード内でツリー ノードを選択する場合に役立ちます。ノードを選択した後にこのメソッドを呼び出して、選択されたノードをユーザーに対して表示し、すぐに操作できるようにします。

メモ
TreeView.ItemHeight プロパティをツリー ビュー コントロールの高さよりも大きな値に設定した場合、このメソッドを呼び出すと、予期しない結果が得られます。

使用例

ボタンがクリックされたときに、最後のルート ツリー ノードの最後の子ツリー ノードをツリー ビューの表示領域内に表示させるコード例を次に示します。この例は、TreeNode オブジェクトのコレクションを格納する TreeView コントロール、および Button が、Form に配置されていることを前提にしています。十分な数のツリー ノードを作成し、一部のノードがツリー ビュー コントロールの表示領域に収まらないようにします。

Visual Basic

Private Sub button3_Click(sender As
 Object, _
  e As System.EventArgs) Handles button3.Click
   Dim lastNode as TreeNode
   lastNode = treeView1.Nodes(treeView1.Nodes.Count - 1). _
     Nodes(treeView1.Nodes(treeView1.Nodes.Count - 1).Nodes.Count - 1)

   If Not lastNode.IsVisible Then
      lastNode.EnsureVisible()
      MessageBox.Show(lastNode.Text & _
        " tree node is visible.")
   End If
End Sub

C#

private void button3_Click(object sender, System.EventArgs
 e)
{
   TreeNode lastNode = treeView1.Nodes[treeView1.Nodes.Count - 1].
     Nodes[treeView1.Nodes[treeView1.Nodes.Count - 1].Nodes.Count - 1];

   if (!lastNode.IsVisible)
   {
      lastNode.EnsureVisible();
      MessageBox.Show(lastNode.Text + " tree node is visible.");
   }
}

C++

void button3_Click( Object^ /*sender*/, System::EventArgs^ /*e*/
 )
{
   TreeNode^ lastNode = treeView1->Nodes[ treeView1->Nodes->Count - 1 ]->Nodes[
 treeView1->Nodes[ treeView1->Nodes->Count - 1 ]->Nodes->Count -
 1 ];
   if (  !lastNode->IsVisible )
   {
      lastNode->EnsureVisible();
      MessageBox::Show( String::Concat( lastNode->Text, " tree node is visible."
 ) );
   }
}

J#

private void button3_Click(Object sender, System.EventArgs
 e)
{
    TreeNode lastNode = treeView1.get_Nodes().get_Item(
        (treeView1.get_Nodes().get_Count() - 1)).get_Nodes().
        get_Item((treeView1.get_Nodes().get_Item(treeView1.get_Nodes().
        get_Count() - 1).get_Nodes().get_Count() - 1));

    if (!(lastNode.get_IsVisible())) {
        lastNode.EnsureVisible();
        MessageBox.Show(lastNode.get_Text() + " tree node is visible.");
    }
} //button3_Click

プラットフォーム

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
.NET Compact Framework
サポート対象 : 2.0

参照

関連項目
TreeNode クラス
TreeNode メンバ
System.Windows.Forms 名前空間
IsVisible
PrevVisibleNode
NextVisibleNode