공통 옵션 설명

이 모듈은 20260507 이후 버전에서 사용할 수 있습니다.

여러 ui_element 인터페이스가 옵션 테이블을 받으며, 대상 App, 반환 수, 재귀 깊이, 히트 검증 및 스크롤 단계 값을 지정하는 데 사용합니다.

조회 옵션

local options = {
    pid = app.front_pid(),
    max_level = 2,
    max_elements = 200,
    include_hit_state = true,
}

• pid 정수. 대상 App의 프로세스 식별자를 지정합니다. 전달하지 않으면 일반적으로 포그라운드 App을 사용합니다.
• max_level 정수. 하위 요소의 재귀 깊이입니다. 반환 데이터 양을 제어할 때 보통 1 또는 2를 사용합니다.
• max_elements 정수. 반환할 최상위 요소의 최대 수입니다.
• fallback_children 불리언. 일반 목록이 비어 있으면 하위 요소 읽기를 시도합니다. 기본값은 인터페이스마다 다릅니다.
• include_hit_state 불리언. 히트 상태 필드를 추가할지 여부입니다.
• hit_test 불리언. 화면 샘플링 히트를 사용할지 여부입니다. 일반 스크립트에서는 보통 사용할 필요가 없습니다.
• fallback_hit_test 불리언. 일반 목록이 비어 있으면 화면 샘플링 히트를 시도할지 여부입니다.
• hit_test_spacing 숫자. 화면 샘플링 간격이며 단위는 논리 좌표입니다. 기본값은 40입니다.

동작 옵션

• point 테이블. 스크롤 또는 히트에 사용할 좌표점을 지정하며 단위는 물리 픽셀입니다. 예: { x = 200, y = 700 }.
• x / y 정수. point와 같으며 옵션 테이블에 직접 넣을 수 있습니다.
• steps 숫자. 스크롤, 증가 또는 감소 작업에 사용할 단계 인수입니다. 구체적인 효과는 대상 컨트롤에 따라 다릅니다.

설명

list_text_elements()는 이전 스크립트와의 호환성을 위해 기본 동작이 더 보수적입니다. find(), find_all(), snapshot()과 동작 인터페이스는 새 스크립트에서 직접 사용하기에 더 적합합니다. hit_test는 현재 최상위 화면에 더 가까운 요소를 반환할 수 있지만 비용이 더 높으므로, 일반 조회로 요소를 가져올 수 없을 때만 사용하는 것이 좋습니다.