Class
DockWindow

Base class for all tool and document windows available per RadDock instance. Implements the IDockWindow interface.

Definition

Namespace:Telerik.WinControls.UI.Docking

Assembly:Telerik.WinControls.RadDock.dll

Syntax:

cs-api-definition
public abstract class DockWindow : TabPanel, IDropTarget, ISynchronizeInvoke, IWin32Window, IBindableComponent, IComponent, IDisposable, IContainerControl, INotifyPropertyChanged, IDockWindow

Inheritance: objectMarshalByRefObjectComponentControlScrollableControlContainerControlTabPanelDockWindow

Derived Classes: DockWindowPlaceholderDocumentWindowHostWindowToolWindow

Implements: IBindableComponentIComponentIContainerControlIDisposableIDockWindowIDropTargetINotifyPropertyChangedISynchronizeInvokeIWin32Window

Inherited Members TabPanel.GetTabStrip<T>()TabPanel.OnPropertyChanged(string)TabPanel.BorderStyleTabPanel.DefaultSizeTabPanel.ImageTabPanel.SvgImageTabPanel.TabStripItemTabPanel.ToolTipTextTabPanel.TabStripTabPanel.TextChangedTabPanel.PropertyChangedContainerControl.AdjustFormScrollbars(bool)ContainerControl.OnAutoValidateChanged(EventArgs)ContainerControl.OnCreateControl()ContainerControl.OnFontChanged(EventArgs)ContainerControl.OnLayout(LayoutEventArgs)ContainerControl.OnParentChanged(EventArgs)ContainerControl.PerformAutoScale()ContainerControl.ProcessDialogChar(char)ContainerControl.ProcessDialogKey(Keys)ContainerControl.ProcessCmdKey(ref Message, Keys)ContainerControl.ProcessMnemonic(char)ContainerControl.ProcessTabKey(bool)ContainerControl.Select(bool, bool)ContainerControl.UpdateDefaultButton()ContainerControl.Validate()ContainerControl.Validate(bool)ContainerControl.AutoScaleDimensionsContainerControl.AutoScaleFactorContainerControl.AutoScaleModeContainerControl.BindingContextContainerControl.CanEnableImeContainerControl.ActiveControlContainerControl.CreateParamsContainerControl.CurrentAutoScaleDimensionsContainerControl.ParentFormScrollableControl.ScrollStateAutoScrollingScrollableControl.ScrollStateHScrollVisibleScrollableControl.ScrollStateVScrollVisibleScrollableControl.ScrollStateUserHasScrolledScrollableControl.ScrollStateFullDragScrollableControl.GetScrollState(int)ScrollableControl.OnMouseWheel(MouseEventArgs)ScrollableControl.OnRightToLeftChanged(EventArgs)ScrollableControl.OnPaintBackground(PaintEventArgs)ScrollableControl.OnPaddingChanged(EventArgs)ScrollableControl.OnVisibleChanged(EventArgs)ScrollableControl.ScaleControl(SizeF, BoundsSpecified)ScrollableControl.SetDisplayRectLocation(int, int)ScrollableControl.ScrollControlIntoView(Control)ScrollableControl.ScrollToControl(Control)ScrollableControl.OnScroll(ScrollEventArgs)ScrollableControl.SetAutoScrollMargin(int, int)ScrollableControl.SetScrollState(int, bool)ScrollableControl.AutoScrollScrollableControl.AutoScrollMarginScrollableControl.AutoScrollPositionScrollableControl.AutoScrollMinSizeScrollableControl.DisplayRectangleScrollableControl.HScrollScrollableControl.HorizontalScrollScrollableControl.VScrollScrollableControl.VerticalScrollScrollableControl.ScrollControl.GetAccessibilityObjectById(int)Control.SetAutoSizeMode(AutoSizeMode)Control.GetAutoSizeMode()Control.GetPreferredSize(Size)Control.AccessibilityNotifyClients(AccessibleEvents, int)Control.AccessibilityNotifyClients(AccessibleEvents, int, int)Control.BeginInvoke(Delegate)Control.BeginInvoke(Delegate, params object[])Control.BringToFront()Control.Contains(Control)Control.CreateAccessibilityInstance()Control.CreateControlsInstance()Control.CreateGraphics()Control.CreateHandle()Control.CreateControl()Control.DefWndProc(ref Message)Control.DestroyHandle()Control.DoDragDrop(object, DragDropEffects)Control.DrawToBitmap(Bitmap, Rectangle)Control.EndInvoke(IAsyncResult)Control.FindForm()Control.GetTopLevel()Control.RaiseKeyEvent(object, KeyEventArgs)Control.RaiseMouseEvent(object, MouseEventArgs)Control.Focus()Control.FromChildHandle(IntPtr)Control.FromHandle(IntPtr)Control.GetChildAtPoint(Point, GetChildAtPointSkip)Control.GetChildAtPoint(Point)Control.GetContainerControl()Control.GetScaledBounds(Rectangle, SizeF, BoundsSpecified)Control.GetNextControl(Control, bool)Control.GetStyle(ControlStyles)Control.InitLayout()Control.Invalidate(Region)Control.Invalidate(Region, bool)Control.Invalidate()Control.Invalidate(bool)Control.Invalidate(Rectangle)Control.Invalidate(Rectangle, bool)Control.Invoke(Delegate)Control.Invoke(Delegate, params object[])Control.InvokePaint(Control, PaintEventArgs)Control.InvokePaintBackground(Control, PaintEventArgs)Control.IsKeyLocked(Keys)Control.IsInputChar(char)Control.IsInputKey(Keys)Control.IsMnemonic(char, string)Control.LogicalToDeviceUnits(int)Control.LogicalToDeviceUnits(Size)Control.ScaleBitmapLogicalToDevice(ref Bitmap)Control.NotifyInvalidate(Rectangle)Control.InvokeOnClick(Control, EventArgs)Control.OnAutoSizeChanged(EventArgs)Control.OnBackColorChanged(EventArgs)Control.OnBackgroundImageChanged(EventArgs)Control.OnBackgroundImageLayoutChanged(EventArgs)Control.OnBindingContextChanged(EventArgs)Control.OnCausesValidationChanged(EventArgs)Control.OnContextMenuChanged(EventArgs)Control.OnContextMenuStripChanged(EventArgs)Control.OnCursorChanged(EventArgs)Control.OnDockChanged(EventArgs)Control.OnEnabledChanged(EventArgs)Control.OnForeColorChanged(EventArgs)Control.OnNotifyMessage(Message)Control.OnParentBackColorChanged(EventArgs)Control.OnParentBackgroundImageChanged(EventArgs)Control.OnParentBindingContextChanged(EventArgs)Control.OnParentCursorChanged(EventArgs)Control.OnParentEnabledChanged(EventArgs)Control.OnParentFontChanged(EventArgs)Control.OnParentForeColorChanged(EventArgs)Control.OnParentRightToLeftChanged(EventArgs)Control.OnParentVisibleChanged(EventArgs)Control.OnPrint(PaintEventArgs)Control.OnTabIndexChanged(EventArgs)Control.OnTabStopChanged(EventArgs)Control.OnClick(EventArgs)Control.OnClientSizeChanged(EventArgs)Control.OnControlAdded(ControlEventArgs)Control.OnControlRemoved(ControlEventArgs)Control.OnHandleCreated(EventArgs)Control.OnLocationChanged(EventArgs)Control.OnHandleDestroyed(EventArgs)Control.OnDoubleClick(EventArgs)Control.OnDragEnter(DragEventArgs)Control.OnDragOver(DragEventArgs)Control.OnDragLeave(EventArgs)Control.OnDragDrop(DragEventArgs)Control.OnGiveFeedback(GiveFeedbackEventArgs)Control.InvokeGotFocus(Control, EventArgs)Control.OnHelpRequested(HelpEventArgs)Control.OnInvalidated(InvalidateEventArgs)Control.OnKeyDown(KeyEventArgs)Control.OnKeyPress(KeyPressEventArgs)Control.OnKeyUp(KeyEventArgs)Control.OnLeave(EventArgs)Control.InvokeLostFocus(Control, EventArgs)Control.OnLostFocus(EventArgs)Control.OnMarginChanged(EventArgs)Control.OnMouseDoubleClick(MouseEventArgs)Control.OnMouseClick(MouseEventArgs)Control.OnMouseCaptureChanged(EventArgs)Control.OnMouseEnter(EventArgs)Control.OnMouseLeave(EventArgs)Control.OnDpiChangedBeforeParent(EventArgs)Control.OnDpiChangedAfterParent(EventArgs)Control.OnMouseHover(EventArgs)Control.OnMouseMove(MouseEventArgs)Control.OnMouseUp(MouseEventArgs)Control.OnMove(EventArgs)Control.OnPaint(PaintEventArgs)Control.OnQueryContinueDrag(QueryContinueDragEventArgs)Control.OnRegionChanged(EventArgs)Control.OnResize(EventArgs)Control.OnPreviewKeyDown(PreviewKeyDownEventArgs)Control.OnSizeChanged(EventArgs)Control.OnChangeUICues(UICuesEventArgs)Control.OnStyleChanged(EventArgs)Control.OnSystemColorsChanged(EventArgs)Control.OnValidating(CancelEventArgs)Control.OnValidated(EventArgs)Control.RescaleConstantsForDpi(int, int)Control.PerformLayout()Control.PerformLayout(Control, string)Control.PointToClient(Point)Control.PointToScreen(Point)Control.PreProcessMessage(ref Message)Control.PreProcessControlMessage(ref Message)Control.ProcessKeyEventArgs(ref Message)Control.ProcessKeyMessage(ref Message)Control.ProcessKeyPreview(ref Message)Control.RaiseDragEvent(object, DragEventArgs)Control.RaisePaintEvent(object, PaintEventArgs)Control.RecreateHandle()Control.RectangleToClient(Rectangle)Control.RectangleToScreen(Rectangle)Control.ReflectMessage(IntPtr, ref Message)Control.Refresh()Control.ResetMouseEventArgs()Control.ResetText()Control.ResumeLayout()Control.ResumeLayout(bool)Control.Scale(SizeF)Control.Select()Control.SelectNextControl(Control, bool, bool, bool, bool)Control.SendToBack()Control.SetBounds(int, int, int, int)Control.SetBounds(int, int, int, int, BoundsSpecified)Control.SetBoundsCore(int, int, int, int, BoundsSpecified)Control.SetClientSizeCore(int, int)Control.SizeFromClientSize(Size)Control.SetStyle(ControlStyles, bool)Control.SetTopLevel(bool)Control.SetVisibleCore(bool)Control.RtlTranslateAlignment(HorizontalAlignment)Control.RtlTranslateAlignment(LeftRightAlignment)Control.RtlTranslateAlignment(ContentAlignment)Control.RtlTranslateHorizontal(HorizontalAlignment)Control.RtlTranslateLeftRight(LeftRightAlignment)Control.RtlTranslateContent(ContentAlignment)Control.SuspendLayout()Control.Update()Control.UpdateBounds()Control.UpdateBounds(int, int, int, int)Control.UpdateBounds(int, int, int, int, int, int)Control.UpdateZOrder()Control.UpdateStyles()Control.OnImeModeChanged(EventArgs)Control.AccessibilityObjectControl.AccessibleDefaultActionDescriptionControl.AccessibleDescriptionControl.AccessibleNameControl.AccessibleRoleControl.AllowDropControl.AnchorControl.AutoScrollOffsetControl.LayoutEngineControl.BackgroundImageControl.BackgroundImageLayoutControl.BottomControl.BoundsControl.CanFocusControl.CanRaiseEventsControl.CanSelectControl.CaptureControl.CausesValidationControl.CheckForIllegalCrossThreadCallsControl.ClientRectangleControl.ClientSizeControl.CompanyNameControl.ContainsFocusControl.ContextMenuControl.ContextMenuStripControl.ControlsControl.CreatedControl.CursorControl.DataBindingsControl.DefaultBackColorControl.DefaultCursorControl.DefaultFontControl.DefaultForeColorControl.DefaultMarginControl.DefaultMaximumSizeControl.DefaultMinimumSizeControl.DefaultPaddingControl.DeviceDpiControl.IsDisposedControl.DisposingControl.DockControl.DoubleBufferedControl.EnabledControl.FocusedControl.FontControl.FontHeightControl.ForeColorControl.HandleControl.HasChildrenControl.HeightControl.IsHandleCreatedControl.InvokeRequiredControl.IsAccessibleControl.IsMirroredControl.LeftControl.LocationControl.MarginControl.MaximumSizeControl.MinimumSizeControl.ModifierKeysControl.MouseButtonsControl.MousePositionControl.ParentControl.ProductNameControl.ProductVersionControl.RecreatingHandleControl.RegionControl.RenderRightToLeftControl.ResizeRedrawControl.RightControl.RightToLeftControl.ScaleChildrenControl.SizeControl.TabIndexControl.TabStopControl.TagControl.TextControl.TopControl.TopLevelControlControl.ShowKeyboardCuesControl.ShowFocusCuesControl.UseWaitCursorControl.VisibleControl.WidthControl.PreferredSizeControl.PaddingControl.DefaultImeModeControl.ImeModeControl.ImeModeBaseControl.PropagatingImeModeControl.BackColorChangedControl.BackgroundImageChangedControl.BackgroundImageLayoutChangedControl.BindingContextChangedControl.CausesValidationChangedControl.ClientSizeChangedControl.ContextMenuChangedControl.ContextMenuStripChangedControl.CursorChangedControl.DockChangedControl.EnabledChangedControl.FontChangedControl.ForeColorChangedControl.LocationChangedControl.MarginChangedControl.RegionChangedControl.RightToLeftChangedControl.SizeChangedControl.TabIndexChangedControl.TabStopChangedControl.VisibleChangedControl.ClickControl.ControlAddedControl.ControlRemovedControl.DragDropControl.DragEnterControl.DragOverControl.DragLeaveControl.GiveFeedbackControl.HandleCreatedControl.HandleDestroyedControl.HelpRequestedControl.InvalidatedControl.PaddingChangedControl.PaintControl.QueryContinueDragControl.QueryAccessibilityHelpControl.DoubleClickControl.EnterControl.GotFocusControl.KeyDownControl.KeyPressControl.KeyUpControl.LayoutControl.LeaveControl.LostFocusControl.MouseClickControl.MouseDoubleClickControl.MouseCaptureChangedControl.MouseDownControl.MouseEnterControl.MouseLeaveControl.DpiChangedBeforeParentControl.DpiChangedAfterParentControl.MouseHoverControl.MouseMoveControl.MouseUpControl.MouseWheelControl.MoveControl.PreviewKeyDownControl.ResizeControl.ChangeUICuesControl.StyleChangedControl.SystemColorsChangedControl.ValidatingControl.ValidatedControl.ParentChangedControl.ImeModeChangedComponent.Dispose()Component.GetService(Type)Component.EventsComponent.ContainerComponent.DesignModeComponent.DisposedMarshalByRefObject.MemberwiseClone(bool)MarshalByRefObject.GetLifetimeService()MarshalByRefObject.InitializeLifetimeService()MarshalByRefObject.CreateObjRef(Type)

