BarItemLinkBase.UserContent Property

Gets or sets the link’s Content, defined by an end-user. This is a dependency property.

Namespace: DevExpress.Xpf.Bars

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

Declaration

C#

public object UserContent { get; set; }

VB.NET

Public Property UserContent As Object

Property Value

Type	Description
Object	An object that represents the link’s Content.

Remarks

You can specify the content for a bar item via the BarItem.Content property. By default, this data will be used by all links. However, you can provide the content for individual links via the UserContent property, overriding the bar item’s corresponding setting.

At runtime, an end-user can modify a link’s caption in customization mode. See Quick Customization to learn more.

Note

BarItem objects can be displayed in multiple places simultaneously (for instance, in a Ribbon Page Group and Ribbon Quick Access Toolbar), while it is not possible to display the same UIElement in multiple places simultaneously. Therefore it is not possible to use UIElement objects as BarItems’ contents.

Related GitHub Examples

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the UserContent 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#

how-to-change-baritemlinks-appearance-via-templates-e2701/VB/MainWindow.xaml#L19

<dxb:Bar.ItemLinks>
    <dxb:BarButtonItemLink BarItemName="bt" UserContent="Regular BarButtonItem" />
    <dxb:BarButtonItemLink BarItemName="bt" UserContent="BarButtonItem using custom resources">