# WinSetTransColor

使所选颜色的所有像素在指定的窗口内不可见(透明).

    WinSetTransColor Color , WinTitle, WinText, ExcludeTitle, ExcludeText

## 参数

Color

  类型: 字符串或整数

  指定一个颜色名称或 RGB 值(请参阅颜色列表以获得指导, 或在 RGB 模式下使用 PixelGetColor). 如果要使窗口的可见部分部分透明(半透明), 请在透明度级别(0-255) 后面添加一个空格(不是逗号). 例如: `WinSetTransColor "EEAA99 150", WinTitle`.

  如果值是一个字符串, 任何数字颜色值必须是十六进制的格式. 颜色值可以省略; 例如, `WinSetTransColor " 150"`(带前导空格) 等同于 `WinSetTransparent 150`.

  单词 `"Off"`(不区分大小写) 可以完全关闭窗口的透明度. 这与 `WinSetTransparent "Off", WinTitle` 功能相同. 指定 `"Off"` 与指定 255 不同, 因为它可能会提高性能并减少系统资源的使用(但可能只在禁用桌面合成时).

WinTitle, WinText, ExcludeTitle, ExcludeText

  类型: 字符串, 整数或对象

  如果这些都未设置或省略, 将使用上次找到的窗口. 否则, 为 WinTitle 指定窗口标题或其他条件, 来标识目标窗口, 和/或为 WinText 指定目标窗口的单个文本元素的子字符串(由包含的 Window Spy 实用程序显示). 如果 DetectHiddenText 已经打开, 则检测隐藏文本元素. 标题或文本包含 ExcludeTitle 或 ExcludeText 的窗口将不被考虑.

## 错误处理

如果找不到窗口, 则抛出 TargetError.

如果无法应用更改, 则抛出 OSError.

## 备注

这使得后面的窗口内容可以显示出来. 如果用户点击一个不可见的像素, 点击会 "穿透" 到后面的窗口.

要改变一个窗口现有的 TransColor, 可能需要在改变之前关闭透明度.

鼠标光标下的窗口的 ID 可以使用 MouseGetPos 来获取.

窗口标题和文本是区分大小写的. 除非 DetectHiddenWindows 被打开, 否则不会检测隐藏窗口.

此函数常用来创建屏幕显示(OSD) 和其他视觉效果. 在 Gui 对象页面的底部有一个屏幕显示的例子. 有关通过热键的简单演示, 请参阅在 WinSetTransparent 页面的示例 #4.

这个函数经常被用来创建屏幕上的显示和其他视觉效果. 在 Gui 对象页面的底部有一个屏幕显示的例子. 通过热键进行简单的演示, 请参阅 WinSetTransparent 页面的示例 #3.

## 相关

WinSetTransparent, 窗口函数, 控件函数

## 示例

使记事本中的所有白色像素都不可见. 这个例子在 Windows 11 或更高版本的新记事本上可能不能很好地工作.

    WinSetTransColor "White", "Untitled - Notepad"

dftg