Class
DateTimeGroupDescription

Used for DateTime values to group items, provide well known groups, sort and filter the groups.

Definition

Namespace:Telerik.Pivot.Core

Assembly:Telerik.WinControls.PivotGrid.dll

Syntax:

cs-api-definition
[DataContract]
public sealed class DateTimeGroupDescription : PropertyGroupDescriptionBase, INotifyPropertyChanged, ISupportInitialize, IServiceProvider, IGroupDescription, IDescriptionBase, INamed, IEditable, ILabelGroupFilterHost, IValueGroupFilterHost, IFilteringDescription, IDistinctValuesDescription, IConditionFactory, IFilterOperatorsProvider

Inheritance: objectCloneableSettingsNodeDescriptionBaseGroupDescriptionBaseGroupDescriptionPropertyGroupDescriptionBaseDateTimeGroupDescription

Implements: IConditionFactoryIDescriptionBaseIDistinctValuesDescriptionIEditableIFilterOperatorsProviderIFilteringDescriptionIGroupDescriptionILabelGroupFilterHostINamedINotifyPropertyChangedIServiceProviderISupportInitializeIValueGroupFilterHost

Inherited Members PropertyGroupDescriptionBase.PropertyNamePropertyGroupDescriptionBase.CalculatedItemsGroupDescription.ShowGroupsWithNoDataGroupDescription.AutoShowSubTotalsGroupDescription.GroupFilterGroupDescriptionBase.GroupComparerGroupDescriptionBase.SortOrderDescriptionBase.DisplayNameDescriptionBase.CustomNameSettingsNode.BeginEdit()SettingsNode.BeginInit()SettingsNode.EndInit()SettingsNode.GetService(Type)SettingsNode.ParentSettingsNode.SettingsChangedSettingsNode.ServicesChangedSettingsNode.PropertyChangedCloneable.Clone()

Constructors

DateTimeGroupDescription()

Initializes a new instance of the DateTimeGroupDescription class.

Declaration

cs-api-definition
public DateTimeGroupDescription()

Properties

Step

Gets or sets the step of the grouping. Items will be put in an IGroup with a Name based on the DateTimeStep. DayGroup. MonthGroup. QuarterGroup. YearGroup. WeekGroup. HourGroup - not auto generated by default. MinuteGroup - not auto generated by default. SecondGroup - not auto generated by default.

Declaration

cs-api-definition
[DataMember]
public DateTimeStep Step { get; set; }

Property Value

DateTimeStep

Methods

CloneOverride(Cloneable)

When overridden in derived classes, performs type-specific cloning operations for the derived class properties. This method is called by CloneCore(Cloneable) after base properties have been copied.

Declaration

cs-api-definition
protected override void CloneOverride(Cloneable source)

Parameters

source

Cloneable

The source object to clone from.

Overrides PropertyGroupDescriptionBase.CloneOverride(Cloneable)

Remarks

Notes to Inheritors: If you derive from Cloneable, you need to override this method to copy all properties. It is essential that all implementations call the base implementation of this method (if you don't call base you should manually copy all needed properties including base properties).

CreateInstanceCore()

When implemented in a derived class, creates a new instance of the Cloneable derived class.

Declaration

cs-api-definition
protected override Cloneable CreateInstanceCore()

Returns

Cloneable

New instance for cloning.

Overrides Cloneable.CreateInstanceCore()

Remarks

Do not call this method directly (except when calling base in an implementation). This method is called internally by the Clone() method whenever a new instance of the Cloneable is created. Notes to Inheritors. Every Cloneable derived class must implement this method. A typical implementation is to simply call the default constructor and return the result.

GetAllNames(IEnumerable<object>, IEnumerable<object>)

Gets all possible group names by combining unique names from the data with calculated items. This method merges the actual data group names with any defined calculated items to provide a complete list of available groups.

Declaration

cs-api-definition
protected override IEnumerable<object> GetAllNames(IEnumerable<object> uniqueNames, IEnumerable<object> parentGroupNames)

Parameters

uniqueNames

IEnumerable<object>

The unique group names found in the actual data.

parentGroupNames

IEnumerable<object>

The parent group names in the hierarchy.

Returns

IEnumerable<object>

A combined enumerable of unique names and calculated items.

Overrides PropertyGroupDescriptionBase.GetAllNames(IEnumerable<object>, IEnumerable<object>)

GetUniqueName()

Gets the unique name for this group description, which is the property name used for grouping. This unique name is used to identify and distinguish this group description from others.

Declaration

cs-api-definition
public override string GetUniqueName()

Returns

string

The property name that serves as the unique identifier for this group description.

Overrides PropertyGroupDescriptionBase.GetUniqueName()

GroupNameFromItem(object, int)

Names a group that would contain the item. DayGroup. MonthGroup. QuarterGroup. YearGroup.

Declaration

cs-api-definition
protected override object GroupNameFromItem(object item, int level)

Parameters

item

object

The item to group.

level

int

The level of grouping for this GroupDescription.

Returns

object

A name for the group that would contain the item.

Overrides PropertyGroupDescriptionBase.GroupNameFromItem(object, int)