DotNet 4.8.1 build of DotNetBar

This commit is contained in:
2025-02-07 10:35:23 -05:00
parent 33439b63a0
commit 6b0a5d60f4
2609 changed files with 989814 additions and 7 deletions

View File

@@ -0,0 +1,26 @@
using System;
using System.Text;
using System.ComponentModel;
namespace DevComponents.DotNetBar
{
/// <summary>
/// Represents the cancelable event arguments with integer value.
/// </summary>
public class CancelIntValueEventArgs : CancelEventArgs
{
/// <summary>
/// Gets or sets the new value that will be used if event is not canceled.
/// </summary>
public int NewValue = 0;
/// <summary>
/// Indicates the source of the event.
/// </summary>
public eEventSource EventSource = eEventSource.Code;
}
/// <summary>
/// Defines delegate for cancelable events.
/// </summary>
public delegate void CancelIntValueEventHandler(object sender, CancelIntValueEventArgs e);
}

View File

@@ -0,0 +1,31 @@
using System;
using System.Text;
using System.ComponentModel;
namespace DevComponents.DotNetBar
{
/// <summary>
/// Represents the cancelable event arguments with object value.
/// </summary>
public class CancelObjectValueEventArgs : CancelEventArgs
{
/// <summary>
/// Initializes a new instance of the CancelObjectValueEventArgs class.
/// </summary>
/// <param name="o"></param>
public CancelObjectValueEventArgs(object o)
{
this.Data = o;
}
/// <summary>
/// Gets or sets the data connected to this event.
/// </summary>
public object Data = null;
}
/// <summary>
/// Defines delegate for cancelable events.
/// </summary>
public delegate void CancelObjectValueEventHandler(object sender, CancelObjectValueEventArgs e);
}

View File

@@ -0,0 +1,60 @@
using System;
using System.Text;
using System.Drawing;
namespace DevComponents.DotNetBar
{
/// <summary>
/// Provides data for CheckBoxItem rendering events.
/// </summary>
public class CheckBoxItemRenderEventArgs : EventArgs
{
/// <summary>
/// Gets or sets Graphics object group is rendered on.
/// </summary>
public Graphics Graphics = null;
/// <summary>
/// Gets or sets the reference to CheckBoxItem being rendered.
/// </summary>
public CheckBoxItem CheckBoxItem = null;
/// <summary>
/// ColorScheme object that is used to provide colors for rendering check box item in legacy styles like Office 2003. Office 2007 style
/// uses color tables provided by renderers.
/// </summary>
public ColorScheme ColorScheme = null;
/// <summary>
/// Indicates whether item is in Right-To-Left environment.
/// </summary>
public bool RightToLeft = false;
/// <summary>
/// Gets or sets the text font.
/// </summary>
public Font Font = null;
/// <summary>
/// Gets or sets the ItemPaintArgs reference.
/// </summary>
internal ItemPaintArgs ItemPaintArgs;
/// <summary>
/// Creates new instance of the object and provides default values.
/// </summary>
/// <param name="g">Reference to Graphics object</param>
/// <param name="item">Reference to CheckBoxItem</param>
/// <param name="cs">Reference to legacy ColorScheme</param>
/// <param name="f">Indicates the font for the text.</param>
/// <param name="rtl">Indicates whether item is in Right-To-Left environment.</param>
public CheckBoxItemRenderEventArgs(Graphics g, CheckBoxItem item, ColorScheme cs, Font f, bool rtl)
{
this.Graphics = g;
this.CheckBoxItem = item;
this.ColorScheme = cs;
this.RightToLeft = rtl;
this.Font = f;
}
}
}

View File

