TreeNode.EnsureVisible TreeNode.EnsureVisible TreeNode.EnsureVisible TreeNode.EnsureVisible Method

Definición

Garantiza que el nodo de árbol está visible, expandiendo los nodos de árbol y desplaza el control de vista de árbol según sea necesario.Ensures that the tree node is visible, expanding tree nodes and scrolling the tree view control as necessary.

public:
 void EnsureVisible();
public void EnsureVisible ();
member this.EnsureVisible : unit -> unit
Public Sub EnsureVisible ()

Ejemplos

En el ejemplo de código siguiente se muestra al último elemento secundario el nodo de árbol del último nodo de árbol raíz en la vista de árbol cuando se hace clic en un botón.The following code example brings the last child tree node of the last root tree node into view in the tree view when a button is clicked. En este ejemplo requiere que haya un TreeView control en un Form que contiene una colección de TreeNode objetos y un Button.This example requires that you have a TreeView control on a Form that contains a collection of TreeNode objects, and a Button. Debe haber suficientes nodos de árbol para que no estén visibles en el control de vista de árbol.There should be enough tree nodes so that they are not all visible in the tree view control.

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

Comentarios

Cuando el EnsureVisible se llama al método, el árbol se expande y se desplaza para asegurarse de que el actual nodo de árbol está visible en el TreeView.When the EnsureVisible method is called, the tree is expanded and scrolled to ensure that the current tree node is visible in the TreeView. Este método es útil si se selecciona un nodo de árbol en código basado en determinados criterios.This method is useful if you are selecting a tree node in code based on certain criteria. Al llamar a este método después de seleccionar el nodo, el usuario puede ver e interactuar con el nodo seleccionado.By calling this method after you select the node, the user can see and interact with the selected node.

Nota

Si el TreeView.ItemHeight propiedad está establecida en un valor mayor que el alto del control de vista de árbol, llamar a este método tiene resultados inesperados.If the TreeView.ItemHeight property is set to a value that is larger than the height of the tree view control, calling this method has unexpected results.

Se aplica a

Consulte también: