TreeNode.EnsureVisible Methode

Definition

Stellt sicher, dass der Strukturknoten sichtbar ist, wobei ggf. Strukturknoten erweitert werden und bei Bedarf im Strukturansicht-Steuerelement ein Bildlauf durchgeführt wird.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 ()

Beispiele

Im folgenden Codebeispiel wird der letzte untergeordnete Struktur Knoten des letzten Stamm Struktur Knotens in der Strukturansicht angezeigt, wenn auf eine Schaltfläche geklickt wird.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. Für dieses Beispiel ist es erforderlich, TreeView dass Sie über Form ein-Steuerelement für TreeNode eine verfügen, die Buttoneine Auflistung von-Objekten enthält, und eineThis example requires that you have a TreeView control on a Form that contains a collection of TreeNode objects, and a Button. Es sollten genügend Struktur Knoten vorhanden sein, damit Sie nicht alle im Strukturansicht-Steuerelement sichtbar sind.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

Hinweise

Wenn die EnsureVisible -Methode aufgerufen wird, wird die Struktur erweitert und gescrollt, um sicherzustellen, dass der aktuelle Struktur TreeViewKnoten in der sichtbar ist.When the EnsureVisible method is called, the tree is expanded and scrolled to ensure that the current tree node is visible in the TreeView. Diese Methode ist nützlich, wenn Sie einen Struktur Knoten in Code basierend auf bestimmten Kriterien auswählen.This method is useful if you are selecting a tree node in code based on certain criteria. Wenn Sie diese Methode aufrufen, nachdem Sie den Knoten ausgewählt haben, kann der Benutzer den ausgewählten Knoten sehen und damit interagieren.By calling this method after you select the node, the user can see and interact with the selected node.

Hinweis

Wenn die TreeView.ItemHeight Eigenschaft auf einen Wert festgelegt ist, der größer ist als die Höhe des Strukturansicht-Steuer Elements, weist das Aufrufen dieser Methode unerwartete Ergebnisse auf.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.

Gilt für:

Siehe auch