// Licensed to the .NET Foundation under one or more agreements.
// The .NET Foundation licenses this file to you under the MIT license.
 
//
// Description:
//     The AnnotationStore.StoreContentChanged event is generated when any
//     changes are made to an annotation in an AnnotationStore.  
//
//     File contains the StoreContentChangedEventArgs class, the 
//     AnnotationStoreEnum and the StoreContentChangedEventHandler delegate.
//     Spec: CAF%20Storage%20Spec.doc
//
 
namespace System.Windows.Annotations.Storage
{
    /// <summary>
    ///     Event handler delegate for AnnotationUpdated event.  Listeners for
    ///     this event must supply a delegate with this signature.
    /// </summary>
    /// <param name="sender">AnnotationStore in which the change took place</param>
    /// <param name="e">the event data</param>
    public delegate void StoreContentChangedEventHandler(object sender, StoreContentChangedEventArgs e);
 
    /// <summary>
    ///     Possible actions performed on an IAnnotation in an AnnotationStore.
    /// </summary>
    public enum StoreContentAction
    {
        /// <summary>
        ///     Annotation was added to the store
        /// </summary>
        Added,
        /// <summary>
        ///     Annotation was deleted from the store
        /// </summary>
        Deleted
    }
 
    /// <summary>
    ///     The AnnotationUpdated event is generated when any changes are made
    ///     to an annotation in an AnnotationStore.  An instance of this class 
    ///     specifies the action that was taken and the IAnnotation that was 
    ///     acted upon.
    /// </summary>
    public class StoreContentChangedEventArgs : System.EventArgs
    {
        //------------------------------------------------------
        //
        //  Constructors
        //
        //------------------------------------------------------
 
        #region Constructors
        
        /// <summary>
        ///     Creates an instance of AnnotationUpdatedEventArgs with the
        ///     specified action and annotation.
        /// </summary>
        /// <param name="action">the action that was performed on an annotation</param>
        /// <param name="annotation">the annotation that was updated</param>
        public StoreContentChangedEventArgs(StoreContentAction action, Annotation annotation)
        {
            ArgumentNullException.ThrowIfNull(annotation);
 
            _action = action;
            _annotation = annotation;
        }
 
        #endregion Constructors
        
        //------------------------------------------------------
        //
        //  Public Methods
        //
        //------------------------------------------------------
 
        //------------------------------------------------------
        //
        //  Public Operators
        //
        //------------------------------------------------------
 
        //------------------------------------------------------
        //
        //  Public Properties
        //
        //------------------------------------------------------
 
        #region Public Properties
        
        /// <summary>
        ///     Returns the IAnnotation that was updated.
        /// </summary>
        public Annotation Annotation
        {
            get
            {
                return _annotation;
            }
        }
 
        /// <summary>
        ///     Returns the action that was performed on the annotation.
        /// </summary>
        public StoreContentAction Action
        {
            get
            {
                return _action;
            }
        }
 
        #endregion Public Properties
 
        //------------------------------------------------------
        //
        //  Public Events
        //
        //------------------------------------------------------
 
        //------------------------------------------------------
        //
        //  Private Fields
        //
        //------------------------------------------------------
 
        #region Private Fields
 
        private StoreContentAction  _action;        // action taken on the annotation
        private Annotation          _annotation;    // annotation that was updated
 
        #endregion Private Fields
    }
}