|
// Licensed to the .NET Foundation under one or more agreements.
// The .NET Foundation licenses this file to you under the MIT license.
// See the LICENSE file in the project root for more information.
// Description: The CommandBindingCollection class serves the purpose of Storing/Retrieving
// CommandBindings.
//
// See spec at : http://avalon/coreUI/Specs/Commanding%20--%20design.htm
using System.Collections;
namespace System.Windows.Input
{
/// <summary>
/// CommandBindingCollection - Collection of CommandBindings.
/// Stores the CommandBindings Sequentially in an System.Collections.Generic.List"CommandBinding".
/// Will be changed to generic List implementation once the
/// parser supports generic collections.
/// </summary>
public sealed class CommandBindingCollection : IList
{
//------------------------------------------------------
//
// Constructors
//
//------------------------------------------------------
#region Constructors
/// <summary>
/// Constructor
/// </summary>
public CommandBindingCollection()
{
}
/// <summary>
/// CommandBindingCollection
/// </summary>
/// <param name="commandBindings">CommandBinding array</param>
public CommandBindingCollection(IList commandBindings)
{
if (commandBindings is { Count: > 0 })
{
AddRange(commandBindings);
}
}
#endregion Constructors
//------------------------------------------------------
//
// Public Methods
//
//------------------------------------------------------
#region Public Methods
#region Implementation of IList
#region Implementation of ICollection
/// <summary>
/// CopyTo - to copy the entire collection into an array
/// </summary>
/// <param name="array">commandbinding array to copy into</param>
/// <param name="index">start index in current list to copy</param>
void ICollection.CopyTo(System.Array array, int index)
{
((ICollection)_innerCBList)?.CopyTo(array, index);
}
#endregion Implementation of ICollection
/// <summary>
/// IList.Contains
/// </summary>
/// <param name="key">key</param>
/// <returns>true - if found, false - otherwise</returns>
bool IList.Contains(object key)
{
return Contains(key as CommandBinding) ;
}
/// <summary>
/// IndexOf
/// </summary>
/// <param name="value">item whose index is queried</param>
/// <returns></returns>
int IList.IndexOf(object value)
{
return ((value is CommandBinding commandBinding) ? IndexOf(commandBinding) : -1);
}
/// <summary>
/// Insert
/// </summary>
/// <param name="index">index at which to insert the given item</param>
/// <param name="value">item to insert</param>
void IList.Insert(int index, object value)
{
Insert(index, value as CommandBinding);
}
/// <summary>
/// Add
/// </summary>
/// <param name="commandBinding">CommandBinding object to add</param>
int IList.Add(object commandBinding)
{
return Add(commandBinding as CommandBinding);
}
/// <summary>
/// Remove
/// </summary>
/// <param name="commandBinding">CommandBinding object to remove</param>
void IList.Remove(object commandBinding)
{
Remove(commandBinding as CommandBinding);
}
/// <summary>
/// Indexing operator
/// </summary>
object IList.this[int index]
{
get
{
return this[index];
}
set
{
if (value is not CommandBinding commandBinding)
throw new NotSupportedException(SR.CollectionOnlyAcceptsCommandBindings);
this[index] = commandBinding;
}
}
#endregion Implementation of IList
/// <summary>
/// Indexing operator
/// </summary>
public CommandBinding this[int index]
{
get
{
return (_innerCBList?[index]);
}
set
{
if (_innerCBList != null)
{
_innerCBList[index] = value;
}
}
}
/// <summary>
/// Add
/// </summary>
/// <param name="commandBinding">commandBinding to add</param>
public int Add(CommandBinding commandBinding)
{
if (commandBinding != null)
{
_innerCBList ??= new Collections.Generic.List<CommandBinding>(1);
_innerCBList.Add(commandBinding);
return 0; // ICollection.Add no longer returns the indice
}
else
{
throw new NotSupportedException(SR.CollectionOnlyAcceptsCommandBindings);
}
}
/// <summary>
/// Adds the elements of the given collection to the end of this list. If
/// required, the capacity of the list is increased to twice the previous
/// capacity or the new size, whichever is larger.
/// </summary>
/// <param name="collection">collection to append</param>
public void AddRange(ICollection collection)
{
ArgumentNullException.ThrowIfNull(collection);
if (collection.Count <= 0) return;
_innerCBList ??= new System.Collections.Generic.List<CommandBinding>(collection.Count);
IEnumerator collectionEnum = collection.GetEnumerator();
while(collectionEnum.MoveNext())
{
if (collectionEnum.Current is CommandBinding cmdBinding)
{
_innerCBList.Add(cmdBinding);
}
else
{
throw new NotSupportedException(SR.CollectionOnlyAcceptsCommandBindings);
}
}
}
/// <summary>
/// Insert
/// </summary>
/// <param name="index">index at which to insert the given item</param>
/// <param name="commandBinding">item to insert</param>
public void Insert(int index, CommandBinding commandBinding)
{
if (commandBinding != null)
{
_innerCBList?.Insert(index, commandBinding);
}
else
{
throw new NotSupportedException(SR.CollectionOnlyAcceptsCommandBindings);
}
}
/// <summary>
/// Remove
/// </summary>
/// <param name="commandBinding">CommandBinding to remove</param>
public void Remove(CommandBinding commandBinding)
{
if (_innerCBList != null && commandBinding != null)
_innerCBList.Remove(commandBinding);
}
/// <summary>
/// RemoveAt
/// </summary>
/// <param name="index">index at which the item needs to be removed</param>
public void RemoveAt(int index)
{
_innerCBList?.RemoveAt(index);
}
/// <summary>
/// IsFixedSize
/// </summary>
public bool IsFixedSize
{
get { return IsReadOnly; }
}
/// <summary>
/// ICollection.IsSynchronized
/// </summary>
public bool IsSynchronized
{
get
{
return _innerCBList is not null && ((IList)_innerCBList).IsSynchronized;
}
}
/// <summary>
/// Synchronization Root to take lock on
/// </summary>
public object SyncRoot
{
get
{
return this;
}
}
/// <summary>
/// IList.IsReadOnly - Tells whether this is readonly Collection.
/// </summary>
public bool IsReadOnly
{
get { return false; }
}
/// <summary>
/// Count
/// </summary>
public int Count
{
get
{
return _innerCBList?.Count ?? 0;
}
}
/// <summary>
/// Clears the Entire CommandBindingCollection
/// </summary>
public void Clear()
{
if (_innerCBList is null) return;
_innerCBList.Clear();
_innerCBList = null;
}
/// <summary>
/// IndexOf
/// </summary>
/// <param name="value"></param>
/// <returns></returns>
public int IndexOf(CommandBinding value)
{
return _innerCBList?.IndexOf(value) ?? -1;
}
/// <summary>
/// Contains
/// </summary>
/// <param name="commandBinding">commandBinding to check</param>
/// <returns>true - if found, false - otherwise</returns>
public bool Contains(CommandBinding commandBinding)
{
if (_innerCBList != null && commandBinding != null)
{
return _innerCBList.Contains(commandBinding) ;
}
return false;
}
/// <summary>
/// CopyTo - to copy the entire collection starting at an index into an array
/// </summary>
/// <param name="commandBindings"> type-safe (CommandBinding) array</param>
/// <param name="index">start index in current list to copy</param>
public void CopyTo(CommandBinding[] commandBindings, int index)
{
_innerCBList?.CopyTo(commandBindings, index);
}
#region Implementation of Enumerable
/// <summary>
/// IEnumerable.GetEnumerator - For Enumeration purposes
/// </summary>
/// <returns></returns>
public IEnumerator GetEnumerator()
{
if (_innerCBList != null)
return _innerCBList.GetEnumerator();
System.Collections.Generic.List<CommandBinding> list = new System.Collections.Generic.List<CommandBinding>(0);
return list.GetEnumerator();
}
#endregion Implementation of IEnumberable
#endregion Public
#region Internal
internal ICommand FindMatch(object targetElement, InputEventArgs inputEventArgs)
{
for (int i = 0; i < Count; i++)
{
CommandBinding commandBinding = this[i];
if (commandBinding.Command is not RoutedCommand routedCommand) continue;
InputGestureCollection inputGestures = routedCommand.InputGesturesInternal;
if (inputGestures?.FindMatch(targetElement, inputEventArgs) != null)
{
return routedCommand;
}
}
return null;
}
internal CommandBinding FindMatch(ICommand command, ref int index)
{
while (index < Count)
{
CommandBinding commandBinding = this[index++];
if (commandBinding.Command == command)
{
return commandBinding;
}
}
return null;
}
#endregion
//------------------------------------------------------
//
// Private Fields
//
//------------------------------------------------------
#region Private Fields
private Collections.Generic.List<CommandBinding> _innerCBList;
#endregion Private Fields
}
}
|