WinSetTransColor

指定されたウィンドウの中で、選択された色のすべてのピクセルを見えなくします。

WinSetTransColor Color , WinTitle, WinText, ExcludeTitle, ExcludeText

パラメータ

Color

型:文字列または整数

色名またはRGB値を指定する(ガイダンスとしてカラーチャートを参照するか、RGBモードのPixelGetColorを使用する)。さらにウィンドウの可視部分を部分的に透明にするには、スペース(カンマではない)の後に透明度(0~255)を追加する。事例:WinSetTransColor "EEAA99 150".

値が文字列の場合、色の数値は16進数でなければならない。例えば、WinSetTransColor " 150"(先頭スペースあり)は、WinSetTransparent 150と同じです。

"Off" (case-insensitive) or an empty string may be specified to completely turn off transparency for a window. This is functionally identical to WinSetTransparent "Off". Specifying Off is different than specifying 255 because it may improve performance and reduce usage of system resources (but probably only when desktop composition is disabled).

WinTitle、WinText、ExcludeTitle、ExcludeText

型:文字列整数またはオブジェクト

もしこれらの項目が未設定または省略されたときは、最後に見つかったウィンドウが使用されます。そうでないときは、WinTitleウィンドウタイトルまたはターゲットウィンドウを識別するための他の基準、および/またはWinTextにターゲットウィンドウの単一のテキスト要素からの部分文字列(付属のWindow Spyユーティリティを使えばわかります)を指定します。

ExcludeTitleExcludeTextはウィンドウのタイトルまたはテキストで除外するために使用します。指定の仕方はWinTitleWinTextに似ていますが、ExcludeTitleはウィンドウのタイトル以外の基準(ウィンドウクラスやHWNDなど)を認識しません。

ウィンドウのタイトルとテキストは大文字と小文字を区別します。DetectHiddenWindows関数 と DetectHiddenText関数で変更しない限り、初期設定では非表示ウィンドウは検出されず、非表示テキストは検出されます。SetTitleMatchMode関数で変更しない限り、初期設定ではウィンドウのタイトルはその中のどこかにWinTitleまたはExcludeTitleを含んでいれば一致します。

エラー処理

ウィンドウが見つからないときは、TargetErrorがスローされます。

変更が適用できなかったときはOSErrorがスローされます。

備考

これにより、背後のウィンドウの内容が透けて見える。ユーザーが不可視のピクセルをクリックすると、そのクリックは背後のウィンドウに「フォールスルー」される。

ウィンドウの既存のTransColorを変更するには、変更する前に透明度をオフにする必要があります。

マウスカーソルの下にあるウィンドウのIDは、MouseGetPos関数で取得できます。

この機能は、オンスクリーンディスプレイやその他のビジュアルエフェクトを作成するためによく使用される。Guiオブジェクト・ページの一番下にオンスクリーン表示の例がある。For a simple demonstration via hotkeys, see WinSetTransparent example #4.

WinSetTransparent, Win functions, Control functions

メモ帳のすべての白いピクセルを見えなくする。この例は、Windows11以降の新しいメモ帳ではうまく動作しないかもしれません。

WinSetTransColor "White", "Untitled - Notepad"