TreeView.Indent Eigenschaft

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Ruft den Abstand für das Einrücken der einzelnen Ebenen von untergeordneten Strukturknoten ab oder legt diesen fest.

public:
 property int Indent { int get(); void set(int value); };

public int Indent { get; set; }

member this.Indent : int with get, set

Public Property Indent As Integer

Eigenschaftswert

Int32

Der Abstand für das Einrücken der einzelnen Ebenen von untergeordneten Strukturknoten (in Pixel). Der Standardwert ist 19.

Ausnahmen

ArgumentOutOfRangeException

Der zugewiesene Wert ist kleiner als 0.

- oder -

Der zugewiesene Wert ist größer als 32.000.

Beispiele

Das folgende Codebeispiel veranschaulicht eine angepasste TreeView. Durch das Erben der TreeView Klasse verfügt diese benutzerdefinierte Version über alle Funktionen einer typischen TreeView. Das Ändern verschiedener Eigenschaftenwerte im Konstruktor bietet eine eindeutige Darstellung. Da die Eigenschaft auf "false" festgelegt ist, überschreibt das ShowPlusMinus angepasste Steuerelement auch die OnAfterSelect Methode, sodass Knoten erweitert und reduziert werden können, wenn sie geklickt werden.

Ein Steuerelement, das in dieser Weise angepasst wird, kann in einer organisation verwendet werden, wodurch 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

Wenn diese Eigenschaft auf einen Wert von -1 festgelegt wird, wird keine Ausnahme ausgelöst, wenn der Wert noch nicht von seinem Standard geändert wurde. Dies liegt daran, dass das Steuerelement einen Wert von -1 als interner Standard verwendet, bevor der Steuerelementhandpunkt erstellt wurde. Dieser interne Standardwert bewirkt, dass das umgebrochene Steuerelement seinen eigenen Standardwert von 19 zurückgibt.