StaticImageのキー
Category = StaticImageのフィールドのキー一覧です。
- キー名が赤字と青字のキーは必須のキーです。
(青字のキーは他のキーの設定状況などによっては省略することも可能です)
- キー名の左の欄に*があるキーは、
ModifyItemコマンドで後から設定を変更することができます。
カテゴリの設定
|
キー名 |
値 |
内容 |
|
Category |
StaticImage |
カテゴリをStaticImageに指定 |
配置する画像ファイルの設定
|
キー名 |
値 |
内容 |
初期値 |
* |
ImageFile |
画像ファイル名 |
表示する画像のファイル名 |
|
☆Width・Heightの両方のキーが設定されている場合に限り省略可能です。
背景色の設定
|
キー名 |
値 |
内容 |
初期値 |
* |
BackgroundColor |
色指定 |
アイテムの背景色(・透明度)の設定【※】 |
0x00000000 |
※アイテムの表示領域の矩形(長方形)部分全体に設定した色・透明度で塗りつぶされます。
ImageFileキーで設定されている画像ファイルのすぐ下に(奥に)背景色が表示されます。
アイテムの表示サイズの指定
|
キー名 |
値 |
内容 |
初期値 |
* |
Width |
数値 |
アイテムの表示サイズ(幅) |
ImageFileの画像ファイルの幅 |
* |
Height |
数値 |
アイテムの表示サイズ(高さ) |
ImageFileの画像ファイルの高さ |
☆Width・Heightキーは、
ImageFileキーが設定されている場合に限り省略可能です。
この場合、Width・HeightはImageFileの画像ファイルの幅・高さになります。
アイテムの表示位置指定
☆通常は『PosX・PosYキー両方とも』
ウィンドウの特定位置(四隅・四辺の中央など)からの相対位置にする場合は
『TopLeftAnchorキー』が、それぞれ必須キーになります。
(PosX・PosYは省略してもエラーにはなりませんが
TopLeftAnchorキーが未設定のときにPosX・PosYも省略すると
PosX・PosYがどちらも0扱いとなり、アイテムがフェイス左上端に配置されてしまうので
基本的にはPosX・PosYを省略せずに記述するようにしてください。
なお、OriginItemキー設定時で
基準アイテムと同じ位置に配置する場合は省略してもかまいません。)
|
キー名 |
値 |
内容 |
初期値 |
* |
PosX |
数値 |
アイテムの左上端位置のX座標 |
0 |
* |
PosY |
数値 |
アイテムの左上端位置のY座標 |
0 |
|
OriginItem |
基準になるアイテムの フィールド名【※1】 |
アイテムの表示位置が キーの値に指定した フィールド名のアイテムの表示位置からの 相対位置になる【※2】 |
|
* |
TopLeftAnchor |
【※3】 |
アイテムの表示領域の左上座標を 指定した原点からの相対座標に固定する 【※4】 |
None |
* |
BottomRightAnchor |
【※3】 |
アイテムの表示領域の右下座標を 指定した原点からの相対座標に固定し、 ウィンドウサイズの大きさに応じて 表示サイズを自動調整する【※5】 |
None |
|
Priority |
数値 |
アイテムの表示の優先度 |
0 |
※1 iniファイル(定義ファイル)内で、
このキーを記述するフィールドの前に記述されているフィールド名のみが対象。
(このキーを記述するフィールドの後にあるフィールド名や
iniファイル内に存在しないフィールド名はエラーになります。)
※2 OriginItemキーを記述した場合、
アイテムの左上端位置のX座標は、
「OriginItemで指定したアイテムのPosX+このアイテムのPosX」に、
Y座標は「OriginItemで指定したアイテムのPosY+このアイテムのPosY」になります。
PosX・PosYキーの数値にマイナスの数値を指定することで、
OriginItemで指定したアイテムよりも上や左に配置することもできます。
PosX・PosYキーの数値がどちらも0の場合(または、キーを省略した場合)は
OriginItemで指定したアイテムと同じ位置に配置されます。
※3 〔原点〕, 〔相対X座標〕, 〔相対Y座標〕の3つを半角スペースとカンマで区切って指定します。
原点はTopLeft(左上端)・TopCenter(上端中央)・TopRight(右上端)・
CenterLeft(左端中央)・Center(中央)・CenterRight(右端中央)・
BottomLeft(左下端)・BottomCenter(下端中央)・BottomRight(右下端)・
None(自動補正を行わない)のうちどれか1つ。
相対X座標と相対Y座標はピクセル単位だけでなく、
ウィンドウの幅や高さに対する割合でも設定が可能です。
割合で指定する場合は数値の後に半角で%を記述してください。
(%表記の場合、10.0%というふうに小数表記も可能です)
※4 このキーはPosX・PosYキーの代わりに設定します。
また、OriginItemキーの設定は無視されます。
※5 このキーはTopLeftAnchorキーとともに設定します。
アイテムの表示サイズはウィンドウサイズに応じて自動的に調整されますが、
初期サイズとしてのWidth・Heightキーは設定しておいてください。
(ImageFileキーを省略している場合は
Width・Heightキーも省略してしまうとエラーになります。)
画像ファイルの配置設定
|
キー名 |
値 |
内容 |
初期値 |
|
Align |
【※1】 |
アイテムの表示領域内での画像ファイルの表示位置 |
TopLeft |
|
TilingMethod |
【※2】 |
画像ファイルの表示方法(繰り返し・拡大縮小) |
None |
※1 TopLeft(左上端)・TopCenter(上端中央)・TopRight(右上端)・
CenterLeft(左端中央)・Center(中央)・CenterRight(右端中央)・
BottomLeft(左下端)・BottomCenter(下端中央)・BottomRight(右下端)のうち
どれか1つ
※2 Both(縦横に繰り返し)・Horizontal(横方向に繰り返し)・Vertical(縦方向に繰り返し)・
Scaling(表示サイズにあわせて拡大縮小表示)・
KeepAspectScaling(縦横比を保ったまま拡大縮小表示)・
None(繰り返しや拡大縮小を行わない)のうちどれか1つ
マウスオーバー/クリックへの反応の設定
|
キー名 |
値 |
内容 |
初期値 |
* |
TipHint |
文字列 |
マウスカーソルがアイテムの表示位置に 一定時間置かれたときに表示されるチップヒントの内容 |
|
* |
Enable |
TrueかFalse |
True:クリックに反応するようになる【※1】 Commandキーが設定されている アイテムの場合、 クリック時にそのコマンドが実行される |
False |
|
AlphaThreshold |
数値(整数) (0~255) |
〔指定した数値〕より大きいα値を持つピクセルに 当たり判定を持たせる【※2】 |
0 |
|
DisableRegion |
TrueかFalse |
True:表示画像の中で 完全に透けている部分のある画像でも アイテムの表示領域全体に 当たり判定を持たせる False:表示画像の中で完全に透けている部分には 当たり判定を持たせない【※2】 |
False |
|
MouseCursor |
【※3】 |
マウスオーバー/クリック時の マウスカーソルの指定 |
Auto |
※1
StaticImageアイテムの場合、クリック/マウスオーバーしても
表示される画像や背景色が変更されないので、
クリックされたかどうかは見た目では判断できません。
ただし、
Commandキーが設定されていればコマンドは実行されます。
※2
AlphaThresholdキーで当たり判定を制御する場合は
DisableRegionキーは省略するか
Falseを指定してください。
※3 マウスカーソルに使用する
*.curのカーソルファイル名か、
以下の値のうちどれか1つ
Auto・
Normal・
Finger・
TopLeftResizer・
TopRightResizer・
BottomLeftResizer・
BottomRightResizer・
Arrow・
IBeam・
Wait・
Cross・
UpArrow・
Size・
SizeNWSE・
SizeNESW・
SizeWE・
SizeNS・
No・
Hand・
AppStarting・
Help
設定可能なマウスカーソルの一覧はこちら。
アイテムの初期表示状態の設定
|
キー名 |
値 |
内容 |
初期値 |
* |
IsHided |
TrueかFalse |
True:初期状態でアイテムを非表示にする【※】 |
False |
※HideItemコマンドで非表示にしたのと同じ状態です。
後からShowItem・SwitchShowItemコマンドで表示させることはできます。
アイテムの透明度の設定
☆背景色指定の透明度や画像ファイル自体の透明情報を編集すれば
ConstAlphaキーを使用しなくても
アイテムの表示透明度を制御することは可能です。
|
キー名 |
値 |
内容 |
初期値 |
* |
ConstAlpha |
数値(整数) (0~255か-1) |
アイテムの定数α(不透明度)を指定【※】 |
-1 |
※「0」で完全透明、
「255」で不透明(背景色や画像ファイル自体が半透明なら、その透明度のまま)になります。
ただし、不透明扱いにするのならキーを省略(-1に設定)するほうが高速に描画されるので
このキーで透明度を調整する必要が無い場合は、キーを省略してください。
なお、背景色指定の透明度や画像ファイル自体の透明情報が設定されている場合
ConstAlphaキーの設定が乗算されます。
アイテムの表示エリアの差分描画の設定
|
キー名 |
値 |
内容 |
初期値 |
|
DisablePartialUpdate |
TrueかFalse |
True:差分描画が行われなくなる |
False |
コマンドの設定
|
キー名 |
値 |
内容 |
初期値 |
* |
Command |
コマンド名 |
クリック時に実行するコマンド名 |
|
* |
CommandParamType |
【※1】 |
コマンドのパラメータの種類 (パラメータが必要なコマンドのみ) |
|
* |
CommandParam |
【※2】 |
コマンドのパラメータの内容 (パラメータが必要なコマンドのみ) |
|
|
CommandTargetWindow |
ウィンドウ名【※3】 |
コマンドを実行する対象のウィンドウ (別のウィンドウに対して実行する場合のみ。 省略した場合は Commandキーを記述したウィンドウ自身が 対象になる) |
|
|
CommandTargetPlugin |
プラグイン名 |
コマンドを実行する対象のプラグイン名 (プラグインに対して実行する場合のみ) |
|
* |
CommandCount |
数値 |
実行するコマンドの数 (複数のコマンドを設定する場合のみ【※4】) |
|
|
UseAsyncCommand |
TrueかFalse |
True:コマンドを非同期実行するようにする |
False |
※1 Int・String・Double・Bool・RandomInt・RandomString のうちどれか1つ
(コマンドによって使用できる種類が異なる)
※2 文字列や数値など、コマンドによって異なる
※3 CreateSubFace・ToggleSubFaceコマンドで開くときにパラメータで指定した「ウィンドウ名」。
サブウィンドウに記述したコマンドで、メインウィンドウを対象とする場合は
「uLilith::MainWindow」と指定する。
※4 1つのアイテムに複数のコマンドを設定する場合、
CommandCountキーを設定した上で
Command・CommandParamType・CommandParam・
CommandTargetWindow・CommandTargetPluginの全てのキーの末尾に
(スペースは入れずに)連番をつける必要があります。
例:「Command2」「CommandParamType2」など
コマンドはキー末尾につけた連番の番号の順に実行されます。
最終更新:2013年02月18日 23:02