Class
GridViewColumn

This is a dependency object used to store column's specific data.

Definition

Namespace:Telerik.Windows.Controls

Assembly:Telerik.Windows.Controls.GridView.dll

Syntax:

cs-api-definition
public class GridViewColumn : FrameworkContentElement, IFieldDescriptor, INotifyPropertyChanged

Inheritance: objectGridViewColumn

Derived Classes: GridViewBoundColumnBaseGridViewExpressionColumnGridViewPinRowColumnGridViewSelectColumnGridViewToggleRowDetailsColumn

Implements: IFieldDescriptorINotifyPropertyChanged

Constructors

GridViewColumn()

Declaration

cs-api-definition
public GridViewColumn()

Fields

BackgroundProperty

Identifies the Background dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty BackgroundProperty

Field Value

DependencyProperty

CellEditTemplateProperty

Identifies the CellEditTemplateProperty property.

Declaration

cs-api-definition
public static readonly DependencyProperty CellEditTemplateProperty

Field Value

DependencyProperty

CellEditTemplateSelectorProperty

Identifies the CellEditTemplateSelector dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty CellEditTemplateSelectorProperty

Field Value

DependencyProperty

CellStyleProperty

Identifies the CellStyle dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty CellStyleProperty

Field Value

DependencyProperty

CellStyleSelectorProperty

Identifies the CellStyleSelector dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty CellStyleSelectorProperty

Field Value

DependencyProperty

CellTemplateProperty

Identifies the CellTemplate property.

Declaration

cs-api-definition
public static readonly DependencyProperty CellTemplateProperty

Field Value

DependencyProperty

CellTemplateSelectorProperty

Identifies the CellTemplateSelector dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty CellTemplateSelectorProperty

Field Value

DependencyProperty

DisplayIndexProperty

Identifies the DisplayIndex dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty DisplayIndexProperty

Field Value

DependencyProperty

DistinctValuesDisplayModeProperty

Identifies the DistinctValuesDisplayMode dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty DistinctValuesDisplayModeProperty

Field Value

DependencyProperty

DistinctValuesSearchModeProperty

Identifies the DistinctValuesSearchMode dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty DistinctValuesSearchModeProperty

Field Value

DependencyProperty

EditTriggersProperty

Identifies the EditTriggers dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty EditTriggersProperty

Field Value

DependencyProperty

EnableDistinctValuesFilteringProperty

Identifies the EnableDistinctValuesFiltering dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty EnableDistinctValuesFilteringProperty

Field Value

DependencyProperty

FilterMemberTypeProperty

Identifies the FilterMemberType dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty FilterMemberTypeProperty

Field Value

DependencyProperty

FilteringControlStyleProperty

Identifies the FilteringControlStyle dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty FilteringControlStyleProperty

Field Value

DependencyProperty

FooterCellStyleProperty

Identifies the FooterCellStyle dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty FooterCellStyleProperty

Field Value

DependencyProperty

FooterProperty

Identifies the Footer dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty FooterProperty

Field Value

DependencyProperty

FooterTextAlignmentProperty

Gets or sets a value that indicates the horizontal alignment of header text content Affects all the header cell in the column.

Declaration

cs-api-definition
public static readonly DependencyProperty FooterTextAlignmentProperty

Field Value

DependencyProperty

GroupFooterCellStyleProperty

Identifies the GroupFooterCellStyle dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty GroupFooterCellStyleProperty

Field Value

DependencyProperty

GroupFooterCellStyleSelectorProperty

Identifies the GroupFooterCellStyleSelector dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty GroupFooterCellStyleSelectorProperty

Field Value

DependencyProperty

GroupFooterTemplateProperty

Identifies the GroupFooterTemplate property.

Declaration

cs-api-definition
public static readonly DependencyProperty GroupFooterTemplateProperty

Field Value

DependencyProperty

GroupFooterTemplateSelectorProperty

Identifies the GroupFooterTemplateSelector dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty GroupFooterTemplateSelectorProperty

Field Value

DependencyProperty

GroupHeaderTemplateProperty

Identifies the GroupFooterTemplateProperty property.

Declaration

cs-api-definition
public static readonly DependencyProperty GroupHeaderTemplateProperty

Field Value

DependencyProperty

GroupHeaderTemplateSelectorProperty

Identifies the GroupHeaderTemplateSelector dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty GroupHeaderTemplateSelectorProperty

Field Value

DependencyProperty

HeaderCellStyleProperty

Identifies the HeaderCellStyle dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty HeaderCellStyleProperty

Field Value

DependencyProperty

HeaderProperty

Identifies the Header dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty HeaderProperty

Field Value

DependencyProperty

HeaderTextAlignmentProperty

Gets or sets a value that indicates the horizontal alignment of header text content Affects all the header cell in the column.

Declaration

cs-api-definition
public static readonly DependencyProperty HeaderTextAlignmentProperty

Field Value

DependencyProperty

HeaderTextDecorationsProperty

Identifies the HeaderTextDecorations dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty HeaderTextDecorationsProperty

Field Value

DependencyProperty

HeaderTextTrimmingProperty

Identifies the HeaderTextTrimming property.

Declaration

cs-api-definition
public static readonly DependencyProperty HeaderTextTrimmingProperty

