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

Represents a form with customizable shape and appearance that can be themed.

Definition

Namespace:Telerik.WinControls.UI

Assembly:Telerik.WinControls.UI.dll

Syntax:

C#
public class ShapedForm : Form, IDropTarget, ISynchronizeInvoke, IWin32Window, IBindableComponent, IComponent, IDisposable, IContainerControl, IThemeChangeListener

Inheritance: objectMarshalByRefObjectComponentControlScrollableControlContainerControlFormShapedForm...

Derived Classes: MiniToolBarBaseRadCalloutFormRadDiagramSettingsPaneRadFlyoutFormRadOverlayFormRadSplashScreenFormIntelliPromptBase...

Implements: IBindableComponentIComponentIContainerControlIDisposableIDropTargetISynchronizeInvokeIThemeChangeListenerIWin32Window...

Inherited Members Form.SetVisibleCore(bool)Form.Activate()Form.ActivateMdiChild(Form)Form.AddOwnedForm(Form)Form.AdjustFormScrollbars(bool)Form.Close()Form.CreateControlsInstance()Form.CreateHandle()Form.DefWndProc(ref Message)Form.ProcessMnemonic(char)Form.CenterToParent()Form.CenterToScreen()Form.LayoutMdi(MdiLayout)Form.OnActivated(EventArgs)Form.OnBackgroundImageChanged(EventArgs)Form.OnBackgroundImageLayoutChanged(EventArgs)Form.OnClosing(CancelEventArgs)Form.OnClosed(EventArgs)Form.OnFormClosing(FormClosingEventArgs)Form.OnFormClosed(FormClosedEventArgs)Form.OnCreateControl()Form.OnDeactivate(EventArgs)Form.OnEnabledChanged(EventArgs)Form.OnEnter(EventArgs)Form.OnFontChanged(EventArgs)Form.OnHandleCreated(EventArgs)Form.OnHandleDestroyed(EventArgs)Form.OnHelpButtonClicked(CancelEventArgs)Form.OnLayout(LayoutEventArgs)Form.OnMaximizedBoundsChanged(EventArgs)Form.OnMaximumSizeChanged(EventArgs)Form.OnMinimumSizeChanged(EventArgs)Form.OnInputLanguageChanged(InputLanguageChangedEventArgs)Form.OnInputLanguageChanging(InputLanguageChangingEventArgs)Form.OnVisibleChanged(EventArgs)Form.OnMdiChildActivate(EventArgs)Form.OnMenuStart(EventArgs)Form.OnMenuComplete(EventArgs)Form.OnPaint(PaintEventArgs)Form.OnResize(EventArgs)Form.OnDpiChanged(DpiChangedEventArgs)Form.OnGetDpiScaledSize(int, int, ref Size)Form.OnRightToLeftLayoutChanged(EventArgs)Form.OnTextChanged(EventArgs)Form.ProcessCmdKey(ref Message, Keys)Form.ProcessDialogKey(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.UpdateDefaultButton()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.MaximumSizeForm.MainMenuStripForm.MenuForm.MinimumSizeForm.MaximizeBoxForm.MdiChildrenForm.MdiParentForm.MergedMenuForm.MinimizeBoxForm.ModalForm.OpacityForm.OwnedFormsForm.OwnerForm.RestoreBoundsForm.RightToLeftLayoutForm.ShowInTaskbarForm.ShowIconForm.ShowWithoutActivationForm.SizeForm.SizeGripStyleForm.StartPositionForm.TextForm.TopLevelForm.TopMostForm.TransparencyKeyForm.WindowStateForm.AutoSizeChangedForm.AutoValidateChangedForm.HelpButtonClickedForm.MaximizedBoundsChangedForm.MaximumSizeChangedForm.MinimumSizeChangedForm.ActivatedForm.DeactivateForm.FormClosingForm.FormClosedForm.LoadForm.MdiChildActivateForm.MenuCompleteForm.MenuStartForm.InputLanguageChangedForm.InputLanguageChangingForm.RightToLeftLayoutChangedForm.ShownForm.DpiChangedForm.ResizeBeginForm.ResizeEndContainerControl.OnAutoValidateChanged(EventArgs)ContainerControl.OnParentChanged(EventArgs)ContainerControl.PerformAutoScale()ContainerControl.Validate()ContainerControl.Validate(bool)ContainerControl.AutoScaleDimensionsContainerControl.AutoScaleFactorContainerControl.AutoScaleModeContainerControl.BindingContextContainerControl.CanEnableImeContainerControl.ActiveControlContainerControl.CurrentAutoScaleDimensionsContainerControl.ParentFormScrollableControl.ScrollStateAutoScrollingScrollableControl.ScrollStateHScrollVisibleScrollableControl.ScrollStateVScrollVisibleScrollableControl.ScrollStateUserHasScrolledScrollableControl.ScrollStateFullDragScrollableControl.GetScrollState(int)ScrollableControl.OnMouseWheel(MouseEventArgs)ScrollableControl.OnRightToLeftChanged(EventArgs)ScrollableControl.OnPaddingChanged(EventArgs)ScrollableControl.SetDisplayRectLocation(int, int)ScrollableControl.ScrollControlIntoView(Control)ScrollableControl.ScrollToControl(Control)ScrollableControl.OnScroll(ScrollEventArgs)ScrollableControl.SetAutoScrollMargin(int, int)ScrollableControl.SetScrollState(int, bool)ScrollableControl.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.CreateGraphics()Control.CreateControl()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.GetNextControl(Control, bool)Control.GetStyle(ControlStyles)Control.Hide()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.OnBindingContextChanged(EventArgs)Control.OnCausesValidationChanged(EventArgs)Control.OnContextMenuChanged(EventArgs)Control.OnContextMenuStripChanged(EventArgs)Control.OnCursorChanged(EventArgs)Control.OnDockChanged(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.OnLocationChanged(EventArgs)Control.OnDoubleClick(EventArgs)Control.OnDragEnter(DragEventArgs)Control.OnDragOver(DragEventArgs)Control.OnDragLeave(EventArgs)Control.OnDragDrop(DragEventArgs)Control.OnGiveFeedback(GiveFeedbackEventArgs)Control.InvokeGotFocus(Control, EventArgs)Control.OnGotFocus(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.OnMouseDown(MouseEventArgs)Control.OnMouseEnter(EventArgs)Control.OnMouseLeave(EventArgs)Control.OnDpiChangedBeforeParent(EventArgs)Control.OnDpiChangedAfterParent(EventArgs)Control.OnMouseHover(EventArgs)Control.OnMouseMove(MouseEventArgs)Control.OnMouseUp(MouseEventArgs)Control.OnQueryContinueDrag(QueryContinueDragEventArgs)Control.OnRegionChanged(EventArgs)Control.OnPreviewKeyDown(PreviewKeyDownEventArgs)Control.OnChangeUICues(UICuesEventArgs)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.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.SizeFromClientSize(Size)Control.SetStyle(ControlStyles, bool)Control.SetTopLevel(bool)Control.RtlTranslateAlignment(HorizontalAlignment)Control.RtlTranslateAlignment(LeftRightAlignment)Control.RtlTranslateAlignment(ContentAlignment)Control.RtlTranslateHorizontal(HorizontalAlignment)Control.RtlTranslateLeftRight(LeftRightAlignment)Control.RtlTranslateContent(ContentAlignment)Control.Show()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.CompanyNameControl.ContainsFocusControl.ContextMenuControl.ContextMenuStripControl.ControlsControl.CreatedControl.CursorControl.DataBindingsControl.DefaultBackColorControl.DefaultCursorControl.DefaultFontControl.DefaultForeColorControl.DefaultMarginControl.DefaultMaximumSizeControl.DefaultMinimumSizeControl.DefaultPaddingControl.DeviceDpiControl.IsDisposedControl.DisposingControl.DockControl.DoubleBufferedControl.EnabledControl.FocusedControl.FontHeightControl.HandleControl.HasChildrenControl.HeightControl.IsHandleCreatedControl.InvokeRequiredControl.IsAccessibleControl.IsMirroredControl.LeftControl.MarginControl.ModifierKeysControl.MouseButtonsControl.MousePositionControl.NameControl.ParentControl.ProductNameControl.ProductVersionControl.RecreatingHandleControl.RegionControl.RenderRightToLeftControl.ResizeRedrawControl.RightControl.RightToLeftControl.ScaleChildrenControl.SiteControl.TabIndexControl.TabStopControl.TagControl.TopControl.TopLevelControlControl.ShowKeyboardCuesControl.ShowFocusCuesControl.UseWaitCursorControl.VisibleControl.WidthControl.PreferredSizeControl.PaddingControl.ImeModeControl.ImeModeBaseControl.PropagatingImeModeControl.BackColorChangedControl.BackgroundImageChangedControl.BackgroundImageLayoutChangedControl.BindingContextChangedControl.CausesValidationChangedControl.ClientSizeChangedControl.ContextMenuChangedControl.ContextMenuStripChangedControl.CursorChangedControl.DockChangedControl.EnabledChangedControl.FontChangedControl.ForeColorChangedControl.LocationChangedControl.MarginChangedControl.RegionChangedControl.RightToLeftChangedControl.SizeChangedControl.TabIndexChangedControl.TabStopChangedControl.TextChangedControl.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 instance of the ShapedForm class.

C#
public ShapedForm()

Properties

Allow form's resize

C#
[Browsable(true)]
public bool AllowResize { get; set; }

Gets or sets the BackColor of the ShapedForm.

C#
public override Color BackColor { get; set; }

Overrides: Form.BackColor

Gets or sets the pen alignment for the border.

C#
public PenAlignment BorderAlignment { get; set; }

Gets or sets the form's border color

C#
[Browsable(true)]
public Color BorderColor { get; set; }
C#
protected GraphicsPath BorderPath { get; set; }

Gets or sets the form's border width

C#
[Browsable(true)]
public virtual int BorderWidth { get; set; }

Gets or sets the theme class name for the control.

C#
public string ControlThemeClassName { get; }

Implements: IThemeChangeListener.ControlThemeClassName

C#
protected override CreateParams CreateParams { get; }

Overrides: Form.CreateParams

Enables or disables transparent background on Vista

C#
[Browsable(true)]
public bool EnableCompositionOnVista { get; set; }

Gets or sets the form's font

C#
[Browsable(true)]
public override Font Font { get; set; }

Overrides: Control.Font

Gets or sets the form's foreground color

C#
[Browsable(true)]
public override Color ForeColor { get; set; }

Overrides: Control.ForeColor

Gets or sets the FormBorderStyle of the Form.

C#
public FormBorderStyle FormBorderStyle { get; set; }
C#
protected GraphicsPath OuterPath { get; set; }

Gets or sets an instance of the Shape object of a form. The shape of the form is responsible for providing its' border(s) with custom shape.

C#
[Browsable(true)]
public virtual ElementShape Shape { get; set; }
Remarks:

Some predefined shapes are available, like RoundRectShape or EllipseShape. CustomShape offers a way to specify element's shape with a sequence of points and curves using code or the design time ElementShapeEditor UITypeEditor.

C#
protected RadControl ShapedControl { get; }

Gets or sets theme name.

C#
[Browsable(true)]
public string ThemeName { get; set; }

Gets or sets the windows related setting. Exposes API to round the form's corners on Windows 11. Using the rounded corners API with form's shapes that are not rectangular may lead to unexpected results.

C#
public WindowsSettings WindowsSettings { get; set; }

Methods

C#
protected virtual void ApplicationThemeChanged(object sender, ThemeChangedEventArgs args)
Parameters:senderobjectargsThemeChangedEventArgs
C#
protected virtual void ApplyShape()
C#
protected virtual void ApplyTheme(string themeName)
Parameters:themeNamestring
C#
protected virtual GraphicsPath CreateBorderPath()
Returns:

GraphicsPath

Clean up any resources being used.

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

true if managed resources should be disposed; otherwise, false.

Overrides: Form.Dispose(bool)

C#
protected virtual int GetHitTest(Point point)
Parameters:pointPointReturns:

int

C#
protected virtual bool IsRectangularShape(ref int radius)
Parameters:radiusintReturns:

bool

C#
public static short LOWORD(int number)
Parameters:numberintReturns:

short

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

Overrides: Form.OnLoad(EventArgs)

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

Overrides: Control.OnMove(EventArgs)

C#
protected override void OnPaintBackground(PaintEventArgs e)
Parameters:ePaintEventArgs

Overrides: ScrollableControl.OnPaintBackground(PaintEventArgs)

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

Overrides: Form.OnResizeBegin(EventArgs)

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

Overrides: Form.OnResizeEnd(EventArgs)

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

Overrides: Form.OnShown(EventArgs)

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

Overrides: Control.OnSizeChanged(EventArgs)

Handles theme change events to update the form's appearance.

C#
public void OnThemeChanged(ThemeChangedEventArgs e)
Parameters:eThemeChangedEventArgs

The theme changed event arguments.

Implements: IThemeChangeListener.OnThemeChanged(ThemeChangedEventArgs)

C#
protected virtual void PaintBorder(Graphics g)
Parameters:gGraphics
C#
protected virtual void PaintFrame(Graphics g)
Parameters:gGraphics
C#
protected override void ScaleControl(SizeF factor, BoundsSpecified specified)
Parameters:factorSizeFspecifiedBoundsSpecified

Overrides: Form.ScaleControl(SizeF, BoundsSpecified)

C#
protected override void SetBoundsCore(int x, int y, int width, int height, BoundsSpecified specified)
Parameters:xintyintwidthintheightintspecifiedBoundsSpecified

Overrides: Form.SetBoundsCore(int, int, int, int, BoundsSpecified)

C#
protected override void SetClientSizeCore(int x, int y)
Parameters:xintyint

Overrides: Form.SetClientSizeCore(int, int)

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

Overrides: Form.WndProc(ref Message)