TreeNode.EnsureVisible Metoda

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Windows.Forms
Zestaw:
System.Windows.Forms.dll

Gwarantuje, że węzeł drzewa jest widoczny, rozwija węzły drzewa i w razie potrzeby przewija kontrolkę widoku drzewa.

public:
 void EnsureVisible();
public void EnsureVisible ();
member this.EnsureVisible : unit -> unit
Public Sub EnsureVisible ()

Przykłady

Poniższy przykład kodu powoduje przejście ostatniego węzła drzewa podrzędnego ostatniego węzła drzewa głównego do widoku drzewa po kliknięciu przycisku. W tym przykładzie jest wymagana kontrolka TreeView obiektu Form , która zawiera kolekcję TreeNode obiektów i Button. Powinno istnieć wystarczająco dużo węzłów drzewa, aby nie wszystkie były widoczne w kontrolce widoku drzewa.

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

Uwagi

Po wywołaniu EnsureVisible metody drzewo jest rozwijane i przewijane, aby upewnić się, że bieżący węzeł drzewa jest widoczny w elemencie TreeView. Ta metoda jest przydatna, jeśli wybierasz węzeł drzewa w kodzie na podstawie określonych kryteriów. Wywołując tę metodę po wybraniu węzła, użytkownik może zobaczyć wybrany węzeł i wchodzić z nim w interakcje.

Uwaga

TreeView.ItemHeight Jeśli właściwość jest ustawiona na wartość większą niż wysokość kontrolki widoku drzewa, wywołanie tej metody ma nieoczekiwane wyniki.

Dotyczy

Zobacz też