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

ui_click

Ekran, pencereler ve arayüz · macOS · Windows

Etki: çalıştırma. 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ç

Bir öğeye (element_ref ile, merkezinden) veya bir ekran koordinatına (coords ile) tıklar. button left|right, count 2 = çift tıklama. {clicked, at:{x,y}} döndürür; `clicked`, tıklama olayının bu koordinatlara GÖNDERİLDİĞİ anlamına gelir, uygulamanın buna tepki verdiği anlamına GELMEZ: CGEvent teslim onayı taşımaz, bu yüzden meşgul, kipli (modal) veya girdiyi yok sayan bir uygulama da tamamen aynı başarıyı bildirir. Etkiyi `clicked` değerine güvenmek yerine ui_wait_for_element veya ui_read_tree ile doğrulayın. element_disabled yalnızca uygulama gerçekten AXEnabled=false yayımladığında döndürülür; AXEnabled'ı hiç yayımlamayan bir denetim bilinmeyen sayılır ve tıklanır. Konum yayımlamayan bir öğeden (web sayfalarındaki bazı denetimler) görünür alana kaydırması istenir; yine konumu yoksa erişilebilirlik basma eylemiyle tek bir sol tıklama yapılır ve yanıt `at` olmadan {clicked, via:"press_action"} olur; bu da reddedilirse hata no_bounds olur; bir ekran görüntüsünden coords kullanın. Erişilebilirlik izni gerekir.

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": {
    "button": {
      "description": "Default left.",
      "enum": [
        "left",
        "right"
      ],
      "type": "string"
    },
    "by": {
      "description": "Default element if element_ref given, else coords.",
      "enum": [
        "element",
        "coords"
      ],
      "type": "string"
    },
    "coords": {
      "description": "{x,y} in global screen points.",
      "type": "object"
    },
    "count": {
      "description": "1 (default) or 2 for double-click.",
      "type": "integer"
    },
    "element_ref": {
      "description": "Element handle returned by ui_find_element or ui_read_tree; the click lands at that element's center. Needed when by=element, which is the default whenever element_ref is present.",
      "type": "string"
    }
  },
  "required": [],
  "type": "object"
}

Belge örneği

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

{
  "coords": {
    "x": 100,
    "y": 100
  }
}

Windows

Amaç

Bir öğeye (element_ref ile, merkezine) veya ekran koordinatına (coords ile) tıklar. button left|right, count 2 = çift tıklama. {clicked, at:{x,y}} döndürür; `clicked`, tıklamanın bu koordinatlarda GÖNDERİLDİĞİ anlamına gelir, uygulamanın buna tepki verdiği anlamına GELMEZ: SendInput teslimat doğrulaması taşımaz, dolayısıyla meşgul veya modal bir uygulama aynı başarıyı bildirir. `clicked` değerine güvenmek yerine etkiyi ui_wait_for_element veya ui_read_tree ile doğrulayın.

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": {
    "button": {
      "description": "Default left.",
      "enum": [
        "left",
        "right"
      ],
      "type": "string"
    },
    "coords": {
      "description": "{x,y} in global screen pixels.",
      "type": "object"
    },
    "count": {
      "description": "1 (default) or 2 for double-click.",
      "type": "integer"
    },
    "element_ref": {
      "description": "Element handle returned by ui_find_element or ui_read_tree; the click lands at that element's center. Pass this or coords — a non-empty element_ref wins, and coords is only read when it is absent.",
      "type": "string"
    }
  },
  "required": [],
  "type": "object"
}

Belge örneği

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

{
  "coords": {
    "x": 100,
    "y": 100
  }
}