Ξ
Δ
◄
►
¬
Ѕ
Filter
Direktiven
Interne Variablen
Interne Funktionen
Kontrollanweisungen
Operatoren
Deklarationen
Interne Klassen
Interne Methoden/Eigenschaften
Ahk2Exe-Compiler
Suchwörter hervorheben
<script src="../static/ga4.js" type="text/javascript"></script> </head> <body> <h1>ToolTip</h1> <p>Zeigt ein Immer-Im-Vordergrund-Fenster an beliebiger Stelle auf dem Bildschirm an.</p> <pre class="Syntax"><span class="func">ToolTip</span> <span class="optional">Text, X, Y, WelcherToolTip</span></pre> <h2 id="Parameters">Parameter</h2> <dl> <dt>Text</dt> <dd> <p>Typ: <a href="../Concepts.htm#strings">Zeichenkette</a></p> <p>Wenn leer oder weggelassen, wird der Tooltip (falls vorhanden) versteckt. Andernfalls geben Sie eine Zeichenkette an, die im Tooltip angezeigt werden soll. Um einen Tooltip mehrzeilig zu machen, trennen Sie jede Zeile mit einem Zeilenvorschubzeichen (`n), z.B. <code>"Zeile1`nZeile2"</code>.</p> <p>Wenn <em>Text</em> relativ lang ist, kann es via <a href="../Scripts.htm#continuation">Fortsetzungsbereich</a> in mehrere kurze Zeilen aufgeteilt werden, um die Übersichtlichkeit und Wartbarkeit des Skripts zu verbessern.</p> </dd> <dt>X, Y</dt> <dd> <p>Typ: <a href="../Concepts.htm#numbers">Integer</a></p> <p>Wenn weggelassen, wird der Tooltip in der Nähe des Mauszeigers angezeigt. Andernfalls geben Sie die X- und Y-Koordinate der oberen linken Ecke des Tooltips relativ zum Clientbereich des aktiven Fensters an (mit <code><a href="CoordMode.htm">CoordMode</a> "ToolTip"</code> können die Koordinaten relativ zum Bildschirm gemacht werden).</p> </dd> <dt>WelcherToolTip</dt> <dd> <p>Typ: <a href="../Concepts.htm#numbers">Integer</a></p> <p>Wenn weggelassen, wird standardmäßig 1 verwendet (der erste Tooltip). Andernfalls geben Sie eine Nummer zwischen 1 und 20 an, um zu bestimmen, mit welchem Tooltip gearbeitet werden soll, wenn mehrere Tooltips gleichzeitig verwendet werden.</p> </dd> </dl> <h2 id="Return_Value">Rückgabewert</h2> <p>Typ: <a href="../Concepts.htm#numbers">Integer</a></p> <p>Wenn ein Tooltip angezeigt oder aktualisiert wird, gibt diese Funktion die <a href="../misc/WinTitle.htm#ahk_id">HWND-Nummer (eindeutige ID)</a> des Tooltip-Fensters zurück. Diese Nummer kann verwendet werden, um den Tooltip zu verschieben oder <a href="https://learn.microsoft.com/windows/win32/controls/bumper-tooltip-control-reference-messages">Tooltip-Steuerelementmeldungen</a> zu senden.</p> <p>Wenn <em>Text</em> leer ist oder weggelassen wird, wird 0 zurückgegeben.</p> <h2 id="Remarks">Bemerkungen</h2> <p>Ein typischer Tooltip sieht wie folgt aus: <img src="../static/dlg_tooltip.png" alt="ToolTip" style="vertical-align: middle" /></p> <p>Wenn die angegebene X- und Y-Koordinate dazu führen, dass der Tooltip außerhalb des Bildschirms oder unter Windows 8 oder höher außerhalb des <a href="MonitorGetWorkArea.htm">Arbeitsbereichs des Bildschirms</a> liegt, wird der Tooltip neu positioniert, um vollständig sichtbar zu bleiben.</p> <p>Der Tooltip wird solange angezeigt, bis eine der folgenden Bedingungen erfüllt ist:</p> <ul> <li>Das Skript wird terminiert.</li> <li>Die ToolTip-Funktion wird mit leerem <em>Text</em>-Parameter erneut ausgeführt.</li> <li>Der Benutzer hat den Tooltip angeklickt (dieses Verhalten variiert je nach Betriebssystem).</li> </ul> <p>Mit Mitteln wie der <a href="Gui.htm#OwnDialogs">OwnDialogs</a>-Option kann ein Tooltip einem GUI-Fenster untergeordnet werden. Tooltips dieser Art werden automatisch zerstört, sobald ihr übergeordnetes Fenster zerstört wird.</p> <h2 id="Related">Siehe auch</h2> <p><a href="CoordMode.htm">CoordMode</a>, <a href="TrayTip.htm">TrayTip</a>, <a href="Gui.htm">GUI</a>, <a href="MsgBox.htm">MsgBox</a>, <a href="InputBox.htm">InputBox</a>, <a href="FileSelect.htm">FileSelect</a>, <a href="DirSelect.htm">DirSelect</a></p> <h2 id="Examples">Beispiele</h2> <div class="ex" id="ExBasic"> <p><a class="ex_number" href="#ExBasic"></a> Zeigt einen mehrzeiligen Tooltip an einer bestimmten Position im aktiven Fenster an.</p> <pre>ToolTip "Mehrzeiliger`nTooltip", 100, 150</pre> </div> <div class="ex" id="ExAutoHide"> <p><a class="ex_number" href="#ExAutoHide"></a> Versteckt einen Tooltip nach einer gewissen Zeit, ohne Sleep verwenden zu müssen (was den aktuellen Thread anhalten würde).</p> <pre>ToolTip "Zeitgesteuerter Tooltip`nDies wird 5 Sekunden lang angezeigt." SetTimer () => ToolTip(), -5000</pre> </div> </body> </html>