Back to Devexpress

BarItem.SuperTip Property

wpf-devexpress-dot-xpf-dot-bars-dot-baritem-4679f26e.md

latest4.7 KB
Original Source

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.v25.2.dll

NuGet Package : DevExpress.Wpf.Core

Declaration

csharp
public SuperTip SuperTip { get; set; }
vb
Public Property SuperTip As SuperTip

Property Value

TypeDescription
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>

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.

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

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

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

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

See Also

Hint

ShowScreenTips

ShowScreenTip

BarItem Class

BarItem Members

DevExpress.Xpf.Bars Namespace