Tüm araçlar

ui_find_element

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ç

GUI otomasyonu — yerel bir uygulamanın arayüzünü denetler. Bir uygulamanın erişilebilirlik ağacında role ve/veya label ile bir öğe (düğme, alan, menü…) bulur. app_bundle_id veya window_id ile kapsamı daraltın. Opak bir element_ref (bu oturumda ui_click / ui_get_element ile kullanılabilir) ile birlikte role, label, bounds, focused ve yalnızca uygulama AXEnabled yayımladığında `enabled` döndürür (aksi halde `enabled_unknown: true`; bu devre dışı anlamına GELMEZ). Uygulamaya erişilebildiği halde eşleşen öğe yoksa found=false olur; app_not_found açık bir hatadır. Accessibility izni gerektirir.

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": "Scope the search to this app.",
      "type": "string"
    },
    "index": {
      "description": "Which match to return if several (default 0).",
      "type": "integer"
    },
    "label": {
      "description": "AX title/description to match.",
      "type": "string"
    },
    "match": {
      "description": "Default contains.",
      "enum": [
        "exact",
        "contains"
      ],
      "type": "string"
    },
    "role": {
      "description": "AX role, e.g. AXButton, AXMenuItem, AXTextField.",
      "type": "string"
    },
    "window_id": {
      "description": "Alternatively scope by a window_id from list_windows.",
      "type": "string"
    }
  },
  "required": [],
  "type": "object"
}

Belge örneği

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

{
  "label": "Save"
}

Windows

Amaç

GUI otomasyonu — yerel bir Windows uygulamasının arayüzünü denetler. Bir uygulamanın UI Automation ağacında role ve/veya label ile bir öğe (düğme, alan, menü…) bulur. `app` ile kapsamı daraltın ("notepad" gibi işlem adı veya pencere başlığı alt dizesi). Opak bir element_ref (bu oturumda ui_click / ui_type / ui_get_element ile kullanılabilir) ile birlikte role, label, bounds, enabled ve focused döndürür. `role`, bir UIA denetim türüdür (Button, Edit, CheckBox, MenuItem, Hyperlink, Text…); kesin adları görmek için ui_read_tree çalıştırın. Uygulamaya erişilebildiği halde hiçbir şey eşleşmezse found=false olur; app_not_found açık bir hatadır.

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": "Scope to this app: process name (e.g. notepad) or a window-title substring.",
      "type": "string"
    },
    "index": {
      "description": "Which match to return if several (default 0).",
      "type": "integer"
    },
    "label": {
      "description": "Name/HelpText/Value to match.",
      "type": "string"
    },
    "match": {
      "description": "Default contains.",
      "enum": [
        "exact",
        "contains"
      ],
      "type": "string"
    },
    "role": {
      "description": "UIA control type, e.g. Button, Edit, MenuItem, CheckBox.",
      "type": "string"
    }
  },
  "required": [],
  "type": "object"
}

Belge örneği

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

{
  "label": "Save"
}