ActionButtonGroup

アクションボタングループ (ActionButtonGroup)要素 は、Warhammer Onlineで使用されている形式のアクションボタンの描画パフォーマンスを最適化する、特殊化されたウィンドウ要素です。

このウィンドウ要素は単独のアクションボタンから成る多数のテンプレートを持ち、その組み合わせはドロー要求の定数を引き出すボタンのあらゆる数や行・列を生成することができます。

Summary
ActionButtonGroupアクションボタングループ (ActionButtonGroup)要素 は、Warhammer Onlineで使用されている形式のアクションボタンの描画パフォーマンスを最適化する、特殊化されたウィンドウ要素です。
実装の詳細
XML定義アクションボタングループのXML定義です。
XMLタグ
必須属性
numRows作成するボタンの列数。
numCols作成するボタンの行数。
要素
ActionButtonDefs全てのボタンコンポーネントのテンプレート情報を指定します。
ButtonSpacingボタンとボタンの間の空白を指定します。
ウィンドウ コールバック
コールバック
OnActionButtonLButtonDownユーザーがボタンの上でマウスの左ボタンを押した時に呼び出されます。
OnActionButtonLButtonUpユーザーがボタンの上でマウスの左ボタンを放した時に呼び出されます。
OnActionButtonRButtonDownユーザーがボタンの上でマウスの右ボタンを押した時に呼び出されます。
OnActionButtonRButtonUpユーザーがボタンの上でマウスの右ボタンを放した時に呼び出されます。
OnActionButtonMouseOverユーザーがアクションボタンの上にマウスカーソルを合わせた時に呼び出されます。
OnActionButtonMouseOverEndユーザーがアクションボタンからマウスカーソルを放した時に呼び出されます。
定数
定数
Time Formats時間フォーマット
Window.TimeFormat.SECONDS秒数で時間を表示します。
Window.TimeFormat.LARGEST_UNIT_ROUNDUP最も大きな時間単位で時間を表示し、端数を切り上げます。
Window.TimeFormat.LARGEST_UNIT_TRUNCATE最も大きな時間単位で時間を表示し、端数を切り捨てます。
Window.TimeFormat.NUM_FORMATS時間フォーマットの数。
関数
関数
ActionButtonGroupSetIcon()指定したボタンのインデックスにアイコンを設定します。
ActionButtonGroupSetText()指定したボタンのインデックスにテキストを設定します。
ActionButtonGroupSetTimer()指定したボタンのインデックスにタイマーを設定します。
ActionButtonGroupSetTintColor()指定したボタンのインデックスに色を設定します。
ActionButtonGroupSetGameActionTrigger()このグループ内のボタンをクリックする行為とゲームアクション(キーバインド可能なアクション)を結びつけます。
ActionButtonGroupSetGameActionData()このウィンドウをクリックする行為とゲームアクション(キーバインド可能なアクション)を結びつけます。
ActionButtonGroupSetNumButtons()このアクションボタングループに、行と列の数を設定します。
ActionButtonGroupSetTimeFormat()アクションボタングループの使用する時間フォーマットを設定します。
ActionButtonGroupSetTimeAbbreviations()アクションボタングループの時間の略記号を設定します。

実装の詳細

要素

アクションボタングループは次の要素で構成されています。

  • コアボタンアートの Button 定義。それぞれのボタンの大きさはボタン定義により決定されます。
  • Label 定義。アクションボタングループはボタンとの相対的な位置を計算するのにラベルのアンカーを使います。
  • カウントダウンタイマーの Label 定義。アクションボタングループはボタンとの相対的な位置を計算するのにラベルのアンカーを使います。
  • アイコンの大きさ、位置、座標情報を提供する DynamicImage の定義。
  • クールダウンアイコンの大きさ、位置、座標情報を提供する DynamicImageAnimatedImage の定義。

XML定義

アクションボタングループのXML定義です。

Summary
XMLタグ
必須属性
numRows作成するボタンの列数。
numCols作成するボタンの行数。
要素
ActionButtonDefs全てのボタンコンポーネントのテンプレート情報を指定します。
ButtonSpacingボタンとボタンの間の空白を指定します。

XMLタグ

<ActionButtonGroup>
....
</ActionButtonGroup>

代替グループ

必須属性

numRows

作成するボタンの列数。

データ型

integerボタンの列数。

デフォルト値

  • 0

numCols

作成するボタンの行数。

データ型

integerボタンの行数。

デフォルト値

  • 0

要素

ActionButtonDefs

全てのボタンコンポーネントのテンプレート情報を指定します。

構文

<ActionButtonDefs>
    <ButtonDef templateName="DefaultTimerButton" />
    <TextDef templateName="BackpackWindowEquipmentButtonTextTemplate" />
    <TimerDef templateName="BackpackWindowEquipmentButtonTimerTemplate" />
    <IconDef templateName="EquipmentIconDef" />
    <CooldownDef templateName="BackpackWindow2ButtonGroupCooldownDef" />