Field Value

DependencyProperty

The identifier for the HeaderTextTrimming property.

HeaderTextWrappingProperty

Identifies the HeaderTextWrapping property.

Declaration

cs-api-definition
public static readonly DependencyProperty HeaderTextWrappingProperty

Field Value

DependencyProperty

The identifier for the HeaderTextWrapping property.

IsCustomSortingEnabledProperty

Identifies the IsCustomSortingEnabled dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty IsCustomSortingEnabledProperty

Field Value

DependencyProperty

IsFilterableProperty

Identifies the IsFilterable dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty IsFilterableProperty

Field Value

DependencyProperty

IsFilteringDeferredProperty

Identifies the IsFilteringDeferred dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty IsFilteringDeferredProperty

Field Value

DependencyProperty

IsFrozenProperty

Identifies the IsFrozen readonly dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty IsFrozenProperty

Field Value

DependencyProperty

IsGroupableProperty

Identifies the IsGroupable dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty IsGroupableProperty

Field Value

DependencyProperty

IsReadOnlyProperty

Identifies the IsReadOnly dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty IsReadOnlyProperty

Field Value

DependencyProperty

IsReorderableProperty

Identifies the IsReorderable dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty IsReorderableProperty

Field Value

DependencyProperty

IsResizableProperty

Identifies the IsResizable dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty IsResizableProperty

Field Value

DependencyProperty

IsSelectedProperty

Identifies the IsSelected dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty IsSelectedProperty

Field Value

DependencyProperty

IsSortableProperty

Identifies the IsSortable dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty IsSortableProperty

Field Value

DependencyProperty

IsVisibleProperty

Identifies the IsVisible dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty IsVisibleProperty

Field Value

DependencyProperty

MaxWidthProperty

The DependencyProperty that represents the MaxWidth property.

Declaration

cs-api-definition
public static readonly DependencyProperty MaxWidthProperty

Field Value

DependencyProperty

MinWidthProperty

The DependencyProperty that represents the MinWidth property.

Declaration

cs-api-definition
public static readonly DependencyProperty MinWidthProperty

Field Value

DependencyProperty

OptimizeDistinctFilterQueryProperty

Identifies the OptimizeDistinctFilterQuery dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty OptimizeDistinctFilterQueryProperty

Field Value

DependencyProperty

ShouldGenerateFieldFilterEditorsProperty

Identifies the ShouldGenerateFieldFilterEditors dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty ShouldGenerateFieldFilterEditorsProperty

Field Value

DependencyProperty

ShowColumnWhenGroupedProperty

Identifies the ShowColumnWhenGrouped dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty ShowColumnWhenGroupedProperty

Field Value

DependencyProperty

ShowDistinctFiltersProperty

Identifies the ShowDistinctFilters dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty ShowDistinctFiltersProperty

Field Value

DependencyProperty

ShowFieldFiltersProperty

Identifies the ShowFieldFilters dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty ShowFieldFiltersProperty

Field Value

DependencyProperty

ShowFilterButtonProperty

Identifies the ShowFilterButton dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty ShowFilterButtonProperty

Field Value

DependencyProperty

ShowToolTipOnTrimmedTextProperty

Identifies the ShowToolTipOnTrimmedText dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty ShowToolTipOnTrimmedTextProperty

Field Value

DependencyProperty

SortingIndexProperty

Identifies the SortingIndex readonly dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty SortingIndexProperty

Field Value

DependencyProperty

SortingStateChangedEvent

Identifies the SortingStateChanged routed event.

Declaration

cs-api-definition
public static readonly RoutedEvent SortingStateChangedEvent

Field Value

RoutedEvent

SortingStateProperty

Identifies the SortingState dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty SortingStateProperty

Field Value

DependencyProperty

TabStopModeProperty

Identifies the TabStopMode dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty TabStopModeProperty

Field Value

DependencyProperty

TextAlignmentProperty

Gets or sets a value that indicates the horizontal alignment of text content Affects all the cells in the column.

Declaration

cs-api-definition
public static readonly DependencyProperty TextAlignmentProperty

Field Value

DependencyProperty

TextDecorationsProperty

Identifies the TextDecorations dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty TextDecorationsProperty

Field Value

DependencyProperty

TextTrimmingProperty

Identifies the TextTrimming property.

Declaration

cs-api-definition
public static readonly DependencyProperty TextTrimmingProperty

Field Value

DependencyProperty

The identifier for the TextTrimming property.

TextWrappingProperty

Identifies the TextWrapping property.

Declaration

cs-api-definition
public static readonly DependencyProperty TextWrappingProperty

Field Value

DependencyProperty

The identifier for the TextWrapping property.

ToolTipShowDurationProperty

Identifies the ToolTipShowDurationProperty property.

Declaration

cs-api-definition
public static readonly DependencyProperty ToolTipShowDurationProperty

Field Value

DependencyProperty

ToolTipTemplateProperty

Identifies the ToolTipTemplateProperty property.

Declaration

cs-api-definition
public static readonly DependencyProperty ToolTipTemplateProperty

Field Value

DependencyProperty

ToolTipTemplateSelectorProperty

Identifies the ToolTipTemplateSelector dependency property.

Declaration

