GridTree Control Properties in WPF GridTreeControl (Classic)

4 May 20213 minutes to read

The GridTree control has the following properties that allow you to control much of the behavior available within the control. Here is a list of these properties along with some discussion of each.

</tr> </table>
GridTree control Property Description Type of Property Value It Accepts Property Syntax
AllowAutoSizingNodeColumn Controls whether the width of the ExpandCell is automatically adjusted as more levels are exposed. This property setting is ignored if PercentageSizing is enabled and you have the ExpandCell column marked to participate in the percentage sizing calculations. DependencyProperty bool treeGrid.AllowAutoSizingNodeColumn
AllowDragColumns Controls whether your user can rearrange the columns by moving the mouse down on the header cell and drag it to another location in the control. Dependency property bool treeGrid.AllowDragColumns
AllowSort Controls whether your user can sort columns by clicking the column header. When enabled, holding down the Ctrl key and clicking the columns will allow sorting on multiple columns. All sorting is done within the child lists. Dependency property bool treeGrid.AllowSort
ColumnHeaderStyle A GridStyleInfo object that controls the appearance of the column headers. Dependency property GridStyleInfo treeGrid.ColumnHeaderStyle = new GridStyleInfo() { };
DefaultColumnWidth Provides the default settings for the column width used in the GridTree control. Dependency property Double treeGrid.DefaultColumnWidth
EnableHotRowMarker Controls whether the row under the mouse is overdrawn with a special background brush so that the user can easily see the row under the mouse. The brush can be specified using the GridTreeControl.InternalGrid.markRowBrush property. Dependency property bool treeGrid. EnableHotRowMarker
EnableSelections Controls whether selections are supported. The GridTree control support two types of selections, node selections and cell selections. Use the EnableNodeSelection property to determine which selection type is active. Dependency property bool treeGrid.EnableSelections
EnableNodeSelection Controls whether all the rows will be selected when a single row is clicked. When enabled, you can select multiple rows by holding the Shift key and dragging the mouse. When not enabled, the cell ranges will be selected. Dependency property bool treeGrid.EnableNodeSelection
HideEmptyChildGlyphs Controls whether you can possibly see the expand glyph on a node with no children. The default value is true that indicates glyphs on empty nodes will be hidden when initially displayed. In order to support this behavior, the GridTree control must request the child nodes at the time the parent node is expanded (instead of at the time the child node is clicked to be expanded). Dependency property bool treeGrid.HideEmptyChildGlyphs
InternalGrid Gets a reference to the GridControlImpl object associated with this GridTree control. This property will be null until the ModelLoaded event is raised by the GridTree control. ModeLoaded event is triggered once the grid model is loaded. Normal GridTreeControl treeGrid.InternalGrid
LevelStyles A List object that holds GridStyleInfo objects that will control the look of cells for a given tree level. The 0th GridStyleInfo will be applied to all root node rows, the 1st GridStyleInfo will be applied to level 1 rows, etc. </td> Dependency property List</td> treeGrid.LevelStyles
Model Gives access to the GridTreeModel object associated with this GridTree control. The Model.Options property gives access to the properties that control the behavior of the InternalGrid object associated with this GridTree control. Normal GridTreeModel treeGrid.Model
ReadOnly Determines whether the cells in the GridTree control can be edited. This is a GridTree control-wide setting. You can use the LevelStyles[].StyleInfo.ReadOnly to edit the particular levels. Additionally, you can use Columns[].StyleInfo.ReadOnly to control the edit operation, column-by-column. Finally, you can use the Model.QueryCellInfo event to set ReadOnly properties cell-by-cell in an on-demand manner. Dependency property bool treeGrid.ReadOnly
RowHeaderWidth Specifies the width of the row header column if it is visible. To control the visibility, use the ShowRowHeader property. Dependency property Double treeGrid.RowHeaderWidth
SelectedNodes A collection of nodes selected in the GridTree control. The items in the collection are GridTreeNode objects. Normal GridSelectedTreeNodes treeGrid.SelectedNodes
ShowColumnHeaders Determines whether the column header row is visible. Dependency property bool treeGrid.ShowColumnHeaders
ShowExpandColumnBorders Determines whether the GridTree control display cell borders for the Expand column. Dependency property bool treeGrid.ShowExpandColumnBorders
ShowRowHeader Determines whether the row header column is visible. Dependency property bool treeGrid.ShowRowHeader
SupportRowSizing Determines whether the user can change the row heights using the mouse. Dependency property bool treeGrid.SupportRowSizing
SupportsVisualStyles Determines whether the GridTree control will use the VisualStyle property to control the appearance of the GridTree control. If this property is


, you can directly set the VisualStyle property for the grid. You also have the option of applying the changes through the SkinManager found in the Syncfusion.Shared.WPF library. The GridTree control is bound to the SkinManager values through its Template.
Dependency property bool treeGrid.SupportsVisualStyle
VisualStyle Determines the VisualStyle that is applied to the GridTree control when SupportsVisualStyles property is set to


Dependency property VisualStyle treeGrid.VisualStyle