Class StatusStripEx

StatusStrip control extended. ///

Inheritance
System.Object
StatusStripEx
Namespace: Syncfusion.Windows.Forms.Tools
Assembly: Syncfusion.Tools.Windows.dll
Syntax
public class StatusStripEx : StatusStrip, IThemeProvider, IVisualStyle, IDockExtended

Constructors

StatusStripEx()

Declaration
public StatusStripEx()

Properties

BackColor

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

BeforeTouchSize

Gets/Sets Control size before touch enabled

Declaration
public Size BeforeTouchSize { get; set; }
Property Value
Type Description
System.Drawing.Size

CanApplyTheme

Gets or sets a value indicating whether a SkinManager theme style has been applied to the control.

Declaration
public bool CanApplyTheme { get; set; }
Property Value
Type Description
System.Boolean

The default value is true.

CanOverrideStyle

Gets or sets a value indicating whether control elements styles can be overridden by theme style settings.

Declaration
public bool CanOverrideStyle { get; set; }
Property Value
Type Description
System.Boolean

Default value is false.
Remarks

By default, the control's element styles will not be overridden by theme style settings if the style is set in sample level. If this property is enabled, element style will be overridden by theme style settings event if it is set in sample level. This property should be enabled or disabled before calling the ThemeName property of the control.

ContextMenuStrip

Gets or sets the context menu strip associated with this control. (overridden property)

Declaration
public override ContextMenuStrip ContextMenuStrip { get; set; }
Property Value
Type Description
System.Windows.Forms.ContextMenuStrip

Dock

Gets or sets which control borders are docked to its parent control and determines how a control is resized with its parent.

Declaration
public DockStyleEx Dock { get; set; }
Property Value
Type Description
DockStyleEx

EnableTouchMode

gets or sets the touchmode

Declaration
public virtual bool EnableTouchMode { get; set; }
Property Value
Type Description
System.Boolean

IsVisualStyleEnabled

Gets a value indicating whether the visual style based theme is applied to the control. This also indicates whether the theme files are referred from external assemblies or not.

Declaration
public bool IsVisualStyleEnabled { get; }
Property Value
Type Description
System.Boolean

Return true, if the visual style based theme is applied to control. Otherwise returns false.

LayoutEngine

Gets a cached instance of the control's layout engine.

Declaration
public override LayoutEngine LayoutEngine { get; }
Property Value
Type Description
System.Windows.Forms.Layout.LayoutEngine

MetroColor

Gets or sets the theme color of the ColorUI

Declaration
public Color MetroColor { get; set; }
Property Value
Type Description
System.Drawing.Color

MetroSeperatorColor

Gets/Sets the MetroSeperatorColor of StatusStripEx

Declaration
public Color MetroSeperatorColor { get; set; }
Property Value
Type Description
System.Drawing.Color

OfficeColorScheme

Gets or sets whether the Office color scheme should be Silver or Blue.

Declaration
public virtual ToolStripEx.ColorScheme OfficeColorScheme { get; set; }
Property Value
Type Description
ToolStripEx.ColorScheme

RenderMode

Gets or sets the StatusStripEx render mode. A value that indicates the visual style to apply. The default value is Custom.

Declaration
public ToolStripRenderMode RenderMode { get; set; }
Property Value
Type Description
System.Windows.Forms.ToolStripRenderMode

ShowSeparator

Gets or sets a value indicating whether the separator should be displayed or not.

Declaration
public bool ShowSeparator { get; set; }
Property Value
Type Description
System.Boolean

StatusControlsArea

Gets the area where Status controls are located.

Declaration
public Rectangle StatusControlsArea { get; }
Property Value
Type Description
System.Drawing.Rectangle

ThemeName

Gets or sets the theme name of the StatusStripEx control.

Declaration
public string ThemeName { get; set; }
Property Value
Type Description
System.String

ThemeStyle

