// Copyright (c) AlphaSierraPapa for the SharpDevelop Team (for details please see \doc\copyright.txt) // This code is distributed under the GNU LGPL (for details please see \doc\license.txt) using ICSharpCode.AvalonEdit.Utils; using System; namespace ICSharpCode.AvalonEdit.Document { /// /// Describes a change of the document text. /// This class is thread-safe. /// [Serializable] public class DocumentChangeEventArgs : EventArgs { /// /// The offset at which the change occurs. /// public int Offset { get; private set; } /// /// The text that was inserted. /// public string RemovedText { get; private set; } /// /// The number of characters removed. /// public int RemovalLength { get { return RemovedText.Length; } } /// /// The text that was inserted. /// public string InsertedText { get; private set; } /// /// The number of characters inserted. /// public int InsertionLength { get { return InsertedText.Length; } } volatile OffsetChangeMap offsetChangeMap; /// /// Gets the OffsetChangeMap associated with this document change. /// /// The OffsetChangeMap instance is guaranteed to be frozen and thus thread-safe. public OffsetChangeMap OffsetChangeMap { get { OffsetChangeMap map = offsetChangeMap; if (map == null) { // create OffsetChangeMap on demand map = OffsetChangeMap.FromSingleElement(CreateSingleChangeMapEntry()); offsetChangeMap = map; } return map; } } internal OffsetChangeMapEntry CreateSingleChangeMapEntry() { return new OffsetChangeMapEntry(this.Offset, this.RemovalLength, this.InsertionLength); } /// /// Gets the OffsetChangeMap, or null if the default offset map (=single replacement) is being used. /// internal OffsetChangeMap OffsetChangeMapOrNull { get { return offsetChangeMap; } } /// /// Gets the new offset where the specified offset moves after this document change. /// public int GetNewOffset(int offset, AnchorMovementType movementType) { if (offsetChangeMap != null) return offsetChangeMap.GetNewOffset(offset, movementType); else return CreateSingleChangeMapEntry().GetNewOffset(offset, movementType); } /// /// Creates a new DocumentChangeEventArgs object. /// public DocumentChangeEventArgs(int offset, string removedText, string insertedText) : this(offset, removedText, insertedText, null) { } /// /// Creates a new DocumentChangeEventArgs object. /// public DocumentChangeEventArgs(int offset, string removedText, string insertedText, OffsetChangeMap offsetChangeMap) { ThrowUtil.CheckNotNegative(offset, "offset"); ThrowUtil.CheckNotNull(removedText, "removedText"); ThrowUtil.CheckNotNull(insertedText, "insertedText"); this.Offset = offset; this.RemovedText = removedText; this.InsertedText = insertedText; if (offsetChangeMap != null) { if (!offsetChangeMap.IsFrozen) throw new ArgumentException("The OffsetChangeMap must be frozen before it can be used in DocumentChangeEventArgs"); if (!offsetChangeMap.IsValidForDocumentChange(offset, removedText.Length, insertedText.Length)) throw new ArgumentException("OffsetChangeMap is not valid for this document change", "offsetChangeMap"); this.offsetChangeMap = offsetChangeMap; } } /// /// Creates DocumentChangeEventArgs for the reverse change. /// public DocumentChangeEventArgs Invert() { OffsetChangeMap map = this.OffsetChangeMapOrNull; if (map != null) { map = map.Invert(); map.Freeze(); } return new DocumentChangeEventArgs(this.Offset, this.InsertedText, this.RemovedText, map); } } }