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

ui_click

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

효과: 실행. 상태: 조건부 제공.

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

macOS

목적

요소(element_ref, 중앙 위치) 또는 화면 좌표(coords)를 클릭합니다. button은 left|right이며, count 2는 더블 클릭입니다. {clicked, at:{x,y}}를 반환합니다. `clicked`는 해당 좌표에 클릭 이벤트를 전송했다는 뜻일 뿐 앱이 실제로 반응했다는 뜻이 아닙니다. CGEvent에는 전달 확인 기능이 없어서 바쁘거나, 모달 상태이거나, 입력을 무시하는 앱도 똑같은 성공 응답을 보냅니다. `clicked`를 그대로 믿지 말고 ui_wait_for_element 또는 ui_read_tree로 결과를 확인하세요. element_disabled는 앱이 AXEnabled=false를 실제로 공개한 경우에만 반환되며, AXEnabled를 아예 공개하지 않는 컨트롤은 알 수 없음으로 간주하여 클릭합니다. 위치를 공개하지 않는 요소(웹 페이지 안의 일부 컨트롤)는 스크롤하여 보이게 하도록 요청하며, 그래도 위치가 없으면 접근성 press 동작으로 왼쪽 클릭을 한 번 수행하고 `at` 없이 {clicked, via:"press_action"}로 응답합니다. 그마저도 거부되면 no_bounds 오류가 발생하므로 스크린샷의 좌표를 사용하세요. 손쉬운 사용 권한이 필요합니다.

필수 입력

이 플랫폼의 스키마에는 필수 입력이 선언되어 있지 않습니다. 선택 항목이나 실행 요구 사항은 여전히 있을 수 있습니다.

권한 및 확인

스키마에 명시적 확인 매개변수가 없습니다. 이는 무단 작업을 허용하지 않습니다. 효과를 검토하고 승인을 받으세요.

영문 정식 기술 스키마 — 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"
}

문서 예시

ui_click 문서 예시입니다. 이 예시를 실행하지 마세요. 표시된 인수는 가상 데이터 세트에 속합니다. 실제 호출 전에 실제 식별자를 확인하고 승인을 받으세요.

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

Windows

목적

요소(element_ref의 중심) 또는 화면 좌표(coords)를 클릭합니다. button은 left|right이고 count 2는 더블 클릭입니다. {clicked, at:{x,y}}를 반환하며 `clicked`는 해당 좌표에 클릭이 게시되었다는 뜻이지 앱이 처리했다는 뜻이 아닙니다. SendInput에는 전달 확인이 없어 사용 중이거나 모달 상태인 앱도 같은 성공을 보고합니다. `clicked`를 믿지 말고 ui_wait_for_element 또는 ui_read_tree로 효과를 확인하세요.

필수 입력

이 플랫폼의 스키마에는 필수 입력이 선언되어 있지 않습니다. 선택 항목이나 실행 요구 사항은 여전히 있을 수 있습니다.

권한 및 확인

스키마에 명시적 확인 매개변수가 없습니다. 이는 무단 작업을 허용하지 않습니다. 효과를 검토하고 승인을 받으세요.

영문 정식 기술 스키마 — 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"
}

문서 예시

ui_click 문서 예시입니다. 이 예시를 실행하지 마세요. 표시된 인수는 가상 데이터 세트에 속합니다. 실제 호출 전에 실제 식별자를 확인하고 승인을 받으세요.

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