|
// 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.
//
//
//
// Description: Grid length implementation
//
// See spec at http://avalon/layout/Specs/Star%20LengthUnit.mht
//
//
using System.ComponentModel;
using System.Globalization;
namespace System.Windows
{
/// <summary>
/// GridUnitType enum is used to indicate what kind of value the
/// GridLength is holding.
/// </summary>
// Note: Keep the GridUnitType enum in sync with the string representation
// of units (GridLengthConverter._unitString).
public enum GridUnitType
{
/// <summary>
/// The value indicates that content should be calculated without constraints.
/// </summary>
Auto = 0,
/// <summary>
/// The value is expressed as a pixel.
/// </summary>
Pixel,
/// <summary>
/// The value is expressed as a weighted proportion of available space.
/// </summary>
Star,
}
/// <summary>
/// GridLength is the type used for various length-like properties in the system,
/// that explicitely support Star unit type. For example, "Width", "Height"
/// properties of ColumnDefinition and RowDefinition used by Grid.
/// </summary>
[TypeConverter(typeof(GridLengthConverter))]
public struct GridLength : IEquatable<GridLength>
{
//------------------------------------------------------
//
// Constructors
//
//------------------------------------------------------
#region Constructors
/// <summary>
/// Constructor, initializes the GridLength as absolute value in pixels.
/// </summary>
/// <param name="pixels">Specifies the number of 'device-independent pixels'
/// (96 pixels-per-inch).</param>
/// <exception cref="ArgumentException">
/// If <c>pixels</c> parameter is <c>double.NaN</c>
/// or <c>pixels</c> parameter is <c>double.NegativeInfinity</c>
/// or <c>pixels</c> parameter is <c>double.PositiveInfinity</c>.
/// </exception>
public GridLength(double pixels)
: this(pixels, GridUnitType.Pixel)
{
}
/// <summary>
/// Constructor, initializes the GridLength and specifies what kind of value
/// it will hold.
/// </summary>
/// <param name="value">Value to be stored by this GridLength
/// instance.</param>
/// <param name="type">Type of the value to be stored by this GridLength
/// instance.</param>
/// <remarks>
/// If the <c>type</c> parameter is <c>GridUnitType.Auto</c>,
/// then passed in value is ignored and replaced with <c>0</c>.
/// </remarks>
/// <exception cref="ArgumentException">
/// If <c>value</c> parameter is <c>double.NaN</c>
/// or <c>value</c> parameter is <c>double.NegativeInfinity</c>
/// or <c>value</c> parameter is <c>double.PositiveInfinity</c>.
/// </exception>
public GridLength(double value, GridUnitType type)
{
if (double.IsNaN(value))
{
throw new ArgumentException(SR.Format(SR.InvalidCtorParameterNoNaN, "value"));
}
if (double.IsInfinity(value))
{
throw new ArgumentException(SR.Format(SR.InvalidCtorParameterNoInfinity, "value"));
}
if ( type != GridUnitType.Auto
&& type != GridUnitType.Pixel
&& type != GridUnitType.Star )
{
throw new ArgumentException(SR.Format(SR.InvalidCtorParameterUnknownGridUnitType, "type"));
}
_unitValue = (type == GridUnitType.Auto) ? 0.0 : value;
_unitType = type;
}
#endregion Constructors
//------------------------------------------------------
//
// Public Methods
//
//------------------------------------------------------
#region Public Methods
/// <summary>
/// Overloaded operator, compares 2 GridLength's.
/// </summary>
/// <param name="gl1">first GridLength to compare.</param>
/// <param name="gl2">second GridLength to compare.</param>
/// <returns>true if specified GridLengths have same value
/// and unit type.</returns>
public static bool operator == (GridLength gl1, GridLength gl2)
{
return ( gl1.GridUnitType == gl2.GridUnitType
&& gl1.Value == gl2.Value );
}
/// <summary>
/// Overloaded operator, compares 2 GridLength's.
/// </summary>
/// <param name="gl1">first GridLength to compare.</param>
/// <param name="gl2">second GridLength to compare.</param>
/// <returns>true if specified GridLengths have either different value or
/// unit type.</returns>
public static bool operator != (GridLength gl1, GridLength gl2)
{
return ( gl1.GridUnitType != gl2.GridUnitType
|| gl1.Value != gl2.Value );
}
/// <summary>
/// Compares this instance of GridLength with another object.
/// </summary>
/// <param name="oCompare">Reference to an object for comparison.</param>
/// <returns><c>true</c>if this GridLength instance has the same value
/// and unit type as oCompare.</returns>
override public bool Equals(object oCompare)
{
if(oCompare is GridLength)
{
GridLength l = (GridLength)oCompare;
return (this == l);
}
else
return false;
}
/// <summary>
/// Compares this instance of GridLength with another instance.
/// </summary>
/// <param name="gridLength">Grid length instance to compare.</param>
/// <returns><c>true</c>if this GridLength instance has the same value
/// and unit type as gridLength.</returns>
public bool Equals(GridLength gridLength)
{
return (this == gridLength);
}
/// <summary>
/// <see cref="Object.GetHashCode"/>
/// </summary>
/// <returns><see cref="Object.GetHashCode"/></returns>
public override int GetHashCode()
{
return ((int)_unitValue + (int)_unitType);
}
/// <summary>
/// Returns <c>true</c> if this GridLength instance holds
/// an absolute (pixel) value.
/// </summary>
public bool IsAbsolute { get { return (_unitType == GridUnitType.Pixel); } }
/// <summary>
/// Returns <c>true</c> if this GridLength instance is
/// automatic (not specified).
/// </summary>
public bool IsAuto { get { return (_unitType == GridUnitType.Auto); } }
/// <summary>
/// Returns <c>true</c> if this GridLength instance holds weighted propertion
/// of available space.
/// </summary>
public bool IsStar { get { return (_unitType == GridUnitType.Star); } }
/// <summary>
/// Returns value part of this GridLength instance.
/// </summary>
public double Value { get { return ((_unitType == GridUnitType.Auto) ? 1.0 : _unitValue); } }
/// <summary>
/// Returns unit type of this GridLength instance.
/// </summary>
public GridUnitType GridUnitType { get { return (_unitType); } }
/// <summary>
/// Returns the string representation of this object.
/// </summary>
public override string ToString()
{
return GridLengthConverter.ToString(this, CultureInfo.InvariantCulture);
}
#endregion Public Methods
//------------------------------------------------------
//
// Public Properties
//
//------------------------------------------------------
#region Public Properties
/// <summary>
/// Returns initialized Auto GridLength value.
/// </summary>
public static GridLength Auto
{
get { return (s_auto); }
}
#endregion Public Properties
//------------------------------------------------------
//
// Private Fields
//
//------------------------------------------------------
#region Private Fields
private double _unitValue; // unit value storage
private GridUnitType _unitType; // unit type storage
// static instance of Auto GridLength
private static readonly GridLength s_auto = new GridLength(1.0, GridUnitType.Auto);
#endregion Private Fields
}
}
|