Class RadStatusStrip

Represents a status strip control that displays status information in an application. The RadStatusStrip class is a wrapper for the RadStatusBarElement class and acts to transfer events to and from its corresponding element.

Inheritance
System.Object
RadControl
RadStatusStrip
Inherited Members
Namespace: Telerik.WinControls.UI
Assembly: Telerik.WinControls.UI.dll

Syntax

[TelerikToolboxCategory("Menus & Toolbars")]
public class RadStatusStrip : RadControl, INotifyPropertyChanged, ISupportInitializeNotification, ISupportInitialize, IComponentTreeHandler, ILayoutHandler, IPCHost, IAnalyticsProvider, IExtenderProvider

Constructors

RadStatusStrip()

Initializes a new instance of the RadStatusStrip class.

Declaration
public RadStatusStrip()

Properties

AutoSize

Gets or sets a value indicating whether the status strip is automatically resized to display its entire contents.

Declaration
public override bool AutoSize { get; set; }
Property Value
System.Boolean

Overrides

BackColor

Gets or sets the background color of the status strip. RadStatusStrip consists of multiple visual elements and separate settings are provided to customize their appearance. Current BackColor property might be ignored.

Declaration
public override Color BackColor { get; set; }
Property Value
System.Drawing.Color

Overrides

DefaultSize

Gets the default size for the status strip control.

Declaration
protected override Size DefaultSize { get; }
Property Value
System.Drawing.Size

Dock

Gets or sets the docking behavior of the status strip control. The default value is System.Windows.Forms.DockStyle.Bottom.

Declaration
public override DockStyle Dock { get; set; }
Property Value
System.Windows.Forms.DockStyle

ForeColor

Gets or sets the foreground color of the status strip. RadStatusStrip consists of multiple visual elements and separate settings are provided to customize their appearance. Current ForeColor property might be ignored.

Declaration
public override Color ForeColor { get; set; }
Property Value
System.Drawing.Color

Overrides

Items

Gets the collection of items that belong to the RadStatusStrip.

Declaration
[RadEditItemsAction]
[RadNewItem("Type here", true)]
public RadItemOwnerCollection Items { get; }
Property Value
RadItemOwnerCollection

LayoutStyle

Gets or sets the layout style of the RadStatusStrip.

Declaration
public RadStatusBarLayoutStyle LayoutStyle { get; set; }
Property Value
RadStatusBarLayoutStyle

SizingGrip

Gets or sets a value indicating whether the sizing grip is visible for repositioning the control.

Declaration
public bool SizingGrip { get; set; }
Property Value
System.Boolean

StatusBarElement

Gets the instance of RadStatusBarElement wrapped by this control. RadStatusBarElement is the main element in the hierarchy tree and encapsulates the actual functionality of RadStatusStrip.

Declaration
public RadStatusBarElement StatusBarElement { get; }
Property Value
RadStatusBarElement

Text

This property is not relevant for this class.

Declaration
public override string Text { get; set; }
Property Value
System.String

Overrides

Methods

CanExtend(Object)

Determines whether this extender provider can extend the specified object.

Declaration
public bool CanExtend(object extendee)
Parameters
System.Object extendee

The object to test for extensibility.
Returns
System.Boolean

True if the object can be extended; otherwise, false.

CreateAccessibilityInstance()

Creates an accessibility object for the status strip.

Declaration
protected override AccessibleObject CreateAccessibilityInstance()
Returns
System.Windows.Forms.AccessibleObject

An System.Windows.Forms.AccessibleObject instance for accessibility support.

CreateChildItems(RadElement)

Creates child items for the status strip.

Declaration
protected override void CreateChildItems(RadElement parent)
Parameters
RadElement parent

The parent element to which child items will be added.
Overrides

GetSpring(RadItem)

Gets the spring property value for the specified RadItem.

Declaration
public bool GetSpring(RadItem control)
Parameters
RadItem control

The RadItem to get the spring property for.
Returns
System.Boolean

True if spring behavior is enabled; otherwise, false.

InitializeRootElement(RootRadElement)

Initializes the root element with appropriate stretch settings.

Declaration
protected override void InitializeRootElement(RootRadElement rootElement)
Parameters
RootRadElement rootElement

The root element to initialize.
Overrides

OnMouseClick(MouseEventArgs)

Raises the System.Windows.Forms.Control.MouseClick event and fires the StatusBarClick event.

Declaration
protected override void OnMouseClick(MouseEventArgs e)
Parameters
System.Windows.Forms.MouseEventArgs e

The mouse event arguments.

ProcessAutoSizeChanged(Boolean)

Processes auto-size changes for the status strip.

Declaration
protected override void ProcessAutoSizeChanged(bool value)
Parameters
System.Boolean value

The new auto-size value.
Overrides

ProcessCodedUIMessage(ref IPCMessage)

Processes coded UI messages for automation support.

Declaration
protected override void ProcessCodedUIMessage(ref IPCMessage request)
Parameters
IPCMessage request

The IPC message containing the request information.
Overrides

ResetBackColorThemeOverrides()

Resets theme overrides for the background color property.

Declaration
protected override void ResetBackColorThemeOverrides()
Overrides

ResetForeColorThemeOverrides()

Resets theme overrides for the foreground color property.

Declaration
protected override void ResetForeColorThemeOverrides()
Overrides

SetBackColorThemeOverrides()

Sets theme overrides for the background color property.

Declaration
protected override void SetBackColorThemeOverrides()
Overrides

SetForeColorThemeOverrides()

Sets theme overrides for the foreground color property.

Declaration
protected override void SetForeColorThemeOverrides()
Overrides

SetSpring(RadItem, Boolean)

Sets the spring property for the specified RadItem.

Declaration
public void SetSpring(RadItem control, bool value)
Parameters
RadItem control

The RadItem to set the spring property for.
System.Boolean value

True to enable spring behavior; otherwise, false.

WmNCHitTest(ref Message)

Handles the WM_NCHITTEST Windows message for proper hit testing.

Declaration
protected virtual bool WmNCHitTest(ref Message msg)
Parameters
System.Windows.Forms.Message msg

The Windows message to process.
Returns
System.Boolean

True if the message was handled; otherwise, false.

WndProc(ref Message)

Processes Windows messages for the status strip control.

Declaration
protected override void WndProc(ref Message m)
Parameters
System.Windows.Forms.Message m

The Windows message to process.
Overrides

Events

LayoutStyleChanged

Occurs after the layout style has changed.

Declaration
public event EventHandler LayoutStyleChanged
Event Type
System.EventHandler

LayoutStyleChanging

Occurs before the layout style is changing.

Declaration
public event ValueChangingEventHandler LayoutStyleChanging
Event Type
ValueChangingEventHandler

StatusBarClick

Occurs when the status bar is clicked.

Declaration
public event RadStatusStrip.RadStatusBarClickEvenHandler StatusBarClick
Event Type
RadStatusStrip.RadStatusBarClickEvenHandler

Extension Methods