// ----------------------------------------------------------------------- // // Copyright 2014 MIT Licence. See licence.md for more information. // // ----------------------------------------------------------------------- namespace Perspex.Controls { using System; using System.Collections.Generic; using System.Collections.Specialized; using System.Linq; using Perspex.Collections; /// /// Base class for controls that can contain multiple children. /// /// /// Controls can be added to a by adding them to its /// collection. All children are layed out to fill the panel. /// public class Panel : Control, ILogical, IItemsPanel { private Controls children; private ILogical childLogicalParent; /// /// Initializes a new instance of the class. /// public Panel() { this.childLogicalParent = this; } /// /// Gets or sets the children of the . /// /// /// Even though this property can be set, the setter is only intended for use in object /// initializers. Assigning to this property does not change the underlying collection, /// it simply clears the existing collection and addds the contents of the assigned /// collection. /// public Controls Children { get { if (this.children == null) { this.children = new Controls(); this.children.CollectionChanged += this.ChildrenChanged; } return this.children; } set { Contract.Requires(value != null); if (this.children != value) { if (this.children != null) { this.ClearLogicalParent(this.children); this.children.CollectionChanged -= this.ChildrenChanged; } this.children = value; this.ClearVisualChildren(); if (this.children != null) { this.children.CollectionChanged += this.ChildrenChanged; this.AddVisualChildren(value); this.SetLogicalParent(value); this.InvalidateMeasure(); } } } } /// /// Gets the logical children of the control. /// IPerspexReadOnlyList ILogical.LogicalChildren { get { return this.children; } } /// ILogical IItemsPanel.ChildLogicalParent { get { return this.childLogicalParent; } set { this.childLogicalParent = value; this.SetLogicalParent(this.Children); } } /// protected virtual void OnChildrenAdded(IEnumerable child) { } /// protected virtual void OnChildrenRemoved(IEnumerable child) { } /// /// Clears for the specified controls. /// /// The controls. private void ClearLogicalParent(IEnumerable controls) { foreach (var control in controls) { ((ISetLogicalParent)control).SetParent(null); } } /// /// Sets for the specified controls. /// /// The controls. private void SetLogicalParent(IEnumerable controls) { var parent = this.childLogicalParent as Control; foreach (var control in controls) { ((ISetLogicalParent)control).SetParent(parent); } } /// /// Called when the collection changes. /// /// The event sender. /// The event args. private void ChildrenChanged(object sender, NotifyCollectionChangedEventArgs e) { List controls; // TODO: Handle Replace. switch (e.Action) { case NotifyCollectionChangedAction.Add: controls = e.NewItems.OfType().ToList(); this.SetLogicalParent(controls); this.AddVisualChildren(e.NewItems.OfType()); this.OnChildrenAdded(controls); break; case NotifyCollectionChangedAction.Remove: controls = e.OldItems.OfType().ToList(); this.ClearLogicalParent(e.OldItems.OfType()); this.RemoveVisualChildren(e.OldItems.OfType()); this.OnChildrenRemoved(controls); break; case NotifyCollectionChangedAction.Reset: controls = e.OldItems.OfType().ToList(); this.ClearLogicalParent(controls); this.ClearVisualChildren(); this.AddVisualChildren(this.children); this.OnChildrenAdded(controls); break; } this.InvalidateMeasure(); } } }