본문으로 건너뛰기
모든 도구

list_windows

화면, 윈도우 및 인터페이스 · macOS · Windows

효과: 읽기. 상태: 조건부 제공.

‘조건부 제공’은 도구가 버전, 플랫폼, 권한, 계정 또는 설정에 따라 달라질 수 있음을 뜻하며 모든 설치에서 활성화되었다는 의미는 아닙니다.

macOS

목적

모든 앱의 화면에 표시된 창을 window_id, 소유 앱 번들 ID와 이름, 제목, 경계(전역 공간, 좌측 상단, 포인트), display_id(CGDirectDisplayID로 list_displays와 일치하므로 창이 어느 디스플레이에 있는지 조회 가능), layer(0 = 일반 앱 창, 0이 아님 = 패널/오버레이/메뉴), is_focused와 함께 나열합니다. 창 제목을 보려면 화면 기록 권한이 필요합니다. 권한이 없으면 제목 없는 결과 대신 명시적인 permission_required 오류를 반환합니다. 선택적 app_bundle_id 필터를 사용할 수 있지만 Electron 계열 앱은 다른 번들 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

목적

이 머신에서 열린 창의 창 id, 소유 앱(exe 이름), pid, 제목, 경계 {x,y,w,h}와 디스플레이 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 문서 예시입니다. 이 예시를 실행하지 마세요. 표시된 인수는 가상 데이터 세트에 속합니다. 실제 호출 전에 실제 식별자를 확인하고 승인을 받으세요.

{}