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

Represents a popup form that is used to host floating DockWindow instances.

Definition

Namespace:Telerik.WinControls.UI.Docking

Assembly:Telerik.WinControls.RadDock.dll

Syntax:

C#
public class FloatingWindow : DockPopupForm, IDropTarget, ISynchronizeInvoke, IWin32Window, IBindableComponent, IComponent, IDisposable, IContainerControl, IComponentTreeHandler, ILayoutHandler, ISupportInitializeNotification, ISupportInitialize, INotifyPropertyChanged, IAnalyticsProvider, ISupportRootUIAutomation

Inheritance: objectMarshalByRefObjectComponentControlScrollableControlContainerControlFormRadFormControlBaseRadFormDockPopupFormFloatingWindow...

Implements: IAnalyticsProviderIBindableComponentIComponentIComponentTreeHandlerIContainerControlIDisposableIDropTargetILayoutHandlerINotifyPropertyChangedISupportInitializeISupportInitializeNotificationISupportRootUIAutomationISynchronizeInvokeIWin32Window...

Inherited Members DockPopupForm.OnHandleDestroyed(EventArgs)DockPopupForm.OnHandleCreated(EventArgs)DockPopupForm.OnClosed(EventArgs)DockPopupForm.DockManagerRadForm.ScrollToControl(Control)RadForm.ProcessCaptureChangeRequested(RadElement, bool)RadForm.InitializeFormBehavior()RadForm.SetIconPrimitiveVisibility(bool)RadForm.EnableUIAutomationRadForm.TextRadForm.FormElementRadForm.IconScalingRadForm.AllowThemingRadForm.ShowIconRadFormControlBase.newBoundsRadFormControlBase.oldDpiRadFormControlBase.currentDpiRadFormControlBase.isBehaviorPreparedRadFormControlBase.controlIsInitializingRootComponentRadFormControlBase.isPaintingRadFormControlBase.Construct()RadFormControlBase.OnCreateControl()RadFormControlBase.LoadElementTree()RadFormControlBase.LoadElementTree(Size)RadFormControlBase.OnLoad(Size)RadFormControlBase.OnPaint(PaintEventArgs)RadFormControlBase.OnPaintBackground(PaintEventArgs)RadFormControlBase.ProcessDialogKey(Keys)RadFormControlBase.UpdateDefaultButton()RadFormControlBase.OnBackColorChanged(EventArgs)RadFormControlBase.OnForeColorChanged(EventArgs)RadFormControlBase.OnFontChanged(EventArgs)RadFormControlBase.OnParentChanged(EventArgs)RadFormControlBase.ShouldSerializeProperty(RadProperty)RadFormControlBase.ResetFormBehavior(bool)RadFormControlBase.PerformDesignModeLocationCorrection(ref Message)RadFormControlBase.CallBaseWndProc(ref Message)RadFormControlBase.ProcessFocusRequested(RadElement)RadFormControlBase.OnNotifyPropertyChanged(string)RadFormControlBase.OnNotifyPropertyChanged(PropertyChangedEventArgs)RadFormControlBase.CreateChildItems(RadElement)RadFormControlBase.CreateRootElement()RadFormControlBase.OnThemeNameChanged(ThemeNameChangedEventArgs)RadFormControlBase.OnDisplayPropertyChanged(RadPropertyChangedEventArgs)RadFormControlBase.OnToolTipTextNeeded(object, ToolTipTextNeededEventArgs)RadFormControlBase.OnVisibleChanged(EventArgs)RadFormControlBase.OnAutoSizeChanged(EventArgs)RadFormControlBase.OnLayout(LayoutEventArgs)RadFormControlBase.CreateHandle()RadFormControlBase.SetClientSizeCore(int, int)RadFormControlBase.SetBoundsCore(int, int, int, int, BoundsSpecified)RadFormControlBase.GetPreferredSize(Size)RadFormControlBase.InvalidateIfNotSuspended()RadFormControlBase.InvalidateElement(RadElement)RadFormControlBase.InvalidateElement(RadElement, Rectangle)RadFormControlBase.AddInvalidatedRect(Rectangle)RadFormControlBase.SuspendUpdate()RadFormControlBase.ResumeUpdate()RadFormControlBase.ResumeUpdate(bool)RadFormControlBase.RegisterHostedControl(RadHostItem)RadFormControlBase.UnregisterHostedControl(RadHostItem, bool)RadFormControlBase.OnScreenTipNeeded(object, ScreenTipNeededEventArgs)RadFormControlBase.ControlThemeChangedCallback()RadFormControlBase.InvokeLayoutCallback(LayoutCallback)RadFormControlBase.BeginInit()RadFormControlBase.HandleDpiChanged()RadFormControlBase.ScaleControl(SizeF, BoundsSpecified)RadFormControlBase.SuspendDpiScaling()RadFormControlBase.ResumeDpiScaling()RadFormControlBase.OnWm_SettingChange(Message)RadFormControlBase.SiteRadFormControlBase.EnableAnalyticsRadFormControlBase.IsLoadedRadFormControlBase.MaximumSizeRadFormControlBase.MinimumSizeRadFormControlBase.FormBorderStyleRadFormControlBase.FormBehaviorRadFormControlBase.BehaviorRadFormControlBase.SmallImageListRadFormControlBase.FocusedElementRadFormControlBase.AllowShowFocusCuesRadFormControlBase.ShowItemToolTipsRadFormControlBase.CommandBindingsRadFormControlBase.EnableKeyMapRadFormControlBase.WindowsSettingsRadFormControlBase.BackColorRadFormControlBase.ForeColorRadFormControlBase.FontRadFormControlBase.IsDesignModeRadFormControlBase.ElementTreeRadFormControlBase.ThemeNameRadFormControlBase.RootElementRadFormControlBase.IsUpdateSuspendedRadFormControlBase.ImageListRadFormControlBase.SmallImageScalingSizeRadFormControlBase.ImageScalingSizeRadFormControlBase.IsInitializedRadFormControlBase.IsPerformingScaleRadFormControlBase.HasOwnToolbarRadFormControlBase.IsDpiScalingSuspendedRadFormControlBase.ThemeNameChangedRadFormControlBase.ToolTipTextNeededRadFormControlBase.ScreenTipNeededRadFormControlBase.InitializedRadFormControlBase.PropertyChangedRadFormControlBase.WindowsThemeChangedForm.SetVisibleCore(bool)Form.Activate()Form.ActivateMdiChild(Form)Form.AddOwnedForm(Form)Form.AdjustFormScrollbars(bool)Form.Close()Form.CreateControlsInstance()Form.DefWndProc(ref Message)Form.ProcessMnemonic(char)Form.CenterToParent()Form.CenterToScreen()Form.LayoutMdi(MdiLayout)Form.OnBackgroundImageChanged(EventArgs)Form.OnBackgroundImageLayoutChanged(EventArgs)Form.OnFormClosing(FormClosingEventArgs)Form.OnFormClosed(FormClosedEventArgs)Form.OnDeactivate(EventArgs)Form.OnEnabledChanged(EventArgs)Form.OnEnter(EventArgs)Form.OnHelpButtonClicked(CancelEventArgs)Form.OnMaximizedBoundsChanged(EventArgs)Form.OnMaximumSizeChanged(EventArgs)Form.OnMinimumSizeChanged(EventArgs)Form.OnInputLanguageChanged(InputLanguageChangedEventArgs)Form.OnInputLanguageChanging(InputLanguageChangingEventArgs)Form.OnMdiChildActivate(EventArgs)Form.OnMenuStart(EventArgs)Form.OnMenuComplete(EventArgs)Form.OnResize(EventArgs)Form.OnDpiChanged(DpiChangedEventArgs)Form.OnGetDpiScaledSize(int, int, ref Size)Form.OnRightToLeftLayoutChanged(EventArgs)Form.OnTextChanged(EventArgs)Form.ProcessCmdKey(ref Message, Keys)Form.ProcessDialogChar(char)Form.ProcessKeyPreview(ref Message)Form.ProcessTabKey(bool)Form.RemoveOwnedForm(Form)Form.Select(bool, bool)Form.GetScaledBounds(Rectangle, SizeF, BoundsSpecified)Form.SetDesktopBounds(int, int, int, int)Form.SetDesktopLocation(int, int)Form.Show(IWin32Window)Form.ShowDialog()Form.ShowDialog(IWin32Window)Form.ToString()Form.OnResizeBegin(EventArgs)Form.OnResizeEnd(EventArgs)Form.OnStyleChanged(EventArgs)Form.ValidateChildren()Form.ValidateChildren(ValidationConstraints)Form.AcceptButtonForm.ActiveFormForm.ActiveMdiChildForm.AllowTransparencyForm.AutoScrollForm.AutoSizeForm.AutoSizeModeForm.AutoValidateForm.CancelButtonForm.ClientSizeForm.ControlBoxForm.DefaultImeModeForm.DefaultSizeForm.DesktopBoundsForm.DesktopLocationForm.DialogResultForm.HelpButtonForm.IconForm.IsMdiChildForm.IsMdiContainerForm.IsRestrictedWindowForm.KeyPreviewForm.LocationForm.MaximizedBoundsForm.MainMenuStripForm.MenuForm.MaximizeBoxForm.MdiChildrenForm.MdiParentForm.MergedMenuForm.MinimizeBoxForm.ModalForm.OpacityForm.OwnedFormsForm.OwnerForm.RestoreBoundsForm.RightToLeftLayoutForm.ShowInTaskbarForm.ShowWithoutActivationForm.SizeForm.SizeGripStyleForm.StartPositionForm.TopLevelForm.TopMostForm.TransparencyKeyForm.WindowStateForm.AutoSizeChangedForm.AutoValidateChangedForm.HelpButtonClickedForm.MaximizedBoundsChangedForm.MaximumSizeChangedForm.MinimumSizeChangedForm.ActivatedForm.DeactivateForm.FormClosingForm.FormClosedForm.LoadForm.MdiChildActivateForm.MenuCompleteForm.MenuStartForm.InputLanguageChangedForm.InputLanguageChangingForm.RightToLeftLayoutChangedForm.ShownForm.DpiChangedForm.ResizeBeginForm.ResizeEnd...

