StatusBar Class

[ToolboxBitmap(typeof(StatusBar))]
public class StatusBar : UIControl, IUIControl, IUIElement, ILogicalTreeNode, IDpiAwareElement, IDisposable, IWeakEventListener

public StatusBar()

[Browsable(false)]
public override AnchorStyles Anchor { get; set; }

Property Value

AnchorStyles:

A bitwise combination of the AnchorStyles values. The default is Top and Left.

public override DockStyle Dock { get; set; }

Property Value

DockStyle:

One of the DockStyle values. The default is None.

Exceptions

Type	Condition
InvalidEnumArgumentException	The value assigned is not one of the DockStyle values.

[Browsable(false)]
public bool Enabled { get; set; }

Property Value

bool:

true if the control can respond to user interaction; otherwise, false. The default is true.

public bool GripperVisible { get; set; }

Property Value

bool:

true if the gripper is visible; otherwise, false.

public ImageList? ImageList { get; set; }

Property Value

ImageList:

The default value is a null.

public StatusBarPanelCollection Panels { get; }

Property Value

StatusBarPanelCollection

public IStatusBarRenderer? Renderer { get; set; }

Property Value

IStatusBarRenderer

Remarks

If this value is null, then the global renderer will be used instead.

[Browsable(false)]
public IStatusBarRenderer RendererResolved { get; }

Property Value

IStatusBarRenderer

Remarks

This property will return a global renderer if there is no control instance renderer override. The registered renderer type with the UIRendererManager for this property is IStatusBarRenderer.

[Browsable(false)]
public int TabIndex { get; set; }

Property Value

int:

The index value of the control within the set of controls within its container. The controls in the container are included in the tab order.

[Browsable(false)]
public bool TabStop { get; set; }

Property Value

bool:

    <code>true</code> if the user can give the focus to the control using the TAB key; otherwise, <code>false</code>. The default is <code>true</code>.

Note: This property will always return true for an instance of the Form class.

protected override Size ArrangeOverride(Size finalSize)

Parameter	Type	Description
finalSize	Size	The final area within the parent that this element should use to arrange itself and its children.

Returns

Size:

The actual size used.

Remarks

Element authors should override this method, call Arrange(Rectangle) on each visible child element and position each child element. It is required that a parent element calls Arrange(Rectangle) on each child or they won't be rendered.

protected override IList<ILogicalTreeNode> CreateChildren()

Returns

IList<ILogicalTreeNode>:

The list that should be assigned to the Children property.

Remarks

By default, no child collection is created.

protected override void Dispose(bool disposing)

Parameter	Type	Description
disposing	bool	true to release both managed and unmanaged resources; false to release only unmanaged resources.

public override void DpiScaleChanged(SizeF scaleFactor)

Parameter	Type	Description
scaleFactor	SizeF	The new scale factor where Width is applied to the x-axis, and Height is applied to the y-axis.

See Also

• DpiScaleFactor

public override Cursor? GetCursor(Point point)

Parameter	Type	Description
point	Point	The Point to examine.

Returns

Cursor

protected override Size MeasureOverride(Graphics? g, Size availableSize)

Parameter	Type	Description
g	Graphics	The Graphics object to use for measurement.
availableSize	Size	The available size that this element can give to child elements. Infinity can be specified as a value to indicate that the element will size to whatever content is available.

Returns

Size:

The size that this element determines it needs during layout, based on its calculations of child element sizes.

Remarks

Element authors should override this method, call Measure(Graphics?, Size) on each visible child element and determine the total size required.

protected override void OnMouseLeave(EventArgs e)

Parameter	Type	Description
e	EventArgs	An EventArgs that contains the event data.

protected override void OnMouseMove(MouseEventArgs e)

Parameter	Type	Description
e	MouseEventArgs	A MouseEventArgs that contains the event data.

protected override void OnRender(PaintEventArgs e)

Parameter	Type	Description
e	PaintEventArgs	The event data.

protected virtual void OnStatusBarPanelClick(StatusBarPanelMouseEventArgs e)

Parameter	Type	Description
e	StatusBarPanelMouseEventArgs	The event data.

protected override void WndProc(ref Message m)

Parameter	Type	Description
m	Message	The Windows Message to process.

public event StatusBarPanelMouseEventHandler? StatusBarPanelClick

Event Type

StatusBarPanelMouseEventHandler