@@ -0,0 +1,29 @@
using System;
using System.Drawing;
using System.Text;
namespace DevComponents.DotNetBar
{
public class ColorItemRendererEventArgs : EventArgs
{
/// <summary>
/// Gets or sets Graphics object group is rendered on.
/// </summary>
public Graphics Graphics = null;
/// <summary>
/// Gets the reference to ButtonItem instance being rendered.
/// </summary>
public ColorItem ColorItem = null;
/// <summary>
/// Creates new instance of the object and initializes it with default values
/// </summary>
/// <param name="g">Reference to Graphics object.</param>
/// <param name="item">Reference to ColorItem object.</param>
public ColorItemRendererEventArgs(Graphics g, ColorItem item)
{
this.Graphics = g;
this.ColorItem = item;
}
}
}

View File

@@ -0,0 +1,38 @@
using System;
using System.Drawing;
using System.Text;
namespace DevComponents.DotNetBar
{
/// <summary>
/// Defines the event arguments class for ColorPickerDropDown ColorPreview event.
/// </summary>
public class ColorPreviewEventArgs : EventArgs
{
/// <summary>
/// Gets the color that is being previewed.
/// </summary>
public Color Color = Color.Empty;
/// <summary>
/// Gets the ColorItem if available for the color being previewed. This property can be null if there is no ColorItem connected with the color.
/// </summary>
public ColorItem ColorItem = null;
/// <summary>
/// Creates new instance of the object.
/// </summary>
/// <param name="c">Color being previewed.</param>
/// <param name="ci">ColorItem connected with the color.</param>
public ColorPreviewEventArgs(Color c, ColorItem ci)
{
this.Color = c;
this.ColorItem = ci;
}
}
/// <summary>
/// Defines delegate for ColorPreview event.
/// </summary>
public delegate void ColorPreviewEventHandler(object sender, ColorPreviewEventArgs e);
}

View File

@@ -0,0 +1,43 @@
using System;
namespace DevComponents.DotNetBar
{
/// <summary>
/// Represents event arguments for DockTabClosing event.
/// </summary>
public class DockTabClosingEventArgs:EventArgs
{
/// <summary>
/// Indicates the DockContainerItem that is about to close.
/// </summary>
public readonly DockContainerItem DockContainerItem;
/// <summary>
/// Provides ability to cancel closing of the DockContainerItem. Default value is false.
/// </summary>
public bool Cancel=false;
/// <summary>
/// Set to true to automatically remove DockContainerItem from the Bar.Items collection after it is closed. Default value is false
/// which means that DockContainerItem will be kept in collection but it will be hidden after this event is complete.
/// </summary>
public bool RemoveDockTab=false;
/// <summary>
/// Returns source of the event: keyboard, mouse or code.
/// </summary>
public readonly eEventSource Source;
/// <summary>
/// Creates new instance of the class.
/// </summary>
/// <param name="item">Reference to DockContainerItem that is about to close</param>
public DockTabClosingEventArgs(DockContainerItem item, eEventSource source)
{
this.DockContainerItem=item;
this.Source=source;
}
}
/// <summary>
/// Delegate for DockTabClosing event.
/// </summary>
public delegate void DockTabClosingEventHandler(object sender, DockTabClosingEventArgs e);
}

View File

@@ -0,0 +1,59 @@
using System;
using System.Text;
namespace DevComponents.DotNetBar.Events
{
/// <summary>
/// Represents event arguments that provide information on source of action.
/// </summary>
public class EventSourceArgs : EventArgs
{
/// <summary>
/// Gets the source of the event.
/// </summary>
public readonly eEventSource Source = eEventSource.Code;
/// <summary>
/// Initializes a new instance of the EventSourceArgs class.
/// </summary>
/// <param name="source"></param>
public EventSourceArgs(eEventSource source)
{
Source = source;
}
}
/// <summary>
/// Delegate for the CancelableEventSource event.
/// </summary>
public delegate void CancelableEventSourceHandler(object sender, CancelableEventSourceArgs e);
/// <summary>
/// Represents event arguments that provide information on source of action and allow canceling of action.
/// </summary>
public class CancelableEventSourceArgs : EventSourceArgs
{
/// <summary>
/// Gets or sets whether event action will be canceled.
/// </summary>
public bool Cancel = false;
/// <summary>
/// Initializes a new instance of the EventSourceArgs class.
/// </summary>
/// <param name="source"></param>
public CancelableEventSourceArgs(eEventSource source)
: base(source)
{
}
/// <summary>
/// Initializes a new instance of the CancelableEventSourceArgs class.
/// </summary>
/// <param name="cancel"></param>
public CancelableEventSourceArgs(eEventSource source, bool cancel)
: base(source)
{
Cancel = cancel;
}
}
}

