Not logged in▾
Log In Register
Forgot Password Resend Validation E-mail
In This Article

StatusBarLabelPanel Class

Namespace:
ActiproSoftware.UI.WinForms.Controls.Bars
Assembly:
ActiproSoftware.Bars.WinForms.dll

Represents a label panel for a StatusBar.

public class StatusBarLabelPanel : StatusBarPanel, IInputElement, IUIElement, ILogicalTreeNode, IDpiAwareElement, IDisposable, IImageListProvider
Inheritance:
object MarshalByRefObject MarshalByRefDisposableObject LogicalTreeNodeBase UIElement StatusBarPanel object
Implements:
IInputElement IUIElement ILogicalTreeNode IDpiAwareElement IDisposable IImageListProvider

Constructors

StatusBarLabelPanel()

Initializes an instance of the class.

public StatusBarLabelPanel()

StatusBarLabelPanel(string, int, string)

Initializes an instance of the class.

public StatusBarLabelPanel(string key, int width, string text)
Parameter Type Description
key string

The key of the panel.
width int

The width of the panel.
text string

The text to display in the panel.

StatusBarLabelPanel(string, int, string, StatusBarPanelAutoSize)

Initializes an instance of the class.

public StatusBarLabelPanel(string key, int width, string text, StatusBarPanelAutoSize autoSize)
Parameter Type Description
key string

The key of the panel.
width int

The width of the panel.
text string

The text to display in the panel.
autoSize StatusBarPanelAutoSize

The auto-size style to apply to the panel.

Properties

Enabled

Indicates whether the panel is enabled.

public bool Enabled { get; set; }

Property Value

bool:

true if the panel is enabled; otherwise, false.

ForeColor

The Color to use for drawing the Text.

public Color ForeColor { get; set; }

Property Value

Color

HorizontalAlignment

The horizontal alignment of text in the panel.

public HorizontalAlignment HorizontalAlignment { get; set; }

Property Value

HorizontalAlignment

Image

The image that is displayed for the panel.

public Image? Image { get; set; }

Property Value

Image

ImageIndex

The index of an image within an ImageList that is displayed on the panel.

[ImageIndex]
[TypeConverter(typeof(ImageIndexConverter))]
public int ImageIndex { get; set; }

Property Value

int:

The default value is -1.

ImageLayoutStyle

The layout style of the panel's image in relation to the text.

public StatusBarPanelImageLayoutStyle ImageLayoutStyle { get; set; }

Property Value

StatusBarPanelImageLayoutStyle

ImageSizeToFit

Indicates whether the to size the panel's image to fit in the panel.

public bool ImageSizeToFit { get; set; }

Property Value

bool:

true if the panel's image should be sized to fit in the panel; otherwise, false.

InvalidateOnMouseEvents

Indicates whether to invalidate the element when mouse events occur.

protected override bool InvalidateOnMouseEvents { get; }

Property Value

bool:

true if the element should be invalidated when mouse events occur; otherwise, false.

Indicates whether the panel is a link.

public bool IsLink { get; set; }

Property Value

bool:

true if the panel is a link; otherwise, false.

LinkBehavior

The link behavior.

public StatusBarLabelPanelLinkBehavior LinkBehavior { get; set; }

Property Value

StatusBarLabelPanelLinkBehavior

LinkVisited

Indicates whether the link has been visited.

public bool LinkVisited { get; set; }

Property Value

bool:

true if the link has been visited; otherwise, false.

Text

The text to display in the panel.

public string? Text { get; set; }

Property Value

string

TextTrimming

The StringTrimming to use for text in the panel.

public StringTrimming TextTrimming { get; set; }

Property Value

StringTrimming

Methods

Dispose(bool)

Releases the unmanaged resources used by the object and optionally releases the managed resources.

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.

Remarks

This method is called by the public Dispose method and the Finalize method. Dispose invokes this method with the disposing parameter set to true. Finalize invokes this method with disposing set to false.

GetCursor(Point)

Returns the Cursor that should be used when the mouse is over the element at the specified Point.

public override Cursor? GetCursor(Point point)
Parameter Type Description
point Point

The Point to examine.

Returns

Cursor

MeasureOverride(Graphics?, Size)

Measures the size in layout required for child elements and determines a size for the element itself.

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.

OnRender(PaintEventArgs)

Renders the element.

protected override void OnRender(PaintEventArgs e)
Parameter Type Description
e PaintEventArgs

The event data.

ResetForeColor()

Resets the ForeColor property to its default value.

public virtual void ResetForeColor()

ShouldSerializeForeColor()

Indicates whether the ForeColor property should be persisted.

public virtual bool ShouldSerializeForeColor()

Returns

bool:

true if the property value has changed from its default; otherwise, false.

Inherited Members

Extension Methods