Constructors

DockWindow()

Initializes a new DockWindow instance.

Declaration

cs-api-definition
public DockWindow()

DockWindow(DockState, DockState)

Declaration

cs-api-definition
protected DockWindow(DockState dockState, DockState previousDockState)

Parameters

dockState

DockState

previousDockState

DockState

Properties

AllowedDockState

Get or set allowed dock states for DockWindow instance

Declaration

cs-api-definition
[Browsable(false)]
public AllowedDockState AllowedDockState { get; set; }

Property Value

AllowedDockState

AutoHideSize

Declaration

cs-api-definition
[Browsable(false)]
public virtual Size AutoHideSize { get; set; }

Property Value

Size

AutoHideTab

Declaration

cs-api-definition
[Browsable(false)]
public TabStripItem AutoHideTab { get; }

Property Value

TabStripItem

BackColor

Declaration

cs-api-definition
public override Color BackColor { get; set; }

Property Value

Color

Overrides Control.BackColor

CloseAction

Gets or sets the action to be used when a Close request occurs for this window.

Declaration

cs-api-definition
public virtual DockWindowCloseAction CloseAction { get; set; }

Property Value

DockWindowCloseAction

DefaultCloseAction

Retrieves the default DockWindowCloseAction for this instance. Will be Hide for ToolWindow instances and CloseAndDispose for DocumentWindow instances.

