Class RadDock
Represents the major control in the Telerik.WinForms.UI.Docking assembly. Root component for the entire docking framework.
Provides highly extensible and completely transparent transaction-based API for managing a set of tool and document windows registered within the docking framework.
Mimics the user experience found in Microsoft Visual Studio - dockable panes, tabbed documents, document navigation plus much more.
Inherited Members
Namespace: Telerik.WinControls.UI.Docking
Assembly: Telerik.WinControls.RadDock.dll
Syntax
[TelerikToolboxCategory("Containers")]
public class RadDock : RadSplitContainer, INotifyPropertyChanged, ISupportInitializeNotification, ISupportInitialize, IComponentTreeHandler, ILayoutHandler, IPCHost, IAnalyticsProvider, ILoadObsoleteDockingManagerXml, IMessageListener
Constructors
RadDock()
Fields
DockSplitContainerThemeClassName
Declaration
public const string DockSplitContainerThemeClassName = "DockSplitContainer"
Field Value
System.
|
Properties
ActiveFloatingWindows
Declaration
public ReadOnlyCollection<FloatingWindow> ActiveFloatingWindows { get; }
Property Value
System.
|
ActiveWindow
Gets or sets the DockWindow instance, which is currently active (meaning it contains the Keyboard focus).
Declaration
public DockWindow ActiveWindow { get; set; }
Property Value
AllowDrop
Declaration
public override bool AllowDrop { get; set; }
Property Value
System.
|
AutoDetectMdiChildren
Gets or sets a value indicating whether [auto detect MDI child].
Declaration
public bool AutoDetectMdiChildren { get; set; }
Property Value
System.
|
AutoHideAnimation
Determines what animation will be used when displaying/hiding auto-hidden windows.
Declaration
public AutoHideAnimateMode AutoHideAnimation { get; set; }
Property Value
AutoHideAnimationDuration
Gets or sets the duration of the auto hide window animation. The default value is 200 milliseconds.
Declaration
public int AutoHideAnimationDuration { get; set; }
Property Value
System. The duration of the auto hide window animation. The default value is 200 milliseconds. |
AutoHidePopup
AutoScroll
Declaration
public override bool AutoScroll { get; set; }
Property Value
System.
|
AutoScrollMargin
Declaration
public Size AutoScrollMargin { get; set; }
Property Value
System.
|
AutoScrollMinSize
Declaration
public Size AutoScrollMinSize { get; set; }
Property Value
System.
|
AutoSize
Gets or sets whether the edit control is auto-sized
Declaration
public override bool AutoSize { get; set; }
Property Value
System.
|
Overrides
BackColor
RadDock consists of multiple visual elements and separate settings are provided to customize their appearance. Current BackColor property might be ignored.
Declaration
public override Color BackColor { get; set; }
Property Value
System.
|
Overrides
Collapsed
Declaration
public bool Collapsed { get; set; }
Property Value
System.
|
CommandManager
Gets the Rad
Declaration
public RadDockCommandManager CommandManager { get; }
Property Value
ContentRectangle
Overrides the content rectangle to add any visible auto-hide tabstrips to the calculations.
Declaration
public override Rectangle ContentRectangle { get; }
Property Value
System.
|
Overrides
DockingGuidesTemplate
Gets or sets the template, which defines the appearance of the guides displayed upon drag-and-drop operation.
Declaration
public IDockingGuidesTemplate DockingGuidesTemplate { get; set; }
Property Value
DockWindows
Gets a collection with all the currently attached Dock
Declaration
public DockWindowCollection DockWindows { get; }
Property Value
DocumentManager
Gets the Document
Declaration
public DocumentManager DocumentManager { get; }
Property Value
DocumentTabsAlignment
Gets or sets the alignment of the TabStripElement in all DocumentTabStrip instances.
Declaration
public TabStripAlignment DocumentTabsAlignment { get; set; }
Property Value
DocumentTabsTextOrientation
Gets or sets the text orientation of the TabStripElement in all ToolTabStrip instances.
Declaration
public TabStripTextOrientation DocumentTabsTextOrientation { get; set; }
Property Value
DocumentTabsVisible
Determines whether the TabStripElement in DocumentTabStrip instances is visible.
Declaration
public bool DocumentTabsVisible { get; set; }
Property Value
System.
|
DragDropAllowedDockStates
Gets or sets the allowed dock states for a committing drag-and-drop operation.
Declaration
public AllowedDockState DragDropAllowedDockStates { get; set; }
Property Value
DragDropMode
Gets or sets the mode used by the DragDropService when a drag-and-drop request is made.
Declaration
public DragDropMode DragDropMode { get; set; }
Property Value
Enabled
Declaration
public bool Enabled { get; set; }
Property Value
System.
|
EnableFloatingWindowSnapping
Determines whether all floating windows' will snap to their edges.
Declaration
public bool EnableFloatingWindowSnapping { get; set; }
Property Value
System.
|
EnableFloatingWindowTheming
Determines whether all floating windows' frames within the framework will be themed using Telerik's TPF or will be let with their system appearance.
Declaration
public bool EnableFloatingWindowTheming { get; set; }
Property Value
System.
|
FloatingWindows
Gets a list of the floating windows. Can contain duplicates, empty or hidden toolwindows which are used internally as re-dock targets.
Declaration
public FloatingWindowCollection FloatingWindows { get; }
Property Value
ForeColor
RadDock consists of multiple visual elements and separate settings are provided to customize their appearance. Current ForeColor property might be ignored.
Declaration
public override Color ForeColor { get; set; }
Property Value
System.
|
Overrides
GuidToNameMappings
Declaration
public GuidToNameMappingCollection GuidToNameMappings { get; }
Property Value
IsDragging
Determines whether the DragDropService is currently working (a drag-and-drop operation is running).
Declaration
public bool IsDragging { get; }
Property Value
System.
|
IsInTransactionBlock
Determines whether the RadDock is currently in a transaction (internal operation).
Declaration
public bool IsInTransactionBlock { get; }
Property Value
System.
|
Item[String]
Gets DockWindow instance with the corresponding Name.
Declaration
public DockWindow this[string dockWindowName] { get; }
Parameters
System.
|
Property Value
Dock DockWindow instance with matching Name. Null (Nothing in VB.NET) otherwise. |
LayoutStrategyType
Gets or sets the Type to be used when a new RadSplitContainer instance is internally created and a layout strategy is initialized for it. Allows plugging of completely custom layout behavior.
Declaration
public Type LayoutStrategyType { get; set; }
Property Value
System.
|
MainDocumentContainer
Gets or sets the document container for this RadDock instance. This property is used primarily for serialization purposes and is not intended to be used directly by code.
Declaration
public DocumentContainer MainDocumentContainer { get; set; }
Property Value
MainDocumentContainerVisible
Determines whether the main document container is visible.
Declaration
public bool MainDocumentContainerVisible { get; set; }
Property Value
System.
|
MdiChildren
Gets an array with all the standard Forms added as TabbedDocument to this RadDock instance.
Declaration
public Form[] MdiChildren { get; }
Property Value
System.
|
MdiChildrenDockType
Gets or sets a value indicating dock type of MDI child host windows added to RadDock.
Declaration
public DockType MdiChildrenDockType { get; set; }
Property Value
Padding
Declaration
public Padding Padding { get; set; }
Property Value
System.
|
QuickNavigatorSettings
ReleaseMemoryOnClose
Declaration
public bool ReleaseMemoryOnClose { get; set; }
Property Value
System.
|
RootContainer
SerializableAutoHideContainer
Gets an instance of DockAutoHideSerializationContainer that contains information about auto-hidden windows which have been set up through designer or xml file. This nethod is no intended for use directly from your code.
Declaration
public DockAutoHideSerializationContainer SerializableAutoHideContainer { get; }
Property Value
SerializableFloatingWindows
Gets an instance of FloatingWindowList that contains information about floating windows which have been set up through designer or xml file. This nethod is no intended for use directly from your code.
Declaration
public FloatingWindowList SerializableFloatingWindows { get; }
Property Value
ShowDocumentCloseButton
Determines whether DocumentTabStrip instances will display a Close Button next to each item.
Declaration
public bool ShowDocumentCloseButton { get; set; }
Property Value
System.
|
ShowDocumentPinButton
Determines whether DocumentTabStrip instances will display a Pin Button next to each item.
Declaration
public bool ShowDocumentPinButton { get; set; }
Property Value
System.
|
ShowToolCloseButton
Determines whether ToolTabStrip instances will display Close Button next to each item.
Declaration
public bool ShowToolCloseButton { get; set; }
Property Value
System.
|
SingleScreen
Gets or sets a value indicating whether the RadDock control behavior and layout apply only to primary screen.
Declaration
public bool SingleScreen { get; set; }
Property Value
System.
|
Site
Declaration
public override ISite Site { get; set; }
Property Value
System.
|
Overrides
SizeInfo
SplitContainer
SplitPanels
SplitterWidth
Declaration
public override int SplitterWidth { get; set; }
Property Value
System.
|
Overrides
TabStripsLayout
Text
This property is not relevant for this class.
Declaration
public override string Text { get; set; }
Property Value
System.
|
Overrides
ThemeClassName
Declaration
public override string ThemeClassName { get; set; }
Property Value
System.
|
Overrides
ToolTabsAlignment
Gets or sets the alignment of the TabStripElement in all ToolTabStrip instances.
Declaration
public TabStripAlignment ToolTabsAlignment { get; set; }
Property Value
ToolTabsTextOrientation
Gets or sets the text orientation of the TabStripElement in all ToolTabStrip instances.
Declaration
public TabStripTextOrientation ToolTabsTextOrientation { get; set; }
Property Value
ToolTabsVisible
Determines whether the TabStripElement in ToolTabStrip instances is visible.
Declaration
public bool ToolTabsVisible { get; set; }
Property Value
System.
|
ToolWindowInsertOrder
Gets or sets the insert order to be used when adding dock windows to a ToolTabStrip.
Declaration
public DockWindowInsertOrder ToolWindowInsertOrder { get; set; }
Property Value
XmlSerializationInfo
Gets the serialization info for RadDock used by Save/Load loyout methods to persist grid settings to/from XML. By default, or when set to null the ComponentXmlSerializationInfo provided by GetDefaultXmlSerializationInfo() will be used.
Declaration
public ComponentXmlSerializationInfo XmlSerializationInfo { get; set; }
Property Value
Methods
ActivateMdiChild(Form)
Activates the MDI child of a form.
Declaration
public void ActivateMdiChild(Form form)
Parameters
System. The child form to activate. |
ActivateWindow(DockWindow)
Activates the specified DockWindow and gives it the keyboard focus.
Declaration
public bool ActivateWindow(DockWindow window)
Parameters
Dock
|
Returns
System.
|
ActivateWindow(DockWindow, Boolean)
Activates the specified window and gives it the keyboard focus.
Declaration
protected virtual bool ActivateWindow(DockWindow window, bool forceNotify)
Parameters
Dock
|
System. True to force ActiveWindowChanging and ActiveWindowChanged notifications, false otherwise. Sometimes a transaction may change the current active window several times and the method needs to know when to raise the notifications. |
Returns
System.
|
AddDocument(DockWindow)
Adds the specified DockWindow instance to the main document tab strip.
Declaration
public void AddDocument(DockWindow dockWindow)
Parameters
Dock The dock window. |
AddDocument(DockWindow, DockPosition)
Adds the the specified DockWindow instance at the specified dock position, aligned with the main document tabstrip.
Declaration
public void AddDocument(DockWindow dockWindow, DockPosition position)
Parameters
Dock The dock window. |
Dock The desired dock position. |
AddDocument(DockWindow, DockWindow, DockPosition)
Adds the the specified DockWindow instance to the specified DocumentTabStrip instance.
Declaration
public void AddDocument(DockWindow dockWindow, DockWindow target, DockPosition position)
Parameters
Dock The dock window. |
Dock The target of the dock opeation. |
Dock The desired dock position. |
AddDocument(DockWindow, DocumentTabStrip, DockPosition)
Adds the specified DockWindow instance to a new DocumentTabStrip instance.
Declaration
public void AddDocument(DockWindow dockWindow, DocumentTabStrip tabStrip, DockPosition position)
Parameters
Dock The dock window. |
Document The DocumentTabStrip, which is the target of the operation. |
Dock The position. |
AddDocuments(DockWindow[], DocumentTabStrip, DockPosition)
Adds a collection of DockWindows to a new DocumentTabStrip instance.
Declaration
public void AddDocuments(DockWindow[] dockWindows, DocumentTabStrip tabStrip, DockPosition position)
Parameters
Dock The dock windows. |
Document The DocumentTabStrip, which is the target of the operation. |
Dock The position. |
ApplySplitterWidth(Int32)
Declaration
public override void ApplySplitterWidth(int splitterWidth)
Parameters
System.
|
Overrides
AutoHideWindow(DockWindow)
Makes the specified DockWindow auto-hidden.
Declaration
public void AutoHideWindow(DockWindow window)
Parameters
Dock
|
AutoHideWindows(IEnumerable<DockWindow>, AutoHidePosition)
Makes the specified DockWindow collection auto-hidden.
Declaration
public void AutoHideWindows(IEnumerable<DockWindow> windows, AutoHidePosition position)
Parameters
System.
|
Auto The edge at which the windows should be auto-hidden against. |
BeginInit()
BeginTransactionBlock()
Opens a transaction (batch) operation. This is used by the framework to indicate some lengthy operations, during which no updates should be performed.
Declaration
public void BeginTransactionBlock()
BeginTransactionBlock(Boolean)
Opens a transaction (batch) operation. This is used by the framework to indicate some lengthy operations, during which no updates should be performed.
Declaration
public void BeginTransactionBlock(bool saveActiveWindow)
Parameters
System.
|
BeginUpdate()
Begins an update operation. Internally used by the transaction mechanism.
Declaration
public void BeginUpdate()
CallOnControlTreeChanged(ControlTreeChangedEventArgs)
Calls the OnControlTreeChanged method. This method is used internally.
Declaration
public virtual void CallOnControlTreeChanged(ControlTreeChangedEventArgs args)
Parameters
CanChangeWindowState(DockWindow, DockState)
Determines whether the provided dock state may be applied to the specified DockWindow.
Declaration
public bool CanChangeWindowState(DockWindow window, DockState state)
Parameters
Dock
|
Dock
|
Returns
System.
|
CanChangeWindowState(DockWindow, DockState, Boolean)
Determines whether the specified window's DockState value can be changed to the specified new one.
Declaration
protected virtual bool CanChangeWindowState(DockWindow window, DockState state, bool raiseChanging)
Parameters
Dock The window, which should be examined. |
Dock The new target state. |
System. True to raise DockStateChanging notification, false otherwise. |
Returns
System. True if the state can be changed, false otherwise. |
CleanUp()
Performs a clean-up pass which removes all unnecessary internally created split panels and/or collapses or disposes them.
Declaration
public void CleanUp()
CloseAllWindows()
Calls the Close method for all currently registered windows, using each window's CloseAction.
Declaration
public bool CloseAllWindows()
Returns
System. [true] if all windows were successfully closed, [false] otherwise |
CloseAutoHidePopup()
Closes the popup of the currently opened auto-hide window.
Declaration
public void CloseAutoHidePopup()
CloseWindow(DockWindow)
Removes or hides (depending on the CloseAction) the specified window.
Declaration
public void CloseWindow(DockWindow window)
Parameters
Dock
|
CloseWindows(IEnumerable<DockWindow>)
Removes or hides (depending on the CloseAction) the specified windows.
Declaration
public void CloseWindows(IEnumerable<DockWindow> windows)
Parameters
System.
|
CommitTransaction(RadDockTransaction)
Commits the specified transaction.
Declaration
protected virtual void CommitTransaction(RadDockTransaction transaction)
Parameters
Rad
|
Contains(String)
Determines whether a DockWindow instance with the specified name is registered with this RadDock instance.
Declaration
public bool Contains(string name)
Parameters
System.
|
Returns
System.
|
Contains(DockWindow)
Determines whether the specified DockWindow is registered with this RadDock instances.
Declaration
public bool Contains(DockWindow dockWindow)
Parameters
Dock
|
Returns
System.
|
CreateChildItems(RadElement)
Declaration
protected override void CreateChildItems(RadElement parent)
Parameters
Rad
|
Overrides
CreateDefaultTabStrip(DockType)
Creates and returns the default DockTabStrip for a given DockType.
Declaration
public DockTabStrip CreateDefaultTabStrip(DockType type)
Parameters
Dock
|
Returns
CreateLayoutStrategy()
Creates new SplitContainerLayoutStrategy instance. Allows inheritors to provide custom type.
Declaration
protected virtual SplitContainerLayoutStrategy CreateLayoutStrategy()
Returns
CreateXmlWriterSettings()
Creates the core XmlWritterSettings to be used by the serialization manager.
Declaration
protected virtual XmlWriterSettings CreateXmlWriterSettings()
Returns
System.
|
DisplayQuickNavigator()
DisplayWindow(DockWindow)
Displays the specified window if was previously hidden.
Declaration
public void DisplayWindow(DockWindow window)
Parameters
Dock
|
DisplayWindows(IEnumerable<DockWindow>)
Displays the provided dock windows if they were previously hidden and are registered with this RadDock instance.
Declaration
public void DisplayWindows(IEnumerable<DockWindow> windows)
Parameters
System.
|
Dispose(Boolean)
Declaration
protected override void Dispose(bool disposing)
Parameters
System.
|
Overrides
DockControl(Control, DockPosition)
Registers the specified control as part of the docking framework.
Declaration
public HostWindow DockControl(Control control, DockPosition position)
Parameters
System.
|
Dock
|
Returns
DockControl(Control, DockPosition, DockType)
Registers the specified control as part of the docking framework.
Declaration
public HostWindow DockControl(Control control, DockPosition position, DockType dockType)
Parameters
System.
|
Dock
|
Dock
|
Returns
DockControl(Control, DockTabStrip, DockPosition)
Registers the specified control as part of the docking framework.
Declaration
public HostWindow DockControl(Control control, DockTabStrip dockAnchor, DockPosition position)
Parameters
System.
|
Dock
|
Dock
|
Returns
DockControl(Control, DockTabStrip, DockPosition, DockType)
Registers the specified control as part of the docking framework.
Declaration
public HostWindow DockControl(Control control, DockTabStrip dockAnchor, DockPosition position, DockType dockType)
Parameters
System.
|
Dock
|
Dock
|
Dock
|
Returns
DockControl(Control, DockWindow, DockPosition)
Registers the specified control as part of the docking framework.
Declaration
public HostWindow DockControl(Control control, DockWindow target, DockPosition position)
Parameters
System.
|
Dock
|
Dock
|
Returns
DockControl(Control, DockWindow, DockPosition, DockType)
Registers the specified control as part of the docking framework.
Declaration
public HostWindow DockControl(Control control, DockWindow target, DockPosition position, DockType dockType)
Parameters
System.
|
Dock
|
Dock
|
Dock
|
Returns
DockWindow(DockWindow, DockPosition)
Registers the specified DockWindow instance and docks it at the desired psotion.
Declaration
public void DockWindow(DockWindow dockWindow, DockPosition position)
Parameters
Dock
|
Dock
|
DockWindow(DockWindow, DockWindow, DockPosition)
Registers the specified DockWindow instance and docks it at the desired psotion, using the provided target window as an anchor.
Declaration
public void DockWindow(DockWindow dockWindow, DockWindow target, DockPosition position)
Parameters
Dock
|
Dock
|
Dock
|
DockWindow(DockWindow, SplitPanel, DockPosition)
Registers the specified DockWindow instance and docks it at the desired position, using the provided SplitPanel as an anchor.
Declaration
public void DockWindow(DockWindow window, SplitPanel dockAnchor, DockPosition position)
Parameters
Dock
|
Split Any split panel instance that resides |
Dock
|
EndInit()
EndTransactionBlock()
Ends previously opened transaction. Optionally preforms update.
Declaration
public void EndTransactionBlock()
EndUpdate()
Ends a BeginUpdate block.
Declaration
public void EndUpdate()
EndUpdate(Boolean)
Ends a BeginUpdate block and optionally performs update.
Declaration
public void EndUpdate(bool update)
Parameters
System.
|
EnqueueTransaction(RadDockTransaction)
Adds the
Declaration
public void EnqueueTransaction(RadDockTransaction transaction)
Parameters
Rad
|
EnsureInitialized()
This method is used internally.
Declaration
public void EnsureInitialized()
EnumFrameworkControls<T>()
Enumerates all currently alive T instances available within the framework.
Declaration
public IEnumerable<T> EnumFrameworkControls<T>()
where T : Control
Returns
System.
|
Type Parameters
T
|
FloatToolTabStrip(ToolTabStrip, Rectangle)
Makes the specified tool tab strip floating.
Declaration
public void FloatToolTabStrip(ToolTabStrip strip, Rectangle bounds)
Parameters
Tool
|
System. The desired floating bounds. Pass Rectangle.Empty to set the default bounds. |
FloatWindow(DockWindow)
Makes the specified window floating.
Declaration
public void FloatWindow(DockWindow window)
Parameters
Dock
|
FloatWindow(DockWindow, Rectangle)
Makes the specified window floating, using the provided bounds.
Declaration
public void FloatWindow(DockWindow window, Rectangle bounds)
Parameters
Dock
|
System. The desired floating bounds. Pass Rectangle.Empty to set the default bounds. |
FloatWindows(IEnumerable<DockWindow>, Rectangle)
Makes the specified windows floating, using the provided bounds.
Declaration
public void FloatWindows(IEnumerable<DockWindow> windows, Rectangle bounds)
Parameters
System.
|
System. The desired floating bounds. Pass Rectangle.Empty to set the default bounds. |
FloatWindows(IEnumerable<DockWindow>, Rectangle, DockType)
Makes the specified windows floating, using the provided bounds.
Declaration
public void FloatWindows(IEnumerable<DockWindow> windows, Rectangle bounds, DockType containerType)
Parameters
System.
|
System. The desired floating bounds. Pass Rectangle.Empty to set the default bounds. |
Dock The type of the container inside the floating form - ToolWindow or DocumentWindow. |
FlushTransactions()
Commits all pending transactions without exitting the transaction block.
Declaration
public void FlushTransactions()
GetAutoHideTab(DockWindow)
Gets the auto hide tab item.
Declaration
public TabStripItem GetAutoHideTab(DockWindow dockWindow)
Parameters
Dock The dock window. |
Returns
GetAutoHideTabStrip(AutoHidePosition)
Gets the auto hide tab strip.
Declaration
public RadPageViewStripElement GetAutoHideTabStrip(AutoHidePosition position)
Parameters
Auto The position. |
Returns
GetDefaultDocumentTabStrip(Boolean)
Gets the default DocumentTabStrip instance, used to add documents without explicitly specified dock target.
Declaration
public DocumentTabStrip GetDefaultDocumentTabStrip(bool createNew)
Parameters
System. True to create a new DocumentTabStrip instance and add it to the document container. |
Returns
GetDefaultXmlSerializationInfo()
Gets the default serialization info for RadDock used by Save/Load loyout methods to persist grid settings to/from XML.
Declaration
public virtual ComponentXmlSerializationInfo GetDefaultXmlSerializationInfo()
Returns
Remarks
You can use the serialization info to include/exclude properties of RadDock and related objects from XML serialization.
GetHostWindow(Control)
Get the host window for Control instance docked with DockControl method or for MDI children Form object
Declaration
public HostWindow GetHostWindow(Control control)
Parameters
System.
|
Returns
Host found HostWindow instance or null |
GetNextDocumentStrip(DockWindow)
Gets the next document tab strip, regarding the specified DockWindow. The window should be in TabbedDocument state for the method to work.
Declaration
public DocumentTabStrip GetNextDocumentStrip(DockWindow window)
Parameters
Dock
|
Returns
GetPreviousDocumentStrip(DockWindow)
Gets the previous document tab strip, regarding the specified DockWindow. The window should be in TabbedDocument state for the method to work.
Declaration
public DocumentTabStrip GetPreviousDocumentStrip(DockWindow window)
Parameters
Dock
|
Returns
GetService<T>()
Retrieves currently registered Rad
Declaration
public T GetService<T>()
where T : RadDockService
Returns
T
|
Type Parameters
T
|
GetService<T>(Int32)
Retrieves currently registered Service by the provided key. All predefined service keys may be found in ServiceConstants class.
Declaration
protected T GetService<T>(int key)
where T : RadDockService
Parameters
System.
|
Returns
T
|
Type Parameters
T
|
GetSplitterElementAtPoint(Point)
Declaration
public override SplitterElement GetSplitterElementAtPoint(Point clientPoint)
Parameters
System.
|
Returns
Overrides
GetWindow<T>(String)
Gets DockWindow instance with the corresponding Name by the specified type.
Declaration
public T GetWindow<T>(string dockWindowName)
where T : DockWindow
Parameters
System.
|
Returns
T
DockWindow instance with matching Name. Null (Nothing in VB.NET) otherwise. |
Type Parameters
T
|
GetWindows(Type[])
Gets the windows by the specified types.
Declaration
public IEnumerable<DockWindow> GetWindows(params Type[] types)
Parameters
System. The types of the windows to get. |
Returns
System.
|
GetWindows<T>()
Gets the windows by the specified type.
Declaration
public IEnumerable<T> GetWindows<T>()
where T : DockWindow
Returns
System.
|
Type Parameters
T
|
IsNameAvailable(String)
Declaration
protected virtual bool IsNameAvailable(string name)
Parameters
System.
|
Returns
System.
|
LoadFromXml(Stream, Boolean)
Loads the docking layout configuration from a stream. This method will try to guess if the xml in the stream was written with the DockingManager or with the new RadDock in order to determine how to read it successfully.
Declaration
public void LoadFromXml(Stream stream, bool clearDocking = false)
Parameters
System. The stream. |
System. if set to |
LoadFromXml(TextReader, Boolean)
Loads the docking layout configuration from a TextReader. Note that this is a new method and does not support loading xml that was written using DockingManager.
Declaration
public void LoadFromXml(TextReader textReader, bool clearDocking = false)
Parameters
System. The text reader. |
System. if set to |
LoadFromXml(String, Boolean)
Loads the docking layout configuration from a file. This method will try to guess if the xml in the file was written with the DockingManager or with the new RadDock in order to determine how to read it successfully.
Declaration
public void LoadFromXml(string fileName, bool clearDocking = false)
Parameters
System. Name of the file. |
System. if set to |
LoadFromXmlCore(XmlReader, Boolean, Boolean)
Overrwrite this method to change the loading of docking layout configuration.
Declaration
protected virtual void LoadFromXmlCore(XmlReader reader, bool oldXmlFormat, bool clearDocking = false)
Parameters
System. The XmlReader instance that will be used to load the layoiut configuration. |
System. if set to |
System. if set to |
MoveToNextDocumentTabStrip(DockWindow)
Move DockWindow to next document tab strip if exist when DockWindow is in document mode
Declaration
public bool MoveToNextDocumentTabStrip(DockWindow dockWindow)
Parameters
Dock
|
Returns
System.
|
MoveToPreviousDocumentTabStrip(DockWindow)
Move DockWindow to previuos document tab strip if exist when DockWindow is in document mode
Declaration
public bool MoveToPreviousDocumentTabStrip(DockWindow dockWindow)
Parameters
Dock
|
Returns
System.
|
OnActiveWindowChanged(DockWindowEventArgs)
Raises the Active
Declaration
protected virtual void OnActiveWindowChanged(DockWindowEventArgs e)
Parameters
OnActiveWindowChanging(DockWindowCancelEventArgs)
Raises the Active
Declaration
protected virtual void OnActiveWindowChanging(DockWindowCancelEventArgs e)
Parameters
OnAutoHideButtonClicked(ToolTabStrip)
An Auto-hide button click notification, received from a registered ToolTabStrip.
Declaration
protected virtual void OnAutoHideButtonClicked(ToolTabStrip strip)
Parameters
Tool
|
OnAutoHideWindowDisplayed(DockWindowEventArgs)
Raises the Auto
Declaration
protected virtual void OnAutoHideWindowDisplayed(DockWindowEventArgs e)
Parameters
OnAutoHideWindowDisplaying(AutoHideWindowDisplayingEventArgs)
Raises the Auto
Declaration
protected virtual void OnAutoHideWindowDisplaying(AutoHideWindowDisplayingEventArgs e)
Parameters
OnAutoHideWindowHidden(DockWindowEventArgs)
Raises the Auto
Declaration
protected virtual void OnAutoHideWindowHidden(DockWindowEventArgs e)
Parameters
OnAutoHideWindowHiding(DockWindowCancelEventArgs)
Raises the Auto
Declaration
protected virtual void OnAutoHideWindowHiding(DockWindowCancelEventArgs e)
Parameters
OnBackgroundImageChanged(EventArgs)
Declaration
protected override void OnBackgroundImageChanged(EventArgs e)
Parameters
System.
|
OnControlTreeChanged(ControlTreeChangedEventArgs)
Declaration
protected override void OnControlTreeChanged(ControlTreeChangedEventArgs args)
Parameters
Overrides
OnDockStateChanged(DockWindowEventArgs)
Raises the Dock
Declaration
protected virtual void OnDockStateChanged(DockWindowEventArgs e)
Parameters
OnDockStateChanging(DockStateChangingEventArgs)
Raises the Dock
Declaration
protected virtual void OnDockStateChanging(DockStateChangingEventArgs e)
Parameters
OnDockStateContextMenuClicked(DockWindow, DockState)
Recieves a notification for a change state request, made from the window's associated context menu.
Declaration
protected virtual void OnDockStateContextMenuClicked(DockWindow window, DockState newState)
Parameters
Dock
|
Dock
|
OnDockWindowAdded(DockWindowEventArgs)
Raises the Dock
Declaration
protected virtual void OnDockWindowAdded(DockWindowEventArgs e)
Parameters
OnDockWindowClosed(DockWindowEventArgs)
Raises the Dock
Declaration
protected virtual void OnDockWindowClosed(DockWindowEventArgs e)
Parameters
OnDockWindowClosing(DockWindowCancelEventArgs)
Raises the Dock
Declaration
protected virtual void OnDockWindowClosing(DockWindowCancelEventArgs e)
Parameters
OnDockWindowNameChanged(DockWindow, String)
The manager gets notified for a change in the specified Dock
Declaration
protected virtual void OnDockWindowNameChanged(DockWindow dockWindow, string oldName)
Parameters
Dock The DockWindow which name has changed. |
System. The window's previous name. |
OnDockWindowRemoved(DockWindowEventArgs)
Raises the Dock
Declaration
protected virtual void OnDockWindowRemoved(DockWindowEventArgs e)
Parameters
OnDockWindowSerializing(DockWindow)
Raises the Dock
Declaration
protected virtual bool OnDockWindowSerializing(DockWindow dockWindow)
Parameters
Dock
|
Returns
System. [true] if canceled, [false] otherwise. |
OnEnabledChanged(EventArgs)
Declaration
protected override void OnEnabledChanged(EventArgs e)
Parameters
System.
|
Overrides
OnFloatingWindowCreated(FloatingWindowEventArgs)
Raises the FloatingWindowCreated event.
Declaration
protected virtual void OnFloatingWindowCreated(FloatingWindowEventArgs e)
Parameters
OnHandleCreated(EventArgs)
Declaration
protected override void OnHandleCreated(EventArgs e)
Parameters
System.
|
OnHandleDestroyed(EventArgs)
Declaration
protected override void OnHandleDestroyed(EventArgs e)
Parameters
System.
|
Overrides
OnLoad(Size)
Called when control's creation is complete.
Declaration
protected override void OnLoad(Size desiredSize)
Parameters
System.
|
Overrides
OnLoadedFromXml()
OnMouseDown(MouseEventArgs)
Declaration
protected override void OnMouseDown(MouseEventArgs e)
Parameters
System.
|
Overrides
OnMouseMove(MouseEventArgs)
Declaration
protected override void OnMouseMove(MouseEventArgs e)
Parameters
System.
|
Overrides
OnPaddingChanged(EventArgs)
Declaration
protected override void OnPaddingChanged(EventArgs e)
Parameters
System.
|
Overrides
OnParentChanged(EventArgs)
Declaration
protected override void OnParentChanged(EventArgs e)
Parameters
System.
|
Overrides
OnParentVisibleChanged(EventArgs)
Declaration
protected override void OnParentVisibleChanged(EventArgs e)
Parameters
System.
|
OnQuickNavigatorSnapshotNeeded(DockWindowSnapshotEventArgs)
OnSavedToXml()
OnSelectedTabChanged(SelectedTabChangedEventArgs)
Declaration
protected virtual void OnSelectedTabChanged(SelectedTabChangedEventArgs e)
Parameters
OnSelectedTabChanging(SelectedTabChangingEventArgs)
Declaration
protected virtual void OnSelectedTabChanging(SelectedTabChangingEventArgs e)
Parameters
OnTabStripItemDoubleClick(TabStripItem, DockTabStrip)
Declaration
protected virtual void OnTabStripItemDoubleClick(TabStripItem item, DockTabStrip strip)
Parameters
Tab
|
Dock
|
OnThemeChanged()
Delegates the ThemeChanged event to all owned controls and elements.
Declaration
protected override void OnThemeChanged()
Overrides
OnToolTabStripDoubleClick(ToolTabStrip, Point)
Receives a notification from a tooltabstrip that the mouse was clicked inside its area. The default implementation will try to restore the state of the associated windows.
Declaration
protected virtual void OnToolTabStripDoubleClick(ToolTabStrip strip, Point click)
Parameters
Tool
|
System.
|
OnTransactionBlockEnded(EventArgs)
Raises the TransactionBlockEnded event.
Declaration
protected virtual void OnTransactionBlockEnded(EventArgs e)
Parameters
System.
|
OnTransactionBlockStarted(EventArgs)
Raises the Transaction
Declaration
protected virtual void OnTransactionBlockStarted(EventArgs e)
Parameters
System.
|
OnTransactionCommitted(RadDockTransactionEventArgs)
Raises the TransactionCommitted event.
Declaration
protected virtual void OnTransactionCommitted(RadDockTransactionEventArgs e)
Parameters
OnTransactionCommitting(RadDockTransactionCancelEventArgs)
Raises the TransactionCommitting event.
Declaration
protected virtual void OnTransactionCommitting(RadDockTransactionCancelEventArgs e)
Parameters
OnVisibleChanged(EventArgs)
Declaration
protected override void OnVisibleChanged(EventArgs e)
Parameters
System.
|
Overrides
PerformUpdate()
Performs the core update logic after an EndUpdate call.
Declaration
protected virtual void PerformUpdate()
PostCommitTransaction(RadDockTransaction)
Allows inheritors to provide additional post-commit processing of a transaction.
Declaration
protected virtual void PostCommitTransaction(RadDockTransaction transaction)
Parameters
Rad
|
PreCommitTransaction(RadDockTransaction)
Allows inheritors to provide additional pre-commit processing of a transaction.
Declaration
protected virtual void PreCommitTransaction(RadDockTransaction transaction)
Parameters
Rad
|
ProcessFocusRequested(RadElement)
Declaration
protected override bool ProcessFocusRequested(RadElement element)
Parameters
Rad
|
Returns
System.
|
Overrides
RegisterService(Int32, RadDockService)
Registers the specified service with ourselves.
Declaration
public void RegisterService(int key, RadDockService service)
Parameters
System.
|
Rad
|
RemoveAllDocumentWindows()
Removes all DocumentWindows, without disposing it.
Declaration
public void RemoveAllDocumentWindows()
RemoveAllDocumentWindows(DockWindowCloseAction)
Removes all DocumentWindows, using the specified close action.
Declaration
public void RemoveAllDocumentWindows(DockWindowCloseAction closeAction)
Parameters
Dock The action to be taken when closing a window. |
RemoveAllToolWindows(DockWindowCloseAction, AllowedDockState)
Removes all ToolWindows with the specified DockState, using the specified close action.
Declaration
public void RemoveAllToolWindows(DockWindowCloseAction closeAction = DockWindowCloseAction.Close, AllowedDockState allowedDockState = AllowedDockState.Docked | AllowedDockState.AutoHide)
Parameters
Dock The action to be taken when closing a window. |
Allowed Specifies the DockState of the ToolWindows that will be removed. The enumeration flags can be combined. |
RemoveAllWindows()
Removes all DockWindows, without disposing them.
Declaration
public void RemoveAllWindows()
RemoveAllWindows(DockWindowCloseAction)
Removes all DockWindows, using the specified close action.
Declaration
public void RemoveAllWindows(DockWindowCloseAction closeAction)
Parameters
Dock The action to be taken when closing a window. |
RemoveWindow(DockWindow)
Removes the specified window, without disposing it, from the dock manager.
Declaration
public void RemoveWindow(DockWindow window)
Parameters
Dock
|
RemoveWindow(DockWindow, DockWindowCloseAction)
Removes the specified window, using the specified DockWindowCloseAction.
Declaration
public void RemoveWindow(DockWindow window, DockWindowCloseAction closeAction)
Parameters
Dock
|
Dock The desired action to be taken. |
RestoreWindowsStatesAfterLoad()
This method is used internally.
Declaration
public void RestoreWindowsStatesAfterLoad()
RestoreWindowsStatesAfterLoad(Boolean)
This method is used internally.
Declaration
public void RestoreWindowsStatesAfterLoad(bool beginInitWindows)
Parameters
System.
|
SaveToXml(Stream)
Saves the docking layout configuration in an XML format in the specified stream.
Declaration
public void SaveToXml(Stream stream)
Parameters
System. The stream. |
SaveToXml(TextWriter)
Saves the docking layout configuration in an XML format in the specified TextWriter.
Declaration
public void SaveToXml(TextWriter textWriter)
Parameters
System. The text writer. |
SaveToXml(String)
Saves the docking layout configuration in an XML format in the specified file.
Declaration
public void SaveToXml(string fileName)
Parameters
System. Name of the file. |
SaveToXmlCore(XmlWriter)
Performs the core save logic.
Declaration
protected virtual void SaveToXmlCore(XmlWriter writer)
Parameters
System.
|
SetBoundsCore(Int32, Int32, Int32, Int32, BoundsSpecified)
Declaration
protected override void SetBoundsCore(int x, int y, int width, int height, BoundsSpecified specified)
Parameters
System.
|
System.
|
System.
|
System.
|
System.
|
Overrides
SetWindowState(DockWindow, DockState)
Applies the desired DockState to the specified DockWindow. If a previously RedockState is saved for the desired DockState, this state is restored, else the default action is performed.
Declaration
public void SetWindowState(DockWindow window, DockState state)
Parameters
Dock
|
Dock
|
ShouldProcessNotification()
This method is used internally.
Declaration
public bool ShouldProcessNotification()
Returns
System.
|
ShowAutoHidePopup(HostWindow)
ShowAutoHidePopup(ToolWindow)
UpdateBackgroundSettings()
Declaration
protected void UpdateBackgroundSettings()
UpdateCollapsed()
Events
ActiveWindowChanged
Notifies for an actual change of the ActiveWindow property.
Declaration
public event DockWindowEventHandler ActiveWindowChanged
Event Type
ActiveWindowChanging
Notifies for an upcomming change of the ActiveWindow property. Cancelable.
Declaration
public event DockWindowCancelEventHandler ActiveWindowChanging
Event Type
AutoHideWindowDisplayed
Notifies that an auto-hidden window is about to be displayed. Cancelable.
Declaration
public event DockWindowEventHandler AutoHideWindowDisplayed
Event Type
AutoHideWindowDisplaying
Notifies that an auto-hidden window is about to be displayed. Cancelable.
Declaration
public event AutoHideWindowDisplayingEventHandler AutoHideWindowDisplaying
Event Type
AutoHideWindowHidden
Notifies that a window which DockState is AutoHide has been hidden.
Declaration
public event DockWindowEventHandler AutoHideWindowHidden
Event Type
AutoHideWindowHiding
Notifies that a window with AutoHide DockState is hiding.
Declaration
public event DockWindowCancelEventHandler AutoHideWindowHiding
Event Type
DockStateChanged
Notifies for a change in the DockState of the associated window.
Declaration
public event DockWindowEventHandler DockStateChanged
Event Type
DockStateChanging
Notifies for an upcomming change in the DockState of the associated window. Cancelable.
Declaration
public event DockStateChangingEventHandler DockStateChanging
Event Type
DockTabStripNeeded
Raised whenever a new Dock
Declaration
public event DockTabStripNeededEventHandler DockTabStripNeeded
Event Type
DockWindowAdded
Notifies for a new DockWindow registered with this RadDock instance.
Declaration
public event DockWindowEventHandler DockWindowAdded
Event Type
DockWindowClosed
Raised after a DockWindow has been closed.
Declaration
public event DockWindowEventHandler DockWindowClosed
Event Type
DockWindowClosing
Raised before a DockWindow.Close method is called.
Declaration
public event DockWindowCancelEventHandler DockWindowClosing
Event Type
DockWindowRemoved
Notifies for a DockWindow removed from this RadDock instance. This event will not be raised for hidden windows.
Declaration
public event DockWindowEventHandler DockWindowRemoved
Event Type
DockWindowSerializing
Fired when a dock window is being serialized. Allows excluding some windows from serialization.
Declaration
public event EventHandler<DockWindowCancelEventArgs> DockWindowSerializing
Event Type
System.
|
FloatingWindowCreated
Notifies that a FloatingWindow instance is internally created by the framework. Allows listeners to examine and optionally change the window itself.
Declaration
public event FloatingWindowEventHandler FloatingWindowCreated
Event Type
LoadedFromXml
Notifies that manager's state has been loaded from an external XML source.
Declaration
public event EventHandler LoadedFromXml
Event Type
System.
|
PageViewInstanceCreated
Fires after RadPageViewElement is created.
Declaration
public event PageViewInstanceCreatedEventHandler PageViewInstanceCreated
Event Type
QuickNavigatorSnapshotNeeded
SavedToXml
Notifies that manager's state has been saved to an external XML source.
Declaration
public event EventHandler SavedToXml
Event Type
System.
|
SelectedTabChanged
Occurs when selected tab changed in currently manipulated DockTabStrip.
Declaration
public event SelectedTabChangedEventHandler SelectedTabChanged
Event Type
SelectedTabChanging
Occurs when selected tab changing in currently manipulated DockTabStrip.
Declaration
public event SelectedTabChangingEventHandler SelectedTabChanging
Event Type
SplitContainerNeeded
Raised whenever a new Rad
Declaration
public event SplitContainerNeededEventHandler SplitContainerNeeded
Event Type
TransactionBlockEnded
Notifies for a successful EndTransactionBlock operation, when all transactions are committed, the DockTree is cleaned, and updates are resumed.
Declaration
public event EventHandler TransactionBlockEnded
Event Type
System.
|
TransactionBlockStarted
Notifies for a successful BeginTransactionBlock operation.
Declaration
public event EventHandler TransactionBlockStarted
Event Type
System.
|
TransactionCommitted
Raised when a RadDockTransaction is successfully committed. Allows listeners to perform some additional operations.
Declaration
public event RadDockTransactionEventHandler TransactionCommitted
Event Type
TransactionCommitting
Raised when a RadDockTransaction is about to be committed. Allows listeners to investigate the transaction, perform some additional actions and/or cancel it.
Declaration
public event RadDockTransactionCancelEventHandler TransactionCommitting
Event Type
Explicit Interface Implementations
IMessageListener.DesiredHook
Declaration
InstalledHook IMessageListener.DesiredHook { get; }
Returns
Implements
IMessageListener.PreviewMessage(ref Message)
Declaration
MessagePreviewResult IMessageListener.PreviewMessage(ref Message msg)
Parameters
System.
|
Returns
Implements
IMessageListener.PreviewSystemMessage(SystemMessage, Message)
Declaration
void IMessageListener.PreviewSystemMessage(SystemMessage message, Message msg)
Parameters
System
|
System.
|
Implements
IMessageListener.PreviewWndProc(Message)
Declaration
void IMessageListener.PreviewWndProc(Message msg)
Parameters
System.
|
Implements
ILoadObsoleteDockingManagerXml.DockableDeserialized
Declaration
event EventHandler<DockableDeserializedEventArgs> ILoadObsoleteDockingManagerXml.DockableDeserialized
Returns
System.
|
Implements
ILoadObsoleteDockingManagerXml.LoadDockingManagerXml(TextReader)
Declaration
void ILoadObsoleteDockingManagerXml.LoadDockingManagerXml(TextReader input)
Parameters
System.
|