<script type="text/javascript">$(function(){0<=window.navigator.userAgent.toLowerCase().indexOf("ucbrowser")&&CaoNiMaDeUc()})</script> </head> <body> <h1>WinGetList</h1> <p>返回与指定条件匹配的所有现有窗口的唯一 ID 号.</p> <pre class="Syntax">List := <span class="func">WinGetList</span>(<span class="optional">WinTitle, WinText, ExcludeTitle, ExcludeText</span>)</pre> <h2 id="Parameters">参数</h2> <dl> <dt>WinTitle</dt> <dd> <p>类型: <a href="../Concepts.htm#strings">字符串</a>, <a href="../Concepts.htm#numbers">整数</a>或<a href="../Objects.htm">对象</a></p> <p>识别目标窗口的窗口标题或其他条件. 请参阅 <a href="../misc/WinTitle.htm">WinTitle</a>.</p> </dd> <dt>WinText</dt> <dd> <p>类型: <a href="../Concepts.htm#strings">字符串</a></p> <p>如果存在, 此参数必须是目标窗口的单个文本元素的子字符串(和内置的 Window Spy 工具显示的一样). 如果 <a href="DetectHiddenText.htm">DetectHiddenText</a> 为 ON, 那么会检测隐藏文本元素.</p> </dd> <dt>ExcludeTitle</dt> <dd> <p>类型: <a href="../Concepts.htm#strings">字符串</a></p> <p>标题中含有此参数值的窗口将被排除.</p> </dd> <dt>ExcludeText</dt> <dd> <p>类型: <a href="../Concepts.htm#strings">字符串</a></p> <p>文本中含有此参数值的窗口将被排除.</p> </dd> </dl> <h2 id="Return_Value">返回值</h2> <p>类型: <a href="../Concepts.htm#objects">数组</a></p> <p>此函数返回一个数组, 其中包含了与指定参数匹配的所有现有窗口的 <a href="../misc/WinTitle.htm#ahk_id">窗口句柄(HWND)</a>. 如果没有匹配的窗口, 则返回一个空数组.</p> <p>例如, 如果将返回值赋值给名为 <code>List</code> 的变量, 并且发现了两个匹配的窗口, 则 <code>List[1]</code> 包含第一个窗口的 ID, <code>List[2]</code> 包含第二个窗口的 ID, 而 <code>List.<a href="../objects/Array.htm#Length">Length</a></code> 返回数字 2.</p> <p>Windows 将按从顶部到底部的顺序检索(根据它们在桌面上的堆叠方式).</p> <h2 id="Remarks">备注</h2> <p>要获取整个系统的所有窗口, 省略所有的四个标题/文本参数.</p> <p>鼠标光标下的窗口的 ID 可以使用 <a href="MouseGetPos.htm">MouseGetPos</a> 来获取.</p> <p>窗口标题和文本是区分大小写的. 除非 <a href="DetectHiddenWindows.htm">DetectHiddenWindows</a> 被打开, 否则不会检测隐藏窗口.</p> <h2 id="Related">相关</h2> <p><a href="WinGetCount.htm">WinGetCount</a>, <a href="Win.htm">Win 函数</a>, <a href="Control.htm">Control 函数</a></p> <h2 id="Examples">示例</h2> <div class="ex" id="ExBasic"> <p><a class="ex_number" href="#ExBasic"></a> 访问整个系统中的所有窗口并显示它们的信息.</p> <pre>ids := WinGetList(,, "Program Manager") for this_id in ids { WinActivate this_id this_class := WinGetClass(this_id) this_title := WinGetTitle(this_id) Result := MsgBox( ( "Visiting All Windows " A_Index " of " ids.Length " ahk_id " this_id " ahk_class " this_class " " this_title " Continue?" ),, 4) if (Result = "No") break }</pre> </div> </body> </html>