Skip to main content
Bar

DevExpress v24.2 Update — Your Feedback Matters

Our What's New in v24.2 webpage includes product-specific surveys. Your response to our survey questions will help us measure product satisfaction for features released in this major update and help us refine our plans for our next major release.

Take the survey Not interested

BarItemLinkControlProperties Class

A set of properties that describe the BarItem’s visual states.

Namespace: DevExpress.Xpf.Bars

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

NuGet Package: DevExpress.Wpf.Core

#Declaration

public class BarItemLinkControlProperties

#Remarks

You can use Style and ItemTrigger classes to change an item’s properties depending on the item’s state. Use the BarItemLinkControlProperties class to get the element’s state.

#Styles

The following code sample uses the Style class to change the BarButtonItem‘s Glyph property when the mouse pointer is over the element:

<Window ...
  xmlns:dxb="http://schemas.devexpress.com/winfx/2008/xaml/bars"
  xmlns:dxr="http://schemas.devexpress.com/winfx/2008/xaml/ribbon">
  <Window.Resources>
    <Style x:Key="OpenItemStyle" TargetType="{x:Type dxb:BarButtonItem}">
      <Setter Property="Glyph" Value="Open.svg"/>
      <Style.Triggers>
        <Trigger Property="dxb:BarItemLinkControlProperties.IsMouseOver" Value="True">
          <Setter Property="Glyph" Value="Open2.svg"/>
        </Trigger>
      </Style.Triggers>
    </Style>
  </Window.Resources>
  <StackPanel>
    <dxr:RibbonControl Margin="20">
      <dxr:RibbonPage>
        <dxr:RibbonPageGroup>
          <dxb:BarButtonItem Style="{StaticResource OpenItemStyle}"/>
        </dxr:RibbonPageGroup>
      </dxr:RibbonPage>
    </dxr:RibbonControl>
  </StackPanel>
</Window>

#Item Triggers

Use the ItemTrigger class in the following cases:

The following code sample uses the BarItem.Triggers attached property to change the BarItemLink‘s Glyph property when the mouse pointer is over the element:

<Window ..
  xmlns:dxb="http://schemas.devexpress.com/winfx/2008/xaml/bars"
  xmlns:dxr="http://schemas.devexpress.com/winfx/2008/xaml/ribbon">
  <StackPanel>
    <dxr:RibbonControl Margin="20">
      <dxr:RibbonControl.ToolbarItems>
        <dxb:BarItemLink BarItemName="BarItem1"/>
      </dxr:RibbonControl.ToolbarItems>
      <dxr:RibbonPage>
        <dxr:RibbonPageGroup>
          <dxb:BarButtonItem x:Name="BarItem1" Glyph="Open.svg" Content="Open">
            <dxb:BarButtonItem.Triggers>
              <dxb:ItemTrigger Property="IsMouseOver" Value="True">
                <dxb:ItemSetter Property="Glyph" Value="Open2.svg"/>
              </dxb:ItemTrigger>
            </dxb:BarButtonItem.Triggers>
          </dxb:BarButtonItem>
        </dxr:RibbonPageGroup>
      </dxr:RibbonPage>
    </dxr:RibbonControl>
  </StackPanel>
</Window>

#Inheritance

Object
BarItemLinkControlProperties
See Also