File: System\Windows\Automation\RangeValuePattern.cs
Project: wpf\src\UIAutomation\UIAutomationClient\UIAutomationClient.csproj (UIAutomationClient)
//---------------------------------------------------------------------------
//
// <copyright file="RangeValuePattern" company="Microsoft">
//    Copyright (C) Microsoft Corporation.  All rights reserved.
// </copyright>
// 
//
// Description: Client-side wrapper for RangeValue Pattern
//
// History:  
//  06/23/2003 : BrendanM Ported to WCP
//
//---------------------------------------------------------------------------
 
using System;
using System.Windows.Automation.Provider;
using MS.Internal.Automation;
 
namespace System.Windows.Automation
{
 
    /// <summary>
    /// Exposes a related set of properties that reflect a control's ability to manage a value
    /// within a finite range.  It conveys a controls valid minimum and maximum values and its
    /// current value.
    ///
    ///  Pattern requires MinValue less than MaxValue. 
    ///  MinimumValue and MaximumValue must be the same Object type as ValueAsObject.
    /// </summary>
#if (INTERNAL_COMPILE)
    internal class RangeValuePattern : BasePattern
#else
    public class RangeValuePattern : BasePattern
#endif
    {
        //------------------------------------------------------
        //
        //  Constructors
        //
        //------------------------------------------------------
 
        #region Constructors
 
        private RangeValuePattern( AutomationElement el, SafePatternHandle hPattern, bool cached )
            : base(el, hPattern)
        {
            _hPattern = hPattern;
            _cached = cached;
        }
 
        #endregion Constructors
 
 
        //------------------------------------------------------
        //
        //  Public Constants / Readonly Fields
        //
        //------------------------------------------------------
 
        #region Public Constants and Readonly Fields
 
        /// <summary>Value pattern</summary>
        public static readonly AutomationPattern Pattern = RangeValuePatternIdentifiers.Pattern;
 
        /// <summary>Property ID: Value - Value of a value control, as a double</summary>
        public static readonly AutomationProperty ValueProperty = RangeValuePatternIdentifiers.ValueProperty;
 
        /// <summary>Property ID: IsReadOnly - Indicates that the value can only be read, not modified.</summary>
        public static readonly AutomationProperty IsReadOnlyProperty = RangeValuePatternIdentifiers.IsReadOnlyProperty;
 
        /// <summary>Property ID: Maximum value</summary>
        public static readonly AutomationProperty MinimumProperty = RangeValuePatternIdentifiers.MinimumProperty;
 
        /// <summary>Property ID: Maximum value</summary>
        public static readonly AutomationProperty MaximumProperty = RangeValuePatternIdentifiers.MaximumProperty;
 
        /// <summary>Property ID: LargeChange - Indicates a value to be added to or subtracted from the Value property when the element is moved a large distance.</summary>
        public static readonly AutomationProperty LargeChangeProperty = RangeValuePatternIdentifiers.LargeChangeProperty;
 
        /// <summary>Property ID: SmallChange - Indicates a value to be added to or subtracted from the Value property when the element is moved a small distance.</summary>
        public static readonly AutomationProperty SmallChangeProperty = RangeValuePatternIdentifiers.SmallChangeProperty;
 
        #endregion Public Constants and Readonly Fields
 
 
        //------------------------------------------------------
        //
        //  Public Methods
        //
        //------------------------------------------------------
 
        #region Public Methods
        /// <summary>
        /// Request to set the value that this UI element is representing
        /// </summary>
        /// <param name="value">Value to set the UI to, as a double</param>
        /// 
        /// <outside_see conditional="false">
        /// This API does not work inside the secure execution environment.
        /// <exception cref="System.Security.Permissions.SecurityPermission"/>
        /// </outside_see>
        public void SetValue(double value)
        {
            // Test the Enabled state prior to the more general Read-Only state.            
            object enabled = _el.GetCurrentPropertyValue(AutomationElementIdentifiers.IsEnabledProperty);
            if (enabled is bool && !(bool)enabled)
            {
                throw new ElementNotEnabledException();
            }
 
            // Test the Read-Only state after the more specific Enabled state.
            object readOnly = _el.GetCurrentPropertyValue(IsReadOnlyProperty);
            if (readOnly is bool && (bool)readOnly)
            {
                throw new InvalidOperationException(SR.Get(SRID.ValueReadonly));
            }
            UiaCoreApi.RangeValuePattern_SetValue(_hPattern, value);
        }
 
        #endregion Public Methods
 
 
        //------------------------------------------------------
        //
        //  Public Properties
        //
        //------------------------------------------------------
 
        #region Public Properties
        /// <summary>
        /// This member allows access to previously requested
        /// cached properties for this element. The returned object
        /// has accessors for each property defined for this pattern.
        /// </summary>
        /// <remarks>
        /// Cached property values must have been previously requested
        /// using a CacheRequest. If you try to access a cached
        /// property that was not previously requested, an InvalidOperation
        /// Exception will be thrown.
        /// 
        /// To get the value of a property at the current point in time,
        /// access the property via the Current accessor instead of
        /// Cached.
        /// </remarks>
        public RangeValuePatternInformation Cached
        {
            get
            {
                Misc.ValidateCached(_cached);
                return new RangeValuePatternInformation(_el, true);
            }
        }
 
        /// <summary>
        /// This member allows access to current property values
        /// for this element. The returned object has accessors for
        /// each property defined for this pattern.
        /// </summary>
        /// <remarks>
        /// This pattern must be from an AutomationElement with a
        /// Full reference in order to get current values. If the
        /// AutomationElement was obtained using AutomationElementMode.None,
        /// then it contains only cached data, and attempting to get
        /// the current value of any property will throw an InvalidOperationException.
        /// 
        /// To get the cached value of a property that was previously
        /// specified using a CacheRequest, access the property via the
        /// Cached accessor instead of Current.
        /// </remarks>
        public RangeValuePatternInformation Current
        {
            get
            {
                Misc.ValidateCurrent(_hPattern);
                return new RangeValuePatternInformation(_el, false);
            }
        }
 
        #endregion Public Properties
 
 
        //------------------------------------------------------
        //
        //  Internal Methods
        //
        //------------------------------------------------------
 
        #region Internal Methods
 
        static internal object Wrap(AutomationElement el, SafePatternHandle hPattern, bool cached)
        {
            return new RangeValuePattern(el, hPattern, cached);
        }
 
        #endregion Internal Methods
 
 
        //------------------------------------------------------
        //
        //  Private Fields
        //
        //------------------------------------------------------
 
        #region Private Fields
 
        private SafePatternHandle _hPattern;
        private bool _cached;
 
        #endregion Private Fields
 
 
        //------------------------------------------------------
        //
        //  Nested Classes
        //
        //------------------------------------------------------
 
        #region Nested Classes
 
        /// <summary>
        /// This class provides access to either Cached or Current
        /// properties on a pattern via the pattern's .Cached or
        /// .Current accessors.
        /// </summary>
        public struct RangeValuePatternInformation
        {
            //------------------------------------------------------
            //
            //  Constructors
            //
            //------------------------------------------------------
 
            #region Constructors
 
            internal RangeValuePatternInformation(AutomationElement el, bool useCache)
            {
                _el = el;
                _useCache = useCache;
            }
 
            #endregion Constructors
 
 
            //------------------------------------------------------
            //
            //  Public Properties
            //
            //------------------------------------------------------
 
            #region Public Properties
 
            ///<summary>Value of a value control</summary>
            /// 
            /// <outside_see conditional="false">
            /// This API does not work inside the secure execution environment.
            /// <exception cref="System.Security.Permissions.SecurityPermission"/>
            /// </outside_see>
            public double Value
            {
                get
                {
                    object propValue = _el.GetPatternPropertyValue(ValueProperty, _useCache);
                    if (propValue is int)
                    {
                        return (double)(int)propValue;
                    }
                    else if (propValue is Int32)
                    {
                        return (double)(Int32)propValue;
                    }
                    else if (propValue is byte)
                    {
                        return (double)(byte)propValue;
                    }
                    else if (propValue is DateTime)
                    {
                        return (double)((DateTime)propValue).Year;
                    }
                    else
                    {
                        return (double)propValue;
                    }
                }
            }
 
            ///<summary>Indicates that the value can only be read, not modified.
            ///returns True if the control is read-only</summary>
            ///
            /// <outside_see conditional="false">
            /// This API does not work inside the secure execution environment.
            /// <exception cref="System.Security.Permissions.SecurityPermission"/>
            /// </outside_see>
            public bool IsReadOnly
            {
                get
                {
                    return (bool)_el.GetPatternPropertyValue(IsReadOnlyProperty, _useCache);
                }
            }
 
            ///<summary>maximum value </summary>
            /// 
            /// <outside_see conditional="false">
            /// This API does not work inside the secure execution environment.
            /// <exception cref="System.Security.Permissions.SecurityPermission"/>
            /// </outside_see>
            public double Maximum
            {
                get
                {
                    object propValue = _el.GetPatternPropertyValue(MaximumProperty, _useCache);
                    if (propValue is int)
                    {
                        return (double)(int)propValue;
                    }
                    else if (propValue is Int32)
                    {
                        return (double)(Int32)propValue;
                    }
                    else if (propValue is byte)
                    {
                        return (double)(byte)propValue;
                    }
                    else if (propValue is DateTime)
                    {
                        return (double)((DateTime)propValue).Year;
                    }
                    else
                    {
                        return (double)propValue;
                    }
                }
            }
 
            ///<summary>minimum value</summary>
            /// 
            /// <outside_see conditional="false">
            /// This API does not work inside the secure execution environment.
            /// <exception cref="System.Security.Permissions.SecurityPermission"/>
            /// </outside_see>
            public double Minimum
            {
                get
                {
                    object propValue = _el.GetPatternPropertyValue(MinimumProperty, _useCache);
                    if (propValue is int)
                    {
                        return (double)(int)propValue;
                    }
                    else if (propValue is Int32)
                    {
                        return (double)(Int32)propValue;
                    }
                    else if (propValue is byte)
                    {
                        return (double)(byte)propValue;
                    }
                    else if (propValue is DateTime)
                    {
                        return (double)((DateTime)propValue).Year;
                    }
                    else
                    {
                        return (double)propValue;
                    }
                }
            }
 
 
            ///<summary>
            /// Gets a value to be added to or subtracted from the Value property 
            /// when the element is moved a large distance.
            /// </summary>
            /// 
            /// <outside_see conditional="false">
            /// This API does not work inside the secure execution environment.
            /// <exception cref="System.Security.Permissions.SecurityPermission"/>
            /// </outside_see>
            public double LargeChange
            {
                get
                {
                    object propValue = _el.GetPatternPropertyValue(LargeChangeProperty, _useCache);
                    if (propValue is int)
                    {
                        return (double)(int)propValue;
                    }
                    else if (propValue is Int32)
                    {
                        return (double)(Int32)propValue;
                    }
                    else if (propValue is byte)
                    {
                        return (double)(byte)propValue;
                    }
                    else if (propValue is DateTime)
                    {
                        return (double)((DateTime)propValue).Year;
                    }
                    else
                    {
                        return (double)propValue;
                    }
                }
            }
 
            ///<summary>
            /// Gets a value to be added to or subtracted from the Value property 
            /// when the element is moved a small distance.
            /// </summary>
            /// 
            /// <outside_see conditional="false">
            /// This API does not work inside the secure execution environment.
            /// <exception cref="System.Security.Permissions.SecurityPermission"/>
            /// </outside_see>
            public double SmallChange
            {
                get
                {
                    object propValue = _el.GetPatternPropertyValue(SmallChangeProperty, _useCache);
                    if (propValue is int)
                    {
                        return (double)(int)propValue;
                    }
                    else if (propValue is Int32)
                    {
                        return (double)(Int32)propValue;
                    }
                    else if (propValue is byte)
                    {
                        return (double)(byte)propValue;
                    }
                    else if (propValue is DateTime)
                    {
                        return (double)((DateTime)propValue).Year;
                    }
                    else
                    {
                        return (double)propValue;
                    }
                }
            }
 
            #endregion Public Properties
 
            //------------------------------------------------------
            //
            //  Private Fields
            //
            //------------------------------------------------------
 
            #region Private Fields
 
            private AutomationElement _el; // AutomationElement that contains the cache or live reference
            private bool _useCache; // true to use cache, false to use live reference to get current values
 
            #endregion Private Fields
        }
        #endregion Nested Classes
    }
}