</ActionButtonDefs>
ButtonDefコアボタンアートの Button 定義。
TextDefボタンテキストの Label 定義。
TimerDefタイマーテキストの Label 定義。
IconDefボタンアイコンの DynamicImage 定義。
CooldownDefボタンのクールダウン画像の DynamicImage 定義。

ボタンの大きさは Button 定義によって決定されます。他の全ての要素のアンカーは、ボタンとの相対位置を取るのに使用されます。例えば、右上の右上へのテキストフィールドのアンカリングはボタンの右上隅にそれをアンカーします。

DynamicImage がクールダウンに使用されると、時間と共にアルファがフェードします。 AnimatedImage はまだ実装されていません。

ButtonSpacing

ボタンとボタンの間の空白を指定します。

構文

<ButtonSpacing x="0" y="0" />
x各列間の空白。デフォルトは0。
y各行間の空白。デフォルトは0。

ウィンドウ コールバック

Summary
コールバック
OnActionButtonLButtonDownユーザーがボタンの上でマウスの左ボタンを押した時に呼び出されます。
OnActionButtonLButtonUpユーザーがボタンの上でマウスの左ボタンを放した時に呼び出されます。
OnActionButtonRButtonDownユーザーがボタンの上でマウスの右ボタンを押した時に呼び出されます。
OnActionButtonRButtonUpユーザーがボタンの上でマウスの右ボタンを放した時に呼び出されます。
OnActionButtonMouseOverユーザーがアクションボタンの上にマウスカーソルを合わせた時に呼び出されます。
OnActionButtonMouseOverEndユーザーがアクションボタンからマウスカーソルを放した時に呼び出されます。

コールバック

OnActionButtonLButtonDown

ユーザーがボタンの上でマウスの左ボタンを押した時に呼び出されます。

構文

SomeWindow.OnButtonLButtonDown( buttonIndex )

OnActionButtonLButtonUp

ユーザーがボタンの上でマウスの左ボタンを放した時に呼び出されます。

構文

SomeWindow.OnButtonLButtonUp( buttonIndex )

OnActionButtonRButtonDown

ユーザーがボタンの上でマウスの右ボタンを押した時に呼び出されます。

構文

SomeWindow.OnButtonRButtonDown( buttonIndex )

OnActionButtonRButtonUp

ユーザーがボタンの上でマウスの右ボタンを放した時に呼び出されます。

構文

SomeWindow.OnButtonRButtonUp( buttonIndex )

OnActionButtonMouseOver

ユーザーがアクションボタンの上にマウスカーソルを合わせた時に呼び出されます。

構文

SomeWindow.OnButtonMouseOver( buttonIndex )

OnActionButtonMouseOverEnd

ユーザーがアクションボタンからマウスカーソルを放した時に呼び出されます。

構文

SomeWindow.OnButtonMouseOverEnd( buttonIndex )

定数

Summary
定数
Time Formats時間フォーマット
Window.TimeFormat.SECONDS秒数で時間を表示します。
Window.TimeFormat.LARGEST_UNIT_ROUNDUP最も大きな時間単位で時間を表示し、端数を切り上げます。
Window.TimeFormat.LARGEST_UNIT_TRUNCATE最も大きな時間単位で時間を表示し、端数を切り捨てます。
Window.TimeFormat.NUM_FORMATS時間フォーマットの数。

定数

Time Formats

時間フォーマット

Window.TimeFormat.SECONDS

秒数で時間を表示します。

Window.TimeFormat.LARGEST_UNIT_ROUNDUP

最も大きな時間単位で時間を表示し、端数を切り上げます。

Window.TimeFormat.LARGEST_UNIT_TRUNCATE

最も大きな時間単位で時間を表示し、端数を切り捨てます。

Window.TimeFormat.NUM_FORMATS

時間フォーマットの数。

関数

Summary
関数
ActionButtonGroupSetIcon()指定したボタンのインデックスにアイコンを設定します。
ActionButtonGroupSetText()指定したボタンのインデックスにテキストを設定します。
ActionButtonGroupSetTimer()指定したボタンのインデックスにタイマーを設定します。
ActionButtonGroupSetTintColor()指定したボタンのインデックスに色を設定します。
ActionButtonGroupSetGameActionTrigger()このグループ内のボタンをクリックする行為とゲームアクション(キーバインド可能なアクション)を結びつけます。
ActionButtonGroupSetGameActionData()このウィンドウをクリックする行為とゲームアクション(キーバインド可能なアクション)を結びつけます。
ActionButtonGroupSetNumButtons()このアクションボタングループに、行と列の数を設定します。
ActionButtonGroupSetTimeFormat()アクションボタングループの使用する時間フォーマットを設定します。
ActionButtonGroupSetTimeAbbreviations()アクションボタングループの時間の略記号を設定します。

関数

ActionButtonGroupSetIcon()

指定したボタンのインデックスにアイコンを設定します。

パラメータ

