本文へスキップ
すべてのツール

list_windows

画面、ウインドウ、UI · macOS · Windows

効果: 読み取り. 状態: 条件付き提供.

「条件付き提供」は、バージョン、プラットフォーム、権限、アカウント、設定に依存する可能性を示し、すべての環境で有効という意味ではありません。

macOS

目的

任意のアプリの画面上のウィンドウを、window_id、所有アプリの bundle id と名前、タイトル、境界（グローバル空間、左上原点、ポイント単位）、display_id（CGDirectDisplayID。list_displays と一致するため、ウィンドウがどのディスプレイにあるか調べられます）、layer（0 = 通常のアプリウィンドウ、0 以外 = パネル/オーバーレイ/メニュー）、is_focused とともに一覧表示します。ウィンドウのタイトルには画面収録権限が必要です。権限がない場合、タイトルなしの結果ではなく明示的な permission_required エラーを返します。任意で app_bundle_id による絞り込みが可能ですが、Electron 系アプリでは別の bundle id を持つ HELPER プロセスがウィンドウを所有することが多く、画面上に見えていても結果が空になる場合があります。on_screen_only の既定値は TRUE で、最小化、非表示、別の Space にあるウィンドウは除外されます。false を渡すとそれらも表示されます。include_overlays の既定値は FALSE で、layer が 0 以外のウィンドウ（通知センター、ウィジェット、メニュー）を除外します。true を渡すと含まれ、結果の layer で通常のウィンドウと区別できます。include_minimized_state の既定値は FALSE です（アプリごとにアクセシビリティの追加照会が発生するため、オプトインです）。true を渡すと各ウィンドウに `minimized`（true/false）が追加され、on_screen_only が true（既定）のときは、そのフィルターが本来除外する最小化ウィンドウも戻されます。アクセシビリティが許可されていない場合、`minimized` は `null`（不明）で、最小化ウィンドウは戻されず、推測した false が返ることはありません。そのため、最小化されたウィンドウを前面に出さなくても見つけたりキャプチャしたりできます。結果が空のとき、このツールはどのフィルターで空になったか、代わりに何を渡すべきかを説明する `note` を返します。アプリにウィンドウがないと結論づける前に、それを読んでください。window_id はセッション内で安定しており、後からの指定に使えます。

必須入力

このプラットフォームのスキーマには必須入力が宣言されていません。任意の選択項目や実行要件が存在する場合があります。

権限と確認

スキーマには明示的な確認パラメータがありません。これは無許可の操作を認めるものではありません。効果を確認し、承認を得てください。

英語の正規技術スキーマ — macOS
{
  "properties": {
    "app_bundle_id": {
      "description": "Only return windows owned by this app bundle id.",
      "type": "string"
    },
    "include_minimized_state": {
      "description": "Add `minimized` (true/false) to each window via an Accessibility lookup; null without Accessibility granted (default false).",
      "type": "boolean"
    },
    "include_overlays": {
      "description": "Include non-zero-layer windows — Notification Center, desktop widgets, menus (default false).",
      "type": "boolean"
    },
    "on_screen_only": {
      "description": "Only on-screen windows (default true).",
      "type": "boolean"
    }
  },
  "required": [],
  "type": "object"
}

ドキュメント例

list_windows のドキュメント例です。この例は実行しないでください。表示される引数は架空のデータセットに属します。実際に呼び出す前に実在する識別子を確認し、承認を得てください。

{}

Windows

目的

このマシンで開いているウィンドウを、window id、所有アプリ（exe 名）、pid、タイトル、境界 {x,y,w,h}、display id とともに一覧表示します。Win32 ウィンドウ API を使う Windows 専用機能です。app_bundle_id でアプリを絞り込めます（Windows では exe 名の部分一致）。on_screen_only の既定値は TRUE で、最小化されたウィンドウとタイトルのないウィンドウは除外されます（mac-swift の list_windows と同じ、#3634）。false を渡すとそれらも表示されます。include_minimized_state の既定値は FALSE です。true を渡すと各ウィンドウに `minimized`（true/false）が追加され、on_screen_only が true（既定）のときは、そのフィルターが本来除外する最小化ウィンドウも残されます（mac-swift と同等、#3663）。Mac のアクセシビリティ依存の照会とは異なり、IsIconic は Windows では権限が不要なため、`minimized` は常に解決され、ここで null/不明になることはありません。

必須入力

このプラットフォームのスキーマには必須入力が宣言されていません。任意の選択項目や実行要件が存在する場合があります。

権限と確認

スキーマには明示的な確認パラメータがありません。これは無許可の操作を認めるものではありません。効果を確認し、承認を得てください。

英語の正規技術スキーマ — Windows
{
  "properties": {
    "app_bundle_id": {
      "description": "Filter to windows owned by this app. On Windows, a case-insensitive substring of the exe name (e.g. 'chrome').",
      "type": "string"
    },
    "include_minimized_state": {
      "description": "Add `minimized` (true/false) to each window, and keep minimized windows under on_screen_only:true instead of dropping them (default false).",
      "type": "boolean"
    },
    "on_screen_only": {
      "description": "Only return visible, non-minimized, non-empty-title windows (default true).",
      "type": "boolean"
    }
  },
  "required": [],
  "type": "object"
}

ドキュメント例

list_windows のドキュメント例です。この例は実行しないでください。表示される引数は架空のデータセットに属します。実際に呼び出す前に実在する識別子を確認し、承認を得てください。

{}