3rdpartylibs/fastreports/Fast-Report/FastReport.DesignExt/Design/ToolWindows/ToolWindowBase.cs

using System;
using System.Drawing;
using System.Windows.Forms;
using FastReport.Controls;
using FastReport.Forms;
using FastReport.Utils;
#if !MONO
using FastReport.DevComponents.DotNetBar;
#endif

namespace FastReport.Design.ToolWindows
{
    /// <summary>
    /// Base class for all tool windows such as "Properties", "Data Dictionary" etc.
    /// </summary>
    /// <remarks>
    /// <para>Use this class to create own tool window. To do this:</para>
    /// <para>- in the constructor, set the <b>Name</b> and <b>Image</b> properties and create necessary controls. 
    /// The <b>Name</b> will be used to restore window's state;</para>
    /// <para>- override the <b>SelectionChanged</b> method. This method is called when current selection
    /// is changed. In this method, you should update buttons state to reflect the current selection. 
    /// Selected objects can be accessed via <b>Designer.SelectedObjects</b> property;</para>
    /// <para>- override the <b>UpdateContent</b> method. This method is called when the report
    /// content was changed. Typically you need to do the same actions in <b>SelectionChanged</b> and
    /// <b>UpdateContent</b> methods;</para>
    /// <para>- to register a toolwindow, add its type to the <see cref="DesignerPlugins"/> global collection:
    /// <code>
    /// DesignerPlugins.Add(typeof(MyToolWindow));
    /// </code>
    /// </para>
    /// </remarks>
#if !MONO
    public class ToolWindowBase : DockContainerItem, IDesignerPlugin
#else
    public class ToolWindowBase : PageControlPage, IDesignerPlugin
#endif
    {
        #region Fields
        private Designer designer;
        private bool locked;
#if !MONO
        private eShortcut shortcut;
#endif
        #endregion

        #region Properties
        /// <summary>
        /// Gets the report designer.
        /// </summary>
        public Designer Designer
        {
            get { return designer; }
        }

        /// <summary>
        /// Gets a value indicating that window is locked.
        /// </summary>
        public bool Locked
        {
            get { return locked; }
        }

        /// <inheritdoc/>
        public string PluginName
        {
            get { return Name; }
        }

#if !MONO
        /// <summary>
        /// Gets or sets shortcut keys used to show this toolwindow.
        /// </summary>
        public eShortcut Shortcut
        {
            get { return shortcut; }
            set { shortcut = value; }
        }

        /// <summary>
        /// Gets or sets a value indicating that the toolwindow can be closed by the x button.
        /// </summary>
        public bool CanHide
        {
            get { return Bar.CanHide; }
            set { Bar.CanHide = value; }
        }

        internal Bar Bar
        {
            get
            {
                BaseItem item = this;
                while (item.Parent != null)
                    item = item.Parent;
                return item.ContainerControl as Bar;
            }
        }

        /// <summary>
        /// Gets a parent control that contains all controls.
        /// </summary>
        /// <remarks>
        /// Add your control to the parent control Controls collection.
        /// </remarks>
        public Control ParentControl
        {
            get { return Control; }
        }
#endif
        #endregion

        #region Private Methods
#if !MONO
        private Bar CreateBar()
        {
            Bar bar = new Bar();
            bar.Name = Name + "Bar";
            bar.CanHide = true;
            bar.CloseSingleTab = true;
            bar.GrabHandleStyle = eGrabHandleStyle.Caption;
            bar.LayoutType = eLayoutType.DockContainer;
            bar.Stretch = true;
            bar.AutoSyncBarCaption = true;

            DockTo(bar);
            return bar;
        }
#endif
        #endregion

        #region Public Methods
#if !MONO
        internal void DoDefaultDock()
        {
            DockTo(Designer.DotNetBarManager.RightDockSite, Designer.DataWindow, eDockSide.Top);
        }

        internal void DockTo(DockSite site)
        {
            site.GetDocumentUIManager().Dock(CreateBar());
        }

        internal void DockTo(DockSite site, ToolWindowBase referenceWindow, eDockSide side)
        {
            site.GetDocumentUIManager().Dock(referenceWindow.Bar, CreateBar(), side);
        }

        internal void DockTo(ToolWindowBase win)
        {
            DockTo(win.Bar);
        }

        internal void DockTo(Bar bar)
        {
            bar.Controls.Add(Control);
            bar.Items.Add(this);
        }

        /// <summary>
        /// Shows the toolwindow.
        /// </summary>
        public void Show()
        {
            // force SetDockContainerVisible to do the work
            Visible = false;
            BarUtilities.SetDockContainerVisible(this, true);
            Activate();
        }

        /// <summary>
        /// Hides the toolwindow.
        /// </summary>
        public void Hide()
        {
            BarUtilities.SetDockContainerVisible(this, false);
        }

        internal void Close()
        {
            Bar bar = Bar;
            if (bar != null)
                bar.CloseDockTab(this);
        }

        internal void Activate()
        {
            Bar bar = Bar;
            if (bar != null)
            {
                bar.SelectedDockContainerItem = this;
                if (bar.AutoHide)
                    bar.AutoHide = false;
            }
        }

        internal ButtonItem AddButton(EventHandler click)
        {
            return AddButton(-1, click);
        }

        internal ButtonItem AddButton(int imageIndex, EventHandler click)
        {
            ButtonItem button = new ButtonItem();
            button.ImageIndex = imageIndex;
            if (click != null)
                button.Click += click;
            return button;
        }

        internal void UpdateImages(SubItemsCollection items)
        {
            foreach (BaseItem item in items)
            {
                ButtonItem b = item as ButtonItem;
                if (b != null && b.ImageIndex != -1)
                    b.Image = Designer.GetImage(b.ImageIndex);
                UpdateImages(item.SubItems);
            }
        }
#else
        internal ToolStripButton AddButton(int imageIndex, EventHandler click)
        {
            ToolStripButton btn = new ToolStripButton();
            btn.Image = this.GetImage(imageIndex);
            btn.Click += click;
            return btn;
        }

        internal ToolStripMenuItem AddMenuItem(int imageIndex, EventHandler click)
        {
            ToolStripMenuItem mi = new ToolStripMenuItem();
            mi.Image = this.GetImage(imageIndex);
            mi.Click += click;
            return mi;
        }
        internal ToolStripMenuItem AddMenuItem(EventHandler click)
        {
            return AddMenuItem(-1, click);
        }

#endif
        #endregion

        #region IDesignerPlugin
        /// <inheritdoc/>
        public virtual void SaveState()
        {
        }

        /// <inheritdoc/>
        public virtual void RestoreState()
        {
        }

        /// <inheritdoc/>
        public virtual void SelectionChanged()
        {
        }

        /// <inheritdoc/>
        public virtual void UpdateContent()
        {
        }

        /// <inheritdoc/>
        public virtual void Lock()
        {
            locked = true;
        }

        /// <inheritdoc/>
        public virtual void Unlock()
        {
            locked = false;
            UpdateContent();
        }

        /// <inheritdoc/>
        public virtual void Localize()
        {
        }

        /// <summary>
        /// Implements <see cref="IDesignerPlugin.GetOptionsPage"/> method.
        /// </summary>
        /// <returns>The options page, if implemented; otherwise, <b>null</b>.</returns>
        public virtual DesignerOptionsPage GetOptionsPage()
        {
            return null;
        }

        /// <inheritdoc/>
        public virtual void UpdateUIStyle()
        {
        }

        /// <inheritdoc/>
#if !MONO
        public new virtual void UpdateDpiDependencies()
        {
            if (Bar != null)
            {
                Bar.UpdateDpiDependencies();
                // this will take effect if high dpi is not enabled in DpiHelper 
                Bar.DockTabStripHeight = Designer.LogicalToDevice(25);
                Bar.PaddingLeft = -2;
                Bar.PaddingRight = -2;
                Bar.PaddingTop = -2;
                Bar.PaddingBottom = -2;
            }
            base.UpdateDpiDependencies();
        }
#else
        public virtual void UpdateDpiDependencies()
        {
        }
#endif
        #endregion

        /// <summary>
        /// Initializes a new instance of the <see cref="ToolWindowBase"/> class with default settings.
        /// </summary>
        /// <param name="designer">The report designer.</param>
        /// <remarks>
        /// You don't need to call this constructor. The designer will do this automatically.
        /// </remarks>
        public ToolWindowBase(Designer designer) : base()
        {
            this.designer = designer;
#if !MONO
            shortcut = eShortcut.None;
            Control = new PanelDockContainer();
#endif
        }
    }

}