SliderBar

スライダーバー (SliderBar) はWindowsスタイルのスライダーバーコントロールを提供します。このウィンドウ要素はいくつかの他のウィンドウコンポーネントを自動的に組み合わせたものです。

Summary
SliderBarスライダーバー (SliderBar) はWindowsスタイルのスライダーバーコントロールを提供します。このウィンドウ要素はいくつかの他のウィンドウコンポーネントを自動的に組み合わせたものです。
実装の詳細スライダーバーはウィンドウ要素の組み合わせで、より基本的なウィンドウコンポーネントのセットからスライダーボックスの動作を自動化します。
XML定義
XMLタグ
必須属性
backgroundバーの背景画像としての水平リサイズイメージ定義の名前。
tickmark一目盛り用のテクスチャ座標とサイズを含むダイナミックイメージ定義の名前。
sliderbuttonスライダーボタンのボタン定義の名前。
numticksバーの目盛りの数。
orientationスライダーバーが水平、または垂直方向に動作するよう、内部関数を変更します。
locktoticks目盛りが指している値までしかスライダーバーを動かせないようにするかどうかを設定します。
ウィンドウ コールバック
コールバック
OnSlideバーの(スライダー)位置が変更された時に呼び出されます。
関数
関数
SliderBarSetDisabledFlag()スライダーを無効にするかどうかを設定します。
SliderBarGetDisabledFlag()現在、スライダーが無効に設定されているのかどうかを返します。
SliderBarSetCurrentPosition()スライダーバーの現在位置を設定します。
SliderBarGetCurrentPosition()現在のスライダーバーの位置を返します。

実装の詳細

スライダーバーはウィンドウ要素の組み合わせで、より基本的なウィンドウコンポーネントのセットからスライダーボックスの動作を自動化します。

コンポーネント

スライダーバーは以下のコンポーネントで構成されています:

  • 「バー」の背景のための HorizontalResizeImage 定義。これは、ウィンドウの横幅に合うよう調整されます。 +スライダーの目盛りを表示するための DynamicImage 定義。 これは、 numticks に応じて適切に並べられます。
  • スライダーボタンの Button 定義。

スライダーの値は0.0(左端)から1.0(右端)の間です。他の値の範囲でスライダーを使用したい場合は、Luaスクリプトを作成して計算を行う必要があります。

XML定義

Summary
XMLタグ
必須属性
backgroundバーの背景画像としての水平リサイズイメージ定義の名前。
tickmark一目盛り用のテクスチャ座標とサイズを含むダイナミックイメージ定義の名前。
sliderbuttonスライダーボタンのボタン定義の名前。
numticksバーの目盛りの数。
orientationスライダーバーが水平、または垂直方向に動作するよう、内部関数を変更します。
locktoticks目盛りが指している値までしかスライダーバーを動かせないようにするかどうかを設定します。

XMLタグ

<SliderBar>
....
</SliderBar>

代替グループ

必須属性

background

バーの背景画像としての水平リサイズイメージ定義の名前。

データ型

string有効な HorizontalResizeImage の名前。

デフォルト値

  • ””

tickmark

一目盛り用のテクスチャ座標とサイズを含むダイナミックイメージ定義の名前。

データ型

string有効な DynamicImage 名前。

デフォルト値

  • ””

sliderbutton

スライダーボタンのボタン定義の名前。

データ型

string有効な Button の名前。

デフォルト値

  • ””

numticks

バーの目盛りの数。

データ型

integer0〜n

デフォルト値

  • 3

orientation

スライダーバーが水平、または垂直方向に動作するよう、内部関数を変更します。

データ型

string

”horizontal”水平方向
”vertical”垂直方向

デフォルト値

  • ”horizontal”

メモ

  • 機能しない場合もあるかもしれません。

locktoticks

目盛りが指している値までしかスライダーバーを動かせないようにするかどうかを設定します。

データ型

boolean

true動かせないようにする。
falseしない。

デフォルト値

  • false

ウィンドウ コールバック

Summary
コールバック
OnSlideバーの(スライダー)位置が変更された時に呼び出されます。

コールバック

OnSlide

バーの(スライダー)位置が変更された時に呼び出されます。

構文

SomeSliderBar.OnSlide( curPos )
curPos(integer) 現在のスライダーの位置。

関数

Summary
関数
SliderBarSetDisabledFlag()スライダーを無効にするかどうかを設定します。
SliderBarGetDisabledFlag()現在、スライダーが無効に設定されているのかどうかを返します。
SliderBarSetCurrentPosition()スライダーバーの現在位置を設定します。
SliderBarGetCurrentPosition()現在のスライダーバーの位置を返します。

関数

SliderBarSetDisabledFlag()

スライダーを無効にするかどうかを設定します。

無効にすると、スライダーボタンはスライドできなくなります。

パラメータ

sliderName(string) スライダーの名前。
isDisabled(boolean) true = 無効にする, false = 無効にしない

戻り値

nil戻り値無し。

メモ

  • スライダーを無効に設定すると、アートワークを更新しなくなります。これは、スライダーボタンの移動を防ぐことになります。

SliderBarSetDisabledFlag("MySlider", false )

SliderBarGetDisabledFlag()

現在、スライダーが無効に設定されているのかどうかを返します。

パラメータ

sliderName(string) スライダーの名前。

戻り値

isDisabled(boolean) true = 無効, false = 有効

local isDisabled = SliderBarSetDisabledFlag("MySlider")

SliderBarSetCurrentPosition()

スライダーバーの現在位置を設定します。

パラメータ

sliderBarName(string) スライダーバーの名前。
position(integer) 希望する位置。0.0(左端)から1.0(右端)の間の値。

戻り値

nil戻り値無し。

SliderBarSetCurrentPosition("ScenarioMapMenuWindowOpacitySlider", SystemData.Settings.Interface.tacticalMapAlpha)

SliderBarGetCurrentPosition()

現在のスライダーバーの位置を返します。

パラメータ

sliderBarName(string) スライダーバーの名前。

戻り値

position(integer) 現在の位置。0.0(左端)から1.0(右端)の間の値。

メモ

  • 失敗した場合、nilを返します。

local value = SliderBarGetCurrentPosition( "ScenarioMapMenuWindowOpacitySlider" )
水平リサイズイメージ (HorizontalResizeImage) 要素を使えば、あらゆる幅のウィンドウに適合する画像を自動的に作成することができます。
ダイナミックイメージ (DynamicImage) 要素を使えば、テクスチャの矩形表示が可能になります。
バーの目盛りの数。
ボタン (Button) 要素は、マウスカーソルの状態に応じて自動的にテクスチャやフォントカラーを変更するなどといった、一般的なボタン要素を自動化します。
ウィンドウ (Window) 要素はウィンドウを作成する際に使用する基本的な要素です。他のウィンドウ要素もこの要素の内容を継承しており、全ての属性、要素、データメンバー、関数をサポートしています。
Close