Ξ
Δ
◄
►
¬
Ѕ
フィルター
ディレクティブ
組み込みの変数
組み込み関数
制御フロー文
演算子
宣言
組み込みクラス
組み込みメソッド／プロパティ
Ahk2Exeコンパイラ
キーワードをハイライト
</head> <body> <h1>ToolTip</h1> <p>Shows an always-on-top window anywhere on the screen.</p> <pre class="Syntax"><span class="func">ToolTip</span> <span class="optional">Text, X, Y, WhichToolTip</span></pre> <h2 id="Parameters">パラメータ</h2> <dl> <dt>Text</dt> <dd> <p>型：<a href="../Concepts.htm#strings">文字列</a></p> <p>If blank or omitted, the existing tooltip (if any) will be hidden. それ以外の場合は、ツールチップに表示するテキストを指定する。複数行のツールチップを作成するには、各行の間に改行文字(`n)を使用します（例：<code>"Line1`nLine2"</code>）。</p> <p><em>Text</em>が長い場合、<a href="../Scripts.htm#continuation">継続セクション</a>によっていくつかの短い行に分割することができ、読みやすさと保守性を向上させることができるかもしれません。</p> </dd> <dt>X, Y</dt> <dd> <p>型：<a href="../Concepts.htm#numbers">整数</a></p> <p>If omitted, the tooltip will be shown near the mouse cursor. それ以外の場合は、アクティブ・ウィンドウのクライアント領域に対するツールチップのXとYの位置を指定する（スクリーン座標に変更するには<code><a href="CoordMode.htm">CoordMode</a> "ToolTip"</code>を使用する）。</p> </dd> <dt>WhichToolTip</dt> <dd> <p>型：<a href="../Concepts.htm#numbers">整数</a></p> <p>If omitted, it defaults to 1 (the first tooltip). そうでない場合は、複数のツールチップを同時に使用するときに、どのツールチップを操作するかを示すために、1から20までの数値を指定する。</p> </dd> </dl> <h2 id="Return_Value">戻り値</h2> <p>型：<a href="../Concepts.htm#numbers">整数</a></p> <p>ツールチップが表示または更新されている場合、この関数はツールチップウィンドウの<a href="../misc/WinTitle.htm#ahk_id">一意のID（HWND</a>）を返し、ツールチップを移動したり、<a href="https://learn.microsoft.com/windows/win32/controls/bumper-tooltip-control-reference-messages">ツールチップコントロールメッセージ</a>を送信したりするのに使用できる。</p> <p>If <em>Text</em> is blank or omitted, the return value is zero.</p> <h2 id="Remarks">備考</h2> <p>ツールチップは通常このように表示される： <img src="../static/dlg_tooltip.png" alt="ToolTip" style="vertical-align: middle" /></p> <p>X座標とY座標が原因でツールチップが画面の外に出ていた場合、またはWindows 8以降で<a href="MonitorGetWorkArea.htm">モニタの作業領域</a>の外に出ていた場合、ツールチップは完全に見えるように再配置されます。</p> <p>ツールチップは以下のいずれかが発生するまで表示される：</p> <ul> <li>スクリプトは終了する。</li> <li>ToolTip関数は、空白の<em>Text</em>パラメータで再度実行されます。</li> <li>ユーザーがツールチップをクリックする（この動作は、オペレーティングシステムのバージョンによって異なる場合があります）。</li> </ul> <p><a href="Gui.htm#OwnDialogs">OwnDialogsオプション</a>によって、GUIウィンドウをツールチップのオーナーにすることができる。このようなツールチップは、そのオーナーが破壊されると自動的に破壊される。</p> <h2 id="Related">関連</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">例</h2> <div class="ex" id="ExBasic"> <p><a class="ex_number" href="#ExBasic"></a> アクティブウィンドウの特定の位置に複数行のツールチップを表示する。</p> <pre>ToolTip "Multiline`nTooltip", 100, 150</pre> </div> <div class="ex" id="ExAutoHide"> <p><a class="ex_number" href="#ExAutoHide"></a> スリープ（現在のスレッドを停止させる）を使用せずに、一定時間後にツールチップを隠す。</p> <pre>ToolTip "Timed ToolTip`nThis will be displayed for 5 seconds." SetTimer () => ToolTip(), -5000</pre> </div> </body> </html>