BarItemLinkBase.RibbonStyle Property

Gets or sets the options that specify the bar item link’s possible states within a RibbonControl. This is a dependency property.

Namespace: DevExpress.Xpf.Bars

Assembly: DevExpress.Xpf.Core.v18.2.dll

Declaration

C#

public RibbonItemStyles RibbonStyle { get; set; }

VB.NET

Public Property RibbonStyle As RibbonItemStyles

Property Value

Type	Description
RibbonItemStyles	A set of RibbonItemStyles flags that specify the bar item link’s possible states within a Ribbon Control.

Available values:

Name	Description
Default	If active, a bar item link’s possible states with a Ribbon Control are determined based on the link’s settings. For example, if the link is associated with a small image and isn’t associated with a large image, its possible states within the Ribbon Control are SmallWithoutText and SmallWithText.
Large	If active, a bar item link can be represented by a large image with a caption.
SmallWithText	If active, a bar item link can be represented by a small image with a caption.
SmallWithoutText	If active, a bar item link can be represented by a small image.
All	If active, enables all other options.

Remarks

For bar item links displayed within a RibbonControl, you can customize which states these objects support. You can customize these settings for bar item links and corresponding bar items via the BarItemLinkBase.RibbonStyle and BarItem.RibbonStyle properties, respectively.

A link’s RibbonStyle property has a higher priority than the corresponding bar item’s RibbonStyle property. If a bar item link’s BarItemLinkBase.RibbonStyle property is set to Default, the corresponding bar item’s property is used. Otherwise, the bar item’s RibbonStyle property is ignored.

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the RibbonStyle property.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

dxrichedit-for-wpf-how-to-share-one-richeditcontrol-toolbar-between-several-richeditcontrols-e3445/CS/MainWindow.xaml#L512

<dxr:RibbonPageGroup Caption="Alignment" Name="grpAlignment">
    <dxb:BarCheckItemLink BarItemName="biTableToggleCellsTopLeftAlignment" RibbonStyle="SmallWithoutText" />
    <dxb:BarCheckItemLink BarItemName="biTableToggleCellsMiddleLeftAlignment" RibbonStyle="SmallWithoutText" />

dxrichedit-for-wpf-table-api-how-to-create-a-multiplication-table-in-code-e3296/CS/MainWindow.xaml#L577

<dxr:RibbonPageGroup Caption="Alignment" Name="grpAlignment" ShowCaptionButton="False">
    <dxb:BarCheckItemLink BarItemName="biTableToggleCellsTopLeftAlignment" RibbonStyle="SmallWithoutText" />
    <dxb:BarCheckItemLink BarItemName="biTableToggleCellsMiddleLeftAlignment" RibbonStyle="SmallWithoutText" />

how-to-handle-the-hyperlink-click-event-to-invoke-the-custom-form-t488029/CS/DXRichEditHyperlinkHandling/MainWindow.xaml#L800

<dxr:RibbonPageGroup.ItemLinks>
    <dxb:BarCheckItemLink BarItemName="biTableToggleCellsTopLeftAlignment" RibbonStyle="SmallWithoutText" />
    <dxb:BarCheckItemLink BarItemName="biTableToggleCellsMiddleLeftAlignment" RibbonStyle="SmallWithoutText" />

dxrichedit-getting-started-lesson-3-provide-ribbon-ui-for-a-richeditcontrol-e2588/VB/WpfApplication1/MainWindow.xaml#L805

<dxr:RibbonPageGroup.ItemLinks>
    <dxb:BarCheckItemLink BarItemName="biTableToggleCellsTopLeftAlignment" RibbonStyle="SmallWithoutText" />
    <dxb:BarCheckItemLink BarItemName="biTableToggleCellsMiddleLeftAlignment" RibbonStyle="SmallWithoutText" />

how-load-ribbon-elements-from-separate-resource-files-dynamically-e2323/VB/RibbonFromXaml/RibbonResources3.xaml#L5

<dxr:RibbonPageGroup Caption="Page group 3">
    <dxb:BarButtonItemLink BarItemName="itmButton" RibbonStyle="All" />
    <dxb:BarButtonItemLink BarItemName="itmSplitButton" RibbonStyle="All" />