단계 매개 변수
단계를 선택하면 그 아래에 단계에 필요한 세부 항목마다 필드가 하나씩 열립니다. 각 필드에는 쉬운 말로 된 레이블이 있습니다. 필드를 가리키면 용도를 알려 주는 도구 설명이 표시됩니다.
필드 종류
| 필드 | 모양 | 받는 값 |
|---|---|---|
| 텍스트 | 텍스트 상자 | 모든 텍스트 |
| 정수 | 텍스트 상자 | 250이나 -3 같은 정수, 0xB3처럼 0x로 시작하는 16진수, 또는 VirtualKey.MediaPlayPause 같은 명명된 상수 |
| 숫자 | 텍스트 상자 | 지역 형식과 관계없이 마침표를 소수점으로 쓰는 숫자(예: 0.5) |
| 참 또는 거짓 | 스위치 | 켬(true) 또는 끔(false) |
| 이름 있는 값 중 선택 | 드롭다운 ② | MouseButton.Primary 같은 나열된 이름 중 하나. 직접 입력할 수도 있습니다 |
| 창 | 텍스트 상자 | 값 메뉴나 변수에서 가져온 창. 보통 대상 창 |
| 키(키 보내기) | 키 캡처 상자 | 누른 키 조합 |
모든 종류의 필드에 $와 변수 이름을 입력하여 이전 단계가 저장한 값을 사용할 수도 있습니다(변수).
단계 필드의 숫자는 지역 형식과 관계없이 항상 마침표를 소수점으로 사용하며, 천 단위 구분 기호를 쓰지 않습니다.
명명된 상수
정수 필드와 숫자 필드에는 명명된 상수도 넣을 수 있습니다. 네임스페이스, 점, 이름으로 이루어지며
(VirtualKey.MediaPlayPause, AudioEndpoint.Playback 등), 스크립트에서 쓰는 이름과 같습니다
(명명된 상수). 대문자를 그대로, 공백 없이 정확히 입력하십시오. 단계는 이름을
저장하며, 작업은 실행할 때 그 숫자를 사용합니다. 텍스트 필드는 그런 이름을 입력한 텍스트 그대로 유지합니다.
키 필드
키 보내기에는 텍스트 상자 대신 캡처 상자가 있습니다. 상자를 클릭한 다음(클릭하여 바로 가기 설정) 키 조합을
누릅니다. 조합만 기록되며, 설정하는 동안에는 아무것도 보내지 않습니다. 미디어 키처럼 키 조합으로 지정할 수 없는
키는 메시지와 함께 거부됩니다. 그런 키를 누르려면 VirtualKey.MediaPlayPause 같은 키 이름으로 키 눌렀다 떼기
단계(KeyboardPressKey)를 사용하십시오(실전 예제).
새 단계는 채워진 상태로 시작
새 단계의 창 필드는 대상 창으로 시작합니다. 제스처를 그린 위치의 창, 또는 단축키나 입력한 텍스트의 경우 포커스가 있는 창입니다. 스위치는 끔으로 시작합니다. 그 밖의 필드는 모두 비어 있으며 직접 채웁니다.
메뉴에서 값 선택
키 필드와 스위치를 제외한 모든 필드 끝에는 작은 화살표(값 선택)가 있습니다. 화살표를 누르면 필드에 맞는 값의 메뉴가 열립니다 ①. 이 메뉴는 단계 자체의 필드 외에도 조건의 값 및 비교 대상 필드와 단일 값 (조건), 반복의 횟수(단계 반복), 변수 설정 단계의 값 (변수)에 있습니다.
| 섹션 | 값 |
|---|---|
| 작업을 시작한 대상에서 | 대상 창, 대상 컨트롤, 제스처 이름, 작업 이름, 앱 그룹 이름, 제스처 단추, 그리고 제스처의 제스처 왼쪽 가장자리, 제스처 위쪽 가장자리, 제스처 너비, 제스처 높이 |
| 단계를 실행할 때 읽음 | 활성 창, 마우스 X 위치, 마우스 Y 위치, 클립보드 텍스트, 현재 날짜 및 시간 |
| 이전 단계에서 저장한 값 | 이 단계보다 위의 단계가 저장하는 변수 |
메뉴에는 필드 종류에 맞는 값만 나열됩니다. 숫자 필드는 정수도 받고, 무엇이든 받는 필드는 모든 값을 받습니다. 횟수에는 정수만 제공되며, 조건의 필드와 변수 설정 값에는 모든 읽기 값이 제공됩니다. 맞는 것이 없으면 메뉴에 이 필드에서 선택할 수 있는 항목이 없습니다 문구가 표시됩니다.
선택한 값은 텍스트 상자 자리에 이름이 있는 칩으로 표시됩니다. 칩을 가리키면 그것이 무엇이며 스크립트에서 어떻게 쓰는지 볼 수 있습니다. 칩의 지우기 단추는 필드를 비워 다시 입력할 수 있게 합니다.
작업을 시작한 대상에서 아래의 값은 트리거를 읽습니다. 단축키나 입력한 텍스트로 시작한 작업에서는 제스처 값이 비어 있거나 0입니다. 코드 조각은 어디서나 호출될 수 있으므로, 모든 값은 단계가 실행되는 모든 곳에서 제공됩니다.
스위치에서는 이전에 입력한 변수가 칩으로 표시되며, 칩을 지우면 스위치가 꺼집니다.
입력하는 동안의 검사
각 필드는 입력하는 동안 검사됩니다. 문제가 있으면 필드 아래에 빨간색으로 표시되고 필드 테두리가 빨간색이 됩니다.
| 메시지 | 의미 |
|---|---|
| 필수 값입니다. | 변수 설정 단계의 변수 이름이 비어 있습니다. |
| 정수(10진수 또는 0x 16진수), 명명된 상수 또는 $변수를 입력하십시오. | 정수 필드에 다른 것이 들어 있습니다. |
| 이 이름의 명명된 상수가 없습니다. VirtualKey.MediaPlayPause처럼 철자와 대소문자를 확인하십시오. | 정수 또는 숫자 필드에 명명된 상수가 아닌 네임스페이스, 점, 이름이 들어 있습니다. |
| 숫자나 $변수를 입력하십시오. | 숫자 필드에 다른 것이 들어 있습니다. |
| true 또는 false나 $변수를 입력하십시오. | 텍스트로 입력한 참 또는 거짓 필드에 다른 것이 들어 있습니다. |
| 단계에서는 인수 안에서 기본 제공 함수를 실행할 수 없습니다. 먼저 변수로 옮기십시오. | 필드에 괄호 안에 무언가가 있는 기본 제공 함수 호출이 들어 있습니다(아래). |
정수나 숫자 필드의 문자, 명명된 상수가 아닌 이름, 참 또는 거짓 필드의 true나 false 이외의 값처럼 필드에 검사를
통과하지 못한 텍스트가 들어 있는 동안에는 단계가 저장되지 않습니다. 작업은 마지막으로 저장된 단계를 유지하며, 필드를
고칠 때까지 목록 아래에 단계가 저장되지 않았습니다: 단계 N에 올바르지 않은 필드가 있습니다 문구가 표시됩니다
(문제).
빈 필드는 메시지를 표시하지 않으며 저장을 막지도 않습니다. 단계는 필드가 빈 채로 저장됩니다. 작업이 실행될 때 숫자, 참 또는 거짓, 창 필드가 비어 있는 단계는 그 자리에서 작업을 중지하며, 콘솔의 시스템 출력에 그 인수의 형식이 잘못되었다고 표시됩니다. 빈 텍스트 필드는 빈 텍스트로 실행되며, 일부 기본 제공 함수(파일 이름, 찾을 창 제목)에서는 단계가 아무것도 하지 않는다는 뜻입니다.
변수로 옮기기
필드에는 값, 변수, 또는 값 메뉴의 읽기 값 중 하나만 들어가며, 인수가 있는 기본 제공 함수 호출은 들어가지 않습니다.
WindowGetTitle($w)처럼 그런 호출을 입력하면 필드에 변수로 옮기기가 제공됩니다. 이를 선택하면 바로 위에 그
호출을 실행하고 필드에서 따온 이름(예: window, 그다음 window2)으로 결과를 저장하는 단계가 추가되고, 그 변수가
필드에 들어갑니다.
ClipboardGetText()처럼 괄호 안에 아무것도 없는 호출은 괜찮습니다. 값 메뉴에서 그 읽기 값을 선택하는 것과 같습니다.
조건의 필드, 횟수, 변수 설정 값을 포함해 값 메뉴가 있는 모든 필드에서 마찬가지입니다.
단계의 결과 보관
대부분의 기본 제공 함수는 읽은 텍스트, 찾은 창, 성공 여부 같은 결과를 냅니다. 결과 저장 이름 ③은 결과를 이름으로
보관하므로, 이후 단계에서 $이름으로 사용할 수 있습니다. 결과를 무시하려면 비워 두십시오.
결과를 보관하는 단계는 요약 끝에 "→ $이름"이 표시됩니다. 이름은 변수의 규칙을 따릅니다.
실행 시 잘못된 종류
편집기는 입력한 내용의 형태를 검사할 뿐, 기본 제공 함수의 모든 규칙을 검사하지는 않습니다. 작업이 실행될 때 잘못된 종류의 값(예: 기본 제공 함수에 정수가 필요한데 텍스트가 든 변수)이나 기본 제공 함수가 거부하는 값은 진단 콘솔에 오류를 남기고 작업을 중지합니다. 오류를 참조하십시오.