cs-api-definition
public static readonly DependencyProperty ToolTipTemplateSelectorProperty

Field Value

DependencyProperty

WidthProperty

The DependencyProperty that represents the Width property.

Declaration

cs-api-definition
public static readonly DependencyProperty WidthProperty

Field Value

DependencyProperty

Properties

ActualWidth

Gets the current width of the column in pixels.

Declaration

cs-api-definition
public double ActualWidth { get; }

Property Value

double

The width of the column in pixels. Returns 0 if the column has not been added to a RadGridView.

AggregateFunctions

Gets an observable collection of the aggregate functions defined for the column.

Declaration

cs-api-definition
public AggregateFunctionCollection AggregateFunctions { get; }

Property Value

AggregateFunctionCollection

The aggregate functions.

Background

Gets or sets the color behind the content of the column.

Declaration

cs-api-definition
public Brush Background { get; set; }

Property Value

Brush

The column background.

CellEditTemplate

Gets or sets the data template for the cell in edit mode.

Declaration

cs-api-definition
public DataTemplate CellEditTemplate { get; set; }

Property Value

DataTemplate

Remarks

Please refer to CellEditTemplate for more information on the property.

CellEditTemplateSelector

Gets or sets the data template selector for the cell in edit mode.

Declaration

cs-api-definition
public DataTemplateSelector CellEditTemplateSelector { get; set; }

Property Value

DataTemplateSelector

CellStyle

Gets or sets the style to be applied for the cells in that column.

Declaration

cs-api-definition
public Style CellStyle { get; set; }

Property Value

Style

The cell style.

CellStyleSelector

Gets or sets the style selector for the cell.

Declaration

cs-api-definition
public StyleSelector CellStyleSelector { get; set; }

Property Value

StyleSelector

CellTemplate

Gets or sets the data template for the cell in view mode.

Declaration

cs-api-definition
public DataTemplate CellTemplate { get; set; }

Property Value

DataTemplate

Remarks

Please refer to CellTemplate for more information on the property.

CellTemplateSelector

Gets or sets the data template selector for the cell in view mode.

Declaration

cs-api-definition
public DataTemplateSelector CellTemplateSelector { get; set; }

Property Value

DataTemplateSelector

ColumnFilterDescriptor

Gets the column filter descriptor.

Declaration

cs-api-definition
public IColumnFilterDescriptor ColumnFilterDescriptor { get; }

Property Value

IColumnFilterDescriptor

The column filter descriptor.

ColumnGroupName

Gets or sets the name of the group this column belongs to.

Declaration

cs-api-definition
public string ColumnGroupName { get; set; }

Property Value

string

DataControl

Gets the owning grid.

Declaration

cs-api-definition
public GridViewDataControl DataControl { get; }

Property Value

GridViewDataControl

DisplayIndex

Gets or sets the display position of the column relative to the other columns in the RadGridView.

Declaration

cs-api-definition
public int DisplayIndex { get; set; }

Property Value

int

The zero-based position of the column as it is displayed in the associated RadGridView. The default is the index of the corresponding Item in the RadGridView.Columns collection.

DistinctValuesDisplayMode

Gets or sets the search mode for the distinct values. Setting this property is set to Tree makes the filtering deferred and disregards the value of the IsFilteringDeferred property.

Declaration

cs-api-definition
public DistinctValuesDisplayMode DistinctValuesDisplayMode { get; set; }

Property Value

DistinctValuesDisplayMode

DistinctValuesSearchMode

Gets or sets the search mode for the distinct values.

Declaration

cs-api-definition
public TextSearchMode DistinctValuesSearchMode { get; set; }

Property Value

TextSearchMode

EditTriggers

Gets or sets the edit triggers.

Declaration

cs-api-definition
public GridViewEditTriggers EditTriggers { get; set; }

Property Value

GridViewEditTriggers

The edit triggers.

EnableDistinctValuesFiltering

Gets or sets a value indicating whether this column will show the distinct values search text box.

Declaration

cs-api-definition
public bool EnableDistinctValuesFiltering { get; set; }

Property Value

bool

FilterMemberPath

Gets or sets a property name, or a period-delimited hierarchy of property names, that indicates the member to filter by.

Declaration

cs-api-definition
public string FilterMemberPath { get; set; }

Property Value

string

FilterMemberType

Gets or sets the filter member type of the column. Set this property when the type cannot be automatically discovered from the FilterMemberPath.

Declaration

cs-api-definition
public Type FilterMemberType { get; set; }

Property Value

Type

The filter member data type of the column.

FilteringControl

Gets or sets the control used for filtering.

Declaration

cs-api-definition
public IFilteringControl FilteringControl { get; set; }

Property Value

IFilteringControl

FilteringControlStyle

Gets or sets the style which will be applied on the filtering control.

Declaration

cs-api-definition
public Style FilteringControlStyle { get; set; }

Property Value

Style

The editor style.

FilteringDisplayFunc

Gets the filtering display function.

Declaration

cs-api-definition
protected virtual Func<object, object> FilteringDisplayFunc { get; }

Property Value

Func<object, object>

The filtering display function.

Remarks

This function is used by the filtering control distinct values list. It accepts a raw data value and returns what will become the content of the distinct value checkbox.

Gets or sets the object used for Column footer.

