强制 WPF 工具提示留在屏幕上

Question

我有一个标签的工具提示，我希望它保持打开状态，直到用户 将鼠标移动到不同的控件。

我在工具提示上尝试了以下属性：

StaysOpen="True"

和

ToolTipService.ShowDuration = "60000"

但在这两种情况下，工具提示仅显示 5 秒。

为什么会忽略这些值？

Answer 1

前几天我还在与 WPF 工具提示搏斗。似乎无法阻止它自行出现和消失，所以最后我求助于处理Opened 事件。例如，我想阻止它打开，除非它有一些内容，所以我处理了Opened 事件，然后这样做：

tooltip.IsOpen = (tooltip.Content != null);

这是一个 hack，但它有效。

大概您可以类似地处理Closed 事件并告诉它再次打开，从而使其保持可见。

Answer 2

您可能希望使用 Popup 而不是 Tooltip，因为 Tooltip 假定您以预定义的 UI 标准方式使用它。

我不确定为什么 StaysOpen 不起作用，但 ShowDuration 的工作原理与 MSDN 中的记录一样——它是工具提示在显示时显示的时间量。将其设置为少量（例如 500 毫秒）以查看差异。

在您的情况下，诀窍是保持“最后一个悬停控件”状态，但是一旦您拥有它，如果您正在使用动态（手动或通过绑定）更改放置目标和内容应该是相当简单的一个 Popup，或者如果您使用多个 Popup，则隐藏最后一个可见的 Popup。

就窗口大小调整和移动而言，弹出窗口存在一些问题（弹出窗口不会随容器移动），因此您在调整行为时可能还需要牢记这一点。详情请见this link。

HTH。

Answer 3

此外，如果您想在 ToolTip 中放置任何其他控件，它就无法获得焦点，因为 ToolTip 本身可以获得焦点。所以就像 micahtan 说的，你最好的镜头是弹出窗口。

Answer 4

如果您只想为一个工具提示设置此项，请在具有工具提示的对象上设置持续时间，如下所示：

<Label ToolTipService.ShowDuration="12000" Name="lblShowTooltip" Content="Shows tooltip">
    <Label.ToolTip>
        <ToolTip>
            <TextBlock>Hello world!</TextBlock>
        </ToolTip>
    </Label.ToolTip>
</Label>

我会说选择这种设计是因为它允许相同的工具提示在不同的控件上具有不同的超时时间。

如果您希望在整个应用中全局使用此功能，请参阅已接受的答案。

Answer 5

只需将此代码放在初始化部分。

ToolTipService.ShowDurationProperty.OverrideMetadata(
    typeof(DependencyObject), new FrameworkPropertyMetadata(Int32.MaxValue));

Answer 6

ToolTipService.ShowDurationProperty.OverrideMetadata(
    typeof(DependencyObject), new FrameworkPropertyMetadata(Int32.MaxValue));

它对我有用。将此行复制到您的类构造函数中。

Answer 7

这也让我今晚发疯了。我创建了一个ToolTip 子类来处理这个问题。对我来说，在 .NET 4.0 上，ToolTip.StaysOpen 属性并不是“真正”保持打开状态。

在下面的类中，使用新属性ToolTipEx.IsReallyOpen，而不是属性ToolTip.IsOpen。你会得到你想要的控制。通过Debug.Print() 调用，您可以在调试器输出窗口中查看this.IsOpen = false 被调用了多少次！ StaysOpen 这么多，还是我应该说 "StaysOpen"？享受吧。

public class ToolTipEx : ToolTip
{
    static ToolTipEx()
    {
        IsReallyOpenProperty =
            DependencyProperty.Register(
                "IsReallyOpen",
                typeof(bool),
                typeof(ToolTipEx),
                new FrameworkPropertyMetadata(
                    defaultValue: false,
                    flags: FrameworkPropertyMetadataOptions.None,
                    propertyChangedCallback: StaticOnIsReallyOpenedChanged));
    }

    public static readonly DependencyProperty IsReallyOpenProperty;

    protected static void StaticOnIsReallyOpenedChanged(
        DependencyObject o, DependencyPropertyChangedEventArgs e)
    {
        ToolTipEx self = (ToolTipEx)o;
        self.OnIsReallyOpenedChanged((bool)e.OldValue, (bool)e.NewValue);
    }

    protected void OnIsReallyOpenedChanged(bool oldValue, bool newValue)
    {
        this.IsOpen = newValue;
    }

    public bool IsReallyOpen
    {
        get
        {
            bool b = (bool)this.GetValue(IsReallyOpenProperty);
            return b;
        }
        set { this.SetValue(IsReallyOpenProperty, value); }
    }

