IBM PCOMM 에뮬레이터 메소드

  • 릴리스 버전: Washingtondc
  • 업데이트 날짜 2024년 02월 01일
  • 읽기6분

    • IBM PCOMM 에뮬레이터 메서드를 사용하면 IBM PCOMM 에뮬레이터에서 작업을 자동화할 수 있습니다. 예를 들어 에뮬레이터 화면에서 테이블 형식으로 텍스트를 캡처하고 Excel 시트에 텍스트를 삽입할 수 있습니다.

    화면 수준 메서드

    필드 텍스트 구하기(GetFieldText)

    지정한 행과 열 번호에 따라 식별한 후 필드의 모든 텍스트를 반환합니다. 행과 열은 필드의 일부입니다. 이 그림에서는 문자 A의 행과 열 번호를 지정하지만 메서드는 필드의 일부이기 때문에 AMD64 텍스트를 반환합니다.

    화면의 필드입니다.

    표 1. GetFieldText 메서드 매개 변수
    매개변수 설명 데이터 포트 항목 유형 데이터 유형 기본값 필수? 메모
    행 메서드가 필드를 식별하는 기준이 되는 터미널 화면 필드의 행 번호입니다. 데이터 입력 정수 해당 사항 없음 예
    열 메서드가 필드를 식별하는 기준이 되는 터미널 화면 필드의 열 번호입니다. 데이터 입력 정수 해당 사항 없음 예
    다시 이동 필드에 전체 텍스트를 반환합니다. 데이터 출력 문자열. 해당 사항 없음 해당 사항 없음

    GetTextFromRect (사각형에서 텍스트 가져오기)

    화면의 가상 사각형 영역에서 텍스트를 반환합니다. 사각형 영역은 시작 및 끝 행과 열 번호를 제공하여 지정합니다. 이미지는 화면의 사각형 영역과 시작 및 끝 행과 열을 보여줍니다.

    화면의 사각형 영역입니다.

    표 2. GetTextFromRect 메서드 매개 변수
    매개변수 설명 데이터 포트 항목 유형 데이터 유형 기본값 필수? 메모
    시작 행 사각형 영역의 시작 부분에 있는 행 번호입니다. 데이터 입력 정수 해당 사항 없음 예
    StartCol 사각형 영역의 시작 부분에 있는 열 번호입니다. 데이터 입력 정수 해당 사항 없음 예
    EndRow (끝행) 사각형 영역의 끝에 있는 행 번호입니다. 데이터 입력 정수 해당 사항 없음 예
    EndCol 사각형 영역의 끝에 있는 열 번호입니다. 데이터 입력 정수 해당 사항 없음 예
    다시 이동 가상 사각형 영역에서 모든 텍스트를 반환합니다. 데이터 출력 문자열 해당 사항 없음 해당 사항 없음

    IsCreated입니다

    에뮬레이터 화면이 활성 상태인지 확인합니다.
    표 3. IsCreated 메서드 매개 변수
    매개변수 설명 데이터 포트 항목 유형 데이터 유형 기본값 필수? 메모
    매치올칠드런 자식 요소를 일치시켜 에뮬레이터 화면을 찾을 수 있도록 메서드를 활성화하는 옵션입니다. 데이터 입력 부울 아니오 예
    경고:
    이 옵션을 사용하면 메서드 속도가 느려질 수 있습니다.
    다시 이동 에뮬레이터 화면이 활성 상태인지 여부에 따라 부울 값을 반환합니다. 데이터 출력 부울 해당 사항 없음 해당 사항 없음

    SearchText

    지정한 텍스트의 첫 번째 문자를 포함하는 행과 열의 번호를 반환합니다. 예를 들어, 문자열 에뮬레이터를 지정하는 경우 메서드는 문자 e의 행 번호와 열 번호를 반환합니다
    주:
    여러 필드에 걸쳐 있는 텍스트를 제공하는 경우 메서드가 단일 필드의 텍스트만 지원하기 때문에 Row 및 Col 포트는 0을 반환합니다.
    표 4. SearchText 메서드 매개 변수
    매개변수 설명 데이터 포트 항목 유형 데이터 유형 기본값 필수? 메모
    텍스트 메서드가 검색하는 텍스트입니다. 데이터 입력 문자열 해당 사항 없음 예 지정하는 텍스트는 대/소문자를 구분합니다.
    행 지정한 텍스트의 첫 번째 문자가 있는 행의 번호입니다. 데이터 출력 정수 해당 사항 없음 해당 사항 없음 지정한 텍스트가 여러 행과 열에 있는 경우 메서드는 텍스트가 포함된 첫 번째 행과 열을 반환합니다.
    Col 지정한 텍스트의 첫 번째 문자가 있는 열의 번호입니다. 데이터 출력 정수 해당 사항 없음 해당 사항 없음 지정한 텍스트가 여러 행과 열에 있는 경우 메서드는 텍스트가 포함된 첫 번째 행과 열을 반환합니다.

    Sendkeys

    키보드에서 입력하는 에뮬레이터 화면의 마우스 장치 위치에서 키 입력을 시뮬레이션합니다. 예를 들어 화면에서 Enter 키 입력을 시뮬레이션할 수 있습니다.

    주:
    이 메서드를 사용하기 전에 SetCursorPosition 메서드를 사용합니다.
    표 5. SendKeys 메서드 매개 변수
    매개변수 설명 데이터 포트 항목 유형 데이터 유형 기본값 필수? 메모
    키 키보드에서 입력하는 키 입력입니다. 데이터 입력 문자열 없음 예
    팁:
    IBM PCOMM 에뮬레이터의 키 입력에 대한 자세한 내용은 을 참조하십시오 https://www.ibm.com/docs/SSEQ5Y_6.0.0/com.ibm.pcomm.doc/books/pdf/emulator_referenceV60.pdf.

    SendKeysSecure (영문)

    에뮬레이터 화면의 마우스 장치 위치에서 암호화된 키 입력을 시뮬레이션합니다.

    주:
    이 메서드를 사용하기 전에 SetCursorPosition 메서드를 사용합니다.
    표 6. SendKeys 메서드 매개 변수
    매개변수 설명 데이터 포트 항목 유형 데이터 유형 기본값 필수? 메모
    키 키보드에서 입력하는 키 입력입니다. 데이터 입력 보안 문자열 없음 예
    팁:
    IBM PCOMM 에뮬레이터의 키 입력에 대한 자세한 내용은 을 참조하십시오 https://www.ibm.com/docs/SSEQ5Y_6.0.0/com.ibm.pcomm.doc/books/pdf/emulator_referenceV60.pdf.

    커서 위치 설정

    에뮬레이터 화면의 지정된 행과 열에 마우스 장치를 설정합니다.
    표 7. SetCursorPosition 메서드 매개 변수
    매개변수 설명 데이터 포트 항목 유형 데이터 유형 기본값 필수? 메모
    행 메서드가 화면에서 마우스 장치를 설정하는 행 번호를 제공하는 옵션입니다. 데이터 입력 정수 해당 사항 없음 해당 사항 없음
    Col 메서드가 화면에서 마우스 장치를 설정하는 열의 번호를 제공하는 옵션입니다. 데이터 입력 정수 해당 사항 없음 해당 사항 없음

    작성 대기

    에뮬레이터 화면이 지정된 시간 동안 활성화될 때까지 기다립니다.
    표 8. WaitForCreate 메서드 매개 변수
    매개변수 설명 데이터 포트 항목 유형 데이터 유형 기본값 필수? 메모
    timeoutin초 메서드 시간이 초과될 때까지의 시간(초)입니다. 데이터 입력 정수 30 예
    매치올칠드런 화면 요소를 일치시켜 에뮬레이터 화면이 활성화될 때까지 메서드를 대기하도록 하는 옵션입니다. 데이터 입력 부울 아니오 예
    경고:
    이 옵션을 사용하면 메서드 실행이 지연될 수 있습니다.
    다시 이동 에뮬레이터 화면이 활성화되었는지 여부에 따라 부울 값을 반환합니다. 데이터 출력 부울 해당 사항 없음 해당 사항 없음

    필드 수준 메서드

    필드 수준 메서드에 액세스하려면 캡처한 필드 또는 테이블을 두 번 클릭합니다. 메서드가 개체 탐색기 창에 나타납니다.

    필드 수준 메서드.

    GetAs테이블

    터미널 화면에서 캡처한 텍스트를 표 형식으로 반환합니다. 이상적으로는 화면에서 데이터를 테이블로 캡처할 때 이 방법을 사용해야 합니다. 그러나 필드로 캡처하는 데이터에도 사용할 수 있습니다. 데이터를 테이블로 캡처하는 방법에 대한 자세한 내용은 을 참조하십시오 IBM PCOMM 에뮬레이터.
    표 9. GetAsTable 메서드 매개 변수
    매개변수 설명 데이터 포트 항목 유형 데이터 유형 기본값 필수? 메모
    다시 이동 터미널 화면에서 캡처한 텍스트를 표 형식으로 반환합니다. 데이터 출력 데이터 테이블 해당 사항 없음 해당 사항 없음 테이블을 보려면 매개변수를 마우스 오른쪽 버튼으로 클릭하고 데이터 미리 보기를 선택합니다.

    Gettext

    에뮬레이터 화면에서 캡처한 텍스트를 반환합니다. 이상적으로는 화면에서 필드로 데이터를 캡처할 때 이 방법을 사용해야 합니다.
    주:
    캡처한 테이블에 대해 이 메서드를 사용하면 가상 사각형 영역의 첫 번째 필드에 텍스트가 반환됩니다.
    표 10. GetText 메서드 매개 변수
    매개변수 설명 데이터 포트 항목 유형 데이터 유형 기본값 필수? 메모
    다시 이동 캡처된 필드에서 텍스트를 반환합니다. 데이터 출력 문자열 해당 사항 없음 해당 사항 없음 테이블을 보려면 매개변수를 마우스 오른쪽 버튼으로 클릭하고 데이터 미리 보기를 선택합니다.

    IsCreated입니다

    요소가 활성 상태인지 여부를 확인합니다.
    표 11. IsCreated 메서드 매개 변수
    매개변수 설명 데이터 포트 항목 유형 데이터 유형 기본값 필수? 메모
    다시 이동 요소가 활성 상태인지 여부에 따라 부울 값을 반환합니다. 데이터 출력 부울 해당 사항 없음 해당 사항 없음

    Settext

    필드 또는 테이블에 사용자 지정 텍스트를 설정합니다. 사용자 지정 텍스트는 기존 텍스트를 대체합니다(있는 경우).
    표 12. SetText 메서드 매개 변수
    매개변수 설명 데이터 포트 항목 유형 데이터 유형 기본값 필수? 메모
    텍스트 필드 또는 테이블에서 설정하려는 텍스트입니다. 데이터 입력 문자열 해당 사항 없음 예

    작성 대기

    지정한 시간 동안 요소가 활성화될 때까지 기다립니다.
    표 13. WaitForCreate 메서드 매개 변수
    매개변수 설명 데이터 포트 항목 유형 데이터 유형 기본값 필수? 메모
    timeoutin초 메서드 시간이 초과될 때까지의 시간(초)입니다. 데이터 입력 정수 30 예
    다시 이동 요소가 활성화되는지 여부에 따라 부울 값을 반환합니다. 데이터 출력 부울 해당 사항 없음 해당 사항 없음