Declaration

cs-api-definition
public object Footer { get; set; }

Property Value

object

FooterCellStyle

Gets or sets the style to be applied for the footer cell in that column.

Declaration

cs-api-definition
public Style FooterCellStyle { get; set; }

Property Value

Style

The cell style.

FooterTextAlignment

Gets or sets the text alignment for GridViewColumn footer cell content.

Declaration

cs-api-definition
public TextAlignment FooterTextAlignment { get; set; }

Property Value

TextAlignment

The text alignment.

GroupFooterCellStyle

Gets or sets the style to be applied for the group footer cell in that column.

Declaration

cs-api-definition
public Style GroupFooterCellStyle { get; set; }

Property Value

Style

The cell style.

GroupFooterCellStyleSelector

Gets or sets the style selector for group footer cells.

Declaration

cs-api-definition
public StyleSelector GroupFooterCellStyleSelector { get; set; }

Property Value

StyleSelector

GroupFooterTemplate

Gets or sets the data template for the group footer cell.

Declaration

cs-api-definition
public DataTemplate GroupFooterTemplate { get; set; }

Property Value

DataTemplate

Remarks

Please refer to GroupFooterTemplate for more information on the property.

GroupFooterTemplateSelector

Gets or sets the data template selector for the group footer cell.

Declaration

cs-api-definition
public DataTemplateSelector GroupFooterTemplateSelector { get; set; }

Property Value

DataTemplateSelector

GroupHeaderFormatString

Gets or sets the header format string. Used with string.Format statement.

Declaration

cs-api-definition
public string GroupHeaderFormatString { get; set; }

Property Value

string

The header format string.

GroupHeaderTemplate

Gets or sets the template for the group header.

Declaration

cs-api-definition
public DataTemplate GroupHeaderTemplate { get; set; }

Property Value

DataTemplate

Remarks

Please refer to GroupHeaderTemplate for more information on the property.

GroupHeaderTemplateSelector

Gets or sets the data template selector for the group header cell.

Declaration

cs-api-definition
public DataTemplateSelector GroupHeaderTemplateSelector { get; set; }

Property Value

DataTemplateSelector

GroupMemberPath

Gets or sets a property name, or a period-delimited hierarchy of property names, that indicates the member to group by.

Declaration

cs-api-definition
public virtual string GroupMemberPath { get; set; }

Property Value

string

Header

Gets or sets the content of the column header.

Declaration

cs-api-definition
public virtual object Header { get; set; }

Property Value

object

Remarks

The ElementName binding does not work when used in column Header or CellTemplate. The problem comes from the fact that binding engine uses FindName method on FrameworkElement to find the target just once. So when element is loaded with LoadContent() – the element is not yet in the visual tree and FindName fails. As a solution, you can apply a Style to set the ContentTemplate.

HeaderCellStyle

Gets or sets the style to be applied for the header cell in that column.

Declaration

cs-api-definition
public Style HeaderCellStyle { get; set; }

Property Value

Style

The cell style.

HeaderTextAlignment

Gets or sets the text alignment for GridViewColumn header cell content.

Declaration

cs-api-definition
public TextAlignment HeaderTextAlignment { get; set; }

Property Value

TextAlignment

The text alignment.

HeaderTextDecorations

Gets or sets the text decoration. Affects the header cell of the column. This is a dependency property.

Declaration

cs-api-definition
public TextDecorationCollection HeaderTextDecorations { get; set; }

Property Value

TextDecorationCollection

HeaderTextTrimming

Gets or sets TextTrimming that will be used to trim the text in this column header cell. This is a dependency property.

Declaration

cs-api-definition
public TextTrimming HeaderTextTrimming { get; set; }

Property Value

TextTrimming

TextTrimming that will be used to trim the inner text in the header cell for this column. The default value is

HeaderTextWrapping

Gets or sets HeaderTextWrapping that will be used to wrap the text in this column header cell. This is a dependency property.

Declaration

cs-api-definition
public TextWrapping HeaderTextWrapping { get; set; }

Property Value

TextWrapping

HeaderTextWrapping that will be used to wrap the inner text in the header cell for this column. The default value is

IsAutoGenerated

Gets a value that indicates whether the column is auto-generated.

Declaration

cs-api-definition
public bool IsAutoGenerated { get; set; }

Property Value

bool

true if this instance is auto generated; otherwise, false.

IsCustomSortingEnabled

Gets or sets a value indicating whether custom sorting is enabled for this instance.

Declaration

cs-api-definition
public bool IsCustomSortingEnabled { get; set; }

Property Value

bool

true if custom sorting is enabled; otherwise, false.

IsFilterable

Gets or sets a value indicating whether this column can be filtered through the UI.

Declaration

cs-api-definition
public bool IsFilterable { get; set; }

Property Value

bool

true if the column can be filtered through the UI; otherwise, false.

IsFilteringDeferred

Gets or sets a value indicating whether this column will have deferred filtering when FilteringMode is Popup.

Declaration

cs-api-definition
public bool IsFilteringDeferred { get; set; }

Property Value

bool

Remarks

This property only makes sense and is used for the Popup FilteringMode of RadGridView.

IsFrozen

Gets a value that indicates whether the column is prevented from scrolling horizontally.

Declaration

