TreeView.ShowPlusMinus Eigenschaft

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Ruft einen Wert ab, der angibt, ob neben den Strukturknoten mit untergeordneten Strukturknoten Schaltflächen mit Pluszeichen (+) und Minuszeichen (-) angezeigt werden, oder legt diesen fest.

public:
 property bool ShowPlusMinus { bool get(); void set(bool value); };

public bool ShowPlusMinus { get; set; }

member this.ShowPlusMinus : bool with get, set

Public Property ShowPlusMinus As Boolean

Eigenschaftswert

Boolean

true, wenn neben den Strukturknoten mit untergeordneten Strukturknoten Schaltflächen mit Pluszeichen (+) und Minuszeichen (-) angezeigt werden, andernfalls false. Der Standardwert ist true.

Beispiele

Das folgende Codebeispiel veranschaulicht eine angepasste TreeView. Durch das Erben der TreeView -Klasse verfügt diese benutzerdefinierte Version über die gesamte Funktionalität eines typischen 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 Steuerelement, das auf diese Weise angepasst wird, kann in einer gesamten Organisation verwendet werden, sodass es einfach ist, eine konsistente Schnittstelle bereitzustellen, 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

Die Schaltflächen Pluszeichen und Minuszeichen werden neben den Stammstrukturknoten nur angezeigt, wenn der ShowRootLines Eigenschaftswert ist true. Wenn die Schaltflächen Plus- und Minuszeichen nicht angezeigt werden, ist kein visueller Hinweis vorhanden, der darauf hinweist, dass der Strukturknoten untergeordnete Strukturknoten enthält und erweiterbar ist. Der Benutzer muss dann auf einen Strukturknoten doppelklicken, um zu bestimmen, ob er untergeordnete Strukturknoten enthält, um ihn zu erweitern oder zu reduzieren.

Weitere Informationen

• ShowRootLines