メインコンテンツまでスキップ

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