<script src="../static/ga4.js" type="text/javascript"></script> </head> <body> <h1>ControlSetChecked</h1> <p>Schaltet ein CheckBox- oder Radio-Steuerelement ein oder aus.</p> <pre class="Syntax"><span class="func">ControlSetChecked</span> NeueEinstellung, Steuerelement <span class="optional">, FensterTitel, FensterText, AusnahmeTitel, AusnahmeText</span></pre> <h2 id="Parameters">Parameter</h2> <dl> <dt>NeueEinstellung</dt> <dd> <p>Typ: <a href="../Concepts.htm#numbers">Integer</a></p> <p>Einer der folgenden Werte:</p> <ul> <li><code>1</code> oder <code>True</code> schaltet die Einstellung ein</li> <li><code>0</code> oder <code>False</code> schaltet die Einstellung aus</li> <li><code>-1</code> schaltet die Einstellung um (setzt sie auf den entgegengesetzten Zustand)</li> </ul> </dd> <dt>Steuerelement</dt> <dd> <p>Typ: <a href="../Concepts.htm#strings">Zeichenkette</a>, <a href="../Concepts.htm#numbers">Integer</a> oder <a href="../Concepts.htm#objects">Objekt</a></p> <p>ClassNN-Bezeichnung, Text oder HWND-Nummer des Steuerelements, oder ein Objekt mit einer <code>Hwnd</code>-Eigenschaft. Einzelheiten finden Sie unter <a href="Control.htm#Parameter">Der Steuerelement-Parameter</a>.</p> </dd> <dt>FensterTitel, FensterText, AusnahmeTitel, AusnahmeText</dt> <dd> <p>Typ: <a href="../Concepts.htm#strings">Zeichenkette</a>, <a href="../Concepts.htm#numbers">Integer</a> oder <a href="../Concepts.htm#objects">Objekt</a></p> <p>Wenn jeder dieser Parameter leer ist oder weggelassen wird, wird das <a href="../misc/WinTitle.htm#LastFoundWindow">Zuletzt Gefundene Fenster</a> verwendet. Andernfalls geben Sie für <em>FensterTitel</em> einen <a href="../misc/WinTitle.htm">Fenstertitel oder andere Kriterien</a> zur Identifizierung des Zielfensters und/oder für <em>FensterText</em> eine Teilzeichenkette aus einem Textelement des Zielfensters an (Textelemente können mit dem internen Tool "Window Spy" in Erfahrung gebracht werden).</p> <p><em>AusnahmeTitel</em> und <em>AusnahmeText</em> können verwendet werden, um ein oder mehrere Fenster anhand ihres Titels oder Textes auszuschließen. Ihre Angabe ähnelt der von <em>FensterTitel</em> und <em>FensterText</em>, außer dass <em>AusnahmeTitel</em> keine anderen Kriterien als den Fenstertitel erkennt.</p> <p>Fenstertitel und -texte sind Groß-/Kleinschreibung-sensitiv. Standardmäßig werden versteckte Fenster nicht erkannt und versteckte Textelemente erkannt, was mit <a href="DetectHiddenWindows.htm">DetectHiddenWindows</a> und <a href="DetectHiddenText.htm">DetectHiddenText</a> geändert werden kann; wenn jedoch <a href="../misc/WinTitle.htm#ahk_id">reine HWND-Nummern</a> verwendet werden, werden versteckte Fenster immer erkannt, unabhängig von DetectHiddenWindows. Standardmäßig kann ein Fenstertitel den angegebenen <em>FensterTitel</em> oder <em>AusnahmeTitel</em> an beliebiger Stelle enthalten, um eine Übereinstimmung zu sein, was mit <a href="SetTitleMatchMode.htm">SetTitleMatchMode</a> geändert werden kann.</p> </dd> </dl> <h2 id="Error_Handling">Fehlerbehandlung</h2> <p>Es wird ein <a href="Error.htm#TargetError">TargetError</a> ausgelöst, wenn das Fenster oder Steuerelement nicht gefunden werden konnte.</p> <p>Es wird ein <a href="Error.htm#OSError">OSError</a> ausgelöst, wenn eine Meldung nicht an das Steuerelement gesendet werden konnte.</p> <h2 id="Remarks">Bemerkungen</h2> <p>Damit diese Funktion korrekt funktioniert, wird das Steuerelement außerdem fokussiert.</p> <p>Um die Zuverlässigkeit zu erhöhen, erfolgt jedes Mal, nachdem diese Funktion verwendet wurde, automatisch eine Verzögerung. Diese Verzögerung kann mit <a href="SetControlDelay.htm">SetControlDelay</a> oder durch Zuweisung eines Wertes an <a href="../Variables.htm#ControlDelay">A_ControlDelay</a> geändert werden. Weitere Informationen finden Sie unter <a href="SetControlDelay.htm#Remarks">SetControlDelay-Bemerkungen</a>.</p> <h2 id="Related">Siehe auch</h2> <p><a href="ControlGetChecked.htm">ControlGetChecked</a>, <a href="GuiControl.htm#Value">Value-Eigenschaft (GuiControl-Objekt)</a>, <a href="Control.htm">Control-Funktionen</a></p> </body> </html>