View File

@@ -0,0 +1,37 @@
using System;
using System.Text;
namespace DevComponents.DotNetBar
{
/// <summary>
/// Provides more information about MarkupLinkClick event.
/// </summary>
public class MarkupLinkClickEventArgs : EventArgs
{
/// <summary>
/// Gets the value of href attribute from the markup link that was clicked.
/// </summary>
public readonly string HRef = "";
/// <summary>
/// Gets the value of name attribute from the markup link that was clicked.
/// </summary>
public readonly string Name = "";
/// <summary>
/// Creates new instance of the object.
/// </summary>
/// <param name="name">Value of name attribute.</param>
/// <param name="href">Value of href attribute.</param>
public MarkupLinkClickEventArgs(string name, string href)
{
this.HRef = href;
this.Name = name;
}
}
/// <summary>
/// Defines delegate for MarkupLinkClick event.
/// </summary>
public delegate void MarkupLinkClickEventHandler(object sender, MarkupLinkClickEventArgs e);
}

View File

@@ -0,0 +1,33 @@
using System;
using System.Text;
using System.Drawing;
namespace DevComponents.DotNetBar
{
/// <summary>
/// Provides data for the RenderMdiSystemitem event.
/// </summary>
public class MdiSystemItemRendererEventArgs : EventArgs
{
/// <summary>
/// Gets or sets Graphics object group is rendered on.
/// </summary>
public Graphics Graphics = null;
/// <summary>
/// Gets or sets the reference to MdiSystemItem being rendered.
/// </summary>
public MDISystemItem MdiSystemItem = null;
/// <summary>
/// Creates new instance of the class and initializes it with default values.
/// </summary>
/// <param name="g">Reference to graphics object.</param>
/// <param name="mdi">Reference to MdiSystemItem being rendered.</param>
public MdiSystemItemRendererEventArgs(Graphics g, MDISystemItem mdi)
{
this.Graphics = g;
this.MdiSystemItem = mdi;
}
}
}

View File

@@ -0,0 +1,31 @@
using System;
using System.Text;
using System.Drawing;
namespace DevComponents.DotNetBar
{
/// <summary>
/// Provides data for the Navigation Pane rendering events.
/// </summary>
public class NavPaneRenderEventArgs : EventArgs
{
/// <summary>
/// Gets or sets Graphics object group is rendered on.
/// </summary>
public Graphics Graphics = null;
/// <summary>
/// Gets or sets the rendering bounds.
/// </summary>
public Rectangle Bounds = Rectangle.Empty;
/// <summary>
/// Creates new instance of the objects and initializes it with default values.
/// </summary>
public NavPaneRenderEventArgs(Graphics g, Rectangle bounds)
{
this.Graphics = g;
this.Bounds = bounds;
}
}
}

View File

