WinForms › Explorer Bar › BinaryExplorerBarPanel

BinaryExplorerBarPanel

class.NET 6 / 8 / 10.NET Framework 4.8Binarymission.WinForms.Controls.NavigationControls

A Panel derived control implementing the Windows XP style Collapsible/Expandable control, that is placed within the BinaryExplorerBar control.

public class BinaryExplorerBarPanel : Panel, IBinaryControlExtendedServices

Inherits from / implements: Panel, IBinaryControlExtendedServices

Members at a glance

`BinaryExplorerBarPanel`	Initializes a new instance of BinaryExplorerBarPanel class.
`BackColor`	Gets or sets the backcolor of the Panel.
`BackgroundPaintingStyleForControlTitle`	Gets or sets the `ControlBackgroundPaintingStyle` for the BinaryExplorerBarPanel.
`CurrentExplorerBarPanelState`	Gets or sets the BinaryExplorerBarPanel's `BinaryExplorerBarPanelState`.
`CurrentHeight`	Gets or sets the current height.
`DownArrowImage`	Gets or sets the `Bitmap` image for the panel title's down arrow image.
`DrawPanelTitleBackgroundImageWithTheDefaultHeight`	Gets or sets whether to draw the panel title's background image using the default height of 24 pixels.
`DrawPanelTitleText`	Gets or sets whether to draw the panel's title text.
`OnHoverUpDownArrowColor`	Gets or sets the color for the Up/Down arrow image, when the mouse pointer is over the panel object's title bar.
`OnHoverUpDownArrowEllipseFillColor`	Gets or sets the Ellipse fill color for the Up/Down arrow image, when the mouse pointer is over the Panel object's title bar.
`OnNormalUpDownArrowColor`	Gets or sets the color for the Up/Down arrow image.
`OnNormalUpDownArrowEllipseFillColor`	Gets or sets the Ellipse fill color for the Up/Down arrow image that appears at the right most corner of the `BinaryExplorerBarPanel` object.
`PanelBorderColor`	Gets or sets the colour of the one pixel border drawn around this panel and its title.
`PanelShadowColor`	Gets or sets the colour of this panel's drop shadow.
`PanelShadowDepth`	Gets or sets the depth, in logical (96 DPI) pixels, of the drop shadow drawn under this panel, or -1 to take the bar's `DefaultPanelShadowDepth`.
`PanelTitleBackColor`	Gets or sets the panel title's backcolor.
`PanelTitleBackStyle`	Gets or sets the `ControlBackgroundPaintingStyle` for the panel's title.
`PanelTitleBackgroundImage`	Gets or sets the background image for the panel title.
`PanelTitleBackgroundImageTransparentColor`	Gets or sets the transparent color for the panel title's background image.
`PanelTitleFont`	Gets or sets the `Font` for the BinaryExplorerBarPanel title.
`PanelTitleForeColor`	Gets or sets the forecolor of the panel's title.
`PanelTitleGradientBeginColor`	Gets or sets the "Begin" Gradient color for the panel's title.
`PanelTitleGradientEndColor`	Gets or sets the "End" Gradient color for the panel's title.
`PanelTitleHoverColor`	Gets or sets the hover state color of the panel's title.
`PanelTitleImage`	Gets or sets the image for the panel title.
`PanelTitleImageTransparentColor`	Gets or sets the transparent color for the panel title's Image.
`PanelTitleText`	Gets or sets the panel title's text string.
`ReflectCurrentXPTheme`	Gets or sets whether to reflect the current active XP theme.
`ShouldPaintCornersAsRoundedRect`	Gets or sets whether to draw a rounded corner for panel's title.
`UpArrowImage`	Gets or sets the `Bitmap` image for the panel title's Up arrow image.
`OnEnabledChanged`	Raises the EnabledChanged event. BinaryExplorerBarPanel overrides it so the control's own handling runs alongside the base behavior.
`OnSizeChanged`	Raises the SizeChanged event. BinaryExplorerBarPanel overrides it so the control's own handling runs alongside the base behavior.
`OnVisibleChanged`	Raises the VisibleChanged event. BinaryExplorerBarPanel overrides it so the control's own handling runs alongside the base behavior.

Constructors

BinaryExplorerBarPanel

public BinaryExplorerBarPanel()

Initializes a new instance of BinaryExplorerBarPanel class.

Properties

BackColor

public override Color BackColor

Gets or sets the backcolor of the Panel.

BackgroundPaintingStyleForControlTitle

public ControlBackgroundPaintingStyle BackgroundPaintingStyleForControlTitle

Gets or sets the ControlBackgroundPaintingStyle for the BinaryExplorerBarPanel.

CurrentExplorerBarPanelState

public BinaryExplorerBarPanelState CurrentExplorerBarPanelState

Gets or sets the BinaryExplorerBarPanel's BinaryExplorerBarPanelState.

CurrentHeight

public int CurrentHeight

Gets or sets the current height.

DownArrowImage

public Bitmap DownArrowImage

Gets or sets the Bitmap image for the panel title's down arrow image.

If you do not set this property, a default image will be drawn and used.
Note: If you are setting this property, you should also set the UpArrowImage property. Otherwise a default image will be drawn and used.

