RibbonBackstageHeaderButton Class
Represents a button control used within a RibbonBackstage header, alongside tabs.
public class RibbonBackstageHeaderButton : Button
- Inheritance:
- object Visual UIElement FrameworkElement Control ContentControl ButtonBase Button object
Constructors
RibbonBackstageHeaderButton()
Initializes an instance of the class.
public RibbonBackstageHeaderButton()
Properties
CanCloseBackstage
Indicates whether button clicks will close the ancestor RibbonBackstage.
public bool CanCloseBackstage { get; set; }
Property Value
- bool:
trueif button clicks will close the ancestor RibbonBackstage; otherwise,false. The default value istrue.
HeaderAlignment
A RibbonBackstageHeaderAlignment indicating the alignment of the control within the ribbon Backstage header.
public RibbonBackstageHeaderAlignment HeaderAlignment { get; set; }
Property Value
- RibbonBackstageHeaderAlignment:
The default value is Top.
Key
A string that uniquely identifies the control.
[Localizability(LocalizationCategory.NeverLocalize)]
public string? Key { get; set; }
Property Value
KeyTipText
The key tip text used to access the control.
[Localizability(LocalizationCategory.Label)]
public string? KeyTipText { get; set; }
Property Value
Label
The text label to display.
[Localizability(LocalizationCategory.Label)]
public string? Label { get; set; }
Property Value
ScreenTipFooter
The screen tip footer content.
ScreenTipHeader
The screen tip header content.
SmallImageSource
The ImageSource for a small image, generally 16x16 size.
Title
The string title, which can override the Label when displayed in screen tips and customization UI.
[Localizability(LocalizationCategory.Title)]
public string? Title { get; set; }
Property Value
Methods
OnClick()
Called when a Button is clicked.
protected override void OnClick()
OnCreateAutomationPeer()
Creates an appropriate ButtonAutomationPeer for this control as part of the WPF infrastructure.
protected override AutomationPeer OnCreateAutomationPeer()
Returns
- AutomationPeer:
A ButtonAutomationPeer for this control.
OnKeyTipInvoked(KeyTipInvokedEventArgs)
Occurs when the control's key tip is invoked.
protected virtual void OnKeyTipInvoked(KeyTipInvokedEventArgs e)
| Parameter | Type | Description |
|---|---|---|
| e | KeyTipInvokedEventArgs | The event data. |
OnKeyTipOpening(KeyTipOpeningEventArgs)
Occurs when the control's key tip is opening.
protected virtual void OnKeyTipOpening(KeyTipOpeningEventArgs e)
| Parameter | Type | Description |
|---|---|---|
| e | KeyTipOpeningEventArgs | The event data. |
OnToolTipOpening(ToolTipEventArgs)
Invoked whenever the ToolTipOpening routed event reaches this class in its route. Implement this method to add class handling for this event.
protected override void OnToolTipOpening(ToolTipEventArgs e)
| Parameter | Type | Description |
|---|---|---|
| e | ToolTipEventArgs | Provides data about the event. |
ToString()
Returns the string representation of this object.
Fields
CanCloseBackstageProperty
Defines the CanCloseBackstage property.
public static readonly DependencyProperty CanCloseBackstageProperty
HeaderAlignmentProperty
Defines the HeaderAlignment property.
public static readonly DependencyProperty HeaderAlignmentProperty
KeyProperty
Defines the Key property.
public static readonly DependencyProperty KeyProperty
KeyTipTextProperty
Defines the KeyTipText property.
public static readonly DependencyProperty KeyTipTextProperty
LabelProperty
Defines the Label property.
public static readonly DependencyProperty LabelProperty
ScreenTipFooterProperty
Defines the ScreenTipFooter property.
public static readonly DependencyProperty ScreenTipFooterProperty
ScreenTipHeaderProperty
Defines the ScreenTipHeader property.
public static readonly DependencyProperty ScreenTipHeaderProperty
SmallImageSourceProperty
Defines the SmallImageSource property.
public static readonly DependencyProperty SmallImageSourceProperty
TitleProperty
Defines the Title property.
public static readonly DependencyProperty TitleProperty