TreeView.Indent Proprietà

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Ottiene o imposta la distanza alla quale viene definito il rientro di ciascun livello di nodi figlio dell'albero.

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

Valore della proprietà

Int32

Distanza, in pixel, alla quale viene definito il rientro di ciascun livello di nodi figlio dell'albero. Il valore predefinito è 19.

Eccezioni

ArgumentOutOfRangeException

Il valore assegnato è minore di 0.

-oppure-

Il valore assegnato è maggiore di 32.000.

Esempio

Nell'esempio di codice seguente viene illustrato un oggetto TreeViewpersonalizzato. Ereditando la TreeView classe, questa versione personalizzata ha tutte le funzionalità di un tipico TreeViewoggetto . La modifica di vari valori di proprietà nel costruttore fornisce un aspetto univoco. Poiché la proprietà è impostata su false, il controllo personalizzato esegue anche l'override ShowPlusMinus del OnAfterSelect metodo in modo che i nodi possano essere espansi e compressi quando vengono selezionati.

Un controllo personalizzato in questo modo può essere usato in tutta un'organizzazione, semplificando l'uso di un'interfaccia coerente senza richiedere l'specifica delle proprietà del controllo in ogni singolo progetto.

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

Commenti

L'impostazione di questa proprietà su un valore di -1 non genera un'eccezione se il valore non è ancora stato modificato dal valore predefinito. Questo perché il controllo usa un valore pari a -1 come impostazione predefinita interna prima della creazione dell'handle di controllo. Questo valore predefinito interno causa la restituzione del valore predefinito 19 del controllo wrapped.