TreeNode.EnsureVisible Метод

Определение

Пространство имен:

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

Гарантирует отображение узла дерева, развертывание узлов дерева и прокрутку элемента управления отображением дерева, если это необходимо.

public:
 void EnsureVisible();

public void EnsureVisible ();

member this.EnsureVisible : unit -> unit

Public Sub EnsureVisible ()

Примеры

В следующем примере кода последний дочерний узел последнего корневого узла дерева отображается в представлении дерева при нажатии кнопки. В этом примере требуется, TreeView чтобы у вас был элемент управления Form , содержащий коллекцию TreeNode объектов и объект Button. Должно быть достаточно узлов дерева, чтобы они не были видимы в элементе управления представлением дерева.

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

Комментарии

При вызове EnsureVisible метода дерево разворачивается и прокручивается, чтобы убедиться, что текущий узел дерева отображается в TreeView. Этот метод полезен при выборе узла дерева в коде на основе определенных критериев. Вызвав этот метод после выбора узла, пользователь сможет просматривать выбранный узел и взаимодействовать с ним.

Примечание

TreeView.ItemHeight Если свойству присвоено значение, превышающее высоту элемента управления представлением дерева, вызов этого метода имеет непредвиденные результаты.

См. также раздел

• IsVisible
• PrevVisibleNode
• NextVisibleNode