actionButtonGroupName(string) アクションボタングループの名前。
buttonIndex(integer) ボタンのインデックス番号。
iconNum(integer) 使用したいアイコンの番号。

戻り値

nil戻り値無し。

ActionButtonGroupSetIcon("BackpackWindowItems", itemSlot, item.iconNum )

ActionButtonGroupSetText()

指定したボタンのインデックスにテキストを設定します。

パラメータ

actionButtonGroupName(string) アクションボタングループの名前。
buttonIndex(integer) ボタンのインデックス番号。
text(wstring) ボタンに表示したいテキスト。

戻り値

nil戻り値無し。

ActionButtonGroupSetText("BackpackWindowItems", 2, L"2" )

ActionButtonGroupSetTimer()

指定したボタンのインデックスにタイマーを設定します。

パラメータ

actionButtonGroupName(string) アクションボタングループの名前。
buttonIndex(integer) ボタンのインデックス番号。
maxTimer(integer) タイマーの最大持続時間。
remainingTimer(integer) このタイマーの残り時間。

戻り値

nil戻り値無し。

ActionButtonGroupSetTimer("BackpackWindowItems", 2, 500, 450 )

ActionButtonGroupSetTintColor()

指定したボタンのインデックスに色を設定します。

パラメータ

windowName(string) ウィンドウの名前。
buttonIndex(integer) ボタンのインデックス番号。
red(integer) 赤値 (0-255)
green(integer) 緑値 (0-255)
blue(integer) 青値 (0-255)

戻り値

nil戻り値無し。

ActionButtonGroupSetTintColor( "SomeWindow", buttonIndex, 255, 255, 255 )

ActionButtonGroupSetGameActionTrigger()

このグループ内のボタンをクリックする行為とゲームアクション(キーバインド可能なアクション)を結びつけます。

パラメータ

windowName(string) ウィンドウの名前。
buttonIndex(integer) ボタンのインデックス番号。
gameActionId(integer) ウィンドウがクリックされた時に発動するキーバインディングアクションID。

戻り値

nil戻り値無し。

ActionButtonGroupSetGameActionTrigger( "SomeWindow", 1, 2 )

ActionButtonGroupSetGameActionData()

このウィンドウをクリックする行為とゲームアクション(キーバインド可能なアクション)を結びつけます。

パラメータ

windowName(string) ウィンドウの名前。
buttonIndex(integer) ボタンのインデックス番号。
gameActionType(integer) アクションのタイプ。
gameActionId(integer) アクションのID番号。
gameActionText(integer) アクションと結び付けられたテキスト。

戻り値

nil戻り値無し。

ActionButtonGroupSetGameActionData( "SomeWindow", true, 2 )

ActionButtonGroupSetNumButtons()

このアクションボタングループに、行と列の数を設定します。

パラメータ

windowName(string) アクションボタングループの名前。
numRows(integer) ボタンの列の数。
numCols(integer) ボタンの行の数。

戻り値

nil戻り値無し。

メモ

  • ボタンの合計数(行*列)を変えた場合、全てのボタンデータを再初期化する必要があります。ボタン合計数を変えずにレイアウトを変更した場合、レイアウトが崩れる場合があります。

ActionButtonGroupSetNumButtons( "WindowName", 10, 1 )

ActionButtonGroupSetTimeFormat()

アクションボタングループの使用する時間フォーマットを設定します。

パラメータ

windowName(string) アクションボタングループの名前。
timeFormat(integer) タイマーの表示フォーマットは、Window.TimeFormat 定数を参照します。

戻り値

nil戻り値無し。

ActionButtonGroupSetTimeFormat( "ActionButtonGroupWindowName", SystemData.ActionButtonGroupTimeFormats.TIMEFORMAT_SECONDS )

ActionButtonGroupSetTimeAbbreviations()

アクションボタングループの時間の略記号を設定します。

パラメータ

windowName(string) アクションボタングループの名前。
days(wstring) 日に使用する略記号。
hours(wstring) 時に使用する略記号。
minutes(wstring) 分に使用する略記号。
seconds(wstring) 秒に使用する略記号。

戻り値

nil戻り値無し。

ActionButtonGroupSetTimeAbbreviations( "ActionButtonGroupWindowName", L"d", L"h", L"m", L"s" )
ボタン (Button) 要素は、マウスカーソルの状態に応じて自動的にテクスチャやフォントカラーを変更するなどといった、一般的なボタン要素を自動化します。
ラベル (Label) 要素は、インターフェースのテキスト描画要素として主に使用されます。
ダイナミックイメージ (DynamicImage) 要素を使えば、テクスチャの矩形表示が可能になります。
アニメーテッドイメージ (AnimatedImage) 要素を使えば、ページめくりスタイルのアニメーションを自動化することができます。
ウィンドウ (Window) 要素はウィンドウを作成する際に使用する基本的な要素です。他のウィンドウ要素もこの要素の内容を継承しており、全ての属性、要素、データメンバー、関数をサポートしています。
Close