TreeNode.EnsureVisible 方法

定义

命名空间:

System.Windows.Forms

程序集:

System.Windows.Forms.dll

确保树节点可见，并在必要时展开树节点和滚动树视图控件。

public:
 void EnsureVisible();

public void EnsureVisible ();

member this.EnsureVisible : unit -> unit

Public Sub EnsureVisible ()

示例

下面的代码示例在单击按钮时，将最后一个根树节点的最后一个子树节点引入树视图中。 此示例要求你对包含TreeView对象集合和对象的Button集合TreeNode具有控件Form。 应该有足够的树节点，这样它们就不会显示在树视图控件中。

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

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

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

注解

When the EnsureVisible method is called, the tree is expanded and scrolled to ensure that the current tree node is visible in the TreeView. 如果要根据特定条件在代码中选择树节点，则此方法非常有用。 通过在选择节点后调用此方法，用户可以查看所选节点并与之交互。

备注

如果属性 TreeView.ItemHeight 设置为大于树视图控件高度的值，则调用此方法会产生意外的结果。

另请参阅

• IsVisible
• PrevVisibleNode
• NextVisibleNode