TreeNode.EnsureVisible Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
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.