모든 도구

ui_keystroke

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

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

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

macOS

목적

키 조합을 보냅니다(예: "cmd+shift+5", "return", "cmd+,", "escape"). 수정 키는 cmd, shift, alt/option, ctrl, fn이며 마지막 토큰이 키입니다. {sent, delivery:"posted_not_confirmed"}를 반환합니다. `sent`는 키 이벤트가 게시되었다는 뜻이지 앱이 처리했다는 뜻이 아닙니다. CGEvent에는 전달 확인이 없고 키 입력 효과는 임의이므로 읽어 확인할 수 없습니다. `sent`를 믿지 말고 ui_get_element / ui_read_tree로 효과를 확인하세요. 조합 후 수정 키가 해제되어 다음 ui_type이 영향을 받지 않습니다. 키를 인식하지 못하면 unknown_key입니다. 손쉬운 사용 권한이 필요합니다.

필수 입력

입력 이름은 도구가 요구하는 정확한 형태로 유지됩니다. 영문 정식 기술 정의는 아래 펼칠 수 있는 스키마에 있습니다.

권한 및 확인

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

영문 정식 기술 스키마 — macOS
{
  "properties": {
    "keys": {
      "description": "e.g. cmd+shift+5, return, cmd+,",
      "type": "string"
    }
  },
  "required": [
    "keys"
  ],
  "type": "object"
}

문서 예시

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

{
  "keys": "escape"
}

Windows

목적

포커스된 앱에 키 조합을 보냅니다(예: "ctrl+s", "ctrl+shift+n", "return", "alt+f4", "escape"). 수정 키는 ctrl, shift, alt, win이며 cmd는 ctrl의 별칭으로 허용됩니다. 마지막 토큰이 키입니다. 키를 인식하지 못하면 unknown_key입니다.

필수 입력

입력 이름은 도구가 요구하는 정확한 형태로 유지됩니다. 영문 정식 기술 정의는 아래 펼칠 수 있는 스키마에 있습니다.

권한 및 확인

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

영문 정식 기술 스키마 — Windows
{
  "properties": {
    "keys": {
      "description": "e.g. ctrl+s, return, ctrl+shift+n",
      "type": "string"
    }
  },
  "required": [
    "keys"
  ],
  "type": "object"
}

문서 예시

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

{
  "keys": "escape"
}