Declaration

cs-api-definition
protected virtual DockWindowCloseAction DefaultCloseAction { get; }

Property Value

DockWindowCloseAction

DefaultDockState

Retrieves the default DockState for this instance. Will be Docked for ToolWindow instances and TabbedDocument for DocumentWindow instances.

Declaration

cs-api-definition
protected virtual DockState DefaultDockState { get; }

Property Value

DockState

DefaultFloatingSize

Gets or sets the size to be used when the window is floated for the first time and does not have previous floating state saved.

Declaration

cs-api-definition
public Size DefaultFloatingSize { get; set; }

Property Value

Size

DockManager

Gets the current RadDock instance this window is associated with.

Declaration

cs-api-definition
[Browsable(false)]
public virtual RadDock DockManager { get; }

Property Value

RadDock

Implements IDockWindow.DockManager

DockState

Gets the current dock state of the window.

Declaration

cs-api-definition
[Browsable(false)]
public DockState DockState { get; set; }

Property Value

DockState

DockTabStrip

Gets the DockTabStrip which hosts this window.

Declaration

cs-api-definition
[Browsable(false)]
public DockTabStrip DockTabStrip { get; }

Property Value

DockTabStrip

DockType

Gets the DockType of this instance.

Declaration

cs-api-definition
[Browsable(false)]
public virtual DockType DockType { get; }