Constructors

Initializes a new instance of the FloatingWindow class with the specified dock manager.

C#
public FloatingWindow(RadDock dockManager)
Parameters:dockManagerRadDock

The RadDock instance that will own and manage this floating window.

Fields

Defines the default size for floating windows.

C#
public static readonly Size DefaultFloatingSize

Properties

Gets the required creation parameters when the control handle is created.

C#
protected override CreateParams CreateParams { get; }
Property Value:

A CreateParams object containing the required creation parameters when the handle is created.

Overrides: DockPopupForm.CreateParams

Gets the RadSplitContainer instance that is the root of the hierarchy of DockWindows inside this FloatingWindow.

C#
public RadSplitContainer DockContainer { get; }
Property Value:

The RadSplitContainer that hosts the docked windows.

Gets or sets a value indicating whether this window should snap to edges while being moved.

C#
[Browsable(false)]
public bool SnapOnMove { get; set; }
Property Value:

true if snapping while moving is enabled; otherwise, false.

Gets or sets a value indicating whether this window should snap to edges while being resized.

C#
[Browsable(false)]
public bool SnapOnResize { get; set; }
Property Value:

true if snapping while resizing is enabled; otherwise, false.

Gets or sets the distance in pixels between window edges at which snapping occurs.

C#
[Browsable(false)]
public int SnapThreshold { get; set; }
Property Value:

