BlueZone 에뮬레이터 메서드
BlueZone 에뮬레이터 메서드를 사용하면 BlueZone 에뮬레이터에서 작업을 자동화할 수 있습니다. 예를 들어 에뮬레이터 화면에서 테이블 형식으로 텍스트를 캡처하고 Excel 시트에 텍스트를 삽입할 수 있습니다.
화면 수준 메서드
필드 텍스트 구하기(GetFieldText)
지정한 행과 열에서 텍스트를 반환합니다.
| 매개변수 | 설명 | 데이터 포트 항목 유형 | 데이터 유형 | 기본값 | 필수? | 메모 |
|---|---|---|---|---|---|---|
| 행 | 에뮬레이터 화면의 행 번호입니다. | 데이터 입력 | 정수 | 없음 | 예 | |
| 열 | 에뮬레이터 화면의 열 번호입니다. | 데이터 입력 | 정수 | 없음 | 예 | |
| 다시 이동 | 행과 열에서 텍스트를 반환합니다. | 데이터 출력 | 문자열 | 해당 사항 없음 | 해당 사항 없음 |
GetTextFromRect (사각형에서 텍스트 가져오기)
에뮬레이터 화면의 사각형 영역에 있는 지정된 범위의 행과 열에서 텍스트를 반환합니다. 이미지는 화면의 사각형 영역과 시작 및 종료 행과 열을 보여줍니다.
| 매개변수 | 설명 | 데이터 포트 항목 유형 | 데이터 유형 | 기본값 | 필수? | 메모 |
|---|---|---|---|---|---|---|
| 시작 행 | 사각형 영역의 시작 부분에 있는 행의 번호입니다. | 데이터 입력 | 정수 | 해당 사항 없음 | 예 | |
| StartCol | 사각형 영역의 시작 부분에 있는 열의 번호입니다. | 데이터 입력 | 정수 | 해당 사항 없음 | 예 | |
| EndRow (끝행) | 사각형 영역의 끝에 있는 행의 번호입니다. | 데이터 입력 | 정수 | 해당 사항 없음 | 예 | |
| EndCol | 사각형 영역의 끝에 있는 열의 번호입니다. | 데이터 입력 | 정수 | 해당 사항 없음 | 예 | |
| 다시 이동 | 텍스트를 반환합니다. | 데이터 출력 | 문자열 | 해당 사항 없음 | 해당 사항 없음 |
IsCreated입니다
에뮬레이터 화면이 활성 상태인지 확인합니다.
| 매개변수 | 설명 | 데이터 포트 항목 유형 | 데이터 유형 | 기본값 | 필수? | 메모 |
|---|---|---|---|---|---|---|
| 매치올칠드런 | 메서드가 자식 요소를 일치시켜 에뮬레이터 화면을 찾을 수 있도록 하는 매개변수입니다. | 데이터 입력 | 부울 | 아니오 | 예 |
경고:
이 옵션을 사용하면 메서드 실행이 지연될 수 있습니다. |
| 다시 이동 | 화면이 활성화된 메서드에 따라 부울 값을 반환합니다. | 데이터 출력 | 부울 | 해당 사항 없음 | 해당 사항 없음 |
SearchText
지정한 텍스트가 있는 열과 행을 반환합니다.
| 매개변수 | 설명 | 데이터 포트 항목 유형 | 데이터 유형 | 기본값 | 필수? | 메모 |
|---|---|---|---|---|---|---|
| 텍스트 | 메서드가 검색하는 텍스트입니다. | 데이터 입력 | 문자열 | 해당 사항 없음 | 예 | 지정하는 텍스트는 대/소문자를 구분합니다. |
| 행 | 지정된 텍스트가 있는 행 번호입니다. | 데이터 출력 | 정수 | 해당 사항 없음 | 해당 사항 없음 | 지정한 텍스트가 여러 행과 열에 있는 경우 메서드는 텍스트가 포함된 첫 번째 행과 열을 반환합니다. |
| Col | 지정된 텍스트가 있는 열 번호입니다. | 데이터 출력 | 정수 | 해당 사항 없음 | 해당 사항 없음 | 지정한 텍스트가 여러 행과 열에 있는 경우 메서드는 텍스트가 포함된 첫 번째 행과 열을 반환합니다. |
Sendkeys
에뮬레이터의 키보드에서 입력하는 키 입력을 삽입합니다.
주:
이 메서드를 사용하기 전에 SetCursorPosition 메서드를 사용합니다.
| 매개변수 | 설명 | 데이터 포트 항목 유형 | 데이터 유형 | 기본값 | 필수? | 메모 |
|---|---|---|---|---|---|---|
| 키 | 키보드에서 입력하는 키 입력입니다. | 데이터 입력 | 문자열 | 없음 | 예 |
SendKeysSecure (영문)
암호화된 키를 에뮬레이터 화면에서 지정한 커서 위치로 보냅니다.
주:
이 메서드를 사용하기 전에 SetCursorPosition 메서드를 사용합니다.
| 매개변수 | 설명 | 데이터 포트 항목 유형 | 데이터 유형 | 기본값 | 필수? | 메모 |
|---|---|---|---|---|---|---|
| 키 | 키보드에서 입력하는 키 입력입니다. | 데이터 입력 | 보안 문자열 | 없음 | 예 |
팁:
BlueZone 에뮬레이터의 키 입력에 대한 자세한 내용은 을 참조하십시오 https://www3.rocketsoftware.com/bluezone/help/v50/en/bz/DISPLAY/OPTIONS/MF/MF_Key_Mapping.htm. |
커서 위치 설정
에뮬레이터 화면에서 지정된 행과 열에 커서를 설정합니다.
| 매개변수 | 설명 | 데이터 포트 항목 유형 | 데이터 유형 | 기본값 | 필수? | 메모 |
|---|---|---|---|---|---|---|
| 행 | 메서드가 커서를 설정하는 행의 번호를 제공하는 옵션입니다. | 데이터 입력 | 정수 | 해당 사항 없음 | 해당 사항 없음 | |
| Col | 메서드가 커서를 설정하는 열의 번호를 제공하는 옵션입니다. | 데이터 입력 | 정수 | 해당 사항 없음 | 해당 사항 없음 |
필드 텍스트 설정
지정한 지정된 행과 열의 텍스트를 설정합니다.
| 매개변수 | 설명 | 데이터 포트 항목 유형 | 데이터 유형 | 기본값 | 필수? | 메모 |
|---|---|---|---|---|---|---|
| 행 | 텍스트를 설정하려는 행의 번호입니다. | 데이터 입력 | 정수 | 없음 | 예 | 이 메서드는 기존 텍스트(있는 경우)를 대체합니다. |
| 열 | 텍스트를 설정할 열의 번호입니다. | 데이터 입력 | 정수 | 없음 | 예 | 이 메서드는 기존 텍스트(있는 경우)를 대체합니다. |
작성 대기
에뮬레이터 화면을 사용할 수 있을 때까지 기다립니다.
| 매개변수 | 설명 | 데이터 포트 항목 유형 | 데이터 유형 | 기본값 | 필수? | 메모 |
|---|---|---|---|---|---|---|
| timeoutInSeconds (시간아웃인초) | 메서드 작업은 지정한 기간 후에 시간 초과됩니다. | 데이터 입력 | 정수 | 30초 | 예 | |
| 매치올칠드런 | 캡처한 화면의 요소(있는 경우)와 일치합니다. | 데이터 입력 | 부울 | 아니오 | 예 |
경고:
이 옵션을 사용하면 메서드 실행이 지연될 수 있습니다. |
| 다시 이동 | 에뮬레이터 화면을 사용할 수 있는지 여부를 나타내는 부울 값을 반환합니다. | 데이터 출력 | 부울 | 해당 사항 없음 | 해당 사항 없음 |
요소 수준 메서드
GetAs테이블
테이블 내에서 캡처한 요소의 텍스트를 반환합니다.
| 매개변수 | 설명 | 데이터 포트 항목 유형 | 데이터 유형 | 기본값 | 필수? | 메모 |
|---|---|---|---|---|---|---|
| 다시 이동 | 테이블 내 요소의 텍스트를 반환합니다. | 데이터 출력 | 데이터 테이블 | 해당 사항 없음 | 해당 사항 없음 |
Gettext
캡처한 요소의 텍스트를 반환합니다.
| 매개변수 | 설명 | 데이터 포트 항목 유형 | 데이터 유형 | 기본값 | 필수? | 메모 |
|---|---|---|---|---|---|---|
| 다시 이동 | 요소에 텍스트를 반환합니다. | 데이터 출력 | 문자열 | 해당 사항 없음 | 해당 사항 없음 |
IsCreated입니다
요소를 사용할 수 있는지 여부를 나타내는 부울 값을 반환합니다.
| 매개변수 | 설명 | 데이터 포트 항목 유형 | 데이터 유형 | 기본값 | 필수? | 메모 |
|---|---|---|---|---|---|---|
| 다시 이동 | 요소를 사용할 수 있는지 여부를 나타내는 부울 값을 반환합니다. | 데이터 출력 | 부울 | 해당 사항 없음 | 해당 사항 없음 |
Settext
요소에 지정하는 텍스트를 설정합니다.
| 매개변수 | 설명 | 데이터 포트 항목 유형 | 데이터 유형 | 기본값 | 필수? | 메모 |
|---|---|---|---|---|---|---|
| 텍스트 | 메서드가 요소로 설정하는 텍스트입니다. | 데이터 입력 | 문자열 | 없음 | 예 | 이 메서드는 기존 텍스트(있는 경우)를 대체합니다. |
작성 대기
요소를 사용할 수 있을 때까지 기다립니다.
| 매개변수 | 설명 | 데이터 포트 항목 유형 | 데이터 유형 | 기본값 | 필수? | 메모 |
|---|---|---|---|---|---|---|
| timeoutInSeconds (시간아웃인초) | 메서드 작업은 지정한 기간 후에 시간 초과됩니다. | 데이터 입력 | 정수 | 30초 | 예 | |
| 다시 이동 | 요소를 사용할 수 있는지 여부를 나타내는 부울 값을 반환합니다. | 데이터 출력 | 부울 | 해당 사항 없음 | 해당 사항 없음 |