cs-api-definition
public bool IsFrozen { get; }

Property Value

bool

true if this column is frozen column; otherwise, false.

IsGroupable

Gets or sets a value indicating whether this instance can be grouped.

Declaration

cs-api-definition
public bool IsGroupable { get; set; }

Property Value

bool

true if this instance can be grouped; otherwise, false.

IsLeftSideFrozen

Gets a value that indicates whether the column frozen to the left side.

Declaration

cs-api-definition
public bool IsLeftSideFrozen { get; }

Property Value

bool

IsReadOnly

Gets or sets a value indicating whether the cells in the column can be edited.

Declaration

cs-api-definition
public virtual bool IsReadOnly { get; set; }

Property Value

bool

true if the cells in the column can be edited; otherwise, false. this property overrides the value of the same RadGridView property.

Implements IFieldDescriptor.IsReadOnly

IsReorderable

Gets or sets a value that indicates whether the user can change the column display position by dragging the column header.

Declaration

cs-api-definition
public bool IsReorderable { get; set; }

Property Value

bool

true if this instance can be reordered; otherwise, false.

IsResizable

Gets or sets a value that indicates whether the user can adjust the column width using the mouse.

Declaration

cs-api-definition
public bool IsResizable { get; set; }

Property Value

bool

true if this instance is resizable; otherwise, false.

IsRightSideFrozen

Gets a value that indicates whether the column frozen to the right side.

Declaration

cs-api-definition
public bool IsRightSideFrozen { get; }

Property Value

bool

IsSelected

Gets or sets a value indicating whether this column is selected.

Declaration

cs-api-definition
public bool IsSelected { get; set; }

Property Value

bool

true if this column is selected; otherwise, false.

IsSortable

Gets or sets a value that indicates whether the user can sort the column by clicking the column header.

Declaration

cs-api-definition
public bool IsSortable { get; set; }

Property Value

bool

true if this instance is sortable; otherwise, false.

IsVisible

Gets or sets a value indicating whether this instance is visible.

Declaration

cs-api-definition
public bool IsVisible { get; set; }

Property Value

bool

true if this instance is visible; otherwise, false.

ItemType

Gets the type of the item that the field belongs to.

Declaration

cs-api-definition
public virtual Type ItemType { get; }

Property Value

Type

The type of the item.

MaxWidth

Gets or sets the maximum column width in pixels.

Declaration

cs-api-definition
public double MaxWidth { get; set; }

Property Value

double

The maximum column width in pixels. The default is PositiveInfinity.

MinWidth

Gets or sets the minimum column width in pixels.

Declaration

cs-api-definition
public double MinWidth { get; set; }

Property Value

double

The minimum column width in pixels, or 20 if the value is not set. The default is 20.

OptimizeDistinctFilterQuery

Gets or sets a value indicating whether to optimize distinct filter query.

Declaration

cs-api-definition
public bool OptimizeDistinctFilterQuery { get; set; }

Property Value

bool

A value indicating whether to optimize distinct filter query.

Remarks

By default, a condition of the form 'Member IsEqualTo Value' is generated for each distinct value selected and then all such conditions are combined with the OR operator. When the amount of distinct values checked grows, the query might become very slow. Setting OptimizeDistinctFilterQuery to true, will check the amount of distinct values checked. If this amount is less than or equal to half of all distinct values the original query will be generated. If, however, the amount of distinct values checked is more than half of all distinct values, an inverted statement like this be generated: (Member IsNotEqualTo uncheckedDistinctValue_0) ... AND ... (Member IsNotEqualTo uncheckedDistinctValue_N) If absolutely all distinct values are checked then no statement will be generated at all because this effectively means that there is no filter applied. Setting this property to true will try to generate the shortest possible LINQ Where clause.

ShouldGenerateFieldFilterEditors

Gets or sets a value indicating whether field filter editors should be generated.

Declaration

cs-api-definition
public bool? ShouldGenerateFieldFilterEditors { get; set; }

Property Value

bool?

ShowColumnWhenGrouped

Indicates whether the column should be visible when grid is grouped by this column.

Declaration

cs-api-definition
public bool ShowColumnWhenGrouped { get; set; }

Property Value

bool

ShowDistinctFilters

Gets or sets a value indicating whether this column will show distinct filters.

Declaration

cs-api-definition
public bool ShowDistinctFilters { get; set; }

Property Value

bool

ShowFieldFilters

Gets or sets a value indicating whether this column will show field filters.

Declaration

cs-api-definition
public bool ShowFieldFilters { get; set; }

Property Value

bool

ShowFilterButton

Gets or sets a value indicating whether this column will show the filter button.

Declaration

cs-api-definition
public bool ShowFilterButton { get; set; }

Property Value

bool

ShowToolTipOnTrimmedText

Gets or sets a value that indicates whether a ToolTip will be visualized if the text in the cells is trimmed.

Declaration

cs-api-definition
public bool? ShowToolTipOnTrimmedText { get; set; }

Property Value

bool?

true if a ToolTip will be visualized; otherwise, false. The registered default is false.

SortMemberPath

Gets or sets a property name, or a period-delimited hierarchy of property names, that indicates the member to sort by.

Declaration

cs-api-definition
public virtual string SortMemberPath { get; set; }

Property Value

string

SortingIndex

