New to Telerik UI for WinForms? Start a free 30-day trial

Implements non-client window behavior for RadTabbedForm, including tab-caption input and composition layout.

Definition

Namespace:Telerik.WinControls.UI

Assembly:Telerik.WinControls.UI.dll

Syntax:

C#
public class RadTabbedFormBehavior : RadNonClientUIBaseFormBehavior<RadTabbedFormControl>, IComponent, IDisposable

Inheritance: objectMarshalByRefObjectComponentFormControlBehaviorThemedFormBehaviorRadNonClientUIBaseFormBehavior<RadTabbedFormControl>RadTabbedFormBehavior...

Implements: IComponentIDisposable

Inherited Members RadNonClientUIBaseFormBehavior<RadTabbedFormControl>.RegionHeightEllipseRadNonClientUIBaseFormBehavior<RadTabbedFormControl>.MaxFormBorderHeightRadNonClientUIBaseFormBehavior<RadTabbedFormControl>.capturedNCItemRadNonClientUIBaseFormBehavior<RadTabbedFormControl>.Dispose(bool)RadNonClientUIBaseFormBehavior<RadTabbedFormControl>.CreateChildItems(RadElement)RadNonClientUIBaseFormBehavior<RadTabbedFormControl>.CreateParams(CreateParams)RadNonClientUIBaseFormBehavior<RadTabbedFormControl>.HandleWndProc(ref Message)RadNonClientUIBaseFormBehavior<RadTabbedFormControl>.CanHandleWndProc()RadNonClientUIBaseFormBehavior<RadTabbedFormControl>.UpdateMDIButtonsAndCaptionText()RadNonClientUIBaseFormBehavior<RadTabbedFormControl>.AdjustSystemButtonsForStyle()RadNonClientUIBaseFormBehavior<RadTabbedFormControl>.AdjustFormIconVisibility()RadNonClientUIBaseFormBehavior<RadTabbedFormControl>.IsApplicationMenu()RadNonClientUIBaseFormBehavior<RadTabbedFormControl>.OnWmMDIActivate(ref Message)RadNonClientUIBaseFormBehavior<RadTabbedFormControl>.OnWmSetIcon(ref Message)RadNonClientUIBaseFormBehavior<RadTabbedFormControl>.OnWmSetText(ref Message)RadNonClientUIBaseFormBehavior<RadTabbedFormControl>.OnGetMinMaxInfo(MinMaxInfo)RadNonClientUIBaseFormBehavior<RadTabbedFormControl>.OnActiveMDIChildTextChanged()RadNonClientUIBaseFormBehavior<RadTabbedFormControl>.FormHandleCreated()RadNonClientUIBaseFormBehavior<RadTabbedFormControl>.OnAssociatedFormPaintBackground(PaintEventArgs)RadNonClientUIBaseFormBehavior<RadTabbedFormControl>.OnFormAssociated()RadNonClientUIBaseFormBehavior<RadTabbedFormControl>.InitializeDummyMenuStrip()RadNonClientUIBaseFormBehavior<RadTabbedFormControl>.Form_Load(object, EventArgs)RadNonClientUIBaseFormBehavior<RadTabbedFormControl>.NCFromClientCoordinates(Point)RadNonClientUIBaseFormBehavior<RadTabbedFormControl>.ExtendFrameIntoClientArea()RadNonClientUIBaseFormBehavior<RadTabbedFormControl>.ResetFormRegion()RadNonClientUIBaseFormBehavior<RadTabbedFormControl>.NonClientUIControlRadNonClientUIBaseFormBehavior<RadTabbedFormControl>.FormElementRadNonClientUIBaseFormBehavior<RadTabbedFormControl>.ClientMarginRadNonClientUIBaseFormBehavior<RadTabbedFormControl>.CaptionHeightRadNonClientUIBaseFormBehavior<RadTabbedFormControl>.CompositionEffectsEnabledRadNonClientUIBaseFormBehavior<RadTabbedFormControl>.CompositionEnabledRadNonClientUIBaseFormBehavior<RadTabbedFormControl>.AllowThemingRadNonClientUIBaseFormBehavior<RadTabbedFormControl>.MenuBoundsRadNonClientUIBaseFormBehavior<RadTabbedFormControl>.IconBoundsRadNonClientUIBaseFormBehavior<RadTabbedFormControl>.CaptionTextBoundsRadNonClientUIBaseFormBehavior<RadTabbedFormControl>.SystemButtonsBoundsThemedFormBehavior.GetMappedWindowPoint(Point)ThemedFormBehavior.GetMaximumFormHeightAccordingToCurrentScreen()ThemedFormBehavior.OnWindowStateChanged(int, int)ThemedFormBehavior.RefreshNC()ThemedFormBehavior.InvalidateNC(Rectangle)ThemedFormBehavior.OnNCPaint(Graphics)ThemedFormBehavior.PaintElement(IGraphics, Rectangle, VisualElement)ThemedFormBehavior.InvalidateElement(RadElement, Rectangle)ThemedFormBehavior.IsMaximizedThemedFormBehavior.IsMinimizedThemedFormBehavior.IsNormalThemedFormBehavior.CurrentFormStateThemedFormBehavior.IsMdiChildMaximizedThemedFormBehavior.FormMdiClientThemedFormBehavior.IsMenuInFormThemedFormBehavior.MainMenuInFormThemedFormBehavior.MaximizedMDIChildThemedFormBehavior.TopResizeFrameThemedFormBehavior.TopLeftResizeFrameThemedFormBehavior.LeftResizeFrameThemedFormBehavior.BottomLeftResizeFrameThemedFormBehavior.BottomResizeFrameThemedFormBehavior.BottomRightResizeFrameThemedFormBehavior.RightResizeFrameThemedFormBehavior.TopRightResizeFrameThemedFormBehavior.CaptionFrameThemedFormBehavior.LeftBorderFrameThemedFormBehavior.BottomBorderFrameThemedFormBehavior.RightBorderFrameThemedFormBehavior.ClientFrameThemedFormBehavior.CurrentFormParamsThemedFormBehavior.FormFormControlBehavior.targetHandlerFormControlBehavior.CallBaseWndProc(ref Message)FormControlBehavior.CallDefWndProc(ref Message)FormControlBehavior.OnAssociatedFormPaint(PaintEventArgs)...

