// Copyright (c) The Perspex Project. All rights reserved. // Licensed under the MIT license. See licence.md file in the project root for full license information. using System; using System.Linq; using Perspex.VisualTree; using Serilog; using Serilog.Core.Enrichers; namespace Perspex.Layout { /// /// Defines how a control aligns itself horizontally in its parent control. /// public enum HorizontalAlignment { /// /// The control stretches to fill the width of the parent control. /// Stretch, /// /// The control aligns itself to the left of the parent control. /// Left, /// /// The control centers itself in the parent control. /// Center, /// /// The control aligns itself to the right of the parent control. /// Right, } /// /// Defines how a control aligns itself vertically in its parent control. /// public enum VerticalAlignment { /// /// The control stretches to fill the height of the parent control. /// Stretch, /// /// The control aligns itself to the top of the parent control. /// Top, /// /// The control centers itself within the parent control. /// Center, /// /// The control aligns itself to the bottom of the parent control. /// Bottom, } /// /// Implements layout-related functionality for a control. /// public class Layoutable : Visual, ILayoutable { /// /// Defines the property. /// public static readonly PerspexProperty WidthProperty = PerspexProperty.Register(nameof(Width), double.NaN); /// /// Defines the property. /// public static readonly PerspexProperty HeightProperty = PerspexProperty.Register(nameof(Height), double.NaN); /// /// Defines the property. /// public static readonly PerspexProperty MinWidthProperty = PerspexProperty.Register(nameof(MinWidth)); /// /// Defines the property. /// public static readonly PerspexProperty MaxWidthProperty = PerspexProperty.Register(nameof(MaxWidth), double.PositiveInfinity); /// /// Defines the property. /// public static readonly PerspexProperty MinHeightProperty = PerspexProperty.Register(nameof(MinHeight)); /// /// Defines the property. /// public static readonly PerspexProperty MaxHeightProperty = PerspexProperty.Register(nameof(MaxHeight), double.PositiveInfinity); /// /// Defines the property. /// public static readonly PerspexProperty MarginProperty = PerspexProperty.Register(nameof(Margin)); /// /// Defines the property. /// public static readonly PerspexProperty HorizontalAlignmentProperty = PerspexProperty.Register(nameof(HorizontalAlignment)); /// /// Defines the property. /// public static readonly PerspexProperty VerticalAlignmentProperty = PerspexProperty.Register(nameof(VerticalAlignment)); /// /// Defines the property. /// public static readonly PerspexProperty UseLayoutRoundingProperty = PerspexProperty.Register(nameof(UseLayoutRounding), defaultValue: true, inherits: true); private Size? _previousMeasure; private Rect? _previousArrange; private readonly ILogger _layoutLog; /// /// Initializes static members of the class. /// static Layoutable() { AffectsMeasure(IsVisibleProperty); AffectsMeasure(WidthProperty); AffectsMeasure(HeightProperty); AffectsMeasure(MinWidthProperty); AffectsMeasure(MaxWidthProperty); AffectsMeasure(MinHeightProperty); AffectsMeasure(MaxHeightProperty); AffectsMeasure(MarginProperty); AffectsMeasure(HorizontalAlignmentProperty); AffectsMeasure(VerticalAlignmentProperty); } /// /// Initializes a new instance of the class. /// public Layoutable() { _layoutLog = Log.ForContext(new[] { new PropertyEnricher("Area", "Layout"), new PropertyEnricher("SourceContext", GetType()), new PropertyEnricher("Id", GetHashCode()), }); } /// /// Gets or sets the width of the element. /// public double Width { get { return GetValue(WidthProperty); } set { SetValue(WidthProperty, value); } } /// /// Gets or sets the height of the element. /// public double Height { get { return GetValue(HeightProperty); } set { SetValue(HeightProperty, value); } } /// /// Gets or sets the minimum width of the element. /// public double MinWidth { get { return GetValue(MinWidthProperty); } set { SetValue(MinWidthProperty, value); } } /// /// Gets or sets the maximum width of the element. /// public double MaxWidth { get { return GetValue(MaxWidthProperty); } set { SetValue(MaxWidthProperty, value); } } /// /// Gets or sets the minimum height of the element. /// public double MinHeight { get { return GetValue(MinHeightProperty); } set { SetValue(MinHeightProperty, value); } } /// /// Gets or sets the maximum height of the element. /// public double MaxHeight { get { return GetValue(MaxHeightProperty); } set { SetValue(MaxHeightProperty, value); } } /// /// Gets or sets the margin around the element. /// public Thickness Margin { get { return GetValue(MarginProperty); } set { SetValue(MarginProperty, value); } } /// /// Gets or sets the element's preferred horizontal alignment in its parent. /// public HorizontalAlignment HorizontalAlignment { get { return GetValue(HorizontalAlignmentProperty); } set { SetValue(HorizontalAlignmentProperty, value); } } /// /// Gets or sets the element's preferred vertical alignment in its parent. /// public VerticalAlignment VerticalAlignment { get { return GetValue(VerticalAlignmentProperty); } set { SetValue(VerticalAlignmentProperty, value); } } /// /// Gets the size that this element computed during the measure pass of the layout process. /// public Size DesiredSize { get; set; } /// /// Gets a value indicating whether the control's layout measure is valid. /// public bool IsMeasureValid { get; private set; } /// /// Gets a value indicating whether the control's layouts arrange is valid. /// public bool IsArrangeValid { get; private set; } /// /// Gets or sets a value that determines whether the element should be snapped to pixel /// boundaries at layout time. /// public bool UseLayoutRounding { get { return GetValue(UseLayoutRoundingProperty); } set { SetValue(UseLayoutRoundingProperty, value); } } /// /// Gets the available size passed in the previous layout pass, if any. /// Size? ILayoutable.PreviousMeasure => _previousMeasure; /// /// Gets the layout rect passed in the previous layout pass, if any. /// Rect? ILayoutable.PreviousArrange => _previousArrange; /// /// Creates the visual children of the control, if necessary /// public virtual void ApplyTemplate() { } /// /// Carries out a measure of the control. /// /// The available size for the control. /// /// If true, the control will be measured even if has not /// changed from the last measure. /// public void Measure(Size availableSize, bool force = false) { if (double.IsNaN(availableSize.Width) || double.IsNaN(availableSize.Height)) { throw new InvalidOperationException("Cannot call Measure using a size with NaN values."); } if (force || !IsMeasureValid || _previousMeasure != availableSize) { IsMeasureValid = true; var desiredSize = MeasureCore(availableSize).Constrain(availableSize); if (IsInvalidSize(desiredSize)) { throw new InvalidOperationException("Invalid size returned for Measure."); } DesiredSize = desiredSize; _previousMeasure = availableSize; _layoutLog.Verbose("Measure requested {DesiredSize}", DesiredSize); } } /// /// Arranges the control and its children. /// /// The control's new bounds. /// /// If true, the control will be arranged even if has not changed /// from the last arrange. /// public void Arrange(Rect rect, bool force = false) { if (IsInvalidRect(rect)) { throw new InvalidOperationException("Invalid Arrange rectangle."); } // If the measure was invalidated during an arrange pass, wait for the measure pass to // be re-run. if (!IsMeasureValid) { return; } if (force || !IsArrangeValid || _previousArrange != rect) { _layoutLog.Verbose("Arrange to {Rect} ", rect); IsArrangeValid = true; ArrangeCore(rect); _previousArrange = rect; } } /// /// Invalidates the measurement of the control and queues a new layout pass. /// public void InvalidateMeasure() { var parent = this.GetVisualParent(); if (IsMeasureValid) { _layoutLog.Verbose("Invalidated measure"); } IsMeasureValid = false; IsArrangeValid = false; _previousMeasure = null; _previousArrange = null; if (parent != null && IsResizable(parent)) { parent.InvalidateMeasure(); } else { var root = GetLayoutRoot(); root?.Item1.LayoutManager?.InvalidateMeasure(this, root.Item2); } } /// /// Invalidates the arrangement of the control and queues a new layout pass. /// public void InvalidateArrange() { var root = GetLayoutRoot(); if (IsArrangeValid) { _layoutLog.Verbose("Arrange measure"); } IsArrangeValid = false; _previousArrange = null; root?.Item1.LayoutManager?.InvalidateArrange(this, root.Item2); } /// /// Marks a property as affecting the control's measurement. /// /// The property. /// /// After a call to this method in a control's static constructor, any change to the /// property will cause to be called on the element. /// protected static void AffectsMeasure(PerspexProperty property) { property.Changed.Subscribe(AffectsMeasureInvalidate); } /// /// Marks a property as affecting the control's arrangement. /// /// The property. /// /// After a call to this method in a control's static constructor, any change to the /// property will cause to be called on the element. /// protected static void AffectsArrange(PerspexProperty property) { property.Changed.Subscribe(AffectsArrangeInvalidate); } /// /// The default implementation of the control's measure pass. /// /// The size available to the control. /// The desired size for the control. /// /// This method calls which is probably the method you /// want to override in order to modify a control's arrangement. /// protected virtual Size MeasureCore(Size availableSize) { if (IsVisible) { ApplyTemplate(); var constrained = LayoutHelper .ApplyLayoutConstraints(this, availableSize) .Deflate(Margin); var measured = MeasureOverride(constrained); var width = measured.Width; var height = measured.Height; if (!double.IsNaN(Width)) { width = Width; } width = Math.Min(width, MaxWidth); width = Math.Max(width, MinWidth); if (!double.IsNaN(Height)) { height = Height; } height = Math.Min(height, MaxHeight); height = Math.Max(height, MinHeight); return NonNegative(new Size(width, height).Inflate(Margin)); } else { return new Size(); } } /// /// Measures the control and its child elements as part of a layout pass. /// /// The size available to the control. /// The desired size for the control. protected virtual Size MeasureOverride(Size availableSize) { double width = 0; double height = 0; foreach (ILayoutable child in this.GetVisualChildren().OfType()) { child.Measure(availableSize); width = Math.Max(width, child.DesiredSize.Width); height = Math.Max(height, child.DesiredSize.Height); } if (UseLayoutRounding) { width = Math.Ceiling(width); height = Math.Ceiling(height); } return new Size(width, height); } /// /// The default implementation of the control's arrange pass. /// /// The control's new bounds. /// /// This method calls which is probably the method you /// want to override in order to modify a control's arrangement. /// protected virtual void ArrangeCore(Rect finalRect) { if (IsVisible) { double originX = finalRect.X + Margin.Left; double originY = finalRect.Y + Margin.Top; var sizeMinusMargins = new Size( Math.Max(0, finalRect.Width - Margin.Left - Margin.Right), Math.Max(0, finalRect.Height - Margin.Top - Margin.Bottom)); var size = sizeMinusMargins; if (HorizontalAlignment != HorizontalAlignment.Stretch) { size = size.WithWidth(Math.Min(size.Width, DesiredSize.Width)); } if (VerticalAlignment != VerticalAlignment.Stretch) { size = size.WithHeight(Math.Min(size.Height, DesiredSize.Height)); } size = LayoutHelper.ApplyLayoutConstraints(this, size); if (UseLayoutRounding) { size = new Size( Math.Ceiling(size.Width), Math.Ceiling(size.Height)); sizeMinusMargins = new Size( Math.Ceiling(sizeMinusMargins.Width), Math.Ceiling(sizeMinusMargins.Height)); } size = ArrangeOverride(size).Constrain(size); switch (HorizontalAlignment) { case HorizontalAlignment.Center: case HorizontalAlignment.Stretch: originX += (sizeMinusMargins.Width - size.Width) / 2; break; case HorizontalAlignment.Right: originX += sizeMinusMargins.Width - size.Width; break; } switch (VerticalAlignment) { case VerticalAlignment.Center: case VerticalAlignment.Stretch: originY += (sizeMinusMargins.Height - size.Height) / 2; break; case VerticalAlignment.Bottom: originY += sizeMinusMargins.Height - size.Height; break; } if (UseLayoutRounding) { originX = Math.Floor(originX); originY = Math.Floor(originY); } Bounds = new Rect(originX, originY, size.Width, size.Height); } } /// /// Positions child elements as part of a layout pass. /// /// The size available to the control. /// The actual size used. protected virtual Size ArrangeOverride(Size finalSize) { foreach (ILayoutable child in this.GetVisualChildren().OfType()) { child.Arrange(new Rect(finalSize)); } return finalSize; } /// /// Calls on the control on which a property changed. /// /// The event args. private static void AffectsMeasureInvalidate(PerspexPropertyChangedEventArgs e) { ILayoutable control = e.Sender as ILayoutable; control?.InvalidateMeasure(); } /// /// Calls on the control on which a property changed. /// /// The event args. private static void AffectsArrangeInvalidate(PerspexPropertyChangedEventArgs e) { ILayoutable control = e.Sender as ILayoutable; control?.InvalidateArrange(); } /// /// Tests whether a control's size can be changed by a layout pass. /// /// The control. /// True if the control's size can change; otherwise false. private static bool IsResizable(ILayoutable control) { return double.IsNaN(control.Width) || double.IsNaN(control.Height); } /// /// Tests whether any of a 's properties incude nagative values, /// a NaN or Infinity. /// /// The rect. /// True if the rect is invalid; otherwise false. private static bool IsInvalidRect(Rect rect) { return rect.Width < 0 || rect.Height < 0 || double.IsInfinity(rect.X) || double.IsInfinity(rect.Y) || double.IsInfinity(rect.Width) || double.IsInfinity(rect.Height) || double.IsNaN(rect.X) || double.IsNaN(rect.Y) || double.IsNaN(rect.Width) || double.IsNaN(rect.Height); } /// /// Tests whether any of a 's properties incude nagative values, /// a NaN or Infinity. /// /// The size. /// True if the size is invalid; otherwise false. private static bool IsInvalidSize(Size size) { return size.Width < 0 || size.Height < 0 || double.IsInfinity(size.Width) || double.IsInfinity(size.Height) || double.IsNaN(size.Width) || double.IsNaN(size.Height); } /// /// Ensures neither component of a is negative. /// /// The size. /// The non-negative size. private static Size NonNegative(Size size) { return new Size(Math.Max(size.Width, 0), Math.Max(size.Height, 0)); } /// /// Gets the layout root, together with its distance. /// /// /// A tuple containing the layout root and the root's distance from this control. /// private Tuple GetLayoutRoot() { var control = (IVisual)this; var distance = 0; while (control != null && !(control is ILayoutRoot)) { control = control.GetVisualParent(); ++distance; } return control != null ? Tuple.Create((ILayoutRoot)control, distance) : null; } } }