</head> <body> <h1>WinGetClientPos</h1> <p>指定されたウィンドウのクライアント領域の位置と大きさを取得します。</p> <pre class="Syntax"><span class="func">WinGetClientPos</span> <span class="optional">&amp;OutX, &amp;OutY, &amp;OutWidth, &amp;OutHeight, WinTitle, WinText, ExcludeTitle, ExcludeText</span></pre> <h2 id="Parameters">パラメータ</h2> <dl> <dt>&amp;OutX, &amp;OutY</dt> <dd> <p>型:<a href="../Concepts.htm#variable-references">VarRef</a></p> <p>省略したときは、対応する値は保存されません。そうでないときは、クライアント領域の左上隅のX座標とY座標を格納する出力変数への参照を指定します。</p> </dd> <dt>&amp;OutWidth, &amp;OutHeight</dt> <dd> <p>型:<a href="../Concepts.htm#variable-references">VarRef</a></p> <p>省略したときは、対応する値は保存されません。そうでないときは、クライアント領域の幅と高さを格納する出力変数への参照を指定します。</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> <h2 id="Remarks">備考</h2> <p>クライアント領域はウィンドウの一部で、コントロールを含むことができます。ウィンドウのタイトルバー、メニュー(標準のものがある場合)、ボーダーは除外されます。クライアント領域の位置とサイズは、<a href="WinGetPos.htm">WinGetPos</a>が返す値よりもOSのバージョンやテーマに依存しません。</p> <p><em>WinTitle</em>が<code>"Program Manager"</code> のときは、この関数はデスクトップのサイズを取得します。通常、これは現在の画面解像度と同じです。</p> <p>最小化されたウィンドウは、位置とサイズを保持しています。この場合に返す値はOSや設定によりますが、通常はXとY座標が-32000、幅と高さが0です。</p> <p>マウスが現在カーソルを置いているウィンドウとコントロールの名前を知るには、<a href="MouseGetPos.htm">MouseGetPos</a>を使います。</p> <p>DPI設定が異なる複数のスクリーンを持つシステムでは、<a href="../misc/DPIScaling.htm">OSのDPIスケーリング</a>により、返される位置やサイズが予想と異なる場合があります。</p> <h2 id="Related">関連</h2> <p><a href="WinGetPos.htm">WinGetPos</a>、<a href="WinMove.htm">WinMove</a>、<a href="ControlGetPos.htm">ControlGetPos</a>、<a href="WinGetTitle.htm">WinGetTitle</a>、<a href="WinGetText.htm">WinGetText</a>、<a href="ControlGetText.htm">ControlGetText</a></p> <h2 id="Examples">例</h2> <div class="ex" id="ExBasic"> <p><a class="ex_number" href="#ExBasic"></a> 電卓のクライアント領域の位置とサイズを取得して報告します。</p> <pre>WinGetClientPos &amp;X, &amp;Y, &amp;W, &amp;H, "Calculator" MsgBox "Calculator's client area is at " X "," Y " and its size is " W "x" H</pre> </div> <div class="ex" id="ExA"> <p><a class="ex_number" href="#ExA"></a> アクティブウィンドウのクライアント領域の位置を取得して報告します。</p> <pre>WinGetClientPos &amp;X, &amp;Y,,, "A" MsgBox "The active window's client area is at " X "," Y</pre> </div> <div class="ex" id="ExLastFound"> <p><a class="ex_number" href="#ExLastFound"></a> メモ帳が存在するときは、そのクライアント領域の位置を取得して報告します。</p> <pre>if WinExist("Untitled - Notepad") { WinGetClientPos &amp;Xpos, &amp;Ypos <em>; WinExist関数で見つかったウィンドウを使用します。</em> MsgBox "Notepad's client area is at " Xpos "," Ypos }</pre> </div> </body> </html>