[ This article is for Windows Phone 8 developers. If you’re developing for Windows 10, see the latest documentation. ]
Describes the grouping of items by using a property name as the criteria.
Assembly: System.Windows (in System.Windows.dll)
Public Class PropertyGroupDescription _ Inherits GroupDescription
public class PropertyGroupDescription : GroupDescription
The PropertyGroupDescription type exposes the following members.
|PropertyGroupDescription()()()||Initializes a new instance of the PropertyGroupDescription class.|
|PropertyGroupDescription(String)||Initializes a new instance of the PropertyGroupDescription class with the specified property name.|
|PropertyGroupDescription(String, IValueConverter)||Initializes a new instance of the PropertyGroupDescription class with the specified property name and converter.|
|PropertyGroupDescription(String, IValueConverter, StringComparison)||Initializes a new instance of the PropertyGroupDescription class with the specified property name, converter, and string comparison.|
|Converter||Gets or sets a converter to apply to the property value or the item to produce the final value that is used to determine which group(s) an item belongs to.|
|GroupNames||Gets the collection of group names. (Inherited from GroupDescription.)|
|PropertyName||Gets or sets the name of the property that is used to determine which group(s) an item belongs to.|
|StringComparison||Gets or sets a StringComparison value that specifies the comparison between the value of an item (as determined by PropertyName and Converter) and the name of a group.|
|Equals(Object)||Determines whether the specified Object is equal to the current Object. (Inherited from Object.)|
|Finalize||Allows an object to try to free resources and perform other cleanup operations before the Object is reclaimed by garbage collection. (Inherited from Object.)|
|GetHashCode||Serves as a hash function for a particular type. (Inherited from Object.)|
|GetType||Gets the Type of the current instance. (Inherited from Object.)|
|GroupNameFromItem||Returns the group name(s) for the specified item. (Overrides GroupDescription..::.GroupNameFromItem(Object, Int32, CultureInfo).)|
|MemberwiseClone||Creates a shallow copy of the current Object. (Inherited from Object.)|
|NamesMatch||Returns a value that indicates whether the group name and the item name match, which indicates that the item belongs to the group. (Overrides GroupDescription..::.NamesMatch(Object, Object).)|
|OnPropertyChanged||Raises the PropertyChanged event. (Inherited from GroupDescription.)|
|ShouldSerializeGroupNames||Indicates whether the group names should be serialized. (Inherited from GroupDescription.)|
|ToString||Returns a string that represents the current object. (Inherited from Object.)|
|PropertyChanged||Occurs when a property value has changed. (Inherited from GroupDescription.)|
Explicit Interface Implementations
|INotifyPropertyChanged..::.PropertyChanged||For a description of this member, see PropertyChanged. (Inherited from GroupDescription.)|
Views support the functionality of grouping, which allows the user to partition the collection in the collection view into logical groups. The groups can be explicit, where the user supplies a list of groups, or implicit, where the groups are generated dynamically depending on the data.
PropertyGroupDescription allows you to create implicit groups based on a property value. To generate groups based on a property, set the PropertyName property. To change the value that is eventually used for grouping before the groups are generated, use the Converter property to supply a value converter. For example, you might want to group items based on the first letter of a name. If the PropertyName property is not set, the item itself is passed to the value converter. The converter can return a collection, which indicates the items can appear in more than one group.
You can also use the StringComparison property to define how string comparison should occur.
Windows Phone OS
Supported in: 8.1, 8.0, 7.1
Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.