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.
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
Dependency property |
List |
treeGrid.LevelStyles | </tr>
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 |
|