/* * Copyright 2019 faddenSoft * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ using System; using System.Collections; using System.Collections.Generic; using System.Collections.Specialized; using System.Diagnostics; using System.ComponentModel; namespace SourceGenWPF { /// /// List of items formatted for display. /// /// /// This is intended to be useful as an ItemSource for a WPF ListView. We need to implement /// plain IList to cause ListView to perform data virtualization, and the property/collection /// changed events so the view will pick up our changes. /// /// The ItemsControl.ItemsSource property wants an IEnumerable (which IList implements). /// According to various articles, if the object implements IList, and the UI element /// is providing *UI* virtualization, you will also get *data* virtualization. This behavior /// doesn't seem to be documented anywhere, but the consensus is that it's expected to work. /// /// Implementing generic IList<> doesn't seem necessary for XAML, but may be useful /// for other consumers of the data. /// /// The list is initially filled with null references, with FormattedParts instances /// generated on demand. This is done by requesting individual items from the /// LineListGen object. /// /// NOTE: it may or may not be possible to implement this trivially with an /// ObservableCollection. At an earlier iteration it wasn't, and I'd like to keep this /// around even if it is now possible, in case the pendulum swings back the other way. /// public class DisplayList : IList, IList, INotifyCollectionChanged, INotifyPropertyChanged { /// /// List of formatted parts. DO NOT access this directly outside the event-sending /// method wrappers. /// private List mList; /// /// Data generation object. /// /// /// This property is set by the LineListGen constructor. /// public LineListGen ListGen { get; set; } /// /// Set of selected items, by list index. /// public DisplayListSelection SelectedIndices { get; private set; } /// /// Constructs an empty collection, with the default initial capacity. /// public DisplayList() { mList = new List(); SelectedIndices = new DisplayListSelection(); } #region Property / Collection Changed public event NotifyCollectionChangedEventHandler CollectionChanged; public event PropertyChangedEventHandler PropertyChanged; // See ObservableCollection class, e.g. // https://github.com/Microsoft/referencesource/blob/master/System/compmod/system/collections/objectmodel/observablecollection.cs private const string CountString = "Count"; private const string IndexerName = "Item[]"; protected virtual void OnPropertyChanged(PropertyChangedEventArgs e) { PropertyChanged?.Invoke(this, e); } private void OnPropertyChanged(string propertyName) { OnPropertyChanged(new PropertyChangedEventArgs(propertyName)); } protected virtual void OnCollectionChanged(NotifyCollectionChangedEventArgs e) { CollectionChanged?.Invoke(this, e); } private void OnCollectionChanged(NotifyCollectionChangedAction action, object item, int index) { OnCollectionChanged(new NotifyCollectionChangedEventArgs(action, item, index)); } private void OnCollectionChanged(NotifyCollectionChangedAction action, object item, int index, int oldIndex) { OnCollectionChanged(new NotifyCollectionChangedEventArgs(action, item, index, oldIndex)); } private void OnCollectionChanged(NotifyCollectionChangedAction action, object oldItem, object newItem, int index) { OnCollectionChanged(new NotifyCollectionChangedEventArgs(action, newItem, oldItem, index)); } private void OnCollectionReset() { OnCollectionChanged(new NotifyCollectionChangedEventArgs(NotifyCollectionChangedAction.Reset)); } #endregion Property / Collection Changed #region IList / IList public int Count => ((IList)mList).Count; public bool IsReadOnly => ((IList)mList).IsReadOnly; public bool IsFixedSize => ((IList)mList).IsFixedSize; public object SyncRoot => ((IList)mList).SyncRoot; public bool IsSynchronized => ((IList)mList).IsSynchronized; public void Add(FormattedParts item) { ((IList)mList).Add(item); OnPropertyChanged(CountString); OnPropertyChanged(IndexerName); OnCollectionReset(); } public int Add(object value) { int posn = ((IList)mList).Add(value); if (posn >= 0) { OnPropertyChanged(CountString); OnPropertyChanged(IndexerName); OnCollectionChanged(NotifyCollectionChangedAction.Add, value, posn); } return posn; } public void Clear() { ((IList)mList).Clear(); OnPropertyChanged(CountString); OnPropertyChanged(IndexerName); OnCollectionReset(); // Not strictly necessary, but does free up the memory sooner. SelectedIndices = new DisplayListSelection(); } public bool Contains(FormattedParts item) { return ((IList)mList).Contains(item); } bool IList.Contains(object value) { return Contains((FormattedParts)value); } public void CopyTo(FormattedParts[] array, int arrayIndex) { ((IList)mList).CopyTo(array, arrayIndex); } public void CopyTo(Array array, int index) { ((IList)mList).CopyTo(array, index); } public IEnumerator GetEnumerator() { // Use the indexer, rather than mList's enumerator, to get on-demand string gen. for (int i = 0; i < Count; i++) { yield return this[i]; } } IEnumerator IEnumerable.GetEnumerator() { return GetEnumerator(); } public int IndexOf(FormattedParts item) { return ((IList)mList).IndexOf(item); } int IList.IndexOf(object value) { return IndexOf((FormattedParts)value); } public void Insert(int index, FormattedParts item) { ((IList)mList).Insert(index, item); OnPropertyChanged(CountString); OnPropertyChanged(IndexerName); OnCollectionChanged(NotifyCollectionChangedAction.Add, item, index); } void IList.Insert(int index, object value) { Insert(index, (FormattedParts)value); } public void RemoveAt(int index) { FormattedParts removed = mList[index]; ((IList)mList).RemoveAt(index); OnPropertyChanged(CountString); OnPropertyChanged(IndexerName); OnCollectionChanged(NotifyCollectionChangedAction.Remove, removed, index); } public bool Remove(FormattedParts item) { // NotifyCollectionChangedAction.Remove wants an index. We can find the index // of the first matching item and then do a RemoveAt, but this call just isn't // all that interesting for us, so it's easier to ignore it. //return ((IList)mList).Remove(item); throw new NotSupportedException(); } void IList.Remove(object value) { //Remove((FormattedParts)value); throw new NotSupportedException(); } object IList.this[int index] { // forward to generic impl get { return this[index]; } set { this[index] = (FormattedParts)value; } } // For IList. public FormattedParts this[int index] { get { FormattedParts parts = mList[index]; if (parts == null) { parts = mList[index] = GetEntry(index); } return parts; } set { FormattedParts orig = mList[index]; mList[index] = value; OnPropertyChanged(IndexerName); OnCollectionChanged(NotifyCollectionChangedAction.Replace, orig, value, index); } } #endregion IList / IList /// /// Retrieves the Nth element. /// private FormattedParts GetEntry(int index) { FormattedParts parts = mList[index]; if (parts == null) { parts = mList[index] = ListGen.GetFormattedParts(index); parts.ListIndex = index; } return parts; } /// /// Resets the list, filling it with empty elements. Also resets the selected indices. /// /// New size of the list. public void ResetList(int size) { // TODO: can we recycle existing elements and just add/trim as needed? Clear(); mList.Capacity = size; for (int i = 0; i < size; i++) { // add directly to list so we don't send events mList.Add(null); } // send one big notification at the end; "reset" means "forget everything you knew" OnPropertyChanged(CountString); OnPropertyChanged(IndexerName); OnCollectionReset(); SelectedIndices = new DisplayListSelection(size); } public class FormattedParts { public string Offset { get; private set; } public string Addr { get; private set; } public string Bytes { get; private set; } public string Flags { get; private set; } public string Attr { get; private set; } public string Label { get; private set; } public string Opcode { get; private set; } public string Operand { get; private set; } public string Comment { get; private set; } public bool IsLongComment { get; private set; } public int ListIndex { get; set; } = -1; // Private constructor -- create instances with factory methods. private FormattedParts() { } public static FormattedParts Create(string offset, string addr, string bytes, string flags, string attr, string label, string opcode, string operand, string comment) { FormattedParts parts = new FormattedParts(); parts.Offset = offset; parts.Addr = addr; parts.Bytes = bytes; parts.Flags = flags; parts.Attr = attr; parts.Label = label; parts.Opcode = opcode; parts.Operand = operand; parts.Comment = comment; parts.IsLongComment = false; return parts; } public static FormattedParts CreateBlankLine() { FormattedParts parts = new FormattedParts(); return parts; } public static FormattedParts CreateLongComment(string comment) { FormattedParts parts = new FormattedParts(); parts.Comment = comment; parts.IsLongComment = true; return parts; } public static FormattedParts CreateDirective(string opstr, string addrStr) { FormattedParts parts = new FormattedParts(); parts.Opcode = opstr; parts.Operand = addrStr; return parts; } public static FormattedParts CreateEquDirective(string label, string opstr, string addrStr, string comment) { FormattedParts parts = new FormattedParts(); parts.Label = label; parts.Opcode = opstr; parts.Operand = addrStr; parts.Comment = comment; return parts; } } } }