Gets the sorting index of the column when there is multiple column sorting.

Declaration

cs-api-definition
public int SortingIndex { get; }

Property Value

int

The sorting index of the column when there is multiple column sorting.

SortingState

Gets or sets a Column sorting state depending on executed sorted command, it can take 3 possible values: Ascending, Descending and None.

Declaration

cs-api-definition
public SortingState SortingState { get; set; }

Property Value

SortingState

TabStopMode

Gets or sets the tab stop mode which denotes if cell could gain focus via TAB key.

Declaration

cs-api-definition
public GridViewTabStop TabStopMode { get; set; }

Property Value

GridViewTabStop

The tab stop mode.

TargetFilters

Gets the FilterDescriptorCollection where this column will add its ColumnFilterDescriptor. By default these are the RadGridView.FilterDescriptors since the column is filtering RadGridView.

Declaration

cs-api-definition
protected virtual FilterDescriptorCollection TargetFilters { get; }

Property Value

FilterDescriptorCollection

The FilterDescriptorCollection where this column will add its ColumnFilterDescriptor.

TextAlignment

Gets or sets the text alignment for GridViewColumn cells content.

Declaration

cs-api-definition
public TextAlignment TextAlignment { get; set; }

Property Value

TextAlignment

The text alignment.

TextDecorations

Gets or sets the text decoration. Affects all the cells in the column. This is a dependency property.

Declaration

cs-api-definition
public TextDecorationCollection TextDecorations { get; set; }

Property Value

TextDecorationCollection

TextTrimming

Gets or sets TextTrimming that will be used to trim the text in this column cells. This is a dependency property.

Declaration

cs-api-definition
public TextTrimming TextTrimming { get; set; }

Property Value

TextTrimming

TextTrimming that will be used to trim the inner text in each cell for this column. The default value is

TextWrapping

Gets or sets TextWrapping that will be used to wrap the text in this column cells. This is a dependency property.

Declaration

cs-api-definition
public TextWrapping TextWrapping { get; set; }

Property Value

TextWrapping

TextWrapping that will be used to wrap the inner text in each cell for this column. The default value is

ToolTipShowDuration

Gets or sets the amount of time (in milliseconds) that a tooltip remains visible.

Declaration

cs-api-definition
public int ToolTipShowDuration { get; set; }

Property Value

int

Remarks

Please refer to ToolTipShowDuration for more information on the property.

ToolTipTemplate

Gets or sets the template for the cell tooltip.

Declaration

cs-api-definition
public DataTemplate ToolTipTemplate { get; set; }

Property Value

DataTemplate

Remarks

Please refer to ToolTipTemplate for more information on the property.

ToolTipTemplateSelector

Gets or sets the data template selector for the cell tooltip.

Declaration

cs-api-definition
public DataTemplateSelector ToolTipTemplateSelector { get; set; }

Property Value

DataTemplateSelector

UniqueName

Gets or sets the unique name of the Column used for identifier.

Declaration

cs-api-definition
public virtual string UniqueName { get; set; }

Property Value

string

The unique name.

Implements IFieldDescriptor.UniqueName

Width

Gets or sets the column width or an automatic sizing mode.

Declaration

cs-api-definition
public GridViewLength Width { get; set; }

Property Value

GridViewLength

A structure that represents the column width or an automatic sizing mode. The default is the RadGridView.ColumnWidth property value.

Remarks

This property overrides the RadGridView.ColumnWidth property.

Methods

CanEdit(object)

Determines whether the data represented by the column can be edited.

Declaration

cs-api-definition
public virtual bool CanEdit(object item)

Parameters

item

object

Returns

bool

true if the data represented by the column can be edited; otherwise, false.

CanFilter()

Determines whether the data represented by the column can be filtered by the RadGridView control.

Declaration

cs-api-definition
public virtual bool CanFilter()

Returns

bool

true if the data represented by the column can be filtered automatically; otherwise, false.

CanGroup()

Determines whether the data represented by the column can be grouped.

Declaration

cs-api-definition
public virtual bool CanGroup()

Returns

bool

true if the data represented by the column can be grouped; otherwise, false.

CanSort()

Determines whether the data represented by the column can be sorted.

Declaration

cs-api-definition
public virtual bool CanSort()

Returns

bool

true if the data represented by the column can be sorted; otherwise, false.

ClearFilters()

Clears all filtering associated with this column.

Declaration

cs-api-definition
public void ClearFilters()

CopyPropertiesFrom(GridViewColumn)

Copy properties from source column.

Declaration

cs-api-definition
public virtual void CopyPropertiesFrom(GridViewColumn source)

Parameters

source

GridViewColumn

CreateCellEditElement(GridViewCell, object)

Creates the element for the cell in edit mode.

Declaration

cs-api-definition
public virtual FrameworkElement CreateCellEditElement(GridViewCell cell, object dataItem)

Parameters

cell

GridViewCell

dataItem

object

Returns

FrameworkElement

CreateCellElement(GridViewCell, object)

Creates the element for the cell in view mode.

Declaration

cs-api-definition
public virtual FrameworkElement CreateCellElement(GridViewCell cell, object dataItem)

Parameters

cell

GridViewCell

dataItem

object

Returns

FrameworkElement

CreateColumnFilterDescriptor()

