TreeViewEventArgs Klasse

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Stellt Daten für das AfterCheck-Ereignis, das AfterCollapse-Ereignis, das AfterExpand-Ereignis oder das AfterSelect-Ereignis eines TreeView-Steuerelements bereit.

public ref class TreeViewEventArgs : EventArgs

public class TreeViewEventArgs : EventArgs

type TreeViewEventArgs = class
    inherit EventArgs

Public Class TreeViewEventArgs
Inherits EventArgs

Vererbung

Object

EventArgs

TreeViewEventArgs

Beispiele

Das folgende Beispiel veranschaulicht eine angepasste TreeView. Durch das Erben der TreeView -Klasse verfügt diese benutzerdefinierte Version über die gesamte Funktionalität eines normalen TreeView. Das Ändern verschiedener Eigenschaftswerte im Konstruktor sorgt für eine eindeutige Darstellung. Da die ShowPlusMinus Eigenschaft auf false festgelegt ist, überschreibt das angepasste Steuerelement auch die OnAfterSelect -Methode, sodass Knoten erweitert und reduziert werden können, wenn sie geklickt werden.

Ein auf diese Weise angepasstes Steuerelement kann in einem organization verwendet werden, sodass eine konsistente Schnittstelle problemlos bereitgestellt werden kann, ohne dass die Steuerelementeigenschaften in jedem einzelnen Projekt angegeben werden müssen.

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.

Konstruktoren

TreeViewEventArgs(TreeNode)	Initialisiert eine neue Instanz der TreeViewEventArgs-Klasse für den angegebenen Strukturknoten.
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.

Eigenschaften

Action	Ruft den Typ der Aktion ab, der das Ereignis ausgelöst hat.
Node	Ruft den Strukturknoten ab, der aktiviert, erweitert, reduziert oder ausgewählt wurde.

Methoden

Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Weitere Informationen

• TreeViewCancelEventArgs