Code:
/ Dotnetfx_Vista_SP2 / Dotnetfx_Vista_SP2 / 8.0.50727.4016 / DEVDIV / depot / DevDiv / releases / Orcas / QFE / wpf / src / Framework / System / Windows / Data / PropertyGroupDescription.cs / 1 / PropertyGroupDescription.cs
//----------------------------------------------------------------------------
//
//
// Copyright (C) 2003 by Microsoft Corporation. All rights reserved.
//
//
//
// Description: Description of grouping based on a property value.
//
// See spec at http://avalon/connecteddata/Specs/Grouping.mht
//
//---------------------------------------------------------------------------
using System; // StringComparison
using System.ComponentModel; // [DefaultValue]
using System.Globalization; // CultureInfo
using System.Reflection; // PropertyInfo
using System.Windows; // SR
using System.Xml; // XmlNode
using MS.Internal; // XmlHelper
namespace System.Windows.Data
{
///
/// Description of grouping based on a property value.
///
public class PropertyGroupDescription : GroupDescription
{
#region Constructors
//-----------------------------------------------------
//
// Constructors
//
//-----------------------------------------------------
///
/// Initializes a new instance of PropertyGroupDescription.
///
public PropertyGroupDescription()
{
}
///
/// Initializes a new instance of PropertyGroupDescription.
///
///
/// The name of the property whose value is used to determine which group(s)
/// an item belongs to.
/// If PropertyName is null, the item itself is used.
///
public PropertyGroupDescription(string propertyName)
{
UpdatePropertyName(propertyName);
}
///
/// Initializes a new instance of PropertyGroupDescription.
///
///
/// The name of the property whose value is used to determine which group(s)
/// an item belongs to.
/// If PropertyName is null, the item itself is used.
///
///
/// This converter is applied to the property value (or the item) to
/// produce the final value used to determine which group(s) an item
/// belongs to.
/// If the delegate returns an ICollection, the item is added to
/// multiple groups - one for each member of the collection.
///
public PropertyGroupDescription(string propertyName,
IValueConverter converter)
{
UpdatePropertyName(propertyName);
_converter = converter;
}
///
/// Initializes a new instance of PropertyGroupDescription.
///
///
/// The name of the property whose value is used to determine which group(s)
/// an item belongs to.
/// If PropertyName is null, the item itself is used.
///
///
/// This converter is applied to the property value (or the item) to
/// produce the final value used to determine which group(s) an item
/// belongs to.
/// If the delegate returns an ICollection, the item is added to
/// multiple groups - one for each member of the collection.
///
///
/// This governs the comparison between an item's value (as determined
/// by PropertyName and Converter) and a group's name.
/// It is ignored unless both comparands are strings.
/// The default value is StringComparison.Ordinal.
///
public PropertyGroupDescription(string propertyName,
IValueConverter converter,
StringComparison stringComparison)
{
UpdatePropertyName(propertyName);
_converter = converter;
_stringComparison = stringComparison;
}
#endregion Constructors
#region Public Properties
//------------------------------------------------------
//
// Public Properties
//
//-----------------------------------------------------
///
/// The name of the property whose value is used to determine which group(s)
/// an item belongs to.
/// If PropertyName is null, the item itself is used.
///
[DefaultValue(null)]
public string PropertyName
{
get { return _propertyName; }
set
{
UpdatePropertyName(value);
OnPropertyChanged("PropertyName");
}
}
///
/// This converter is applied to the property value (or the item) to
/// produce the final value used to determine which group(s) an item
/// belongs to.
/// If the delegate returns an ICollection, the item is added to
/// multiple groups - one for each member of the collection.
///
[DefaultValue(null)]
public IValueConverter Converter
{
get { return _converter; }
set { _converter = value; OnPropertyChanged("Converter"); }
}
///
/// This governs the comparison between an item's value (as determined
/// by PropertyName and Converter) and a group's name.
/// It is ignored unless both comparands are strings.
/// The default value is StringComparison.Ordinal.
///
[DefaultValue(StringComparison.Ordinal)]
public StringComparison StringComparison
{
get { return _stringComparison; }
set { _stringComparison = value; OnPropertyChanged("StringComparison"); }
}
#endregion Public Properties
#region Public Methods
//------------------------------------------------------
//
// Public Methods
//
//------------------------------------------------------
///
/// Return the group name(s) for the given item
///
public override object GroupNameFromItem(object item, int level, CultureInfo culture)
{
object value;
// get the property value
if (String.IsNullOrEmpty(PropertyName))
{
value = item;
}
else if (XmlHelper.IsXmlNode(item))
{
value = GetValueFromXmlNode(item);
}
else if (item != null)
{
using (_propertyPath.SetContext(item))
{
value = _propertyPath.GetValue();
}
}
else
{
value = null;
}
// apply the converter to the value
if (Converter != null)
{
value = Converter.Convert(value, typeof(object), level, culture);
}
return value;
}
///
/// Return true if the names match (i.e the item should belong to the group).
///
public override bool NamesMatch(object groupName, object itemName)
{
string s1 = groupName as string;
string s2 = itemName as string;
if (s1 != null && s2 != null)
{
return String.Equals(s1, s2, StringComparison);
}
else
{
return Object.Equals(groupName, itemName);
}
}
#endregion Public Methods
#region Private Methods
private void UpdatePropertyName(string propertyName)
{
_propertyName = propertyName;
_propertyPath = !String.IsNullOrEmpty(propertyName) ? new PropertyPath(propertyName) : null;
}
private void OnPropertyChanged(string propertyName)
{
OnPropertyChanged(new PropertyChangedEventArgs(propertyName));
}
#endregion Private Methods
// separate method to avoid loading System.Xml
[System.Runtime.CompilerServices.MethodImpl(System.Runtime.CompilerServices.MethodImplOptions.NoInlining)]
private object GetValueFromXmlNode(object item)
{
return XmlHelper.SelectStringValue((XmlNode)item, PropertyName);
}
#region Private Fields
//-----------------------------------------------------
//
// Private Fields
//
//------------------------------------------------------
string _propertyName;
PropertyPath _propertyPath;
IValueConverter _converter;
StringComparison _stringComparison = StringComparison.Ordinal;
#endregion Private Fields
}
}
// File provided for Reference Use Only by Microsoft Corporation (c) 2007.
// Copyright (c) Microsoft Corporation. All rights reserved.
//----------------------------------------------------------------------------
//
//
// Copyright (C) 2003 by Microsoft Corporation. All rights reserved.
//
//
//
// Description: Description of grouping based on a property value.
//
// See spec at http://avalon/connecteddata/Specs/Grouping.mht
//
//---------------------------------------------------------------------------
using System; // StringComparison
using System.ComponentModel; // [DefaultValue]
using System.Globalization; // CultureInfo
using System.Reflection; // PropertyInfo
using System.Windows; // SR
using System.Xml; // XmlNode
using MS.Internal; // XmlHelper
namespace System.Windows.Data
{
///
/// Description of grouping based on a property value.
///
public class PropertyGroupDescription : GroupDescription
{
#region Constructors
//-----------------------------------------------------
//
// Constructors
//
//-----------------------------------------------------
///
/// Initializes a new instance of PropertyGroupDescription.
///
public PropertyGroupDescription()
{
}
///
/// Initializes a new instance of PropertyGroupDescription.
///
///
/// The name of the property whose value is used to determine which group(s)
/// an item belongs to.
/// If PropertyName is null, the item itself is used.
///
public PropertyGroupDescription(string propertyName)
{
UpdatePropertyName(propertyName);
}
///
/// Initializes a new instance of PropertyGroupDescription.
///
///
/// The name of the property whose value is used to determine which group(s)
/// an item belongs to.
/// If PropertyName is null, the item itself is used.
///
///
/// This converter is applied to the property value (or the item) to
/// produce the final value used to determine which group(s) an item
/// belongs to.
/// If the delegate returns an ICollection, the item is added to
/// multiple groups - one for each member of the collection.
///
public PropertyGroupDescription(string propertyName,
IValueConverter converter)
{
UpdatePropertyName(propertyName);
_converter = converter;
}
///
/// Initializes a new instance of PropertyGroupDescription.
///
///
/// The name of the property whose value is used to determine which group(s)
/// an item belongs to.
/// If PropertyName is null, the item itself is used.
///
///
/// This converter is applied to the property value (or the item) to
/// produce the final value used to determine which group(s) an item
/// belongs to.
/// If the delegate returns an ICollection, the item is added to
/// multiple groups - one for each member of the collection.
///
///
/// This governs the comparison between an item's value (as determined
/// by PropertyName and Converter) and a group's name.
/// It is ignored unless both comparands are strings.
/// The default value is StringComparison.Ordinal.
///
public PropertyGroupDescription(string propertyName,
IValueConverter converter,
StringComparison stringComparison)
{
UpdatePropertyName(propertyName);
_converter = converter;
_stringComparison = stringComparison;
}
#endregion Constructors
#region Public Properties
//------------------------------------------------------
//
// Public Properties
//
//-----------------------------------------------------
///
/// The name of the property whose value is used to determine which group(s)
/// an item belongs to.
/// If PropertyName is null, the item itself is used.
///
[DefaultValue(null)]
public string PropertyName
{
get { return _propertyName; }
set
{
UpdatePropertyName(value);
OnPropertyChanged("PropertyName");
}
}
///
/// This converter is applied to the property value (or the item) to
/// produce the final value used to determine which group(s) an item
/// belongs to.
/// If the delegate returns an ICollection, the item is added to
/// multiple groups - one for each member of the collection.
///
[DefaultValue(null)]
public IValueConverter Converter
{
get { return _converter; }
set { _converter = value; OnPropertyChanged("Converter"); }
}
///
/// This governs the comparison between an item's value (as determined
/// by PropertyName and Converter) and a group's name.
/// It is ignored unless both comparands are strings.
/// The default value is StringComparison.Ordinal.
///
[DefaultValue(StringComparison.Ordinal)]
public StringComparison StringComparison
{
get { return _stringComparison; }
set { _stringComparison = value; OnPropertyChanged("StringComparison"); }
}
#endregion Public Properties
#region Public Methods
//------------------------------------------------------
//
// Public Methods
//
//------------------------------------------------------
///
/// Return the group name(s) for the given item
///
public override object GroupNameFromItem(object item, int level, CultureInfo culture)
{
object value;
// get the property value
if (String.IsNullOrEmpty(PropertyName))
{
value = item;
}
else if (XmlHelper.IsXmlNode(item))
{
value = GetValueFromXmlNode(item);
}
else if (item != null)
{
using (_propertyPath.SetContext(item))
{
value = _propertyPath.GetValue();
}
}
else
{
value = null;
}
// apply the converter to the value
if (Converter != null)
{
value = Converter.Convert(value, typeof(object), level, culture);
}
return value;
}
///
/// Return true if the names match (i.e the item should belong to the group).
///
public override bool NamesMatch(object groupName, object itemName)
{
string s1 = groupName as string;
string s2 = itemName as string;
if (s1 != null && s2 != null)
{
return String.Equals(s1, s2, StringComparison);
}
else
{
return Object.Equals(groupName, itemName);
}
}
#endregion Public Methods
#region Private Methods
private void UpdatePropertyName(string propertyName)
{
_propertyName = propertyName;
_propertyPath = !String.IsNullOrEmpty(propertyName) ? new PropertyPath(propertyName) : null;
}
private void OnPropertyChanged(string propertyName)
{
OnPropertyChanged(new PropertyChangedEventArgs(propertyName));
}
#endregion Private Methods
// separate method to avoid loading System.Xml
[System.Runtime.CompilerServices.MethodImpl(System.Runtime.CompilerServices.MethodImplOptions.NoInlining)]
private object GetValueFromXmlNode(object item)
{
return XmlHelper.SelectStringValue((XmlNode)item, PropertyName);
}
#region Private Fields
//-----------------------------------------------------
//
// Private Fields
//
//------------------------------------------------------
string _propertyName;
PropertyPath _propertyPath;
IValueConverter _converter;
StringComparison _stringComparison = StringComparison.Ordinal;
#endregion Private Fields
}
}
// File provided for Reference Use Only by Microsoft Corporation (c) 2007.
// Copyright (c) Microsoft Corporation. All rights reserved.
Link Menu
This book is available now!
Buy at Amazon US or
Buy at Amazon UK
- DataGridViewCellConverter.cs
- ManagedFilter.cs
- RenderData.cs
- HostingEnvironmentWrapper.cs
- QueryExtender.cs
- NavigationHelper.cs
- HierarchicalDataBoundControl.cs
- TraversalRequest.cs
- SqlMetaData.cs
- StateMachineHelpers.cs
- XmlTextReader.cs
- CollectionView.cs
- ObjectAssociationEndMapping.cs
- ColorBlend.cs
- PagePropertiesChangingEventArgs.cs
- StringExpressionSet.cs
- PropertyGroupDescription.cs
- InkCanvas.cs
- SortedList.cs
- CodeNamespaceImport.cs
- SqlDataSource.cs
- ApplicationException.cs
- CharAnimationUsingKeyFrames.cs
- MustUnderstandSoapException.cs
- Section.cs
- MessageQueuePermissionEntryCollection.cs
- CollectionViewGroup.cs
- MetadataCollection.cs
- Lazy.cs
- XmlQuerySequence.cs
- FontCollection.cs
- Journaling.cs
- ProjectionRewriter.cs
- DbProviderManifest.cs
- StrokeNodeOperations2.cs
- Int16AnimationBase.cs
- InkCanvas.cs
- EventLog.cs
- Misc.cs
- Hash.cs
- PointLightBase.cs
- ButtonBase.cs
- XmlRawWriter.cs
- DataSourceComponent.cs
- AgileSafeNativeMemoryHandle.cs
- DataGridPageChangedEventArgs.cs
- UserPrincipalNameElement.cs
- Task.cs
- Deflater.cs
- ToolBarOverflowPanel.cs
- Root.cs
- FileChangesMonitor.cs
- ItemCollection.cs
- Rfc2898DeriveBytes.cs
- CompiledQuery.cs
- ResourceSetExpression.cs
- ElementAction.cs
- ObjectStateEntryDbDataRecord.cs
- HtmlControlPersistable.cs
- SecurityHeaderTokenResolver.cs
- AccessKeyManager.cs
- ApplicationGesture.cs
- XhtmlBasicValidationSummaryAdapter.cs
- GridViewDeletedEventArgs.cs
- TableItemProviderWrapper.cs
- CustomAttribute.cs
- TextParagraphProperties.cs
- XmlUtil.cs
- TypeFieldSchema.cs
- HttpDebugHandler.cs
- HMACSHA384.cs
- DependencyPropertyDescriptor.cs
- MenuBase.cs
- AssemblyAttributes.cs
- Timeline.cs
- TreeNodeClickEventArgs.cs
- ImportDesigner.xaml.cs
- CatalogZoneBase.cs
- StyleCollection.cs
- HttpPostedFile.cs
- ObjectItemAssemblyLoader.cs
- CustomLineCap.cs
- EmptyEnumerable.cs
- SafeViewOfFileHandle.cs
- PropertyDescriptor.cs
- SqlRowUpdatedEvent.cs
- BindStream.cs
- AsyncWaitHandle.cs
- SiteMapNode.cs
- TextParagraph.cs
- PostBackTrigger.cs
- UniformGrid.cs
- MaterialGroup.cs
- LayoutEngine.cs
- DesignerSerializationOptionsAttribute.cs
- DataServiceHost.cs
- ItemChangedEventArgs.cs
- AssemblyBuilder.cs
- QueryOutputWriterV1.cs
- UnauthorizedWebPart.cs