@@ -0,0 +1,47 @@
using System;
using System.Text;
using System.Drawing;
namespace DevComponents.DotNetBar
{
/// <summary>
/// Provides data for the ProgressBarItem rendering events.
/// </summary>
public class ProgressBarItemRenderEventArgs : EventArgs
{
/// <summary>
/// Gets or sets Graphics object group is rendered on.
/// </summary>
public Graphics Graphics = null;
/// <summary>
/// Gets or sets the reference to ProgressBarItem being rendered.
/// </summary>
public ProgressBarItem ProgressBarItem = null;
/// <summary>
/// Indicates whether item is in Right-To-Left environment.
/// </summary>
public bool RightToLeft = false;
/// <summary>
/// Gets or sets the text font.
/// </summary>
public Font Font = null;
/// <summary>
/// Creates new instance of the object and provides default values.
/// </summary>
/// <param name="g">Reference to Graphics object</param>
/// <param name="item">Reference to ProgressBarItem</param>
/// <param name="f">Indicates the font for the text.</param>
/// <param name="rtl">Indicates whether item is in Right-To-Left environment.</param>
public ProgressBarItemRenderEventArgs(Graphics g, ProgressBarItem item, Font f, bool rtl)
{
this.Graphics = g;
this.ProgressBarItem = item;
this.RightToLeft = rtl;
this.Font = f;
}
}
}

View File

@@ -0,0 +1,32 @@
using System;
using System.Text;
namespace DevComponents.DotNetBar
{
/// <summary>
/// Provides data for the Quick Access Toolbar Customize dialog events.
/// </summary>
public class QatCustomizeDialogEventArgs : EventArgs
{
/// <summary>
/// Gets or sets whether to cancel the current operation. When showing the dialog this allows to cancel the showing. When dialog is closed
/// it allows to cancel the changes made on customize dialog.
/// </summary>
public bool Cancel = false;
/// <summary>
/// Gets or sets the reference to the form that is acting as dialog. You can set this value to your custom form to display it instead of
/// built-in dialog.
/// </summary>
public System.Windows.Forms.Form Dialog = null;
/// <summary>
/// Creates new instance of the object and initializes it with default values.
/// </summary>
/// <param name="dialog">Reference to the dialog being used for customization.</param>
public QatCustomizeDialogEventArgs(System.Windows.Forms.Form dialog)
{
this.Dialog = dialog;
}
}
}

View File

@@ -0,0 +1,32 @@
using System;
using System.Text;
using System.Drawing;
namespace DevComponents.DotNetBar
{
/// <summary>
/// Provides data for the Quick Access Toolbar Customize Item rendering events.
/// </summary>
public class QatCustomizeItemRendererEventArgs : EventArgs
{
/// <summary>
/// Gets or sets the reference to the item being rendered.
/// </summary>
public QatCustomizeItem CustomizeItem = null;
/// <summary>
/// Gets or sets the reference to graphics object.
/// </summary>
public Graphics Graphics = null;
/// <summary>
/// Creates new instance of the object and initializes it with default values.
/// </summary>
/// <param name="overflowItem">Reference to the customize item being rendered.</param>
/// <param name="g">Reference to the graphics object.</param>
public QatCustomizeItemRendererEventArgs(QatCustomizeItem customizeItem, Graphics g)
{
this.CustomizeItem = customizeItem;
this.Graphics = g;
}
}
}

View File

@@ -0,0 +1,32 @@
using System;
using System.Text;
using System.Drawing;
namespace DevComponents.DotNetBar
{
/// <summary>
/// Provides data for the Quick Access Toolbar Overflow item rendering events.
/// </summary>
public class QatOverflowItemRendererEventArgs : EventArgs
{
/// <summary>
/// Gets or sets the reference to the item being rendered.
/// </summary>
public QatOverflowItem OverflowItem = null;
/// <summary>
/// Gets or sets the reference to graphics object.
/// </summary>
public Graphics Graphics = null;
/// <summary>
/// Creates new instance of the object and initializes it with default values.
/// </summary>
/// <param name="overflowItem">Reference to the overflow item being rendered.</param>
/// <param name="g">Reference to the graphics object.</param>
public QatOverflowItemRendererEventArgs(QatOverflowItem overflowItem, Graphics g)
{
this.OverflowItem = overflowItem;
this.Graphics = g;
}
}
}

View File

