123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502 |
- // 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.
- using System.Collections;
- using System.Collections.Generic;
- using System.ComponentModel;
- using System.Globalization;
- namespace System.Windows.Forms
- {
- internal class ItemArray : IComparer
- {
- private static int lastMask = 1;
- private readonly ListControl listControl;
- private Entry[] entries;
- private int count;
- private int version;
- public ItemArray(ListControl listControl)
- {
- this.listControl = listControl;
- }
- internal IReadOnlyList<Entry> Entries => entries;
- /// <summary>
- /// The version of this array. This number changes with each
- /// change to the item list.
- /// </summary>
- public int Version
- {
- get
- {
- return version;
- }
- }
- /// <summary>
- /// Adds the given item to the array. The state is initially
- /// zero.
- /// </summary>
- public object Add(object item)
- {
- EnsureSpace(1);
- version++;
- entries[count] = new Entry(item);
- return entries[count++];
- }
- /// <summary>
- /// Adds the given collection of items to the array.
- /// </summary>
- public void AddRange(ICollection items)
- {
- if (items == null)
- {
- throw new ArgumentNullException(nameof(items));
- }
- EnsureSpace(items.Count);
- foreach (object i in items)
- {
- entries[count++] = new Entry(i);
- }
- version++;
- }
- /// <summary>
- /// Clears this array.
- /// </summary>
- public void Clear()
- {
- if (count > 0)
- {
- Array.Clear(entries, 0, count);
- }
- count = 0;
- version++;
- }
- /// <summary>
- /// Allocates a new bitmask for use.
- /// </summary>
- public static int CreateMask()
- {
- int mask = lastMask;
- lastMask <<= 1;
- return mask;
- }
- /// <summary>
- /// Ensures that our internal array has space for
- /// the requested # of elements.
- /// </summary>
- private void EnsureSpace(int elements)
- {
- if (entries == null)
- {
- entries = new Entry[Math.Max(elements, 4)];
- }
- else if (count + elements >= entries.Length)
- {
- int newLength = Math.Max(entries.Length * 2, entries.Length + elements);
- Entry[] newEntries = new Entry[newLength];
- entries.CopyTo(newEntries, 0);
- entries = newEntries;
- }
- }
- /// <summary>
- /// Turns a virtual index into an actual index.
- /// </summary>
- public int GetActualIndex(int virtualIndex, int stateMask)
- {
- if (stateMask == 0)
- {
- return virtualIndex;
- }
- // More complex; we must compute this index.
- int calcIndex = -1;
- for (int i = 0; i < count; i++)
- {
- if ((entries[i].state & stateMask) != 0)
- {
- calcIndex++;
- if (calcIndex == virtualIndex)
- {
- return i;
- }
- }
- }
- return -1;
- }
- /// <summary>
- /// Gets the count of items matching the given mask.
- /// </summary>
- public int GetCount(int stateMask)
- {
- // If mask is zero, then just give the main count
- if (stateMask == 0)
- {
- return count;
- }
- // more complex: must provide a count of items
- // based on a mask.
- int filteredCount = 0;
- for (int i = 0; i < count; i++)
- {
- if ((entries[i].state & stateMask) != 0)
- {
- filteredCount++;
- }
- }
- return filteredCount;
- }
- /// <summary>
- /// Retrieves an enumerator that will enumerate based on
- /// the given mask.
- /// </summary>
- public IEnumerator GetEnumerator(int stateMask)
- {
- return GetEnumerator(stateMask, false);
- }
- /// <summary>
- /// Retrieves an enumerator that will enumerate based on
- /// the given mask.
- /// </summary>
- public IEnumerator GetEnumerator(int stateMask, bool anyBit)
- {
- return new EntryEnumerator(this, stateMask, anyBit);
- }
- /// <summary>
- /// Gets the item at the given index. The index is
- /// virtualized against the given mask value.
- /// </summary>
- public object GetItem(int virtualIndex, int stateMask)
- {
- int actualIndex = GetActualIndex(virtualIndex, stateMask);
- if (actualIndex == -1)
- {
- throw new IndexOutOfRangeException();
- }
- return entries[actualIndex].item;
- }
- /// <summary>
- /// Gets the item at the given index. The index is
- /// virtualized against the given mask value.
- /// </summary>
- internal object GetEntryObject(int virtualIndex, int stateMask)
- {
- int actualIndex = GetActualIndex(virtualIndex, stateMask);
- if (actualIndex == -1)
- {
- throw new IndexOutOfRangeException();
- }
- return entries[actualIndex];
- }
- /// <summary>
- /// Returns true if the requested state mask is set.
- /// The index is the actual index to the array.
- /// </summary>
- public bool GetState(int index, int stateMask)
- {
- return ((entries[index].state & stateMask) == stateMask);
- }
- /// <summary>
- /// Returns the virtual index of the item based on the
- /// state mask.
- /// </summary>
- public int IndexOf(object item, int stateMask)
- {
- int virtualIndex = -1;
- for (int i = 0; i < count; i++)
- {
- if (stateMask == 0 || (entries[i].state & stateMask) != 0)
- {
- virtualIndex++;
- if (entries[i].item.Equals(item))
- {
- return virtualIndex;
- }
- }
- }
- return -1;
- }
- /// <summary>
- /// Returns the virtual index of the item based on the
- /// state mask. Uses reference equality to identify the
- /// given object in the list.
- /// </summary>
- public int IndexOfIdentifier(object identifier, int stateMask)
- {
- int virtualIndex = -1;
- for (int i = 0; i < count; i++)
- {
- if (stateMask == 0 || (entries[i].state & stateMask) != 0)
- {
- virtualIndex++;
- if (entries[i] == identifier)
- {
- return virtualIndex;
- }
- }
- }
- return -1;
- }
- /// <summary>
- /// Inserts item at the given index. The index
- /// is not virtualized.
- /// </summary>
- public void Insert(int index, object item)
- {
- EnsureSpace(1);
- if (index < count)
- {
- System.Array.Copy(entries, index, entries, index + 1, count - index);
- }
- entries[index] = new Entry(item);
- count++;
- version++;
- }
- /// <summary>
- /// Removes the given item from the array. If
- /// the item is not in the array, this does nothing.
- /// </summary>
- public void Remove(object item)
- {
- int index = IndexOf(item, 0);
- if (index != -1)
- {
- RemoveAt(index);
- }
- }
- /// <summary>
- /// Removes the item at the given index.
- /// </summary>
- public void RemoveAt(int index)
- {
- count--;
- for (int i = index; i < count; i++)
- {
- entries[i] = entries[i + 1];
- }
- entries[count] = null;
- version++;
- }
- /// <summary>
- /// Sets the item at the given index to a new value.
- /// </summary>
- public void SetItem(int index, object item)
- {
- entries[index].item = item;
- }
- /// <summary>
- /// Sets the state data for the given index.
- /// </summary>
- public void SetState(int index, int stateMask, bool value)
- {
- if (value)
- {
- entries[index].state |= stateMask;
- }
- else
- {
- entries[index].state &= ~stateMask;
- }
- version++;
- }
- /// <summary>
- /// Find element in sorted array. If element is not found returns a binary complement of index for inserting
- /// </summary>
- public int BinarySearch(object element)
- {
- return Array.BinarySearch(entries, 0, count, element, this);
- }
- /// <summary>
- /// Sorts our array.
- /// </summary>
- public void Sort()
- {
- Array.Sort(entries, 0, count, this);
- }
- public void Sort(Array externalArray)
- {
- Array.Sort(externalArray, this);
- }
- int IComparer.Compare(object item1, object item2)
- {
- if (item1 == null)
- {
- if (item2 == null)
- {
- return 0; //both null, then they are equal
- }
- return -1; //item1 is null, but item2 is valid (greater)
- }
- if (item2 == null)
- {
- return 1; //item2 is null, so item 1 is greater
- }
- if (item1 is Entry)
- {
- item1 = ((Entry)item1).item;
- }
- if (item2 is Entry)
- {
- item2 = ((Entry)item2).item;
- }
- string itemName1 = listControl.GetItemText(item1);
- string itemName2 = listControl.GetItemText(item2);
- CompareInfo compInfo = CultureInfo.CurrentCulture.CompareInfo;
- return compInfo.Compare(itemName1, itemName2, CompareOptions.StringSort);
- }
- /// <summary>
- /// This is a single entry in our item array.
- /// </summary>
- internal class Entry
- {
- public object item;
- public int state;
- public Entry(object item)
- {
- this.item = item;
- state = 0;
- }
- }
- /// <summary>
- /// EntryEnumerator is an enumerator that will enumerate over
- /// a given state mask.
- /// </summary>
- private class EntryEnumerator : IEnumerator
- {
- private readonly ItemArray items;
- private readonly bool anyBit;
- private readonly int state;
- private int current;
- private readonly int version;
- /// <summary>
- /// Creates a new enumerator that will enumerate over the given state.
- /// </summary>
- public EntryEnumerator(ItemArray items, int state, bool anyBit)
- {
- this.items = items;
- this.state = state;
- this.anyBit = anyBit;
- version = items.version;
- current = -1;
- }
- /// <summary>
- /// Moves to the next element, or returns false if at the end.
- /// </summary>
- bool IEnumerator.MoveNext()
- {
- if (version != items.version)
- {
- throw new InvalidOperationException();
- }
- while (true)
- {
- if (current < items.count - 1)
- {
- current++;
- if (anyBit)
- {
- if ((items.entries[current].state & state) != 0)
- {
- return true;
- }
- }
- else
- {
- if ((items.entries[current].state & state) == state)
- {
- return true;
- }
- }
- }
- else
- {
- current = items.count;
- return false;
- }
- }
- }
- /// <summary>
- /// Resets the enumeration back to the beginning.
- /// </summary>
- void IEnumerator.Reset()
- {
- if (version != items.version)
- {
- throw new InvalidOperationException();
- }
- current = -1;
- }
- /// <summary>
- /// Retrieves the current value in the enumerator.
- /// </summary>
- object IEnumerator.Current
- {
- get
- {
- if (current == -1 || current == items.count)
- {
- throw new InvalidOperationException();
- }
- return items.entries[current].item;
- }
- }
- }
- }
- }
|