Creates the column filter descriptor.

Declaration

cs-api-definition
public virtual IColumnFilterDescriptor CreateColumnFilterDescriptor()

Returns

IColumnFilterDescriptor

CreateField()

Creates a field described by the descriptor.

Declaration

cs-api-definition
public virtual ContentControl CreateField()

Returns

ContentControl

Implements IFieldDescriptor.CreateField()

CreateFieldFilterEditor()

Creates the field filter editor.

Declaration

cs-api-definition
public virtual FrameworkElement CreateFieldFilterEditor()

Returns

FrameworkElement

GetAggregateResults(QueryableCollectionViewGroup)

Gets aggregates results for specified group.

Declaration

cs-api-definition
public IEnumerable<AggregateResult> GetAggregateResults(QueryableCollectionViewGroup group)

Parameters

group

QueryableCollectionViewGroup

Returns

IEnumerable<AggregateResult>

GetFilteringDisplayString(object)

Gets the filtering display string for a distinct value.

Declaration

cs-api-definition
public string GetFilteringDisplayString(object distinctValue)

Parameters

distinctValue

object

The distinctValue.

Returns

string

GetGridViewColumn(IFieldDescriptor)

Gets the GridViewColumn object.

Declaration

cs-api-definition
public static GridViewColumn GetGridViewColumn(IFieldDescriptor fieldDescriptor)

Parameters

fieldDescriptor

IFieldDescriptor

The field descriptor.

Returns

GridViewColumn

OnAggregateFunctionsCollectionChanged(NotifyCollectionChangedEventArgs)

Called when the aggregate functions collection has changed.

Declaration

cs-api-definition
protected virtual void OnAggregateFunctionsCollectionChanged(NotifyCollectionChangedEventArgs e)

Parameters

e

NotifyCollectionChangedEventArgs

The NotifyCollectionChangedEventArgs instance containing the event data.

OnAggregateFunctionsItemChanged(ItemChangedEventArgs<AggregateFunction>)

Called when an item in the aggregate functions collection is changed.

Declaration

cs-api-definition
protected virtual void OnAggregateFunctionsItemChanged(ItemChangedEventArgs<AggregateFunction> e)

Parameters

e

ItemChangedEventArgs<AggregateFunction>

The event arguments containing the event data.

OnCopyingCellClipboardContent(object)

This method is called for each selected cell to retrieve the default cell content.

Declaration

cs-api-definition
public virtual object OnCopyingCellClipboardContent(object item)

Parameters

item

object

The data context for the selected element.

Returns

object

An object that represents the content of the cell.

OnInitialized(EventArgs)

Declaration

cs-api-definition
protected override void OnInitialized(EventArgs e)

Parameters

e

EventArgs

OnPastingCellClipboardContent(object, object)

This method is called for each selected cell to replace the cell content with data from the clipboard.

Declaration

cs-api-definition
public virtual void OnPastingCellClipboardContent(object item, object value)

Parameters

item

object

The data context for the selected element.

value

object

The clipboard data for the selected cell.

OnPropertyChanged(PropertyChangedEventArgs)

Raises the PropertyChanged event.

Declaration

cs-api-definition
protected virtual void OnPropertyChanged(PropertyChangedEventArgs args)

Parameters

args

PropertyChangedEventArgs

The PropertyChangedEventArgs instance containing the event data.

OnPropertyChanged(string)

Raises the PropertyChanged event.

Declaration

cs-api-definition
protected void OnPropertyChanged(string propertyName)

Parameters

propertyName

string

PrepareCellForEdit(FrameworkElement, RoutedEventArgs)

Prepares GridViewCell for edit.

Declaration

cs-api-definition
protected virtual object PrepareCellForEdit(FrameworkElement editingElement, RoutedEventArgs editingEventArgs)

Parameters

editingElement

FrameworkElement

The editing element.

editingEventArgs

RoutedEventArgs

The RoutedEventArgs instance containing the event data.

Returns

object

Refresh()

Refresh this column cells.

Declaration

cs-api-definition
protected virtual void Refresh()

RefreshCellElement(FrameworkElement, DependencyProperty)

Called when cell element needs refresh.

Declaration

cs-api-definition
protected virtual void RefreshCellElement(FrameworkElement element, DependencyProperty dependencyProperty)

Parameters

element

FrameworkElement

dependencyProperty

DependencyProperty

SortDistinctValues(IQueryable)

Sorts the distinct values.

Declaration

cs-api-definition
protected virtual IQueryable SortDistinctValues(IQueryable source)

Parameters

source

IQueryable

The unsorted distinct values.

Returns

IQueryable

The sorted distinct values.

SortDistinctValuesByFilteringDisplay(IQueryable)

Sorts the distinct values according to their display value.

Declaration

cs-api-definition
protected virtual IQueryable SortDistinctValuesByFilteringDisplay(IQueryable source)

Parameters

source

IQueryable

The unsorted distinct values.

Returns

IQueryable

The distinct values sorted according to their display value.

Remarks

Use this method only if you have bound RadGridView to an in-memory collection, i.e. the source.Provider is EnumerableQuery. Other providers may not support this method and will throw an exception.

Events

PropertyChanged

Occurs when a property value changes.

Declaration

cs-api-definition
public event PropertyChangedEventHandler PropertyChanged