Property Value

DockType

DocumentButtons

Gets or sets the visibility of the associated command buttons when the window resides in a DocumentTabStrip instance.

Declaration

cs-api-definition
public DocumentStripButtons DocumentButtons { get; set; }

Property Value

DocumentStripButtons

FloatingParent

Get the parent floating window when the window is in floating mode

Declaration

cs-api-definition
[Browsable(false)]
public FloatingWindow FloatingParent { get; }

Property Value

FloatingWindow

IsInFloatingMode

Get the floating status of window

Declaration

cs-api-definition
[Browsable(false)]
public bool IsInFloatingMode { get; }

Property Value

bool

Name

Gets or sets value representing unique Name of the DockWindow

Declaration

cs-api-definition
[Browsable(false)]
public string Name { get; set; }

Property Value

string

Implements IDockWindow.Name

Site

Declaration

cs-api-definition
public override ISite Site { get; set; }

Property Value

ISite

Overrides Control.Site

ToolCaptionButtons

Gets or sets the visibility of the associated command buttons when the window resides in a ToolTabStrip instance.

Declaration

cs-api-definition
public ToolStripCaptionButtons ToolCaptionButtons { get; set; }

Property Value

ToolStripCaptionButtons

ValidationCancel

Declaration

cs-api-definition
protected bool ValidationCancel { get; }