    protected override void OnClosed(RoutedEventArgs e)
    {
        System.Diagnostics.Debug.Print(String.Format(
            "OnClosed: IsReallyOpen: {0}, StaysOpen: {1}", this.IsReallyOpen, this.StaysOpen));
        if (this.IsReallyOpen && this.StaysOpen)
        {
            e.Handled = true;
            // We cannot set this.IsOpen directly here.  Instead, send an event asynchronously.
            // DispatcherPriority.Send is the highest priority possible.
            Dispatcher.CurrentDispatcher.BeginInvoke(
                (Action)(() => this.IsOpen = true),
                DispatcherPriority.Send);
        }
        else
        {
            base.OnClosed(e);
        }
    }
}

小吐槽：为什么微软不将DependencyProperty 属性（getter/setter）虚拟化，以便我们可以接受/拒绝/调整子类中的更改？或者为每个DependencyProperty 制作一个virtual OnXYZPropertyChanged？呃。

---编辑---

我上面的解决方案在 XAML 编辑器中看起来很奇怪——工具提示总是显示，在 Visual Studio 中阻止了一些文本！

这里有一个更好的方法来解决这个问题：

一些 XAML：

<!-- Need to add this at top of your XAML file:
     xmlns:System="clr-namespace:System;assembly=mscorlib"
-->
<ToolTip StaysOpen="True" Placement="Bottom" HorizontalOffset="10"
        ToolTipService.InitialShowDelay="0" ToolTipService.BetweenShowDelay="0"
        ToolTipService.ShowDuration="{x:Static Member=System:Int32.MaxValue}"
>This is my tooltip text.</ToolTip>

一些代码：

// Alternatively, you can attach an event listener to FrameworkElement.Loaded
public override void OnApplyTemplate()
{
    base.OnApplyTemplate();

    // Be gentle here: If someone creates a (future) subclass or changes your control template,
    // you might not have tooltip anymore.
    ToolTip toolTip = this.ToolTip as ToolTip;
    if (null != toolTip)
    {
        // If I don't set this explicitly, placement is strange.
        toolTip.PlacementTarget = this;
        toolTip.Closed += new RoutedEventHandler(OnToolTipClosed);
    }
}

protected void OnToolTipClosed(object sender, RoutedEventArgs e)
{
    // You may want to add additional focus-related tests here.
    if (this.IsKeyboardFocusWithin)
    {
        // We cannot set this.IsOpen directly here.  Instead, send an event asynchronously.
        // DispatcherPriority.Send is the highest priority possible.
        Dispatcher.CurrentDispatcher.BeginInvoke(
            (Action)delegate
                {
                    // Again: Be gentle when using this.ToolTip.
                    ToolTip toolTip = this.ToolTip as ToolTip;
                    if (null != toolTip)
                    {
                        toolTip.IsOpen = true;
                    }
                },
            DispatcherPriority.Send);
    }
}

结论：ToolTip 和 ContextMenu 的类有些不同。两者都有“服务”类，如ToolTipService 和ContextMenuService，它们管理某些属性，并且在显示期间都使用Popup 作为“秘密”父控件。最后，我注意到ALLWeb 上的XAML ToolTip 示例不直接使用ToolTip 类。相反，他们嵌入了StackPanel 和TextBlocks。让你说：“嗯……”

Answer 8

为了完整起见： 在代码中它看起来像这样：

ToolTipService.SetShowDuration(element, 60000);

Answer 9

如果您想指定只有 Window 中的某些元素具有 有效地无限期ToolTip 持续时间您可以在Window.Resources 中为这些元素定义Style。这是 Style 的 Button 有这样的 ToolTip ：

<Window
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
    xmlns:sys="clr-namespace:System;assembly=mscorlib"
    ...>
    ...
    <Window.Resources>
        <Style x:Key="ButtonToolTipIndefinate" TargetType="{x:Type Button}">
            <Setter Property="ToolTipService.ShowDuration"
                    Value="{x:Static Member=sys:Int32.MaxValue}"/>
        </Style>
        ...
    </Window.Resources>
    ...
    <Button Style="{DynamicResource ButtonToolTipIndefinate}"
            ToolTip="This should stay open"/>
    <Button ToolTip="This Should disappear after the default time.">
    ...

还可以在Style 中添加Style.Resources 以更改其显示的ToolTip 的外观，例如：

<Style x:Key="ButtonToolTipTransparentIndefinate" TargetType="{x:Type Button}">
    <Style.Resources>
        <Style x:Key="{x:Type ToolTip}" TargetType="{x:Type ToolTip}">
            <Setter Property="Background" Value="Transparent"/>
            <Setter Property="BorderBrush" Value="Transparent"/>
            <Setter Property="HasDropShadow" Value="False"/>
        </Style>
    </Style.Resources>
    <Setter Property="ToolTipService.ShowDuration"
            Value="{x:Static Member=sys:Int32.MaxValue}"/>
</Style>

注意：当我这样做时，我还在Style 中使用了BasedOn，因此将应用为具有普通ToolTip 的自定义控件版本定义的所有其他内容。

Answer 10

用相同的代码解决了我的问题。

ToolTipService.ShowDurationProperty.OverrideMetadata( typeof(DependencyObject), new FrameworkPropertyMetadata(Int32.MaxValue));