TreeNode.EnsureVisible Méthode

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Garantit que le nœud d'arbre est visible, en développant les nœuds d'arbre et en faisant défiler le contrôle TreeView.

public:
 void EnsureVisible();

public void EnsureVisible ();

member this.EnsureVisible : unit -> unit

Public Sub EnsureVisible ()

Exemples

L’exemple de code suivant montre comment afficher le dernier nœud d’arbre enfant du dernier nœud d’arborescence racine dans l’arborescence lorsqu’un bouton est cliqué. Cet exemple nécessite que vous ayez un TreeView contrôle sur un Form qui contient une collection d’objets TreeNode et un Button. Il doit y avoir suffisamment de nœuds d’arborescence pour qu’ils ne soient pas tous visibles dans le contrôle d’arborescence.

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

Remarques

Lorsque la EnsureVisible méthode est appelée, l’arborescence est développée et défile pour s’assurer que le nœud d’arborescence actuel est visible dans le TreeView. Cette méthode est utile si vous sélectionnez un nœud d’arbre dans le code en fonction de certains critères. En appelant cette méthode après avoir sélectionné le nœud, l’utilisateur peut voir et interagir avec le nœud sélectionné.

Notes

Si la TreeView.ItemHeight propriété est définie sur une valeur supérieure à la hauteur du contrôle d’arborescence, l’appel de cette méthode a des résultats inattendus.

Voir aussi

• IsVisible
• PrevVisibleNode
• NextVisibleNode