GridTree Control Properties in WPF GridTreeControl (Classic)

23 Oct 2019 / 3 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 true , 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 true .	Dependency property	VisualStyle	treeGrid.VisualStyle