TreeViewEventArgs Classe

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Fornece dados para os eventos AfterCheck, AfterCollapse, AfterExpand ou AfterSelect de um controle TreeView.

public ref class TreeViewEventArgs : EventArgs

public class TreeViewEventArgs : EventArgs

type TreeViewEventArgs = class
    inherit EventArgs

Public Class TreeViewEventArgs
Inherits EventArgs

Herança

Object

EventArgs

TreeViewEventArgs

Exemplos

O exemplo a seguir ilustra um personalizado TreeView. Ao herdar a TreeView classe , essa versão personalizada tem toda a funcionalidade de um normal TreeView. Alterar vários valores de propriedade no construtor fornece uma aparência exclusiva. Como a ShowPlusMinus propriedade é definida como false, o controle personalizado também substitui o método para que os OnAfterSelect nós possam ser expandidos e recolhidos quando são clicados.

Um controle personalizado dessa maneira pode ser usado em toda a organização, facilitando o provisionamento de uma interface consistente sem exigir que as propriedades de controle sejam especificadas em cada projeto individual.

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

Comentários

Para obter mais informações sobre como lidar com eventos, consulte Manipulando e gerando eventos.

Construtores

TreeViewEventArgs(TreeNode)	Inicializa uma nova instância da classe TreeViewEventArgs para o nó de árvore especificado.
TreeViewEventArgs(TreeNode, TreeViewAction)	Inicializa uma nova instância da classe TreeViewEventArgs para o nó de árvore especificado e com o tipo especificado de ação que acionou o evento.

Propriedades

Action	Obtém o tipo de ação que gerou o evento.
Node	Obtém o nó de árvore que foi marcado, expandido, recolhido ou selecionado.

Métodos

Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)

Confira também

• TreeViewCancelEventArgs