Property Value

bool

Methods

Close()

Asks the current DockManager instance (if any) to close the window.

Declaration

cs-api-definition
public void Close()

Dispose(bool)

Declaration

cs-api-definition
protected override void Dispose(bool disposing)

Parameters

disposing

bool

Overrides ContainerControl.Dispose(bool)

DockTo(DockWindow, DockPosition)

Asks the current DockManager instance (if any) to dock the window to the specified target, using the desired position.

Declaration

cs-api-definition
public void DockTo(DockWindow target, DockPosition position)

Parameters

target

DockWindow

position

DockPosition

EnsureVisible()

Ensures that the window is currently visible on its hosting DockTabStrip.

Declaration

cs-api-definition
public void EnsureVisible()

EnsureVisible(bool)

Ensures that the window is currently visible on its hosting DockTabStrip.

Declaration

cs-api-definition
public void EnsureVisible(bool suspendShowAutoHide)

Parameters

suspendShowAutoHide

bool

Indicates whether showing autohide windows should be suspended.

Hide()

Hide the ToolWindow from RadDock manager

Declaration

cs-api-definition
public void Hide()

OnClosed(DockWindowEventArgs)

Called by the owning RadDock instance when the window has been successfully closed. Depending on the current CloseAction, the window will be either hidden, removed or both plus disposed when entering this method.

