すべてのツール

list_windows

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

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

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

macOS

目的

任意のアプリの画面上のウィンドウを、window_id、所有アプリの bundle id と名前、タイトル、境界（グローバル空間、左上原点、ポイント単位）、display_id（CGDirectDisplayID。list_displays と一致するため、ウィンドウがどのディスプレイにあるか調べられます）、is_focused とともに一覧表示します。ウィンドウのタイトルには画面収録権限が必要です。権限がない場合、タイトルなしの結果ではなく明示的な permission_required エラーを返します。任意で app_bundle_id による絞り込みが可能ですが、Electron 系アプリでは別の bundle id を持つ HELPER プロセスがウィンドウを所有することが多く、画面上に見えていても結果が空になる場合があります。on_screen_only の既定値は TRUE で、最小化、非表示、別 Space のウィンドウを除外します。それらも表示するには false を渡します。結果が空の場合、このツールはどのフィルターが原因かと代わりに何を渡すべきかを説明する `note` を返します。アプリにウィンドウがないと判断する前に読んでください。window_id は後で対象指定できるよう、セッション中は安定しています。

必須入力

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

権限と確認

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

英語の正規技術スキーマ — macOS
{
  "properties": {
    "app_bundle_id": {
      "description": "Only return windows owned by this app bundle id.",
      "type": "string"
    },
    "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 名の部分一致）。

必須入力

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

権限と確認

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

英語の正規技術スキーマ — 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"
    },
    "on_screen_only": {
      "description": "Only return visible, non-empty-title windows (default true).",
      "type": "boolean"
    }
  },
  "required": [],
  "type": "object"
}

ドキュメント例

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

{}