Tüm araçlar

ui_read_tree

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ç

Çalışan yerel bir uygulamanın etiketli ve etkileşimli öğelerinden (düğmeler, bağlantılar, metin alanları, onay kutuları, menüler…) oluşan KOMPAKT bir erişilebilirlik ağacı döndürür; web_read aracının a11y modunun yerel karşılığıdır. Bir öğenin role/label değerini önceden bilmiyorsanız (ui_find_element bunu baştan ister) yabancı bir uygulamada neyle etkileşeceğinizi KEŞFETMEK için kullanın. Her etkileşimli düğüm, doğrudan ui_click aracına iletebileceğiniz bir `ref` taşır. Çalışan uygulamanın app_bundle_id değerini iletin (ör. com.apple.finder — list_windows bölümüne bakın); ağaç sinyal taşıyan düğümlere budanır ve max_depth (varsayılan 12) ile düğüm bütçesi tarafından sınırlandırılır, bu yüzden çok büyük pencereler kısmi döner. Uygulamanın macOS menü çubuğu varsayılan olarak atlanır (yüzlerce menü öğesi düğümüdür); özellikle menü çubuğu öğeleriyle etkileşmeniz gerekiyorsa include_menu_bar=true iletin.

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": "Bundle id of a RUNNING app (e.g. com.apple.finder)",
      "type": "string"
    },
    "include_menu_bar": {
      "description": "Include the app's macOS menu bar (hundreds of menu-item nodes). Default false.",
      "type": "boolean"
    },
    "max_depth": {
      "description": "Max tree depth to descend (default 12, max 20)",
      "type": "integer"
    },
    "window_id": {
      "description": "Alternative to app_bundle_id: a window id from list_windows (targets that window's app)",
      "type": "string"
    }
  },
  "required": [],
  "type": "object"
}

Belge örneği

ui_read_tree 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ç

Çalışan bir Windows uygulamasının etiketli ve etkileşimli öğelerinden (düğmeler, bağlantılar, düzenleme alanları, onay kutuları, menüler…) oluşan KOMPAKT bir UI Automation ağacı döndürür; web_read aracının a11y modunun yerel karşılığıdır. Bir öğenin role/label değerini önceden bilmiyorsanız (ui_find_element bunu baştan ister) yabancı bir uygulamada neyle etkileşeceğinizi KEŞFETMEK için kullanın. Her etkileşimli düğüm, doğrudan ui_click aracına iletebileceğiniz bir `ref` taşır. `app` değerini iletin (çalışan uygulamanın işlem adı, ör. notepad). Ağaç sinyal taşıyan düğümlere budanır ve max_depth (varsayılan 12) ile düğüm bütçesi tarafından sınırlandırılır, bu yüzden çok büyük pencereler kısmi döner.

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": {
      "description": "Process name of a RUNNING app (e.g. notepad).",
      "type": "string"
    },
    "max_depth": {
      "description": "Max tree depth to descend (default 12, max 20).",
      "type": "integer"
    }
  },
  "required": [],
  "type": "object"
}

Belge örneği

ui_read_tree 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.

{}