2021.10.03 BeautifulToolTip 高兼容 高性能 简单易用 自定义效果丰富的 ToolTip

这是用 GDI+ 完全重写的 ToolTip 。

BeautifulToolTip ，以下简称 BTT  。

为什么要重写一个 ToolTip 呢，因为下面4个问题真的很烦人。

• 闪烁

• 坐标乱飘

• 文本难以对齐

• 难以在显示前预知大小

BTT 被设计为可以完全取代 ToolTip ，所以它完全兼容 ToolTip 的语法及设置。

• 显示一个内容

  btt("This is BeautifulToolTip")​

• 清空一个内容

  btt()​

• 指定 x,y 及 WhichToolTip

  btt("This is BeautifulToolTip`n`nWhichToolTip = 2",500,500,2)
  Sleep, 5000
  btt(,,,2)

• CoordMode 命令也对 BTT 生效

  CoordMode, ToolTip, Screen
  btt("This is BeautifulToolTip")
  Sleep, 5000
  btt()

除了上面基本用法， BTT 还拥有多个内置样式，使用依然简单。

• 使用内置样式“Style1”

  btt("This is BeautifulToolTip",,,, "Style1")

• 更多内置样式的效果
• 自定义样式也非常简单，只需更改模板参数！

  #SingleInstance Force
  SetBatchLines, -1
  
  Text=
  (
  使用模板可以轻松创建自己的风格。
  欢迎分享，带张截图！！！
  
  Use template to easily create your own style.
  Please share your custom style and include a screenshot.
  It will help a lot of people.
  )
  
  ; 照着模板改参数就可以创建自己的风格了。建好后可以添加到 btt() 函数里，就可以变内置风格了。
  Template :=  {Border:20                                      ; If omitted, 1 will be used. Range 0-20.
              , Rounded:30                                     ; If omitted, 3 will be used. Range 0-30.
              , Margin:30                                      ; If omitted, 5 will be used. Range 0-30.
              , TabStops:[50, 80, 100]                         ; If omitted, [50] will be used. This value must be an array.
              , BorderColor:0xffaabbcc                         ; ARGB
              , BorderColorLinearGradientStart:0xff16a085      ; ARGB
              , BorderColorLinearGradientEnd:0xfff4d03f        ; ARGB
              , BorderColorLinearGradientAngle:45              ; Mode=8 Angle 0(L to R) 90(U to D) 180(R to L) 270(D to U)
              , BorderColorLinearGradientMode:1                ; Mode=4 Angle 0(L to R) 90(D to U), Range 1-8.
              , TextColor:0xff112233                           ; ARGB
              , TextColorLinearGradientStart:0xff00416a        ; ARGB
              , TextColorLinearGradientEnd:0xffe4e5e6          ; ARGB
              , TextColorLinearGradientAngle:90                ; Mode=8 Angle 0(L to R) 90(U to D) 180(R to L) 270(D to U)
              , TextColorLinearGradientMode:1                  ; Mode=4 Angle 0(L to R) 90(D to U), Range 1-8.
              , BackgroundColor:0xff778899                     ; ARGB
              , BackgroundColorLinearGradientStart:0xff8DA5D3  ; ARGB
              , BackgroundColorLinearGradientEnd:0xffF4CFC9    ; ARGB
              , BackgroundColorLinearGradientAngle:135         ; Mode=8 Angle 0(L to R) 90(U to D) 180(R to L) 270(D to U)
              , BackgroundColorLinearGradientMode:1            ; Mode=4 Angle 0(L to R) 90(D to U), Range 1-8.
              , Font:"Font Name"                               ; If omitted, ToolTip's Font will be used. Can specify the font file.
              , FontSize:20                                    ; If omitted, 12 will be used.
              , FontRender:5                                   ; If omitted, 5 will be used. Range 0-5.
              , FontStyle:"Regular Bold Italic BoldItalic Underline Strikeout"}
  
  ; Same as Style7
  OwnStyle1 := {Border:20
              , Rounded:30
              , Margin:30
              , BorderColor:0xffaabbcc
              , TextColor:0xff112233
              , BackgroundColorLinearGradientStart:0xffF4CFC9
              , BackgroundColorLinearGradientEnd:0xff8DA5D3
              , BackgroundColorLinearGradientAngle:0
              , BackgroundColorLinearGradientMode:8
              , FontStyle:"BoldItalic Underline"}
  
  btt(Text,,,,OwnStyle1)
  Sleep, 10000
  ExitApp

  

通过更改 BTT 的 Options 参数，可以很容易的实现一些特效。

• 淡入

for k, v in [15,35,55,75,95,115,135,155,175,195,215,235,255]
{
	btt(Text,,,,"Style7",{Transparent:v})
	Sleep, 30
}

• 淡出

for k, v in [240,220,200,180,160,140,120,100,80,60,40,20,0]
{
	btt(Text,,,,"Style7",{Transparent:v})
	Sleep, 30
}

• 改变“渐变角度”参数实现动画效果

• 窗口跟随

btt(Text,800-1,600-1,,"Style1",{TargetHWND:target})

• 计算最终显示大小

ret := btt("test",,,,,{JustCalculateSize:1})
MsgBox, % "宽：" ret.w " 高：" ret.h

除了以上这些 BTT 还实现了

• 多显示器支持
• 多DPI支持

但这里就不再演示了，自己看打包的示例或者源码中的说明。

最后，在即没有原版那些烦人问题，又拥有诸多新特性的同时。

BTT 的性能    ——     比原版快 2-1000 倍！！！！！！

• 原版 CPU 占用率

• BTT CPU 占用率

• 耗时对比

强烈建议你把 BTT库 及 引用库 放 AHK 公用 Lib 目录里。

也就是说，把 BTT.ahk 、 Gdip_All.ahk 、 NonNull.ahk 放下面目录里（没有就手动新建）

C:\我的电脑\Documents\AutoHotkey\Lib

这样你在每次使用的时候，就不需要再 #Include BTT.ahk 了。

好了，快抛弃 ToolTip 拥抱 BTT 吧！！！秀出你自定义的style！！！

下载地址：

https://github.com/telppa/BeautifulToolTip/releases

更新日志：

• 2021.10.03
  改变 Include 方式，降低库冲突的可能性。
  
• 2021.09.29
  支持设置 TabStops 。
  除 GDIP 库外所有函数内置到 Class 中，降低库冲突的可能性。
  
• 2021.04.30
  修复 Win7 下不能运行的 bug 。（2021.04.20 引起）
  
• 2021.04.20
  支持根据显示器 DPI 缩放比例自动缩放，与 ToolTip 特性保持一致。
  支持直接使用未安装的本地字体。
  Options 增加 JustCalculateSize 参数，可在不绘制内容的前提下直接返回尺寸。
  
• 2021.03.07
  增加 4 种渐变模式。
• 2021.03.05
  删除渐变方向参数。
  增加渐变角度参数，支持 360° 渐变。
  增加渐变模式参数，支持 4 种模式。
  
• 2021.03.03
  文本色支持渐变。
  增加 Style8 。
  增加3个渐变方向。
• 2021.03.02
  细边框色支持渐变。
  增加 Style7 。
  增加2个渐变方向。
• 2021.03.01
  BTT 的总在最上级别现在跟 ToolTip 一样高了。
  解决 BTT 被不明原因置底导致误以为没显示的问题。
  增加 Style6 。
  文字显示更加居中。
• 2021.02.22
  增加返回值与 Transparent 参数。