TreeView.Indent Vlastnost

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Zdroj:

TreeView.cs

Získá nebo nastaví vzdálenost odsazení každé úrovně podřízeného stromu uzlu.

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

Hodnota vlastnosti

Int32

Vzdálenost v pixelech k odsazení úrovně jednotlivých podřízených uzlů stromu. Výchozí hodnota je 19.

Výjimky

ArgumentOutOfRangeException

Přiřazená hodnota je menší než 0.

nebo

Přiřazená hodnota je větší než 32 000.

Příklady

Následující příklad kódu znázorňuje přizpůsobenou TreeView. Děděním TreeView třídy má tato vlastní verze všechny funkce typické TreeView. Změna různých hodnot vlastností v konstruktoru poskytuje jedinečný vzhled. Vzhledem k tomu, že ShowPlusMinus vlastnost je nastavena na false, přizpůsobený ovládací prvek také přepíše metodu OnAfterSelect tak, aby uzly bylo možné rozbalit a sbalit při kliknutí.

Ovládací prvek, který je tímto způsobem přizpůsobený, lze použít v celé organizaci, což usnadňuje poskytování konzistentního rozhraní bez nutnosti zadat vlastnosti ovládacího prvku v každém jednotlivém projektu.

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

Poznámky

Nastavení této vlastnosti na hodnotu -1 nevyvolá výjimku, pokud se hodnota ještě nezměnila z výchozí hodnoty. Důvodem je to, že ovládací prvek používá hodnotu -1 jako interní výchozí před vytvořením popisovače ovládacího prvku. Tato interní výchozí hodnota způsobí, že zabalený ovládací prvek vrátí vlastní výchozí hodnotu 19.