TreeViewEventArgs Klasse

Definition

Stellt Daten für das AfterCheck-Ereignis, das AfterCollapse-Ereignis, das AfterExpand-Ereignis oder das AfterSelect-Ereignis eines TreeView-Steuerelements bereit.Provides data for the AfterCheck, AfterCollapse, AfterExpand, or AfterSelect events of a TreeView control.

public ref class TreeViewEventArgs : EventArgs
public class TreeViewEventArgs : EventArgs
type TreeViewEventArgs = class
    inherit EventArgs
Public Class TreeViewEventArgs
Inherits EventArgs
Vererbung
TreeViewEventArgs

Beispiele

Im folgenden Beispiel wird eine angepasste TreeViewveranschaulicht.The following example illustrates a customized TreeView. Durch das Erben der TreeView -Klasse hat diese benutzerdefinierte Version alle Funktionen einer normalen. TreeViewBy inheriting the TreeView class, this custom version has all the functionality of a normal TreeView. Das Ändern verschiedener Eigenschaftswerte im Konstruktor bietet eine eindeutige Darstellung.Changing various property values in the constructor provides a unique appearance. Da die ShowPlusMinus -Eigenschaft auf false festgelegt ist, überschreibt das angepasste Steuer OnAfterSelect Element auch die-Methode, sodass Knoten erweitert und reduziert werden können, wenn auf Sie geklickt wird.Because the ShowPlusMinus property is set to false, the customized control also overrides the OnAfterSelect method so nodes can be expanded and collapsed when they are clicked.

Ein Steuerelement, das auf diese Weise angepasst wird, kann in einer Organisation verwendet werden, sodass es einfach ist, eine konsistente Schnittstelle bereitzustellen, ohne dass die Steuerelement Eigenschaften in den einzelnen Projekten angegeben werden müssen.A control that is customized in this way can be used throughout an organization, making it easy to provide a consistent interface without requiring the control properties to be specified in each individual project.

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

Hinweise

Weitere Informationen zur Behandlung von Ereignissen finden Sie unter behandeln und Auslösen von Ereignissen.For more information about handling events, see Handling and Raising Events.

Konstruktoren

TreeViewEventArgs(TreeNode)

Initialisiert eine neue Instanz der TreeViewEventArgs-Klasse für den angegebenen Strukturknoten.Initializes a new instance of the TreeViewEventArgs class for the specified tree node.

TreeViewEventArgs(TreeNode, TreeViewAction)

Initialisiert eine neue Instanz der TreeViewEventArgs-Klasse für den angegebenen Strukturknoten und mit dem angegebenen Aktionstyp, der das Ereignis ausgelöst hat.Initializes a new instance of the TreeViewEventArgs class for the specified tree node and with the specified type of action that raised the event.

Eigenschaften

Action

Ruft den Typ der Aktion ab, der das Ereignis ausgelöst hat.Gets the type of action that raised the event.

Node

Ruft den Strukturknoten ab, der aktiviert, erweitert, reduziert oder ausgewählt wurde.Gets the tree node that has been checked, expanded, collapsed, or selected.

Methoden

Equals(Object)

Ermittelt, ob das angegebene Objekt und das aktuelle Objekt gleich sind.Determines whether the specified object is equal to the current object.

(Geerbt von Object)
GetHashCode()

Dient als die Standard-HashfunktionServes as the default hash function.

(Geerbt von Object)
GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Geerbt von Object)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Geerbt von Object)
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Geerbt von Object)

Gilt für:

Siehe auch