// 此文件主体由 AI 生成,应作为独立模块,尽量减少与其他内容的耦合。 // 使用 ModernTooltipService 接管后,TooltipService 仅有 IsEnabled、ShowOnDisabled、InitialShowDelay 仍然有效,其他属性不再生效。 using System.ComponentModel; using System.Windows; using System.Windows.Controls; using System.Windows.Controls.Primitives; using System.Windows.Input; using System.Windows.Media; using System.Windows.Media.Animation; using System.Windows.Media.Effects; using System.Windows.Media.Media3D; using System.Windows.Threading; namespace MeloongCore.Wpf; public static class ModernTooltipService { // 控制是否使用现代化 Tooltip 渲染;默认为 true。是否允许显示 Tooltip 仍由 ToolTipService.IsEnabled 控制。 public static void SetUseModernTooltip(DependencyObject element, bool value) => element.SetValue(UseModernTooltipProperty, value); public static bool GetUseModernTooltip(DependencyObject element) => (bool) element.GetValue(UseModernTooltipProperty); // 控制 Tooltip 是否跟随鼠标移动;默认为 true。 public static void SetFollowMouse(DependencyObject element, bool value) => element.SetValue(FollowMouseProperty, value); public static bool GetFollowMouse(DependencyObject element) => (bool) element.GetValue(FollowMouseProperty); /// /// 全局启用现代 Tooltip。启用后会接管所有 。 /// internal static void Init() { if (initialized) return; initialized = true; EventManager.RegisterClassHandler(typeof(FrameworkElement), UIElement.MouseEnterEvent, new MouseEventHandler(OnMouseEnter), true); EventManager.RegisterClassHandler(typeof(FrameworkElement), UIElement.MouseMoveEvent, new MouseEventHandler(OnMouseMove), true); EventManager.RegisterClassHandler(typeof(FrameworkElement), UIElement.MouseLeaveEvent, new MouseEventHandler(OnMouseLeave), true); EventManager.RegisterClassHandler(typeof(FrameworkElement), UIElement.PreviewMouseUpEvent, new MouseButtonEventHandler(OnPreviewMouseUp), true); EventManager.RegisterClassHandler(typeof(FrameworkElement), ToolTipService.ToolTipOpeningEvent, new ToolTipEventHandler(OnToolTipOpening), true); EventManager.RegisterClassHandler(typeof(FrameworkElement), FrameworkElement.UnloadedEvent, new RoutedEventHandler(static (sender, _) => { if (sender is FrameworkElement owner && ReferenceEquals(owner, currentOwner)) Close(false); }), true); // Loaded 负责常规路径;PreviewMouseDown 兜底处理 Init 晚于控件 Loaded 的情况。 EventManager.RegisterClassHandler(typeof(ComboBox), FrameworkElement.LoadedEvent, new RoutedEventHandler(static (sender, _) => HookComboBoxDropDown(sender as ComboBox)), true); EventManager.RegisterClassHandler(typeof(ComboBox), UIElement.PreviewMouseDownEvent, new MouseButtonEventHandler(static (sender, _) => HookComboBoxDropDown(sender as ComboBox)), true); } #region 字段与属性 // 附加属性 public static readonly DependencyProperty UseModernTooltipProperty = DependencyProperty.RegisterAttached( "UseModernTooltip", typeof(bool), typeof(ModernTooltipService), new PropertyMetadata(true)); public static readonly DependencyProperty FollowMouseProperty = DependencyProperty.RegisterAttached( "FollowMouse", typeof(bool), typeof(ModernTooltipService), new PropertyMetadata(true)); private static readonly DependencyProperty IsComboBoxDropDownHookedProperty = DependencyProperty.RegisterAttached( "IsComboBoxDropDownHooked", typeof(bool), typeof(ModernTooltipService), new PropertyMetadata(false)); // 常量 private const double closedScale = 0.97; private const int shadowRadius = 18, contentMaxWidth = 676; private static readonly Thickness contentMargin = new(12, 11, 12, 8); private static readonly Brush backgroundBrush = new SolidColorBrush(Colors.White); private static readonly Brush borderBrush = new SolidColorBrush(Color.FromRgb(0xD6, 0xD6, 0xD6)); private static readonly Brush foregroundBrush = new SolidColorBrush(Color.FromRgb(0x52, 0x52, 0x52)); private static readonly DependencyPropertyDescriptor toolTipPropertyDescriptor = DependencyPropertyDescriptor.FromProperty(FrameworkElement.ToolTipProperty, typeof(FrameworkElement)); // 状态字段 private static readonly DispatcherTimer openTimer = new(); private static bool initialized; private static int animationToken; private static Point lastMousePoint; private static Popup? popup; private static Border? popupCard; private static ScaleTransform? popupScale; private static FrameworkElement? currentOwner; private static FrameworkElement? observedToolTipOwner; private static ToolTip? borrowedToolTip; private static object? borrowedContent; static ModernTooltipService() { backgroundBrush.Freeze(); borderBrush.Freeze(); foregroundBrush.Freeze(); openTimer.Tick += (_, _) => { openTimer.Stop(); if (currentOwner is not null) Show(currentOwner, lastMousePoint); }; } #endregion #region 事件入口 private static void OnMouseEnter(object sender, MouseEventArgs e) { if (sender is not FrameworkElement reference) return; reference.Dispatcher.BeginInvoke(new Action(() => RefreshCurrentOwner(reference)), DispatcherPriority.Input); } private static void OnMouseMove(object sender, MouseEventArgs e) { if (sender is not FrameworkElement reference) return; if (Mouse.LeftButton == MouseButtonState.Pressed) { if (currentOwner is FrameworkElement pressedOwner) { lastMousePoint = Mouse.GetPosition(pressedOwner); if (GetFollowMouse(pressedOwner) && popup is { IsOpen: true }) { UpdatePosition(pressedOwner, lastMousePoint); } } else if (popup is { IsOpen: true, PlacementTarget: FrameworkElement popupOwner } && GetFollowMouse(popupOwner)) { lastMousePoint = Mouse.GetPosition(popupOwner); UpdatePosition(popupOwner, lastMousePoint); } return; } RefreshCurrentOwner(reference); if (currentOwner is FrameworkElement owner) { lastMousePoint = Mouse.GetPosition(owner); if (GetFollowMouse(owner) && popup is { IsOpen: true }) UpdatePosition(owner, lastMousePoint); return; } if (popup is { IsOpen: true, PlacementTarget: FrameworkElement closingOwner } && GetFollowMouse(closingOwner)) { lastMousePoint = Mouse.GetPosition(closingOwner); UpdatePosition(closingOwner, lastMousePoint); } } private static void OnMouseLeave(object sender, MouseEventArgs e) { if (sender is not FrameworkElement owner || !ReferenceEquals(owner, currentOwner)) return; if (!(owner.IsEnabled || !ToolTipService.GetShowOnDisabled(owner) || !IsPointInside(owner, Mouse.GetPosition(owner)))) return; var nextOwner = FindCurrentTooltipOwner(owner); if (nextOwner is not null && !ReferenceEquals(nextOwner, owner)) { BeginShow(nextOwner, Mouse.GetPosition(nextOwner)); return; } Close(true); } private static void OnPreviewMouseUp(object sender, MouseButtonEventArgs e) { if (sender is not FrameworkElement reference) return; reference.Dispatcher.BeginInvoke(new Action(() => RefreshCurrentOwner(reference)), DispatcherPriority.Input); } private static void OnToolTipOpening(object sender, ToolTipEventArgs e) { if (sender is not FrameworkElement owner || !CanShowModernTooltip(owner) || !TryGetToolTip(owner, out _, out _)) return; e.Handled = true; if (ShouldSuppressTooltip(owner)) { Close(false); return; } // 启用状态控件走 MouseEnter 延迟逻辑;禁用控件只能从原生 Opening 事件接管。 if (owner.IsEnabled) return; if (!ReferenceEquals(currentOwner, owner)) HideImmediately(); currentOwner = owner; openTimer.Stop(); lastMousePoint = Mouse.GetPosition(owner); Show(owner, lastMousePoint); } #endregion #region Tooltip 目标解析 private static void RefreshCurrentOwner(FrameworkElement reference) { var owner = FindCurrentTooltipOwner(reference); if (currentOwner is { IsEnabled: false } disabledOwner && ToolTipService.GetShowOnDisabled(disabledOwner) && IsPointInside(disabledOwner, Mouse.GetPosition(disabledOwner))) { return; } if (ShouldSuppressTooltip(owner)) { // 鼠标捕获仍在当前拥有者分支内时,保留现有气泡,避免拖选或按压时闪烁。 if (currentOwner is not null && Mouse.Captured is DependencyObject captured && IsSameTreeBranch(captured, currentOwner) && IsPointInside(currentOwner, Mouse.GetPosition(currentOwner))) { return; } Close(false); return; } if (owner is not null) { BeginShow(owner, Mouse.GetPosition(owner)); } else if (currentOwner is not null) { Close(true); // 弹窗遮挡等情况可能不会触发原拥有者的 MouseLeave,需要由其他元素收到的 MouseMove 主动关闭 } } private static FrameworkElement? FindCurrentTooltipOwner(FrameworkElement reference) { static FrameworkElement? FindOwnerInAncestors(DependencyObject? start) { for (var current = start; current is not null; current = GetParent(current)) { if (current is FrameworkElement owner && CanShowModernTooltip(owner) && TryGetToolTip(owner, out _, out _)) { return owner; } } return null; } var owner = FindOwnerInAncestors(Mouse.DirectlyOver as DependencyObject); if (owner is not null) return owner; // 重新从窗口根元素命中测试,避免弹窗出现后 Mouse.DirectlyOver 尚未刷新,继续命中已被遮挡的旧元素。 if (PresentationSource.FromVisual(reference)?.RootVisual is UIElement root) { var rootHit = root.InputHitTest(Mouse.GetPosition(root)) as DependencyObject; owner = FindOwnerInAncestors(rootHit); if (owner is not null) return owner; if (rootHit is not null && !IsSameTreeBranch(rootHit, reference)) return null; } return reference.InputHitTest(Mouse.GetPosition(reference)) is DependencyObject hit ? FindOwnerInAncestors(hit) : null; } private static bool CanShowModernTooltip(FrameworkElement owner) => GetUseModernTooltip(owner) && ToolTipService.GetIsEnabled(owner) && (owner.IsEnabled || ToolTipService.GetShowOnDisabled(owner)); private static bool TryGetToolTip(FrameworkElement owner, out object? content, out ToolTip? sourceToolTip) { var raw = owner.ToolTip; sourceToolTip = raw as ToolTip; content = sourceToolTip is null ? raw : sourceToolTip.Content ?? (ReferenceEquals(sourceToolTip, borrowedToolTip) ? borrowedContent : null); return content is not null && (content is not string text || text.Length > 0); } private static bool ShouldSuppressTooltip(FrameworkElement? owner) { if (Mouse.LeftButton == MouseButtonState.Pressed || Mouse.Captured is null) return false; if (Mouse.Captured is not DependencyObject captured) return true; if (owner is null) return true; return !IsSameTreeBranch(captured, owner); } private static bool IsPointInside(FrameworkElement owner, Point point) => point.X >= 0 && point.Y >= 0 && point.X <= owner.ActualWidth && point.Y <= owner.ActualHeight; private static bool IsSameTreeBranch(DependencyObject first, DependencyObject second) { if (ReferenceEquals(first, second)) return true; for (var current = GetParent(second); current is not null; current = GetParent(current)) { if (ReferenceEquals(current, first)) return true; } for (var current = GetParent(first); current is not null; current = GetParent(current)) { if (ReferenceEquals(current, second)) return true; } return false; } private static DependencyObject? GetParent(DependencyObject current) { if (current is Visual or Visual3D && VisualTreeHelper.GetParent(current) is { } visualParent) return visualParent; return LogicalTreeHelper.GetParent(current); } #endregion #region 显示生命周期 private static void BeginShow(FrameworkElement owner, Point point) { if (!CanShowModernTooltip(owner) || !TryGetToolTip(owner, out _, out _)) return; if (ShouldSuppressTooltip(owner)) { Close(false); return; } if (owner is ComboBox comboBox) HookComboBoxDropDown(comboBox); if (ReferenceEquals(currentOwner, owner)) { lastMousePoint = point; if (popup is not { IsOpen: true } && !openTimer.IsEnabled) StartOpenTimer(owner); return; } HideImmediately(); currentOwner = owner; lastMousePoint = point; StartOpenTimer(owner); } private static void StartOpenTimer(FrameworkElement owner) { openTimer.Stop(); var delay = Math.Max(0, ToolTipService.GetInitialShowDelay(owner)); if (delay == 0) { Show(owner, lastMousePoint); return; } openTimer.Interval = TimeSpan.FromMilliseconds(delay); openTimer.Start(); } private static void Show(FrameworkElement owner, Point point) { if (!ReferenceEquals(owner, currentOwner) || !CanShowModernTooltip(owner) || !TryGetToolTip(owner, out var content, out var sourceToolTip)) return; // 禁用控件由原生 ToolTipOpening 确认命中,无法通过常规 InputHitTest 可靠地重新定位。 if (owner.IsEnabled && !ReferenceEquals(owner, FindCurrentTooltipOwner(owner))) { Close(false); return; } if (popup is null) { popupScale = new ScaleTransform(closedScale, closedScale); popupCard = new Border { Background = backgroundBrush, BorderBrush = borderBrush, BorderThickness = new(1), CornerRadius = new(8), MaxWidth = 700, SnapsToDevicePixels = true, UseLayoutRounding = true, RenderTransform = popupScale, RenderTransformOrigin = new(0, 0), Effect = new DropShadowEffect { Opacity = 0.15, BlurRadius = shadowRadius, ShadowDepth = 0, Color = Colors.Black } }; var root = new Grid { Margin = new(shadowRadius + 1), SnapsToDevicePixels = true, UseLayoutRounding = true }; root.Children.Add(popupCard); popup = new Popup { AllowsTransparency = true, IsHitTestVisible = false, StaysOpen = true, PopupAnimation = PopupAnimation.None, Placement = PlacementMode.Relative, Child = root }; } popup.PlacementTarget = owner; UpdatePosition(owner, point); ObserveToolTip(owner); UpdateContent(owner, content!, sourceToolTip); animationToken++; popupCard!.Opacity = 0; popupScale!.ScaleX = closedScale; popupScale.ScaleY = closedScale; popup.IsOpen = true; Animate(1, 1, null); } private static void UpdateContent(FrameworkElement owner, object content, ToolTip? sourceToolTip) { popupCard!.DataContext = sourceToolTip?.DataContext ?? owner.DataContext; popupCard.FlowDirection = owner.FlowDirection; // 先还原上一次借出的 Visual,再挂载新的内容,避免同一元素拥有两个逻辑父级。 popupCard.Child = null; RestoreBorrowedContent(); if (sourceToolTip is not null && content is DependencyObject contentObject && ReferenceEquals(LogicalTreeHelper.GetParent(contentObject), sourceToolTip)) { borrowedToolTip = sourceToolTip; borrowedContent = content; sourceToolTip.Content = null; } var hasTemplate = sourceToolTip?.ContentTemplate is not null || sourceToolTip?.ContentTemplateSelector is not null; popupCard.Child = content is string stringContent && !hasTemplate ? new TextBlock { Text = stringContent, TextWrapping = TextWrapping.Wrap, Foreground = foregroundBrush, Margin = contentMargin, FontSize = 12.5, LineHeight = 17, MaxWidth = contentMaxWidth } : new ContentPresenter { Content = content, ContentTemplate = sourceToolTip?.ContentTemplate, ContentTemplateSelector = sourceToolTip?.ContentTemplateSelector, ContentStringFormat = sourceToolTip?.ContentStringFormat, Margin = contentMargin, MaxWidth = contentMaxWidth }; } private static void ObserveToolTip(FrameworkElement owner) { if (ReferenceEquals(observedToolTipOwner, owner)) return; StopObservingToolTip(); observedToolTipOwner = owner; toolTipPropertyDescriptor.AddValueChanged(owner, OnToolTipChanged); } private static void StopObservingToolTip() { if (observedToolTipOwner is null) return; toolTipPropertyDescriptor.RemoveValueChanged(observedToolTipOwner, OnToolTipChanged); observedToolTipOwner = null; } private static void OnToolTipChanged(object? sender, EventArgs e) { if (sender is not FrameworkElement owner || !ReferenceEquals(owner, currentOwner) || popup is not { IsOpen: true }) return; if (!CanShowModernTooltip(owner) || !TryGetToolTip(owner, out var content, out var sourceToolTip)) { Close(true); return; } UpdateContent(owner, content!, sourceToolTip); } private static void Close(bool animated) { openTimer.Stop(); currentOwner = null; StopObservingToolTip(); if (popup is not { IsOpen: true } || popupCard is null || !animated) { HideImmediately(); return; } var token = ++animationToken; Animate(0, closedScale, (_, _) => { if (token != animationToken) return; HideImmediately(); }); } private static void HideImmediately() { openTimer.Stop(); animationToken++; StopObservingToolTip(); if (popup is not null) popup.IsOpen = false; if (popupCard is not null) { popupCard.BeginAnimation(UIElement.OpacityProperty, null); popupCard.Child = null; } if (popupScale is not null) { popupScale.BeginAnimation(ScaleTransform.ScaleXProperty, null); popupScale.BeginAnimation(ScaleTransform.ScaleYProperty, null); } RestoreBorrowedContent(); } private static void RestoreBorrowedContent() { if (borrowedToolTip is null) return; borrowedToolTip.Content = borrowedContent; borrowedToolTip = null; borrowedContent = null; } #endregion #region Popup 渲染与动画 private static void UpdatePosition(FrameworkElement owner, Point point) { popup!.PlacementTarget = owner; popup.HorizontalOffset = Math.Round(point.X + 15); popup.VerticalOffset = Math.Round(point.Y + 25); } private static void Animate(double opacity, double scale, EventHandler? completed) { var duration = new Duration(TimeSpan.FromMilliseconds(70)); var opacityAnimation = new DoubleAnimation(opacity, duration) { EasingFunction = new QuadraticEase { EasingMode = EasingMode.EaseOut } }; if (completed is not null) opacityAnimation.Completed += completed; var scaleAnimation = new DoubleAnimation(scale, duration) { EasingFunction = new QuadraticEase { EasingMode = EasingMode.EaseOut } }; popupCard!.BeginAnimation(UIElement.OpacityProperty, opacityAnimation, HandoffBehavior.SnapshotAndReplace); popupScale!.BeginAnimation(ScaleTransform.ScaleXProperty, scaleAnimation, HandoffBehavior.SnapshotAndReplace); popupScale.BeginAnimation(ScaleTransform.ScaleYProperty, scaleAnimation, HandoffBehavior.SnapshotAndReplace); } #endregion // WPF 原生 Tooltip 会在 ComboBox 下拉弹出时关闭;这里保持同样行为。 private static void HookComboBoxDropDown(ComboBox? comboBox) { if (comboBox is null || (bool) comboBox.GetValue(IsComboBoxDropDownHookedProperty)) return; comboBox.SetValue(IsComboBoxDropDownHookedProperty, true); comboBox.DropDownOpened += static (_, _) => { if (currentOwner is not null) Close(true); }; } }