TreeNode.EnsureVisible Methode

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Stellt sicher, dass der Strukturknoten sichtbar ist, wobei ggf. Strukturknoten erweitert werden und bei Bedarf im Strukturansicht-Steuerelement ein Bildlauf durchgeführt wird.

public:
 void EnsureVisible();

public void EnsureVisible ();

member this.EnsureVisible : unit -> unit

Public Sub EnsureVisible ()

Beispiele

Im folgenden Codebeispiel wird der letzte untergeordnete Baumknoten des letzten Stammstrukturknotens in der Strukturansicht angezeigt, wenn auf eine Schaltfläche geklickt wird. In diesem Beispiel ist erforderlich, dass Sie über ein Steuerelement verfügenForm, das eine TreeView Auflistung von TreeNode Objekten und eine Button. Es sollte genügend Strukturknoten vorhanden sein, damit sie nicht alle im Strukturansichtssteuerelement sichtbar sind.

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 Methode aufgerufen wird, wird die EnsureVisible Struktur erweitert und scrollt, um sicherzustellen, dass der aktuelle Strukturknoten im Bereich TreeViewangezeigt wird. Diese Methode ist nützlich, wenn Sie einen Strukturknoten im Code basierend auf bestimmten Kriterien auswählen. Wenn Sie diese Methode aufrufen, nachdem Sie den Knoten ausgewählt haben, kann der Benutzer mit dem ausgewählten Knoten anzeigen und interagieren.

Hinweis

Wenn die TreeView.ItemHeight Eigenschaft auf einen Wert festgelegt ist, der größer als die Höhe des Strukturansichtssteuerelements ist, hat das Aufrufen dieser Methode unerwartete Ergebnisse.

Siehe auch

• IsVisible
• PrevVisibleNode
• NextVisibleNode