본문으로 건너뛰기

공통 옵션 설명

이 모듈은 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입니다.

속성 제외 옵션​

20261115 버전부터 사용 가능. snapshot()과 list_text_elements()에만 사용합니다. 모두 불리언이며 기본값은 false이고 자식 요소에도 적용됩니다. 해당 상태가 필요하지 않다면 제외 옵션을 켜서 조회 비용을 줄이고 스냅샷을 더 빠르게 가져올 수 있습니다.

  • exclude_visibility
    true이면 가시성 조회를 건너뛰고 isVisible을 생략합니다.
  • exclude_map
    true이면 지도 속성 검사를 건너뛰고 isMap을 생략합니다. 지도 요소 자체는 유지됩니다.
  • exclude_hit_state
    true이면 중심점 히트 검사를 건너뛰고 canHit, hitVerified, hitTestPoint, hitTestPointLogical을 생략합니다. include_hit_state = true와 함께 사용할 수 없습니다.

요소 범위, 텍스트, 좌표 및 hit_test / fallback_hit_test의 요소 보충 규칙은 바뀌지 않습니다. 상태를 기준으로 필터링해야 한다면 해당 필드를 제외하지 마세요.

동작 옵션​

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

설명​

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