컨트롤 값 설정 (ui_element.set_value)

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

선언

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

매개변수

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

반환값

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

설명

이 인터페이스는 값을 직접 설정할 수 있는 컨트롤에 사용합니다. 슬라이더에는 0.0 ~ 1.0 범위의 실수를 전달하거나 "50%" 같은 백분율 텍스트를 전달해 볼 수 있습니다. 대상 컨트롤의 값이 실제로 바뀌지 않으면 nil, "value unchanged"를 반환할 수 있습니다.

예제

local ui_element = require("ui_element")

ui_element.set_value({
    role = "slider",
    index = 1,
}, 0.5)