본문으로 건너뛰기

UI 스냅샷 한 번 가져오기 (ui_element.snapshot)

이 함수는 20260507 이후 버전에서 사용할 수 있습니다.

선언​

스냅샷, 오류 정보 = ui_element.snapshot([ 옵션 ])

매개변수​

반환값​

  • 스냅샷 테이블. 현재 UI 요소 목록과 스냅샷 메서드를 포함하며 실패하면 nil입니다.
  • 오류 정보 문자열. 실패 원인입니다.

스냅샷 메서드​

요소 = 스냅샷:find(선택자)
요소 목록 = 스냅샷:find_all(선택자)
상태, 정보 = 스냅샷:click(선택자 또는 요소 [, 옵션 ])
상태, 정보 = 스냅샷:scroll([ 선택자 또는 요소, ] 방향 [, 옵션 ])
상태, 정보 = 스냅샷:input_text(선택자 또는 요소, 텍스트 [, 옵션 ])
상태, 정보 = 스냅샷:set_text(선택자 또는 요소, 텍스트 [, 옵션 ])
상태, 정보 = 스냅샷:clear_text(선택자 또는 요소 [, 옵션 ])
상태, 정보 = 스냅샷:toggle(선택자 또는 요소 [, 옵션 ])
상태, 정보 = 스냅샷:set_checked(선택자 또는 요소, 체크 상태 [, 옵션 ])
상태, 정보 = 스냅샷:set_value(선택자 또는 요소, 값 [, 옵션 ])
상태, 정보 = 스냅샷:increase(선택자 또는 요소 [, 옵션 ])
상태, 정보 = 스냅샷:decrease(선택자 또는 요소 [, 옵션 ])

설명​

스냅샷은 일회성 결과이며 같은 화면 안에서 여러 번 찾거나 연속 작업을 수행할 때 적합합니다. 화면 전환, 대화상자 표시, 스크롤 또는 콘텐츠 새로고침이 발생하면 snapshot()을 다시 호출해야 합니다. 스냅샷 테이블의 일반 필드에는 elements와 count가 있습니다.

예제​

local ui_element = require("ui_element")

local ui, err = ui_element.snapshot({
    max_level = 2,
})

if ui then
    local search = ui:find({
        title = "搜索",
        role = "text_field",
    })
    if search then
        ui:set_text(search, "XXTouch")
    end
else
    sys.toast(err)
end

참고: 위 코드에서는 이 장에서 설명하지 않는 함수인 sys.toast를 사용합니다.