TreeViewEventArgs Класс

Определение

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

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

Предоставляет данные для событий AfterCheck, AfterCollapse, AfterExpand или AfterSelect элемента управления TreeView.

public ref class TreeViewEventArgs : EventArgs

public class TreeViewEventArgs : EventArgs

type TreeViewEventArgs = class
    inherit EventArgs

Public Class TreeViewEventArgs
Inherits EventArgs

Наследование

Object

EventArgs

TreeViewEventArgs

Примеры

В следующем примере показан настроенный TreeViewобъект . Наследуя TreeView класс, эта пользовательская версия имеет все функциональные возможности обычного TreeView. Изменение различных значений свойств в конструкторе обеспечивает уникальный внешний вид. Так как свойству ShowPlusMinus присвоено значение false, настраиваемый элемент управления также переопределяет OnAfterSelect метод , чтобы узлы можно было развернуть и свернуть при щелчке.

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

public ref class CustomizedTreeView: public TreeView
{
public:
   CustomizedTreeView()
   {

      // Customize the TreeView control by setting various properties.
      BackColor = System::Drawing::Color::CadetBlue;
      FullRowSelect = true;
      HotTracking = true;
      Indent = 34;
      ShowPlusMinus = false;

      // The ShowLines property must be false for the FullRowSelect
      // property to work.
      ShowLines = false;
   }

protected:
   virtual void OnAfterSelect( TreeViewEventArgs^ e ) override
   {
      // Confirm that the user initiated the selection.
      // This prevents the first node from expanding when it is
      // automatically selected during the initialization of
      // the TreeView control.
      if ( e->Action != TreeViewAction::Unknown )
      {
         if ( e->Node->IsExpanded )
         {
            e->Node->Collapse();
         }
         else
         {
            e->Node->Expand();
         }
      }

      
      // Remove the selection. This allows the same node to be
      // clicked twice in succession to toggle the expansion state.
      SelectedNode = nullptr;
   }
};

public class CustomizedTreeView : TreeView
{
    public CustomizedTreeView()
    {
        // Customize the TreeView control by setting various properties.
        BackColor = System.Drawing.Color.CadetBlue;
        FullRowSelect = true;
        HotTracking = true;
        Indent = 34;
        ShowPlusMinus = false;

        // The ShowLines property must be false for the FullRowSelect 
        // property to work.
        ShowLines = false;
    }

    protected override void OnAfterSelect(TreeViewEventArgs e)
    {
        // Confirm that the user initiated the selection.
        // This prevents the first node from expanding when it is
        // automatically selected during the initialization of 
        // the TreeView control.
        if (e.Action != TreeViewAction.Unknown)
        {
            if (e.Node.IsExpanded) 
            {
                e.Node.Collapse();
            }
            else 
            {
                e.Node.Expand();
            }
        }

        // Remove the selection. This allows the same node to be
        // clicked twice in succession to toggle the expansion state.
        SelectedNode = null;
    }
}

Public Class CustomizedTreeView
    Inherits TreeView

    Public Sub New()
        ' Customize the TreeView control by setting various properties.
        BackColor = System.Drawing.Color.CadetBlue
        FullRowSelect = True
        HotTracking = True
        Indent = 34
        ShowPlusMinus = False

        ' The ShowLines property must be false for the FullRowSelect 
        ' property to work.
        ShowLines = False
    End Sub


    Protected Overrides Sub OnAfterSelect(ByVal e As TreeViewEventArgs)
        ' Confirm that the user initiated the selection.
        ' This prevents the first node from expanding when it is
        ' automatically selected during the initialization of 
        ' the TreeView control.
        If e.Action <> TreeViewAction.Unknown Then
            If e.Node.IsExpanded Then
                e.Node.Collapse()
            Else
                e.Node.Expand()
            End If
        End If

        ' Remove the selection. This allows the same node to be
        ' clicked twice in succession to toggle the expansion state.
        SelectedNode = Nothing
    End Sub

End Class

Комментарии

Дополнительные сведения об обработке событий см. в разделе Обработка и вызов событий.

Конструкторы

TreeViewEventArgs(TreeNode)	Инициализирует новый экземпляр класса TreeViewEventArgs для указанного узла дерева.
TreeViewEventArgs(TreeNode, TreeViewAction)	Инициализирует новый экземпляр класса TreeViewEventArgs для указанного узла дерева с заданным типом действия, которое вызвало событие.

Свойства

Action	Возвращает тип действия, которое вызвало событие.
Node	Возвращает узел дерева, который выделен, развернут, свернут или выбран.

Методы

Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetType()	Возвращает объект Type для текущего экземпляра. (Унаследовано от Object)
MemberwiseClone()	Создает неполную копию текущего объекта Object. (Унаследовано от Object)
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)

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

• TreeViewCancelEventArgs