|
//---------------------------------------------------------------------------
// <copyright file="DocumentReferenceCollection.cs" company="Microsoft">
// Copyright (C) 2004 by Microsoft Corporation. All rights reserved.
// </copyright>
//
// Description:
// Implements the DocumentReferenceCollection as holder for a collection
// of DocumentReference
//
// History:
// 05/07/2004 - Zhenbin Xu (ZhenbinX) - Created.
//
//
//---------------------------------------------------------------------------
namespace System.Windows.Documents
{
using System;
using System.Collections.Generic;
using System.Collections.Specialized;
using System.Diagnostics;
//=====================================================================
/// <summary>
/// DocumentReferenceCollection is an ordered collection of DocumentReference
/// </summary>
[CLSCompliant(false)]
public sealed class DocumentReferenceCollection : IEnumerable<DocumentReference>, INotifyCollectionChanged
{
//--------------------------------------------------------------------
//
// Connstructors
//
//---------------------------------------------------------------------
#region Constructors
internal DocumentReferenceCollection()
{
}
#endregion Constructors
//--------------------------------------------------------------------
//
// Public Methods
//
//---------------------------------------------------------------------
#region Public Methods
#region IEnumerable
/// <summary>
/// <!-- see cref="System.Collections.Generic.IEnumerable<>.GetEnumerator" / -->
/// </summary>
public IEnumerator<DocumentReference> GetEnumerator()
{
return _InternalList.GetEnumerator();
}
System.Collections.IEnumerator System.Collections.IEnumerable.GetEnumerator()
{
return ((IEnumerable<DocumentReference>)this).GetEnumerator();
}
#endregion IEnumerable
///<summary>
///
///</summary>
public void Add(DocumentReference item)
{
int count = _InternalList.Count;
_InternalList.Add(item);
OnCollectionChanged(NotifyCollectionChangedAction.Add, item, count);
}
/// <summary>
/// Passes in document reference array to be copied
/// </summary>
public void CopyTo(DocumentReference[] array, int arrayIndex)
{
_InternalList.CopyTo(array, arrayIndex);
}
#endregion Public Methods
#region Public Properties
/// <summary>
/// Count of Document References in collection
/// </summary>
public int Count
{
get
{
return _InternalList.Count;
}
}
/// <summary>
/// <!-- see cref="System.Collections.Generic.IList<>.this" / -->
/// </summary>
public DocumentReference this[int index]
{
get
{
return _InternalList[index];
}
}
#endregion Public Properties
//--------------------------------------------------------------------
//
// Public Events
//
//---------------------------------------------------------------------
#region Public Event
/// <summary>
/// Occurs when the collection changes, either by adding or removing an item.
/// </summary>
/// <remarks>
/// see <seealso cref="INotifyCollectionChanged" />
/// </remarks>
public event NotifyCollectionChangedEventHandler CollectionChanged;
#endregion Public Event
//--------------------------------------------------------------------
//
// private Properties
//
//---------------------------------------------------------------------
#region Private Properties
// Aggregated IList
private IList<DocumentReference> _InternalList
{
get
{
if (_internalList == null)
{
_internalList = new List<DocumentReference>();
}
return _internalList;
}
}
#endregion Private Properties
#region Private Methods
//--------------------------------------------------------------------
//
// Private Methods
//
//---------------------------------------------------------------------
// fire CollectionChanged event to any listeners
private void OnCollectionChanged(NotifyCollectionChangedAction action, object item, int index)
{
if (CollectionChanged != null)
{
NotifyCollectionChangedEventArgs args;
args = new NotifyCollectionChangedEventArgs(action, item, index);
CollectionChanged(this, args);
}
}
#endregion Private Methods
//--------------------------------------------------------------------
//
// Private Fields
//
//---------------------------------------------------------------------
#region Private Fields
private List<DocumentReference> _internalList;
#endregion Private Fields
}
}
|