@@ -0,0 +1,40 @@
using System;
using System.Text;
using System.Drawing;
namespace DevComponents.DotNetBar
{
/// <summary>
/// Represents events arguments for the Ribbon Control rendering events.
/// </summary>
public class RibbonControlRendererEventArgs : EventArgs
{
/// <summary>
/// Gets or sets Graphics control is rendered on.
/// </summary>
public Graphics Graphics = null;
/// <summary>
/// Gets the reference to RibbonControl instance being rendered.
/// </summary>
public RibbonControl RibbonControl = null;
/// <summary>
/// Gets whether Windows Vista Glass is enabled.
/// </summary>
public bool GlassEnabled = false;
internal ItemPaintArgs ItemPaintArgs = null;
/// <summary>
/// Creates new instance and initializes it with the default values.
/// </summary>
/// <param name="g">Reference to Graphics object</param>
/// <param name="rc">Reference to RibbonControl</param>
public RibbonControlRendererEventArgs(Graphics g, RibbonControl rc, bool glassEnabled)
{
this.Graphics = g;
this.RibbonControl = rc;
this.GlassEnabled = glassEnabled;
}
}
}

View File

@@ -0,0 +1,39 @@
using System;
using System.Text;
namespace DevComponents.DotNetBar
{
/// <summary>
/// Provides information for ribbon customization events.
/// </summary>
public class RibbonCustomizeEventArgs : EventArgs
{
/// <summary>
/// Gets or sets whether the menu popup will be cancelled. Default value is false.
/// </summary>
public bool Cancel = false;
/// <summary>
/// Gets or sets the reference to the object customize menu will be acting on. This could be an ButtonItem or any
/// BaseItem derived class as well as RibbonBar object.
/// </summary>
public object ContextObject = null;
/// <summary>
/// Gets or sets the reference to the popup menu that will be displayed. You can change the members of SubItems collection to add/remove/change
/// the context menu items that will be displayed.
/// </summary>
public BaseItem PopupMenu = null;
/// <summary>
/// Creates new instance of the object and initializes it with default values.
/// </summary>
/// <param name="contextObject">Reference to context object.</param>
/// <param name="popupMenuItem">Reference to popup menu item if any.</param>
public RibbonCustomizeEventArgs(object contextObject, BaseItem popupMenuItem)
{
this.ContextObject = contextObject;
this.PopupMenu = popupMenuItem;
}
}
}

View File

@@ -0,0 +1,48 @@
using System;
using System.Text;
namespace DevComponents.DotNetBar
{
public class RibbonPopupCloseEventArgs : EventArgs
{
/// <summary>
/// Gets or sets whether the closing of the ribbon menu is canceled.
/// </summary>
public bool Cancel = false;
/// <summary>
/// Gets or sets the source object that was cause of the menu closing. For example this could be reference to an item that was clicked.
/// Default value is null which indicates that there is no information about the object that caused closing available.
/// </summary>
/// <remarks>
/// <para>Following is the possible list of types that this property could be set to
/// and causes for closing:</para>
/// <list type="bullet">
/// <item>BaseItem - when an item is clicked the Source will be set to the instance
/// of the item that was clicked.</item>
/// <item>RibbonControl - when parent form RibbonControl is on loses the input
/// focus the Source will be set to the RibbonControl</item>
/// <item>RibbonTabItem - when tab menu is displayed and user clicks the same tab
/// to close the menu. The RibbonTabItem with EventSource=Code will be also set as
/// source when user double-clicks the tab to maximize the ribbon.</item>
/// <item>Any other type if RibbonControl.PopupRibbon method is called by your
/// code.</item>
/// </list>
/// </remarks>
public object Source = null;
/// <summary>
/// Gets or sets the source of the event.
/// </summary>
public eEventSource EventSource = eEventSource.Code;
/// <summary>
/// Creates new instance of the object.
/// </summary>
public RibbonPopupCloseEventArgs(object source, eEventSource eventSource)
{
this.Source = source;
this.EventSource = eventSource;
}
}
}

View File