Declaration

cs-api-definition
protected virtual void OnClosed(DockWindowEventArgs e)

Parameters

e

DockWindowEventArgs

OnClosing(DockWindowCancelEventArgs)

Called by the owning RadDock instance when this window is about to close. Allows specific DockWindow implementations to optionally cancel the operation and/or perform additional actions.

Declaration

cs-api-definition
protected virtual void OnClosing(DockWindowCancelEventArgs e)

Parameters

e

DockWindowCancelEventArgs

OnEnter(EventArgs)

Declaration

cs-api-definition
protected override void OnEnter(EventArgs e)

Parameters

e

EventArgs

Overrides Control.OnEnter(EventArgs)

OnGotFocus(EventArgs)

Declaration

cs-api-definition
protected override void OnGotFocus(EventArgs e)

Parameters

e

EventArgs

Overrides Control.OnGotFocus(EventArgs)

OnImageChanged(EventArgs)

Notifies for a change in the Image and SvgImage members of this panel.

Declaration

cs-api-definition
protected override void OnImageChanged(EventArgs e)

Parameters

e

EventArgs

Overrides TabPanel.OnImageChanged(EventArgs)

OnMouseDown(MouseEventArgs)

Declaration

cs-api-definition
protected override void OnMouseDown(MouseEventArgs e)

Parameters

e

MouseEventArgs

Overrides Control.OnMouseDown(MouseEventArgs)

OnNameChanged(string)

Notifies the owning RadDock instance for a change in the Name value.

Declaration

cs-api-definition
protected virtual void OnNameChanged(string oldName)

Parameters

oldName

string

OnTextChanged(EventArgs)

Declaration

cs-api-definition
protected override void OnTextChanged(EventArgs e)

Parameters

e

EventArgs

Overrides Control.OnTextChanged(EventArgs)

OnToolTipTextChanged(EventArgs)

Declaration

cs-api-definition
protected override void OnToolTipTextChanged(EventArgs e)

Parameters

e

EventArgs

Overrides TabPanel.OnToolTipTextChanged(EventArgs)

Show()

Display the ToolWindow if was previously hidden.

Declaration

cs-api-definition
public void Show()

ToString()

Declaration

cs-api-definition
public override string ToString()

Returns

string

Overrides Component.ToString()

UpdateOnTextChanged()

Updates all associated UI - such as TabItems, Captions, etc. upon TextChanged event.

Declaration

cs-api-definition
protected virtual void UpdateOnTextChanged()

WndProc(ref Message)

Provides special handling for the WM_SETFOCUS notification.

Declaration

cs-api-definition
protected override void WndProc(ref Message m)

Parameters

m

Message

Overrides ContainerControl.WndProc(ref Message)