Event Value

PropertyChangedEventHandler

Implements INotifyPropertyChanged.PropertyChanged

SortingStateChanged

Occurs after when the sorting state of a column changes.

Declaration

cs-api-definition
public event EventHandler<RadRoutedPropertyChangedEventArgs<SortingState>> SortingStateChanged

Event Value

EventHandler<RadRoutedPropertyChangedEventArgs<SortingState>>

In this article
DefinitionConstructorsGridViewColumn()FieldsBackgroundPropertyCellEditTemplatePropertyCellEditTemplateSelectorPropertyCellStylePropertyCellStyleSelectorPropertyCellTemplatePropertyCellTemplateSelectorPropertyDisplayIndexPropertyDistinctValuesDisplayModePropertyDistinctValuesSearchModePropertyEditTriggersPropertyEnableDistinctValuesFilteringPropertyFilterMemberTypePropertyFilteringControlStylePropertyFooterCellStylePropertyFooterPropertyFooterTextAlignmentPropertyGroupFooterCellStylePropertyGroupFooterCellStyleSelectorPropertyGroupFooterTemplatePropertyGroupFooterTemplateSelectorPropertyGroupHeaderTemplatePropertyGroupHeaderTemplateSelectorPropertyHeaderCellStylePropertyHeaderPropertyHeaderTextAlignmentPropertyHeaderTextDecorationsPropertyHeaderTextTrimmingPropertyHeaderTextWrappingPropertyIsCustomSortingEnabledPropertyIsFilterablePropertyIsFilteringDeferredPropertyIsFrozenPropertyIsGroupablePropertyIsReadOnlyPropertyIsReorderablePropertyIsResizablePropertyIsSelectedPropertyIsSortablePropertyIsVisiblePropertyMaxWidthPropertyMinWidthPropertyOptimizeDistinctFilterQueryPropertyShouldGenerateFieldFilterEditorsPropertyShowColumnWhenGroupedPropertyShowDistinctFiltersPropertyShowFieldFiltersPropertyShowFilterButtonPropertyShowToolTipOnTrimmedTextPropertySortingIndexPropertySortingStateChangedEventSortingStatePropertyTabStopModePropertyTextAlignmentPropertyTextDecorationsPropertyTextTrimmingPropertyTextWrappingPropertyToolTipShowDurationPropertyToolTipTemplatePropertyToolTipTemplateSelectorPropertyWidthPropertyPropertiesActualWidthAggregateFunctionsBackgroundCellEditTemplateCellEditTemplateSelectorCellStyleCellStyleSelectorCellTemplateCellTemplateSelectorColumnFilterDescriptorColumnGroupNameDataControlDisplayIndexDistinctValuesDisplayModeDistinctValuesSearchModeEditTriggersEnableDistinctValuesFilteringFilterMemberPathFilterMemberTypeFilteringControlFilteringControlStyleFilteringDisplayFuncFooterFooterCellStyleFooterTextAlignmentGroupFooterCellStyleGroupFooterCellStyleSelectorGroupFooterTemplateGroupFooterTemplateSelectorGroupHeaderFormatStringGroupHeaderTemplateGroupHeaderTemplateSelectorGroupMemberPathHeaderHeaderCellStyleHeaderTextAlignmentHeaderTextDecorationsHeaderTextTrimmingHeaderTextWrappingIsAutoGeneratedIsCustomSortingEnabledIsFilterableIsFilteringDeferredIsFrozenIsGroupableIsLeftSideFrozenIsReadOnlyIsReorderableIsResizableIsRightSideFrozenIsSelectedIsSortableIsVisibleItemTypeMaxWidthMinWidthOptimizeDistinctFilterQueryShouldGenerateFieldFilterEditorsShowColumnWhenGroupedShowDistinctFiltersShowFieldFiltersShowFilterButtonShowToolTipOnTrimmedTextSortMemberPathSortingIndexSortingStateTabStopModeTargetFiltersTextAlignmentTextDecorationsTextTrimmingTextWrappingToolTipShowDurationToolTipTemplateToolTipTemplateSelectorUniqueNameWidthMethodsCanEdit(object)CanFilter()CanGroup()CanSort()ClearFilters()CopyPropertiesFrom(GridViewColumn)CreateCellEditElement(GridViewCell, object)CreateCellElement(GridViewCell, object)CreateColumnFilterDescriptor()CreateField()CreateFieldFilterEditor()GetAggregateResults(QueryableCollectionViewGroup)GetFilteringDisplayString(object)GetGridViewColumn(IFieldDescriptor)OnAggregateFunctionsCollectionChanged(NotifyCollectionChangedEventArgs)OnAggregateFunctionsItemChanged(ItemChangedEventArgs<AggregateFunction>)OnCopyingCellClipboardContent(object)OnInitialized(EventArgs)OnPastingCellClipboardContent(object, object)OnPropertyChanged(PropertyChangedEventArgs)OnPropertyChanged(string)PrepareCellForEdit(FrameworkElement, RoutedEventArgs)Refresh()RefreshCellElement(FrameworkElement, DependencyProperty)SortDistinctValues(IQueryable)SortDistinctValuesByFilteringDisplay(IQueryable)EventsPropertyChangedSortingStateChanged
Not finding the help you need?
Contact Support