İçeriğe geç
Tüm araçlar

list_windows

Ekran, pencereler ve arayüz · macOS · Windows

Etki: okuma. Durum: koşullu kullanılabilir.

“Koşullu kullanılabilirlik”, aracın sürüme, platforma, izinlere, hesaba veya yapılandırmaya bağlı olabileceğini belirtir. Her kurulumda etkin olduğu anlamına gelmez.

macOS

Amaç

Herhangi bir uygulamanın ekrandaki pencerelerini window_id, sahibi uygulamanın paket kimliği ve adı, başlık, sınırlar (genel koordinat uzayı, sol üst başlangıç noktası, punto), display_id (CGDirectDisplayID; list_displays ile eşleşir ve pencerenin hangi ekranda olduğunu bulmanızı sağlar), layer (0 = normal uygulama penceresi; sıfır dışı = panel/katman/menü) ve is_focused ile listeler. Pencere BAŞLIKLARI Screen Recording izni gerektirir; izin yoksa başlıksız sonuç yerine açık bir permission_required hatası döner. İsteğe bağlı app_bundle_id filtresi vardır; Electron tarzı uygulamaların pencerelerinin sık sık farklı paket kimliğine sahip bir YARDIMCI süreçe ait olduğunu unutmayın, bu yüzden uygulama ekranda açıkça görünürken filtre boş dönebilir. on_screen_only VARSAYILAN OLARAK TRUE'DUR ve simge durumuna küçültülmüş, gizli ve diğer Space'lerdeki pencereleri dışarıda bırakır; görmek için false iletin. include_overlays VARSAYILAN OLARAK FALSE'TUR ve sıfır dışı layer değerli pencereleri (Notification Center, widget'lar, menüler) dışarıda bırakır; dahil etmek için true iletin; sonuçtaki layer ile bunları normal pencerelerden ayırt edebilirsiniz. include_minimized_state VARSAYILAN OLARAK FALSE'TUR (uygulama başına ek bir Accessibility sorgusudur, bu yüzden isteğe bağlıdır); her pencereye `minimized` (true/false) eklemek VE on_screen_only true iken (varsayılan) bu filtrenin normalde dışarıda bırakacağı simge durumundaki pencereleri de geri getirmek için true iletin; Accessibility izni OLMADAN `minimized` değeri `null` (bilinmiyor) olur ve simge durumundaki pencere eklenmez, asla tahmin edilen bir false verilmez; böylece simge durumundaki bir pencereyi önce öne getirmeden bulabilir veya yakalayabilirsiniz. Sonuç boş olduğunda araç, hangi filtrenin sonucu boşalttığını ve bunun yerine ne iletileceğini açıklayan bir `note` döndürür; uygulamanın penceresi olmadığı sonucuna varmadan önce onu okuyun. window_id, sonraki hedefleme için oturum boyunca sabittir.

Zorunlu girdiler

Bu platformun şeması zorunlu girdi bildirmiyor. İsteğe bağlı seçiciler veya çalışma zamanı gereksinimleri yine de olabilir.

İzinler ve onay

Şema açık bir onay parametresi bildirmez. Bu, izinsiz işlem yapma yetkisi vermez; etkiyi inceleyin ve yetki alın.

İngilizce kanonik teknik şema — 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"
}

Belge örneği

list_windows için örnek belge. Bu örneği çalıştırmayın. Gösterilen bağımsız değişkenler kurgusal bir veri kümesine aittir; gerçek bir çağrıdan önce gerçek tanıtıcıları bulun ve izin alın.

{}

Windows

Amaç

Bu makinedeki açık pencereleri listeler: pencere kimliği, sahibi uygulama (exe adı), pid, başlık, {x,y,w,h} sınırları ve ekran kimliği. Yalnızca Windows'ta çalışır (Win32 pencere API'sini kullanır). Uygulamaya göre filtrelemek için app_bundle_id kullanın (Windows'ta exe adında alt dize eşleşmesi). on_screen_only VARSAYILAN OLARAK TRUE'DUR ve simge durumuna küçültülmüş ve başlıksız pencereleri dışarıda bırakır (mac-swift'in list_windows davranışını yansıtır, #3634); görmek için false iletin. include_minimized_state VARSAYILAN OLARAK FALSE'TUR; her pencereye `minimized` (true/false) eklemek VE on_screen_only true iken (varsayılan) bu filtrenin normalde dışarıda bırakacağı simge durumundaki pencereleri de korumak için true iletin (#3663, mac-swift ile eşdeğerlik); Mac'in Accessibility'ye bağlı sorgusunun aksine IsIconic Windows'ta izin gerektirmez, bu yüzden `minimized` her zaman çözümlenir ve burada asla null/bilinmiyor olmaz.

Zorunlu girdiler

Bu platformun şeması zorunlu girdi bildirmiyor. İsteğe bağlı seçiciler veya çalışma zamanı gereksinimleri yine de olabilir.

İzinler ve onay

Şema açık bir onay parametresi bildirmez. Bu, izinsiz işlem yapma yetkisi vermez; etkiyi inceleyin ve yetki alın.

İngilizce kanonik teknik şema — 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"
}

Belge örneği

list_windows için örnek belge. Bu örneği çalıştırmayın. Gösterilen bağımsız değişkenler kurgusal bir veri kümesine aittir; gerçek bir çağrıdan önce gerçek tanıtıcıları bulun ve izin alın.

{}