コントロールの値を設定する (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)