</head> <body> <h1>WinSetTitle</h1> <p>指定したウィンドウのタイトルを変更します。</p> <pre class="Syntax"><span class="func">WinSetTitle</span> NewTitle <span class="optional">, WinTitle, WinText, ExcludeTitle, ExcludeText</span></pre> <h2 id="Parameters">パラメータ</h2> <dl> <dt>NewTitle</dt> <dd> <p>型:<a href="../Concepts.htm#strings">文字列</a></p> <p>ウィンドウの新しいタイトル。パラメータがこれだけのときは、<a href="../misc/WinTitle.htm#LastFoundWindow">Last Found Window</a>が使用されます。</p> </dd> <dt>WinTitle, WinText, ExcludeTitle, ExcludeText</dt> <dd> <p>型:<a href="../Concepts.htm#strings">文字列</a>、<a href="../Concepts.htm#numbers">整数</a>または<a href="../Concepts.htm#objects">オブジェクト</a></p> <p>もしこれらの項目が未設定または省略されたときは、<a href="../misc/WinTitle.htm#LastFoundWindow">最後に見つかったウィンドウ</a>が使用されます。そうでないときは、<em>WinTitle</em>に <a href="../misc/WinTitle.htm">ウィンドウタイトルまたはターゲットウィンドウを識別するための他の基準</a>、および/または<em>WinText</em>にターゲットウィンドウの単一のテキスト要素からの部分文字列(付属のWindow Spyユーティリティを使えばわかります)を指定します。</p> <p><em>ExcludeTitle</em>と<em>ExcludeText</em>はウィンドウのタイトルまたはテキストで除外するために使用します。指定の仕方は<em>WinTitle</em>と<em>WinText</em>に似ていますが、<em>ExcludeTitle</em>はウィンドウのタイトル以外の基準(ウィンドウクラスやHWNDなど)を認識しません。</p> <p>ウィンドウのタイトルとテキストは大文字と小文字を区別します。<a href="DetectHiddenWindows.htm">DetectHiddenWindows</a>関数 と <a href="DetectHiddenText.htm">DetectHiddenText</a>関数で変更しない限り、初期設定では非表示ウィンドウは検出されず、非表示テキストは検出されます。<a href="SetTitleMatchMode.htm">SetTitleMatchMode</a>関数で変更しない限り、初期設定ではウィンドウのタイトルはその中のどこかに<em>WinTitle</em>または<em>ExcludeTitle</em>を含んでいれば一致します。</p> </dd> </dl> <h2 id="Error_Handling">エラー処理</h2> <p>ウィンドウが見つからないときは、<a href="Error.htm#TargetError">TargetError</a>がスローされます。</p> <p>変更が適用できなかったときは<a href="Error.htm#OSError">OSError</a>がスローされます。</p> <h2 id="Remarks">備考</h2> <p>ウィンドウを所有するアプリケーションが頻繁にタイトルを変更する場合、ウィンドウのタイトルの変更は一時的なものに過ぎないかもしれない。</p> <h2 id="Related">関連</h2> <p><a href="WinMove.htm">WinMove</a>、<a href="WinGetTitle.htm">WinGetTitle</a>、<a href="WinGetText.htm">WinGetText</a>、<a href="ControlGetText.htm">ControlGetText</a>、<a href="WinGetPos.htm">WinGetPos</a>、<a href="Win.htm">Win関数</a></p> <h2 id="Examples">例</h2> <div class="ex" id="ExBasic"> <p><a class="ex_number" href="#ExBasic"></a> メモ帳のタイトルを変更します。この例は、Windows 11以降では、クラシック版のメモ帳を必要とするため、失敗する可能性があります。</p> <pre>WinSetTitle("This is a new title", "Untitled - Notepad")</pre> </div> <div class="ex" id="ExLastFound"> <p><a class="ex_number" href="#ExLastFound"></a> メモ帳を開き、アクティブになるまで待ち、タイトルを変更する。この例は、Windows 11以降では、クラシック版のメモ帳を必要とするため、失敗する可能性があります。</p> <pre>Run "notepad.exe" WinWaitActive "Untitled - Notepad" WinSetTitle "This is a new title" <em>; WinWaitActive関数で見つかったウィンドウが対象です。</em></pre> </div> <div class="ex" id="ExMainWin"> <p><a class="ex_number" href="#ExMainWin"></a> <a href="../Program.htm#main-window">メイン・ウィンドウ</a>を開き、アクティブになるまで待ち、タイトルを変更する。</p> <pre>ListVars WinWaitActive "ahk_class AutoHotkey" WinSetTitle "This is a new title" <em>; WinWaitActive関数で見つかったウィンドウが対象です。</em></pre> </div> </body> </html>