TreeNode.EnsureVisible-Methode

Artikel
08/20/2007

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

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

Syntax

'Declaration
Public Sub EnsureVisible
'Usage
Dim instance As TreeNode

instance.EnsureVisible

public void EnsureVisible ()

public:
void EnsureVisible ()

public void EnsureVisible ()

public function EnsureVisible ()

Hinweise

Beim Aufruf der EnsureVisible-Methode wird die Struktur erweitert und durchlaufen. Dadurch wird sichergestellt, dass der aktuelle Strukturknoten in der TreeView sichtbar ist. Diese Methode empfiehlt sich, wenn Sie Code schreiben, in dem die Auswahl eines Strukturknotens auf der Grundlage bestimmter Kriterien erfolgen soll. Wenn nach der Auswahl des Knotens diese Methode aufgerufen wird, ist sichergestellt, dass der Benutzer den ausgewählten Knoten sehen und bearbeiten kann.

Hinweis

Wenn die TreeView.ItemHeight-Eigenschaft auf einen größeren Wert als die Höhe des Strukturansicht-Steuerelements festgelegt ist, führt der Aufruf dieser Methode zu unerwarteten Ergebnissen.

Beispiel

Im folgenden Codebeispiel wird beim Klicken auf eine Schaltfläche der letzte untergeordnete Strukturknoten des letzten Stammstrukturknotens angezeigt. Für dieses Beispiel ist es erforderlich, dass ein TreeView-Steuerelement in einem Form mit einer Auflistung von TreeNode-Objekten und ein Button vorhanden sind. Es müssen so viele Strukturknoten vorhanden sein, dass nicht alle im Strukturansichtsteuerelement angezeigt werden können.

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

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.");
   }
}

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.get_Nodes().get_Item(
        (treeView1.get_Nodes().get_Count() - 1)).get_Nodes().
        get_Item((treeView1.get_Nodes().get_Item(treeView1.get_Nodes().
        get_Count() - 1).get_Nodes().get_Count() - 1));

    if (!(lastNode.get_IsVisible())) {
        lastNode.EnsureVisible();
        MessageBox.Show(lastNode.get_Text() + " tree node is visible.");
    }
} //button3_Click

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0

Siehe auch

Referenz

TreeNode-Klasse
TreeNode-Member
System.Windows.Forms-Namespace
IsVisible
PrevVisibleNode
NextVisibleNode

Freigeben über