TreeNode.EnsureVisible Método

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Garante que o nó da árvore esteja visível, expandindo os nós da árvore e rolando o controle de exibição de árvore conforme necessário.

public:
 void EnsureVisible();

public void EnsureVisible ();

member this.EnsureVisible : unit -> unit

Public Sub EnsureVisible ()

Exemplos

O exemplo de código a seguir traz o último nó de árvore filho do último nó de árvore raiz em exibição no modo de exibição de árvore quando um botão é clicado. Este exemplo requer que você tenha um TreeView controle em um Form que contenha uma coleção de TreeNode objetos e um Button. Deve haver nós de árvore suficientes para que eles não fiquem visíveis no controle de exibição de árvore.

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

Comentários

Quando o EnsureVisible método é chamado, a árvore é expandida e rolada para garantir que o nó de árvore atual esteja visível no TreeView. Esse método será útil se você estiver selecionando um nó de árvore no código com base em determinados critérios. Ao chamar esse método depois de selecionar o nó, o usuário poderá ver e interagir com o nó selecionado.

Observação

Se a TreeView.ItemHeight propriedade for definida como um valor maior que a altura do controle de exibição de árvore, chamar esse método terá resultados inesperados.

Confira também

• IsVisible
• PrevVisibleNode
• NextVisibleNode