WinSetTransColor

選択した色のすべてのピクセルを、指定したウィンドウ内で非表示にします。

WinSetTransColor Color , WinTitle, WinText, ExcludeTitle, ExcludeText

パラメータ

Color

型:文字列または整数

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

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

"Off"(大文字小文字を区別しません)または空の文字列を指定すると、ウィンドウの透明度を完全にオフにすることができます。これはWinSetTransparent "Off"と機能的に同じです。Offを指定すればパフォーマンスが向上し、システムリソースの使用量が減る可能性があるため、255を指定するのとは異なります。ただし、デスクトップコンポジションが無効になっているときに限られるでしょう。

WinTitle, WinText, ExcludeTitle, ExcludeText

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

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

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

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

エラー処理

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

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

備考

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

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

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

この機能は、オンスクリーンディスプレイやその他のビジュアルエフェクトを作成するためによく使用される。Guiオブジェクト・ページの一番下にオンスクリーン表示の例がある。ホットキーによる簡単なデモンストレーションは、WinSetTransparentの例4を参照してください。

WinSetTransparentWin関数Control関数

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

WinSetTransColor "White", "Untitled - Notepad"