TreeView.Indent Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Obtient ou définit la distance du retrait à appliquer à chaque niveau de nœud d’arborescence enfant.
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
Valeur de propriété
Distance, en pixels, du retrait à appliquer à chaque niveau de nœud d’arborescence enfant. La valeur par défaut est 19.
Exceptions
La valeur assignée est inférieure à 0.
- ou -
La valeur assignée est supérieure à 32 000.
Exemples
L’exemple de code suivant illustre un .TreeView En hériter de la TreeView classe, cette version personnalisée possède toutes les fonctionnalités d’un .TreeView La modification de différentes valeurs de propriété dans le constructeur fournit une apparence unique. Étant donné que la ShowPlusMinus propriété a la valeur false, le contrôle personnalisé remplace également la OnAfterSelect méthode afin que les nœuds puissent être développés et réduits lorsqu’ils sont cliqués.
Un contrôle personnalisé de cette façon peut être utilisé au sein d’une organisation, ce qui facilite la fourniture d’une interface cohérente sans exiger que les propriétés de contrôle soient spécifiées dans chaque projet individuel.
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
Remarques
La définition de cette propriété à la valeur -1 ne lève pas d’exception si la valeur par défaut n’a pas encore été modifiée. En effet, le contrôle utilise une valeur de -1 comme valeur par défaut interne avant la création du handle de contrôle. Cette valeur par défaut interne fait que le contrôle encapsulé retourne sa propre valeur par défaut de 19.