The distance threshold in pixels that triggers the snapping behavior.

Gets or sets a value indicating whether this window should snap to other windows when moved or resized.

C#
[Browsable(false)]
public bool SnapToOthers { get; set; }
Property Value:

true if snapping to other windows is enabled; otherwise, false.

Gets or sets a value indicating whether this window should snap to the screen's edges when moved or resized.

C#
[Browsable(false)]
public bool SnapToScreen { get; set; }
Property Value:

true if snapping to screen edges is enabled; otherwise, false.

Gets or sets a value indicating whether the floating form should be shown in the task bar and behave like a normal form, or it should be kept as a child form of the form which owns the RadDock.

C#
public bool Standalone { get; set; }
Property Value:

true if the window should appear in the taskbar as a standalone window; otherwise, false to keep it as a child window of the form containing the RadDock.

Gets or sets the theme class name for this floating window.

C#
public override string ThemeClassName { get; set; }
Property Value:

The fully qualified name of the FloatingWindow type.

Overrides: RadForm.ThemeClassName

Remarks:

This override enables separate theming for floating windows distinct from standard RadForm controls.

Methods

Determines whether this control defines the theme for a given element.

C#
public override bool ControlDefinesThemeForElement(RadElement element)
Parameters:elementRadElement

The element to check for theme definition.

Returns:

bool

true if the element is a RadFormTitleBarElement; otherwise, the result of the base implementation.

Overrides: RadFormControlBase.ControlDefinesThemeForElement(RadElement)

Remarks:

This override enables separate styling of the title bar in floating windows.

Releases the unmanaged resources used by the FloatingWindow and optionally releases the managed resources.

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

true to release both managed and unmanaged resources; false to release only unmanaged resources.

Overrides: DockPopupForm.Dispose(bool)

Signals the object that initialization is complete.

C#
public override void EndInit()

Overrides: RadForm.EndInit()

Remarks:

This method is called at the end of initialization and updates the visibility of the window.

Gets the target bounds when the window snaps to another one.

C#
public virtual Rectangle GetSnappedBounds(Rectangle desired, ResizeDirection direction, bool resize)
Parameters:desiredRectangle

The original window bounds.

directionResizeDirection

The direction in which the window is being resized/moved.

resizebool

[true] if this is a resize operation, [false] otherwise.

Returns:

Rectangle

The bounds of the window after snapping.

Raises the Activated event and manages z-ordering of all popup forms.

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

An EventArgs that contains the event data.

Overrides: Form.OnActivated(EventArgs)

Remarks:

This override provides support for proper z-ordering of all popup forms belonging to the owning form.

Raises the Closing event.

C#
protected override void OnClosing(CancelEventArgs e)
Parameters:eCancelEventArgs

A CancelEventArgs that contains the event data.

Overrides: Form.OnClosing(CancelEventArgs)

Remarks:

This method cancels the default closing behavior and delegates the closing process to the dock manager.

Raises the Load event.

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

An EventArgs that contains the event data.

Overrides: DockPopupForm.OnLoad(EventArgs)

Raises the Shown event.

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

An EventArgs that contains the event data.

Overrides: RadFormControlBase.OnShown(EventArgs)

Notifies the control that its theme has changed.

C#
protected override void OnThemeChanged()

Overrides: RadFormControlBase.OnThemeChanged()

Remarks:

This method delegates the theme change event to all nested ToolTabStrip instances.

Updates the enabled state of the close button based on the contained dock windows.

C#
public void UpdateCloseButton()

Processes Windows messages sent to the control.

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

The Windows Message to process.

Overrides: RadForm.WndProc(ref Message)