C1.Win.Ribbon.C1StatusBar

C1StatusBar Class

Represents a Status Bar control to be used with a C1Ribbon control in place of a standard C1StatusBar.

Inheritance

object

C1StatusBar

Implements

ISupportInitialize

ISupportUiaContainer

Namespace: C1.Win.Ribbon

Assembly: C1.Win.Ribbon.4.8.dll

Syntax

[ToolboxBitmap(typeof(C1StatusBar), "C1StatusBar.png")]
[C1Description("C1StatusBar", "Used with C1Ribbon control to display various types of status information.")]
[ClassInterface(ClassInterfaceType.AutoDispatch)]
[ComVisible(true)]
public class C1StatusBar : XView, ISupportInitialize, ISupportUiaContainer

Remarks

A Status Bar is a horizontal area at the bottom of an application window where an application can display various types of status information. The C1StatusBar is split into the left and right panes, each of which can contain a series of items such as labels (RibbonLabel), buttons (RibbonButton), and so on.

Constructors

Name	Description
C1StatusBar()	Creates a new instance of C1StatusBar. The C1StatusBar is automatically docked at the bottom of the parent container.

Properties

Name	Description
Anchor	This property has no effect on C1StatusBar.
AutoSize	This property has no effect on C1StatusBar.
Cursor	This property has no effect on C1StatusBar.
Dock	This property has no effect on C1StatusBar.
LargeImageList	Gets or sets the ImageList that contains the large images to display on the status bar.
LeftPaneItems	Collection of status bar items on the left pane.
Location	Gets the coordinates of the upper-left corner of the control relative to the upper-left corner of its container.
MaximumSize	This property has no effect on C1StatusBar.
MinimumSize	This property has no effect on C1StatusBar.
Padding	This property has no effect on C1StatusBar.
RibbonStyle	Gets or sets a RibbonStyle object that is used for customization of appearance settings.
RightPaneItems	Collection of status bar items on the right pane.
RightPaneWidth	Gets or sets the width of the pane on the right side of the status bar.
Selectable	Gets or sets whether the StatusBar can receive the input focus.
ShowDropDownsOnTop	Gets or sets whether the drop-down windows should appear on top of the status bar.
Size	Gets the height and width of the control.
SizingGrip	Gets or sets whether the status bar has a sizing grip.
SmallImageList	Gets or sets the ImageList that contains the small images to display on the status bar.
TextRenderingHint	Gets or sets the TextRenderingHint that controls text rendering quality.
ToolTipSettings	Gets or sets the properties of the built-in tooltip.
Visible	Gets or sets a value indicating whether the control and all its parent controls are displayed.

Methods

Name	Description
BeginInit()
BeginUpdate()	Maintains performance while items are being added or removed from the C1StatusBar.
CreateHandle()	Creates the handle for the C1StatusBar control.
Dispose(bool)	Clean up any resources being used.
EndInit()
EndUpdate()	Resumes processing after it has been suspended by a call to BeginUpdate().
GetItemAt(Point)	Returns the item located at the specified point in the client area of the C1StatusBar.
GetItemAt(int, int)	Returns the item located at the specified x- and y-coordinates of the C1StatusBar client area.
GetItemBounds(Component)	Returns the size and location of the given item, in pixels, relative to the parent C1StatusBar.
GetItemByName(string)	Searches for the RibbonItem with the specified name through the whole C1StatusBar.
IsMouseInsideXView()	Returns True if the mouse pointer is inside the C1StatusBar control.
Load(Stream)	Loads a status bar definition from a Stream.
Load(string)	Loads a status bar definition from an XML file.
Load(XmlDocument)	Loads a status bar definition from an XmlDocument.
OnControlHostFromXmlNode(ControlHostFromXmlNodeEventArgs)	Raises the ControlHostFromXmlNode event.
OnEnabledChanged(EventArgs)	Raises the EnabledChanged event.
OnFontChanged(EventArgs)	Raises the FontChanged event.
OnItemDeserialized(ItemDeserializedEventArgs)	Raises the ItemDeserialized event.
OnMouseUp(MouseEventArgs)	Raises the MouseUp event.
OnPaint(PaintEventArgs)	Paints the control. Raises the Paint event.
OnParentChanged(EventArgs)	Raises the ParentChanged event.
OnRibbonEvent(RibbonEventArgs)	Raises the RibbonEvent event.
OnRightToLeftChanged(EventArgs)	Raises the RightToLeftChanged event.
OnStatusBarDeserialized(EventArgs)	Raises the StatusBarDeserialized event.
OnToolTipLinkClicked(ToolTipLinkClickedEventArgs)	Raises the ToolTipLinkClicked event.
OnUpdatingItemFont(UpdatingItemFontEventArgs)	Raises the UpdatingItemFont event.
OnUpdatingItemStyle(UpdatingItemStyleEventArgs)	Raises the UpdatingItemStyle event.
OnVisibleChanged(EventArgs)	Raises the VisibleChanged event.
ProcessMnemonic(char)	Processes a mnemonic character.
RescaleConstantsForDpi(int, int)
ResetRightPaneWidth()
ResubscribeTooltip(C1SuperTooltipBase, C1SuperTooltipBase)
Save(Stream)	Saves a status bar definition into a Stream.
Save(string)	Saves a status bar definition into an XML file.
Save(XmlTextWriter)	Saves a status bar definition into an XmlWriter.
ShouldSerializeLeftPaneItems()
ShouldSerializeRightPaneItems()
ShouldSerializeRightPaneWidth()
ShouldSerializeToolTipSettings()
WndProc(ref Message)	Processes Windows messages.

Events

Name	Description
ControlHostFromXmlNode	Occurs before a RibbonControlHost starts loading from XML.
ItemDeserialized	Occurs when a RibbonItem is loaded from XML.
RibbonEvent	Occurs when other Ribbon events occur.
StatusBarDeserialized	Occurs when the C1StatusBar control is loaded from XML.
ToolTipLinkClicked	Event that fires when the user clicks a hyperlink within a tooltip.
UpdatingItemFont	Occurs before a font is applied to a ribbon item.
UpdatingItemStyle	Occurs before a style is applied to a status bar item.