// ----------------------------------------------------------------------- // // Copyright 2014 MIT Licence. See licence.md for more information. // // ----------------------------------------------------------------------- namespace Perspex.Layout { using System; using System.Linq; using Perspex.VisualTree; using Serilog; using Serilog.Core.Enrichers; /// /// 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 ILogger layoutLog; /// /// Initializes static members of the class. /// static Layoutable() { Layoutable.AffectsMeasure(Visual.IsVisibleProperty); Layoutable.AffectsMeasure(Layoutable.WidthProperty); Layoutable.AffectsMeasure(Layoutable.HeightProperty); Layoutable.AffectsMeasure(Layoutable.MinWidthProperty); Layoutable.AffectsMeasure(Layoutable.MaxWidthProperty); Layoutable.AffectsMeasure(Layoutable.MinHeightProperty); Layoutable.AffectsMeasure(Layoutable.MaxHeightProperty); Layoutable.AffectsMeasure(Layoutable.MarginProperty); Layoutable.AffectsMeasure(Layoutable.HorizontalAlignmentProperty); Layoutable.AffectsMeasure(Layoutable.VerticalAlignmentProperty); } /// /// Initializes a new instance of the class. /// public Layoutable() { this.layoutLog = Log.ForContext(new[] { new PropertyEnricher("Area", "Layout"), new PropertyEnricher("SourceContext", this.GetType()), new PropertyEnricher("Id", this.GetHashCode()), }); } /// /// Gets or sets the width of the element. /// public double Width { get { return this.GetValue(WidthProperty); } set { this.SetValue(WidthProperty, value); } } /// /// Gets or sets the height of the element. /// public double Height { get { return this.GetValue(HeightProperty); } set { this.SetValue(HeightProperty, value); } } /// /// Gets or sets the minimum width of the element. /// public double MinWidth { get { return this.GetValue(MinWidthProperty); } set { this.SetValue(MinWidthProperty, value); } } /// /// Gets or sets the maximum width of the element. /// public double MaxWidth { get { return this.GetValue(MaxWidthProperty); } set { this.SetValue(MaxWidthProperty, value); } } /// /// Gets or sets the minimum height of the element. /// public double MinHeight { get { return this.GetValue(MinHeightProperty); } set { this.SetValue(MinHeightProperty, value); } } /// /// Gets or sets the maximum height of the element. /// public double MaxHeight { get { return this.GetValue(MaxHeightProperty); } set { this.SetValue(MaxHeightProperty, value); } } /// /// Gets or sets the margin around the element. /// public Thickness Margin { get { return this.GetValue(MarginProperty); } set { this.SetValue(MarginProperty, value); } } /// /// Gets or sets the element's preferred horizontal alignment in its parent. /// public HorizontalAlignment HorizontalAlignment { get { return this.GetValue(HorizontalAlignmentProperty); } set { this.SetValue(HorizontalAlignmentProperty, value); } } /// /// Gets or sets the element's preferred vertical alignment in its parent. /// public VerticalAlignment VerticalAlignment { get { return this.GetValue(VerticalAlignmentProperty); } set { this.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 this.GetValue(UseLayoutRoundingProperty); } set { this.SetValue(UseLayoutRoundingProperty, value); } } /// /// Gets the available size passed in the previous layout pass, if any. /// Size? ILayoutable.PreviousMeasure { get { return this.previousMeasure; } } /// /// Gets the layout rect passed in the previous layout pass, if any. /// Rect? ILayoutable.PreviousArrange { get { return this.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 || !this.IsMeasureValid || this.previousMeasure != availableSize) { this.IsMeasureValid = true; var desiredSize = this.MeasureCore(availableSize).Constrain(availableSize); if (IsInvalidSize(desiredSize)) { throw new InvalidOperationException("Invalid size returned for Measure."); } this.DesiredSize = desiredSize; this.previousMeasure = availableSize; this.layoutLog.Verbose("Measure requested {DesiredSize}", this.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 (!this.IsMeasureValid) { return; } if (force || !this.IsArrangeValid || this.previousArrange != rect) { this.layoutLog.Verbose("Arrange to {Rect} ", rect); this.IsArrangeValid = true; this.ArrangeCore(rect); this.previousArrange = rect; } } /// /// Invalidates the measurement of the control and queues a new layout pass. /// public void InvalidateMeasure() { var parent = this.GetVisualParent(); if (this.IsMeasureValid) { this.layoutLog.Verbose("Invalidated measure"); } this.IsMeasureValid = false; this.IsArrangeValid = false; this.previousMeasure = null; this.previousArrange = null; if (parent != null && IsResizable(parent)) { parent.InvalidateMeasure(); } else { var root = this.GetLayoutRoot(); if (root != null && root.Item1.LayoutManager != null) { root.Item1.LayoutManager.InvalidateMeasure(this, root.Item2); } } } /// /// Invalidates the arrangement of the control and queues a new layout pass. /// public void InvalidateArrange() { var root = this.GetLayoutRoot(); if (this.IsArrangeValid) { this.layoutLog.Verbose("Arrange measure"); } this.IsArrangeValid = false; this.previousArrange = null; if (root != null && root.Item1.LayoutManager != 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 (this.IsVisible) { this.ApplyTemplate(); var constrained = LayoutHelper .ApplyLayoutConstraints(this, availableSize) .Deflate(this.Margin); var measured = this.MeasureOverride(constrained); var width = measured.Width; var height = measured.Height; if (!double.IsNaN(this.Width)) { width = this.Width; } width = Math.Min(width, this.MaxWidth); width = Math.Max(width, this.MinWidth); if (!double.IsNaN(this.Height)) { height = this.Height; } height = Math.Min(height, this.MaxHeight); height = Math.Max(height, this.MinHeight); return new Size(width, height).Inflate(this.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); } 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 (this.IsVisible) { double originX = finalRect.X + this.Margin.Left; double originY = finalRect.Y + this.Margin.Top; var sizeMinusMargins = new Size( Math.Max(0, finalRect.Width - this.Margin.Left - this.Margin.Right), Math.Max(0, finalRect.Height - this.Margin.Top - this.Margin.Bottom)); var size = sizeMinusMargins; if (this.HorizontalAlignment != HorizontalAlignment.Stretch) { size = size.WithWidth(Math.Min(size.Width, this.DesiredSize.Width)); } if (this.VerticalAlignment != VerticalAlignment.Stretch) { size = size.WithHeight(Math.Min(size.Height, this.DesiredSize.Height)); } size = LayoutHelper.ApplyLayoutConstraints(this, size); if (this.UseLayoutRounding) { size = new Size(Math.Ceiling(size.Width), Math.Ceiling(size.Height)); } size = this.ArrangeOverride(size).Constrain(size); switch (this.HorizontalAlignment) { case HorizontalAlignment.Center: originX += (sizeMinusMargins.Width - size.Width) / 2; break; case HorizontalAlignment.Right: originX += sizeMinusMargins.Width - size.Width; break; } switch (this.VerticalAlignment) { case VerticalAlignment.Center: originY += (sizeMinusMargins.Height - size.Height) / 2; break; case VerticalAlignment.Bottom: originY += sizeMinusMargins.Height - size.Height; break; } if (this.UseLayoutRounding) { originX = Math.Floor(originX); originY = Math.Floor(originY); size = this.ArrangeOverride(size).Constrain(size); } this.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; if (control != null) { 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; if (control != null) { 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); } /// /// 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; } } }