BarItem.SuperTip Property

Gets or sets a customizable ToolTip for the current bar item. This is a dependency property.

Namespace: DevExpress.Xpf.Bars

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

NuGet Package: DevExpress.Wpf.Core

Declaration

C#

public SuperTip SuperTip { get; set; }

VB.NET

Public Property SuperTip As SuperTip

Property Value

Type	Description
SuperTip	A SuperTip object associated with the item.

Remarks

Bar items support regular tooltips and SuperTip objects. A regular hint can be specified via the BarItem.Hint property. This hint is in effect if no SuperTip is assigned.

Use the SuperTip property to assign a SuperTip object to a bar item. A SuperTip is an expandable tooltip, capable of displaying multiple tooltip items. See SuperTip to learn more.

The BarManager.ShowScreenTips and BarItem.ShowScreenTip properties allow you to disable hints and SuperTips.

Example

The following example creates a SuperTip consisting of four items. For the second item, the default layout of the item’s Content and Glyph is changed. The glyph is positioned on the right of the Content.

For the fourth item, the style is changed, so that the text is painted in gray.

The result is shown below:

XAML

<dxb:BarButtonItem.SuperTip>
    <dxc:SuperTip>
        <!--Item 1-->
        <dxc:SuperTipHeaderItem Content="New"/>
        <!--Item 2-->
        <dxc:SuperTipItem Content="Create a new document" 
                          Glyph="pack://application:,,,/Images/new-32x32.png">
            <!--Change the default layout-->
            <dxc:SuperTipItem.LayoutStyle>
                <Style TargetType="{x:Type dxc:Items2Panel}">
                    <Setter Property="Alignment" Value="Right"/>
                    <Setter Property="HorizontalIndent" Value="20"/>
                </Style>
            </dxc:SuperTipItem.LayoutStyle>

        </dxc:SuperTipItem>
        <!--Item 3-->
        <dxc:SuperTipItemSeparator/>
        <!--Item 4-->
        <dxc:SuperTipItem Content="Opens a new document in a new tab" >
            <!--Provide content template-->
            <dxc:SuperTipItem.ContentTemplate>
                <DataTemplate>
                    <TextBlock FontFamily="Calibri" Foreground="Gray" FontSize="11" Text="{Binding}"/>
                </DataTemplate>
            </dxc:SuperTipItem.ContentTemplate>
        </dxc:SuperTipItem>
    </dxc:SuperTip>
</dxb:BarButtonItem.SuperTip>

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the SuperTip 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.

XAML

how-to-create-supertips-for-bar-items-ribbon-items-and-standard-controls-in-code-and-xaml-e2702/CS/SuperTipFromXamlForBars.xaml#L11

<dxb:BarButtonItem Name="bt" Content="Bar Item">
    <dxb:BarButtonItem.SuperTip>
        <dx:SuperTip>

wpf-diagram-mdi/CS/MainWindow.xaml#L110

<dxb:BarButtonItem Command="{Binding CreateDocumentCommand}" Glyph="{dx:DXImage 'SvgImages/Icon Builder/Actions_Add.svg'}">
    <dxb:BarButtonItem.SuperTip>
        <dx:SuperTip>