Skip to main content

RibbonControl.ItemLinksSourceElementGeneratesUniqueBarItem Property

Gets or sets whether each reference to a data object in an ItemLinksSource for this RibbonControl should generate a unique BarItem, whether this data object was previously referenced. This is a dependency property.

Namespace: DevExpress.Xpf.Ribbon

Assembly: DevExpress.Xpf.Ribbon.v24.1.dll

NuGet Package: DevExpress.Wpf.Ribbon

Declaration

public bool ItemLinksSourceElementGeneratesUniqueBarItem { get; set; }

Property Value

Type Description
Boolean

true if each reference to a data object in an ItemLinksSource for this RibbonControl should generate a unique BarItem; otherwise, false. The default is false.

Remarks

While generating a layout via the ItemLinksSource property, if you insert a reference to a single data object into multiple ItemLinksSources for different BarItemLink holders, each holder will contain a corresponding BarItemLink. However, these links will refer to a single BarItem. This default behavior prevents issues related to using two-way bindings.

However, such behavior also prevents you from defining different item templates (or styles) for the same data object. If different templates (styles) need to be defined, you can do one of the following:

  • Clone data objects;
  • Revert to the old behavior by setting the ItemLinksSourceElementGeneratesUniqueBarItem property to true for your RibbonControl.
See Also