Constructors

Initializes the behavior without an associated component tree handler.

C#
public RadTabbedFormBehavior()

Initializes the behavior and specifies whether it should create child items for the component tree.

C#
public RadTabbedFormBehavior(IComponentTreeHandler treeHandler, bool shouldHandleCreateChildItems)
Parameters:treeHandlerIComponentTreeHandler

The component tree handler whose form behavior is managed.

shouldHandleCreateChildItemsbool

Whether this behavior should create the form's child items.

Initializes the behavior for the specified component tree handler.

C#
public RadTabbedFormBehavior(IComponentTreeHandler treeHandler)
Parameters:treeHandlerIComponentTreeHandler

The component tree handler whose form behavior is managed.

Properties

Gets the border thickness configured on the tabbed form element.

C#
public override Padding BorderWidth { get; }

Overrides: FormControlBehavior.BorderWidth

Gets the tab control associated with the form, when one has been added.

C#
protected virtual RadTabbedFormControl TabbedFormControl { get; }

Gets the height reserved for the caption and tabs in the non-client frame, including the frame border when maximized.

C#
public override int TopCompositionMargin { get; }

Overrides: RadNonClientUIBaseFormBehavior<RadTabbedFormControl>.TopCompositionMargin

Methods

Switches between composed and non-composed form layouts, preserving the tab control's theme-related settings.

C#
protected override void AdjustBehaviorForCompositionSate()

Overrides: RadNonClientUIBaseFormBehavior<RadTabbedFormControl>.AdjustBehaviorForCompositionSate()

Mirrors native maximize, restore, and minimize state changes onto the form element and its border.

C#
protected override void AdjustFormElementForFormState(int? formState)
Parameters:formStateint?

Overrides: RadNonClientUIBaseFormBehavior<RadTabbedFormControl>.AdjustFormElementForFormState(int?)

Allows designer parent notifications only when the pointer is over the tab control, excluding create and destroy messages.

C#
protected override bool CanHandleParentNotify(ref Message m)
Parameters:mMessageReturns:

bool

Overrides: RadNonClientUIBaseFormBehavior<RadTabbedFormControl>.CanHandleParentNotify(ref Message)

Creates the element that supplies the tabbed form's state and border.

C#
protected override RadElement CreateFormElement()
Returns:

RadElement

Overrides: RadNonClientUIBaseFormBehavior<RadTabbedFormControl>.CreateFormElement()

Removes the property-change subscriptions installed on the tab control's caption and tab strip.

C#
protected override void DisposeNonClientUIControlImpls()

Overrides: RadNonClientUIBaseFormBehavior<RadTabbedFormControl>.DisposeNonClientUIControlImpls()

Subscribes to caption and tab-strip property changes when the tab control is added to the form.

C#
protected override void Form_ControlAdded(object sender, ControlEventArgs e)
Parameters:senderobjecteControlEventArgs

Overrides: RadNonClientUIBaseFormBehavior<RadTabbedFormControl>.Form_ControlAdded(object, ControlEventArgs)

Recomputes frame padding and composition layout when the form's size or window state changes.

C#
protected override void Form_SizeChanged(object sender, EventArgs e)
Parameters:senderobjecteEventArgs

Overrides: RadNonClientUIBaseFormBehavior<RadTabbedFormControl>.Form_SizeChanged(object, EventArgs)

Finds the tab control hosted by the form and synchronizes its composition setting.

C#
protected override void InitializeNonClientUIControl()

Overrides: RadNonClientUIBaseFormBehavior<RadTabbedFormControl>.InitializeNonClientUIControl()

Updates the active visual state of the form and its tab control from the native activation message.

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

Overrides: RadNonClientUIBaseFormBehavior<RadTabbedFormControl>.OnWMActivateCore(ref Message)

Routes a non-client left-button press to the element under the pointer, preserving native handling when no element handles it.

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

Overrides: RadNonClientUIBaseFormBehavior<RadTabbedFormControl>.OnWmNCLeftMouseButtonDown(ref Message)

Routes a non-client left-button release to the pressed element and opens the system menu when the form icon is clicked.

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

Overrides: RadNonClientUIBaseFormBehavior<RadTabbedFormControl>.OnWmNCLeftMouseButtonUp(ref Message)

Shows the system menu when a right-button release occurs within the tabbed form's caption area.

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

Overrides: RadNonClientUIBaseFormBehavior<RadTabbedFormControl>.OnWMNCRightButtonUp(ref Message)

Selects the tab under the pointer when the designer sends a left-button parent notification.

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

Overrides: RadNonClientUIBaseFormBehavior<RadTabbedFormControl>.OnWmParentNotifyInDesigner(ref Message)

Updates composition, window styles, and the extended frame when the form's theming mode changes.

C#
protected override void UpdateFormForThemingState(bool showAero)
Parameters:showAerobool

Overrides: RadNonClientUIBaseFormBehavior<RadTabbedFormControl>.UpdateFormForThemingState(bool)

Applies the current composition setting to the hosted tab control.

C#
protected override void UpdateNCComposition()

Overrides: RadNonClientUIBaseFormBehavior<RadTabbedFormControl>.UpdateNCComposition()