ToolTipOptions.OpenMode Property

Gets or sets the opening mode of tooltips.

Namespace: DevExpress.Xpf.TreeMap

Assembly: DevExpress.Xpf.TreeMap.v19.2.dll

Declaration

C#

public ToolTipOpenMode OpenMode { get; set; }

VB.NET

Public Property OpenMode As ToolTipOpenMode

Property Value

Type	Description
ToolTipOpenMode	A ToolTipOpenMode enumeration value.

Available values:

Name	Description
OnHover	A tooltip appears when hovering over a particular tree map item.
OnClick	A tooltip appears when clicking a particular tree map item.

Property Paths

You can access this nested property as listed below:

Object Type	Path to OpenMode
TreeMapControl	.ToolTipOptions.OpenMode

Remarks

For more information about tooltips, refer to the Tooltips topic.

Example

The following properties allow you to customize TreeMap tooltips.

• TreeMapControl.ToolTipEnabled - specifies the value indicating whether tooltips are shown.
• TreeMapControl.ToolTipOptions - allows you to configure common tooltip options such as ToolTipOptions.Position, ToolTipOptions.OpenMode, ToolTipOptions.InitialDelay and ToolTipOptions.AutoPopDelay.
• TreeMapControl.ToolTipPattern - specifies a pattern for tooltip text of the leaf tree map items. This text will be stored by the ToolTipInfo.ToolTipText property.
• TreeMapControl.ToolTipGroupPattern - specifies a pattern for tooltip text of the group tree map items. This text will be stored by the TreeMapControl.ToolTipPattern property.
• TreeMapControl.ToolTipContentTemplate - specifies a data template for a leaf item tooltip’s content. Note that the content is represented by the ToolTipInfo object.
• TreeMapControl.ToolTipGroupContentTemplate - specifies a data template for a group item tooltip’s content. Note that the content is represented by the ToolTipInfo object.
• TreeMapControl.ToolTipTemplate - specifies a data template that allows you to change the appearance of tooltips.

Note

A complete sample project is available at https://github.com/DevExpress-Examples/how-to-customize-treemap-tooltips-t308914.

MainWindow.xaml

<Window.Resources>
    <DataTemplate x:Key="tooltipContentTemplate">
        <StackPanel Orientation="Vertical"
                    Margin="8">
            <TextBlock Text="{Binding Item.Label}"
                       Foreground="White" 
                       FontSize="24"/>
            <TextBlock Text="{Binding Path=ToolTipText}"
                       Foreground="LightGray"/>
        </StackPanel>
    </DataTemplate>
    <DataTemplate x:Key="tooltipTemplate">
        <Grid>
            <Border CornerRadius="8" 
                    Background="#FF303030">
                <ContentPresenter Content="{Binding}" 
                                  ContentTemplate="{Binding ContentTemplate}"/>
            </Border>
        </Grid>
    </DataTemplate>
</Window.Resources>
    <dxtm:TreeMapControl ToolTipEnabled="true"
                         ToolTipPattern="{}GDP: {V:C} millions"
                         ToolTipContentTemplate="{Binding Source={StaticResource tooltipContentTemplate}}"
                         ToolTipGroupPattern="{} Summary GDP: {V:C} millions"
                         ToolTipGroupContentTemplate="{Binding Source={StaticResource tooltipContentTemplate}}"
                         ToolTipTemplate="{Binding Source={StaticResource tooltipTemplate}}">
        <dxtm:TreeMapControl.ToolTipOptions>
            <dxtm:ToolTipOptions Position="{Binding ElementName=lbPosition, Path=SelectedValue}"
                                 OpenMode="{Binding ElementName=lbOpenMode, Path=SelectedValue}">
            </dxtm:ToolTipOptions>
        </dxtm:TreeMapControl.ToolTipOptions>
    </dxtm:TreeMapControl>
        <ListBox Grid.Row="1"
                 x:Name="lbPosition"
                 DisplayMemberPath="PositionName"
                 SelectedValuePath="Position"
                 SelectedIndex="0">
            <local:PositionWrapper PositionName="Mouse">
                <dxtm:ToolTipMousePosition/>
            </local:PositionWrapper>
            <local:PositionWrapper PositionName="Relative">
                <dxtm:ToolTipRelativePosition Origin="0.5 0"/>
            </local:PositionWrapper>
        </ListBox>
        <ListBox Grid.Row="3"
                 x:Name="lbOpenMode"
                 DisplayMemberPath="OpenModeName"
                 SelectedValuePath="OpenMode"
                 SelectedIndex="0">
            <local:OpenModeWrapper OpenModeName="On Hover" 
                                   OpenMode="OnHover"/>
            <local:OpenModeWrapper OpenModeName="On Click" 
                                   OpenMode="OnClick"/>
        </ListBox>

Related GitHub Examples

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the OpenMode 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.

C#

how-to-customize-treemap-tooltips-t308914/VB/TreeMapToolTipSample/MainWindow.xaml#L48

<dxtm:ToolTipOptions Position="{Binding ElementName=lbPosition, Path=SelectedValue}"
                     OpenMode="{Binding ElementName=lbOpenMode, Path=SelectedValue}">
</dxtm:ToolTipOptions>