.. default-domain:: csharp .. _SCROLLBAR: ============================= SCROLLBAR ============================= C#: :ref:`CWinCtrlScrollbar` スクロールバーを表示するためのコントロールです。 スクロール可能なコントロールと関連付けることによって、有効になります。 GROUPプロパティにSCROLLBARコントロールを関連づけることによって、スクロールバーを表示することができます。 スクロール可能なコントロールに対して、複数のスクロールバーを関連付けることも可能です。 スクロール可能なコントロールは次のものがあります。 * :ref:`LISTBOX` * :ref:`LISTBOXEX` * :ref:`EDITBOX` * :ref:`TEXTBOX` * :ref:`CONTAINER` * :ref:`LOG` STYLEにHIT/NOHIT共に指定することができません。 SCROLLBAR(コントロール名) { プロパティ1; プロパティ2; : : プロパティn; }; 記述例 =========== :: $w = 300; LISTBOX(List) { ID = 001_100_00000; POSITION = 0,-160; STYLE = ANCHOR_BOTTOM; SIZE = $w,160 - 16; CONTENTS_SIZE = $w,48; CONTENTS = { CHECKBOX(IP) { ID = 001_000_00020; CAPTION = 001_000_00030; STYLE = ANCHOR_LEFTTOP; POSITION = 0,0; SIZE = $w,48; }; } GROUP = SCROLLBAR(List); }; SCROLLBAR(List) { ID = 001_100_00010; DEF_SCROLLBAR; STYLE = ANCHOR_RIGHTTOP; POSITION = 0,16; SIZE = 0,-16 * 2; }; .. .. image:: images/SCROLLBAR.png 位置とサイズ ================= 通常のコントロールと違い、位置とサイズの扱いが特殊です。 位置とサイズは、関連付いているスクロール可能なコントロールからの相対になります。 また、アンカーによって、関連付いているスクロールのどの辺に沿って配置するからを指定できるようになっています。 有効なアンカーは :ref:`こちら` を参照ください。 :: #include "wr.h" WINDOW(255_000_00001) { STYLE = NOTITLEBAR|ANCHOR_CENTER; POSITION = 0,0; SIZE = 256,256; TEX_ID = 100_000_00001; }; CONTAINER(Map) { ID = 000_000_000100; POSITION = 0,0; SIZE = RELATIVE_SIZE(0),RELATIVE_SIZE(0); CONTENTS_SIZE = 512,512; COLOR = COLOR32(255,255,255,255); CONTENTS = { BUTTON(A) { STYLE = BASE_LEFT; PRIORITY = -1; POSITION = 0,256; TEX_ID = "TQML0"; }; BUTTON(B) { STYLE = BASE_TOP; PRIORITY = -1; POSITION = 256,0; TEX_ID = "TQML0"; }; BUTTON(C) { STYLE = BASE_BOTTOM; PRIORITY = -1; POSITION = 256,512; TEX_ID = "TQML0"; }; BUTTON(D) { STYLE = BASE_RIGHT; PRIORITY = -1; POSITION = 512,256; TEX_ID = "TQML0"; }; }; GROUP = SCROLLBAR(LEFT),SCROLLBAR(RIGHT),SCROLLBAR(TOP),SCROLLBAR(BOTTOM); }; SCROLLBAR(LEFT) { STYLE = ANCHOR_LEFTTOP; TEX_ID = "SCBBH"; POSITION = 0,0; SIZE = 0,0; }; SCROLLBAR(RIGHT) { STYLE = ANCHOR_RIGHTTOP; TEX_ID = "SCBBH"; POSITION = 0,0; SIZE = 0,0; }; SCROLLBAR(TOP) { STYLE = ANCHOR_LEFTTOP|ITEM_STACK_H; TEX_ID = "SCBBV"; POSITION = 0,0; SIZE = 0,0; }; SCROLLBAR(BOTTOM) { STYLE = ANCHOR_LEFTBOTTOM|ITEM_STACK_H; TEX_ID = "SCBBV"; POSITION = 0,0; SIZE = 0,0; }; .. スクロールバーの方向 ============================ 縦方向のスクロールバーだけでなく横方向のスクロールバーも設定可能です。 スタイルに次の値を設定してください。 * 縦方向: ITEM_STACK_V * 横方向: ITEM_STACK_H .. _SCROLLBAR_DISPLAY_FLAG: スクロールバーの表示制御 ============================ スタイルに設定することによって、スクロールバーの表示/非表示のタイプを選択できます。 以下の３タイプから選べます。 **SCROLLBAR_DISPLAY_NORMAL(デフォルト)** 領域がスクロール可能で、かつその領域をタッチしてスクロールさせているときだけ表示します。 **SCROLLBAR_DISPLAY_SCROLLABLE** 領域がスクロール可能なときだけ表示します。 **SCROLLBAR_DISPLAY_ALWAYS** 常に表示します。 プロパティ ================== 代表的なデフォルト値 -------------------------- :: TEX_ID = "SCBRH"; STYLE = ITEM_STACK_V; COLOR = 1,1,1,1; **ID** = コントロールID ------------------------------------------- コントロールIDを定義します。 :: ID = 001_000_00010; .. note:: 設定しなかったときは、自動的にハッシュ値から生成します。 **POSITION** = Ｘ，Ｙ ------------------------------------------- 表示位置を決定します。 GROUPによって、関連付けされたコントロールからの相対位置になります。 :: POSITION = 0,16; .. 割合指定はできません。 **TEX_ID** = テクスチャID,パーツID ------------------------------------------- **TEX_ID** = パーツID ------------------------------------------- テクスチャIDとパーツIDを指定します。 **SIZE** = 横幅,縦幅 ---------------------------------------------- スクロールバーの表示サイズを指定します。 GROUPによって、関連付けされたコントロールサイズとの相対サイズになります。 :: SIZE = 0,0; //display size .. 割合指定はできません。 **COLOR** = R,G,B,A ------------------------------------------- カラーを指定します。 カラー変更することによって、含まれるコントロール全てに影響を与えます。 R,G,Bについては、0～2の間で指定してください。 1を超えたとき、そのカラー成分を2倍まで上げて表示することができます。 Aについては、0～1の間で指定してください。 .. _SCROLLBAR_DISPLAY_STYLE: .. _ANCHOR_SCROLLBAR: **STYLE** = フラグ0|フラグ1|..|フラグn ------------------------------------------------------------------ コントロールの表示アンカーを指定できます。 .. tabularcolumns:: |p{0.4\linewidth}|p{0.6\linewidth}| +--------------------------+---------------------------------------------------------------+ | 表示位置アンカーフラグ |説明 | +==========================+===============================================================+ |ANCHOR_DEFAULT |アンカー位置を左上に設定 | | | | | |ANCHOR_LEFTTOPと同じ | | | | | |コントロールの中心位置はデフォルトで、BASE_LEFTTOPになる。 | +--------------------------+---------------------------------------------------------------+ | ANCHOR_LEFTTOP |アンカー位置を左上に設定 | | | | | |コントロールの中心位置はデフォルトで、BASE_LEFTTOPになる。 | +--------------------------+---------------------------------------------------------------+ |ANCHOR_LEFTBOTTOM |アンカー位置を左に設定 | | | | | |縦には下辺を基準に配置 | | | | | |コントロールの中心位置はデフォルトで、BASE_LEFTBOTTOMになる。 | +--------------------------+---------------------------------------------------------------+ |ANCHOR_RIGHTTOP |アンカー位置を右上に設定 | | | | | |コントロールの中心位置はデフォルトで、BASE_RIGHTBOTTOMになる。 | +--------------------------+---------------------------------------------------------------+ |ANCHOR_RIGHTBOTTOM |アンカー位置を右に設定 | | | | | |縦には下辺を基準に配置 | | | | | |コントロールの中心位置はデフォルトで、BASE_RIGHTBOTTOMになる。 | +--------------------------+---------------------------------------------------------------+ 実際の配置は下図を参照ください。 .. image:: images/SCROLLBAR_align.png 機能を制限するスタイルは以下のものがあります。 .. tabularcolumns:: |p{0.4\linewidth}|p{0.6\linewidth}| +----------------------------+-----------------------------------------------------------------------------------------+ |機能制限スタイル |説明 | +============================+=========================================================================================+ |HIDE |表示を隠す。 | +----------------------------+-----------------------------------------------------------------------------------------+ |ITEM_STACK_V |スクロールバーの方向を縦方向に設定する | +----------------------------+-----------------------------------------------------------------------------------------+ |ITEM_STACK_H |スクロールバーの方向を横方向に設定する | +----------------------------+-----------------------------------------------------------------------------------------+ |SCROLLBAR_DISPLAY_NORMAL |領域がスクロール可能で、かつその領域をタッチしてスクロールさせているときだけ表示します。 | +----------------------------+-----------------------------------------------------------------------------------------+ |SCROLLBAR_DISPLAY_SCROLLABLE|領域がスクロール可能なときだけ表示します。 | +----------------------------+-----------------------------------------------------------------------------------------+ |SCROLLBAR_DISPLAY_ALWAYS |常に表示します。 | +----------------------------+-----------------------------------------------------------------------------------------+