@@ -0,0 +1,39 @@
using System;
using System.Text;
namespace DevComponents.DotNetBar
{
/// <summary>
/// Represents arguments for SerializeItem event which allows you to add custom serialization data to definitions saved by control.
/// </summary>
public class SerializeItemEventArgs : EventArgs
{
/// <summary>
/// Gets reference to item being serialized or de-serialized.
/// </summary>
public BaseItem Item = null;
/// <summary>
/// Gets reference to instance of XmlElement that item is serialized to or is being de-serialized from. You should not change any data directly on this element.
/// </summary>
public System.Xml.XmlElement ItemXmlElement = null;
/// <summary>
/// Gets the reference to XmlElement that you can serialize to or de-serialize any custom data from. You can add child elements or set the attributes on
/// this XmlElement when handling SerializeItem event. When handling DeserializeItem event you can load same data from this element.
/// </summary>
public System.Xml.XmlElement CustomXmlElement = null;
public SerializeItemEventArgs(BaseItem item, System.Xml.XmlElement itemXmlElement, System.Xml.XmlElement customXmlElement)
{
this.Item = item;
this.ItemXmlElement = itemXmlElement;
this.CustomXmlElement = customXmlElement;
}
}
/// <summary>
/// Defines delegate for SerializeItem event.
/// </summary>
public delegate void SerializeItemEventHandler(object sender, SerializeItemEventArgs e);
}

View File

@@ -0,0 +1,28 @@
using System;
using System.Text;
using System.Drawing;
namespace DevComponents.DotNetBar
{
public class SideBarPanelItemRendererEventArgs : EventArgs
{
public readonly SideBarPanelItem SideBarPanelItem = null;
/// <summary>
/// Gets or sets the reference to graphics object.
/// </summary>
public Graphics Graphics = null;
internal ItemPaintArgs ItemPaintArgs = null;
/// <summary>
/// Initializes a new instance of the SideBarPanelItemRendererEventArgs class.
/// </summary>
/// <param name="sideBarPanelItem"></param>
/// <param name="graphics"></param>
public SideBarPanelItemRendererEventArgs(SideBarPanelItem sideBarPanelItem, Graphics graphics)
{
SideBarPanelItem = sideBarPanelItem;
Graphics = graphics;
}
}
}

View File

@@ -0,0 +1,29 @@
using System;
using System.Text;
using System.Drawing;
namespace DevComponents.DotNetBar
{
public class SideBarRendererEventArgs : EventArgs
{
public readonly SideBar SideBar = null;
/// <summary>
/// Gets or sets the reference to graphics object.
/// </summary>
public Graphics Graphics = null;
internal ItemPaintArgs ItemPaintArgs = null;
/// <summary>
/// Initializes a new instance of the SideBarRendererEventArgs class.
/// </summary>
/// <param name="sideBar"></param>
/// <param name="graphics"></param>
public SideBarRendererEventArgs(SideBar sideBar, Graphics graphics)
{
SideBar = sideBar;
Graphics = graphics;
}
}
}

View File

@@ -0,0 +1,35 @@
using System;
using System.Text;
using System.Drawing;
namespace DevComponents.DotNetBar
{
/// <summary>
/// Provides data for the Slider item rendering events.
/// </summary>
public class SliderItemRendererEventArgs : EventArgs
{
/// <summary>
/// Gets or sets the reference to the item being rendered.
/// </summary>
public SliderItem SliderItem = null;
/// <summary>
/// Gets or sets the reference to graphics object.
/// </summary>
public Graphics Graphics = null;
internal ItemPaintArgs ItemPaintArgs = null;
/// <summary>
/// Creates new instance of the object and initializes it with default values.
/// </summary>
/// <param name="overflowItem">Reference to the Slider item being rendered.</param>
/// <param name="g">Reference to the graphics object.</param>
public SliderItemRendererEventArgs(SliderItem item, Graphics g)
{
this.SliderItem = item;
this.Graphics = g;
}
}
}