New to Telerik UI for WinFormsStart a free 30-day trial

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:

C#
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

Initializes a new DockWindow instance.

C#
public DockWindow()
C#
protected DockWindow(DockState dockState, DockState previousDockState)
Parameters:dockStateDockStatepreviousDockStateDockState

Properties

Get or set allowed dock states for DockWindow instance

C#
[Browsable(false)]
public AllowedDockState AllowedDockState { get; set; }
C#
[Browsable(false)]
public virtual Size AutoHideSize { get; set; }
C#
[Browsable(false)]
public TabStripItem AutoHideTab { get; }
C#
public override Color BackColor { get; set; }

Overrides: Control.BackColor

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

C#
public virtual DockWindowCloseAction CloseAction { get; set; }

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

C#
protected virtual DockWindowCloseAction DefaultCloseAction { get; }

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

C#
protected virtual DockState DefaultDockState { get; }

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.

C#
public Size DefaultFloatingSize { get; set; }

Gets the current RadDock instance this window is associated with.

C#
[Browsable(false)]
public virtual RadDock DockManager { get; }

Implements: IDockWindow.DockManager

Gets the current dock state of the window.

C#
[Browsable(false)]
public DockState DockState { get; set; }

Gets the DockTabStrip which hosts this window.

C#
[Browsable(false)]
public DockTabStrip DockTabStrip { get; }

Gets the DockType of this instance.

C#
[Browsable(false)]
public virtual DockType DockType { get; }

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

C#
public DocumentStripButtons DocumentButtons { get; set; }

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

C#
[Browsable(false)]
public FloatingWindow FloatingParent { get; }

Get the floating status of window

C#
[Browsable(false)]
public bool IsInFloatingMode { get; }

Gets or sets value representing unique Name of the DockWindow

C#
[Browsable(false)]
public string Name { get; set; }

Implements: IDockWindow.Name

C#
public override ISite Site { get; set; }

Overrides: Control.Site

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

C#
public ToolStripCaptionButtons ToolCaptionButtons { get; set; }
C#
protected bool ValidationCancel { get; }

Methods

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

C#
public void Close()
C#
protected override void Dispose(bool disposing)
Parameters:disposingbool

Overrides: ContainerControl.Dispose(bool)

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

C#
public void DockTo(DockWindow target, DockPosition position)
Parameters:targetDockWindowpositionDockPosition

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

C#
public void EnsureVisible()

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

C#
public void EnsureVisible(bool suspendShowAutoHide)
Parameters:suspendShowAutoHidebool

Indicates whether showing autohide windows should be suspended.

Hide the ToolWindow from RadDock manager

C#
public void Hide()

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.

C#
protected virtual void OnClosed(DockWindowEventArgs e)
Parameters:eDockWindowEventArgs

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.

C#
protected virtual void OnClosing(DockWindowCancelEventArgs e)
Parameters:eDockWindowCancelEventArgs
C#
protected override void OnEnter(EventArgs e)
Parameters:eEventArgs

Overrides: Control.OnEnter(EventArgs)

C#
protected override void OnGotFocus(EventArgs e)
Parameters:eEventArgs

Overrides: Control.OnGotFocus(EventArgs)

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

C#
protected override void OnImageChanged(EventArgs e)
Parameters:eEventArgs

Overrides: TabPanel.OnImageChanged(EventArgs)

C#
protected override void OnMouseDown(MouseEventArgs e)
Parameters:eMouseEventArgs

Overrides: Control.OnMouseDown(MouseEventArgs)

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

C#
protected virtual void OnNameChanged(string oldName)
Parameters:oldNamestring
C#
protected override void OnTextChanged(EventArgs e)
Parameters:eEventArgs

Overrides: Control.OnTextChanged(EventArgs)

C#
protected override void OnToolTipTextChanged(EventArgs e)
Parameters:eEventArgs

Overrides: TabPanel.OnToolTipTextChanged(EventArgs)

Display the ToolWindow if was previously hidden.

C#
public void Show()
C#
public override string ToString()
Returns:

string

Overrides: Component.ToString()

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

C#
protected virtual void UpdateOnTextChanged()

Provides special handling for the WM_SETFOCUS notification.

C#
protected override void WndProc(ref Message m)
Parameters:mMessage

Overrides: ContainerControl.WndProc(ref Message)