TreeNode.EnsureVisible Método

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

Garantiza que el nodo de árbol sea visible, mediante la expansión de los nodos de árbol y el desplazamiento por el control de vista de árbol según sea necesario.

public:
 void EnsureVisible();

public void EnsureVisible ();

member this.EnsureVisible : unit -> unit

Public Sub EnsureVisible ()

Ejemplos

En el ejemplo de código siguiente se muestra el último nodo de árbol secundario del último nodo de árbol raíz en la vista de árbol cuando se hace clic en un botón. En este ejemplo se requiere que tenga un TreeView control en un Form objeto que contenga una colección de TreeNode objetos y un Button. Debe haber suficientes nodos de árbol para que no estén todos visibles en el control de vista de árbol.

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 se llama al EnsureVisible método , el árbol se expande y se desplaza para asegurarse de que el nodo de árbol actual está visible en .TreeView Este método es útil si selecciona un nodo de árbol en el código en función de determinados criterios. Al llamar a este método después de seleccionar el nodo, el usuario puede ver e interactuar con el nodo seleccionado.

Nota

Si la TreeView.ItemHeight propiedad se establece en un valor mayor que el alto del control de vista de árbol, llamar a este método tiene resultados inesperados.

Consulte también

• IsVisible
• PrevVisibleNode
• NextVisibleNode