DrawPanelTitleBackgroundImageWithTheDefaultHeight

public bool DrawPanelTitleBackgroundImageWithTheDefaultHeight

Gets or sets whether to draw the panel title's background image using the default height of 24 pixels.

This property has the effect only if the PanelTitleBackgroundImage property is set with a valid Image object and the property PanelTitleBackStyle is set to ImageStyle.

DrawPanelTitleText

public bool DrawPanelTitleText

Gets or sets whether to draw the panel's title text.

Setting this property to false will ensure that the text is not drawn on the title area, even though a valid value has been set to the property PanelTitleText.

OnHoverUpDownArrowColor

public Color OnHoverUpDownArrowColor

Gets or sets the color for the Up/Down arrow image, when the mouse pointer is over the panel object's title bar.

OnHoverUpDownArrowEllipseFillColor

public Color OnHoverUpDownArrowEllipseFillColor

Gets or sets the Ellipse fill color for the Up/Down arrow image, when the mouse pointer is over the Panel object's title bar.

OnNormalUpDownArrowColor

public Color OnNormalUpDownArrowColor

Gets or sets the color for the Up/Down arrow image.

OnNormalUpDownArrowEllipseFillColor

public Color OnNormalUpDownArrowEllipseFillColor

Gets or sets the Ellipse fill color for the Up/Down arrow image that appears at the right most corner of the BinaryExplorerBarPanel object.

PanelBorderColor

public Color PanelBorderColor

Gets or sets the colour of the one pixel border drawn around this panel and its title.

Empty, the default, means "take the bar's DefaultPanelBorderColor" - the same rule every other colour on this panel follows. If that is empty too, no border is drawn, which is what this control did for twenty years: the panels ran into one another with nothing between them. HANDOVER.md 3ac.

PanelShadowColor

public Color PanelShadowColor

Gets or sets the colour of this panel's drop shadow.

Empty, the default, means "take the bar's DefaultPanelShadowColor" - the rule every other colour on this panel follows. The colour's alpha sets how dark the shadow is at its strongest.

PanelShadowDepth

public int PanelShadowDepth

Gets or sets the depth, in logical (96 DPI) pixels, of the drop shadow drawn under this panel, or -1 to take the bar's DefaultPanelShadowDepth.

The shadow is drawn by the bar, in its margins round the panel, in the same place as the panel's border. Zero draws none.

PanelTitleBackColor

public Color PanelTitleBackColor

Gets or sets the panel title's backcolor.

PanelTitleBackStyle

public ControlBackgroundPaintingStyle PanelTitleBackStyle

Gets or sets the ControlBackgroundPaintingStyle for the panel's title.

PanelTitleBackgroundImage

public Bitmap PanelTitleBackgroundImage

Gets or sets the background image for the panel title.

PanelTitleBackgroundImageTransparentColor

public Color PanelTitleBackgroundImageTransparentColor

Gets or sets the transparent color for the panel title's background image.

PanelTitleFont

public Font PanelTitleFont

Gets or sets the Font for the BinaryExplorerBarPanel title.

PanelTitleForeColor

public Color PanelTitleForeColor

Gets or sets the forecolor of the panel's title.

PanelTitleGradientBeginColor

public Color PanelTitleGradientBeginColor

Gets or sets the "Begin" Gradient color for the panel's title.

PanelTitleGradientEndColor

public Color PanelTitleGradientEndColor

Gets or sets the "End" Gradient color for the panel's title.

PanelTitleHoverColor

public Color PanelTitleHoverColor

Gets or sets the hover state color of the panel's title.

PanelTitleImage

public Bitmap PanelTitleImage

Gets or sets the image for the panel title.

PanelTitleImageTransparentColor

public Color PanelTitleImageTransparentColor

Gets or sets the transparent color for the panel title's Image.

PanelTitleText

public string PanelTitleText

Gets or sets the panel title's text string.

ReflectCurrentXPTheme

public bool ReflectCurrentXPTheme

Gets or sets whether to reflect the current active XP theme.

ShouldPaintCornersAsRoundedRect

public bool ShouldPaintCornersAsRoundedRect

Gets or sets whether to draw a rounded corner for panel's title.

UpArrowImage

public Bitmap UpArrowImage

Gets or sets the Bitmap image for the panel title's Up arrow image.

If you do not set this property, a default image will be drawn and used.
Note: If you are setting this property, you should also set the DownArrowImage property. Otherwise a default image will be drawn and used.

Methods

OnEnabledChanged

protected override void OnEnabledChanged(EventArgs e)

Raises the EnabledChanged event. BinaryExplorerBarPanel overrides it so the control's own handling runs alongside the base behavior.

e: The data for the event.

OnSizeChanged

protected override void OnSizeChanged(EventArgs e)

Raises the SizeChanged event. BinaryExplorerBarPanel overrides it so the control's own handling runs alongside the base behavior.

e: The data for the event.

OnVisibleChanged

protected override void OnVisibleChanged(EventArgs e)

Raises the VisibleChanged event. BinaryExplorerBarPanel overrides it so the control's own handling runs alongside the base behavior.

e: The data for the event.