WinSetTransColor

Macht alle Pixel einer bestimmten Farbe in einem bestimmten Fenster unsichtbar.

WinSetTransColor Farbe , FensterTitel, FensterText, AusnahmeTitel, AusnahmeText

Parameter

Farbe

Typ: Zeichenkette oder Integer

Geben Sie einen Farbnamen oder RGB-Wert an (schauen Sie in der Farbentabelle nach oder verwenden Sie PixelGetColor im RGB-Modus). Um den sichtbaren Bereich eines Fensters zusätzlich transparent zu machen, fügen Sie ein Leerzeichen (kein Komma) gefolgt von der Transparenzstärke (0-255) an. Zum Beispiel: WinSetTransColor "EEAA99 150".

Wenn der Wert eine Zeichenkette ist, muss ein numerischer Farbwert im hexadezimalen Format sein. Der Farbwert kann weggelassen werden, z.B. ist WinSetTransColor " 150" (mit Leerzeichen am Anfang) äquivalent zu WinSetTransparent 150.

Geben Sie "Off" (nicht Groß-/Kleinschreibung-sensitiv) oder eine leere Zeichenkette an, um die Transparenz eines Fensters komplett zu deaktivieren. Dies hat denselben Effekt wie WinSetTransparent "Off". Das Wort Off unterscheidet sich vom Wert 255, da es die Performanz verbessern und den Verbrauch von Systemressourcen verringern kann (aber wahrscheinlich nur, wenn die Desktopgestaltung deaktiviert ist).

FensterTitel, FensterText, AusnahmeTitel, AusnahmeText

Typ: Zeichenkette, Integer oder Objekt

Wenn jeder dieser Parameter leer ist oder weggelassen wird, wird das Zuletzt Gefundene Fenster verwendet. Andernfalls geben Sie für FensterTitel einen Fenstertitel oder andere Kriterien zur Identifizierung des Zielfensters und/oder für FensterText eine Teilzeichenkette aus einem Textelement des Zielfensters an (Textelemente können mit dem internen Tool "Window Spy" in Erfahrung gebracht werden).

AusnahmeTitel und AusnahmeText können verwendet werden, um ein oder mehrere Fenster anhand ihres Titels oder Textes auszuschließen. Ihre Angabe ähnelt der von FensterTitel und FensterText, außer dass AusnahmeTitel keine anderen Kriterien als den Fenstertitel erkennt.

Fenstertitel und -texte sind Groß-/Kleinschreibung-sensitiv. Standardmäßig werden versteckte Fenster nicht erkannt und versteckte Textelemente erkannt, was mit DetectHiddenWindows und DetectHiddenText geändert werden kann. Standardmäßig kann ein Fenstertitel den angegebenen FensterTitel oder AusnahmeTitel an beliebiger Stelle enthalten, um eine Übereinstimmung zu sein, was mit SetTitleMatchMode geändert werden kann.

Fehlerbehandlung

Es wird ein TargetError ausgelöst, wenn das Fenster nicht gefunden werden konnte.

Es wird ein OSError ausgelöst, wenn die Änderung nicht angewendet werden konnte.

Bemerkungen

Dies ermöglicht es, den Inhalt des dahinter liegenden Fensters durchscheinen zu lassen. Wenn der Benutzer auf ein unsichtbares Pixel klickt, wirkt sich der Klick auf das Fenster dahinter aus.

Um die vorhandene TransColor-Einstellung eines Fensters zu ändern, muss eventuell die Transparenz ausgeschaltet werden, bevor die Änderung vorgenommen werden kann.

Mit MouseGetPos kann die ID des Fensters unter dem Mauszeiger abgerufen werden.

Diese Funktion wird oft verwendet, um Bildschirmanzeigen (engl. On-Screen Display, kurz OSD) und andere visuelle Effekte zu erzeugen. Ein Beispiel dazu finden Sie auf der GUI-Objekt-Seite ganz unten. Für eine einfache Demonstration via Hotkeys siehe WinSetTransparent-Beispiel #4.

WinSetTransparent, Win-Funktionen, Control-Funktionen

Beispiele

Macht alle weißen Pixel in Notepad unsichtbar. Dieses Beispiel funktioniert evtl. nicht korrekt mit dem neuen Notepad in Windows 11 oder höher.

WinSetTransColor "White", "Unbenannt - Editor"