Declaration
public StatusStripExVisualStyle ThemeStyle { get; set; }
Property Value
Type Description
StatusStripExVisualStyle

VisualStyle

Gets or sets an advanced appearance for the StatusStripEx.

Declaration
public StatusStripExStyle VisualStyle { get; set; }
Property Value
Type Description
StatusStripExStyle

Methods

ApplyScaleToControl(Single)

applies the scaling

Declaration
public void ApplyScaleToControl(float sf)
Parameters
Type Name Description
System.Single sf

Dispose(Boolean)

Declaration
protected override void Dispose(bool disposing)
Parameters
Type Name Description
System.Boolean disposing

GetActiveThemeName()

Gets the active theme name of the StatusStripEx control.

Declaration
public string GetActiveThemeName()
Returns
Type Description
System.String

Returns the active theme name.

GetPreferredSize(Size)

Retrieves the size of a rectangular area into which a control can be fitted.

Declaration
public override Size GetPreferredSize(Size proposedSize)
Parameters
Type Name Description
System.Drawing.Size proposedSize

Proposed size
Returns
Type Description
System.Drawing.Size

Returns Size

OnControlAdded(ControlEventArgs)

Declaration
protected override void OnControlAdded(ControlEventArgs e)
Parameters
Type Name Description
System.Windows.Forms.ControlEventArgs e

OnFontChanged(EventArgs)

Font changed event

Declaration
protected override void OnFontChanged(EventArgs e)
Parameters
Type Name Description
System.EventArgs e

OnHandleDestroyed(EventArgs)

Declaration
protected override void OnHandleDestroyed(EventArgs e)
Parameters
Type Name Description
System.EventArgs e

OnLayout(LayoutEventArgs)

Declaration
protected override void OnLayout(LayoutEventArgs lea)
Parameters
Type Name Description
System.Windows.Forms.LayoutEventArgs lea

OnParentChanged(EventArgs)

Declaration
protected override void OnParentChanged(EventArgs e)
Parameters
Type Name Description
System.EventArgs e

OnRendererChanged(EventArgs)

Declaration
protected override void OnRendererChanged(EventArgs e)
Parameters
Type Name Description
System.EventArgs e

OnSizeChanged(EventArgs)

Declaration
protected override void OnSizeChanged(EventArgs e)
Parameters
Type Name Description
System.EventArgs e

ResetBackColor()

Resets the BackColor property to it's default value.

Declaration
public override void ResetBackColor()

ResetOfficeColorScheme()

Resets the office color scheme.

Declaration
public void ResetOfficeColorScheme()

SetBoundsCore(Int32, Int32, Int32, Int32, BoundsSpecified)

Declaration
protected override void SetBoundsCore(int x, int y, int width, int height, BoundsSpecified specified)
Parameters
Type Name Description
System.Int32 x
System.Int32 y
System.Int32 width
System.Int32 height
System.Windows.Forms.BoundsSpecified specified

ShouldSerializeOfficeColorScheme()

Indicates whether the current value of the OfficeColorScheme property is to be serialized.

Declaration
public bool ShouldSerializeOfficeColorScheme()
Returns
Type Description
System.Boolean

Returns bool value

WndProc(ref Message)

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

Events

ThemeNameChanged

Occurs when theme name of the StatusStripEx has changed.

Declaration
public event ThemeChangedEventHandler ThemeNameChanged
Event Type
Type Description
ThemeChangedEventHandler

Explicit Interface Implementations

IVisualStyle.VisualTheme

Declaration
string IVisualStyle.VisualTheme { get; set; }
Returns
Type Description
System.String

IThemeProvider.BaseThemeName

Gets or sets the BaseTheme name of the theme

Declaration
string IThemeProvider.BaseThemeName { get; set; }
Returns
Type Description
System.String

IThemeProvider.ControlName

Gets the name of the control.

Declaration
string IThemeProvider.ControlName { get; }
Returns
Type Description
System.String

Implements