UI 요소 클릭 (ui_element.click)

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

선언

상태, 정보 또는 오류 정보 = ui_element.click(선택자 또는 요소 [, 옵션 ])

매개변수

• 선택자 또는 요소 테이블. 선택자, 조회에서 반환된 요소 또는 { x = 가로 좌표, y = 세로 좌표 } 좌표 테이블을 사용할 수 있습니다.
• 옵션 테이블, 선택 사항. 공통 옵션 설명을 참조하십시오.

반환값

• 상태 불리언. 성공하면 true, 실패하면 nil입니다.
• 정보 또는 오류 정보 성공하면 테이블 형식의 동작 정보, 실패하면 문자열 형식의 오류 원인입니다.

설명

버튼, 목록 항목, 키보드 키 또는 그 밖의 클릭 가능한 UI를 클릭하는 데 사용합니다. 좌표 테이블의 좌표 단위는 물리 픽셀입니다. 고정 좌표 클릭에는 touch.tap을 우선 사용하십시오. 여러 대상이 일치하여 고유한 대상을 판단할 수 없으면 nil, "ambiguous target"을 반환할 수 있습니다.

예제

local ui_element = require("ui_element")

local ok, info_or_err = ui_element.click({
    title = "继续",
    role = "button",
})

if not ok then
    sys.toast(info_or_err)
end

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