RibbonPageGroup.ItemLinksSourceElementGeneratesUniqueBarItem Property

Gets or sets whether each reference to a data object in an RibbonPageGroup.ItemLinksSource for this RibbonPageGroup 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.v20.1.dll

Declaration

public bool ItemLinksSourceElementGeneratesUniqueBarItem { get; set; }
Public Property ItemLinksSourceElementGeneratesUniqueBarItem As Boolean

Property Value

Type Description
Boolean

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

Remarks

While generating a layout via the RibbonPageGroup.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 RibbonPageGroup.
See Also