CONTAINER¶

C#: CWinCtrlContainer

It is a control for grouping multiple controls .

Size of the container is determined by the SIZE. The size of the virtual screen is determined by CONTENTS_SIZE.

When virtual screen size is larger than the display size , it is possible to scroll the container.

This control is scrollable control.

if you set SCROLL_LOCK to STYLE property, the window system calls onDrag when you drag these controls.And you can get a dragged direction of these controls.Even if you set DRAG to STYLE property, these controls do not affect anything.

CONTAINER(Control name) {

Property 1;

Property 2;

:

:

Property n

};

Example¶

WINDOW(255_000_00001) {
  STYLE = NOTITLEBAR|ANCHOR_CENTER;
  POSITION = 0,100;
  SIZE = 512,256;
  TEX_ID = 100_010_00000;
};

$w = 400;
CONTAINER(Map) {
  ID = 000_000_000100;
  POSITION = 0,0;
  SIZE = {100},{100};
  CONTENTS_SIZE = 640,1136;
  COLOR = COLOR32(255,255,255,255);
  CONTENTS = {
    TEXTURE(Map) {
      ID = 000_000_000110;
      SIZE = 640,1136;
      PRIORITY = -1;
      POSITION = 0,0;
      TEX_ID = 0,"MAP2";
    };
  };
};

_images/CONTAINER.png

Property¶

Default value¶

COLOR = 1,1,1,1;
CAPTION_COLOR = 1,1,1,1;

ID = Control ID¶

Define the control ID.
ID = 001_000_00010;
Note

If you don’t set the ID, it generates automatically from the hash value.

POSITION = X, Y ¶

Determine the display position. The base position changes according to the anchor in STYLE.
POSITION = 32,{50} + 64;
Coordinates can be specified as a percentage .

SIZE = width,height ¶

It changes the display size. If it is omitted , or , you specify 0 ,it gets the size from the texture parts.
SIZE = 512,512;       //512x512
SIZE = {50} - 100,{50} + 100; //screen width * 0.5 - 100,screen height * 0.5 + 100
Size can be specified as a percentage .

CONTENTS_SIZE = width, height ¶

It defines the size of the virtual screen .

When virtual screen size is larger than the display size , it is possible to scroll the container.
SIZE = 400,400;               //display size
CONTENTS_SIZE = 800,800;      //virtual screen size
Contents size can be specified as a percentage .

CONTENTS = { control define … }¶

It lists the control that contained in the CONTAINER.

Coordinates of the controls in the contents is placed in a relative coordinate from the CONTAINER.

It is possible to include any type of control .
CONTENTS = {
   BUTTON(A) {
      :
   };
   CHECKBOX(B) {
      :
   };
   LISTBOX(C) {
      :
   };
};
Method of accessing content using C # : here

Note

The coordinate and size ratio specifications for controls in the content are calculated relative to the size of the container.

Note that it is not a window size.

COLOR = R,G,B,A¶

It is possible to set the color values . By changing color , it affects all of the controls that are included .

Set R, G, B in the range of 0…2 .

If you set a value in excess of one , each color component can double the brightness.

Set A in the range of 0…1 .

GROUP = SCROLLBAR Control ID,…¶

If you set scroll controls to the GROUP property,it display scroll bars in conjunction with the container.

It should be careful not to set to CONTENTS.

It is also possible to assign multiple scrollbars.
GROUP = SCROLLBAR(Horizon),SCROLLBAR(Vertical);

STYLE = Flag0|Flag1|..|Flagn¶

Container-specific styles are as follows.

Container control flag	Description
NOBOUNCES	When you’ve stopped it to scroll ,it is stopped even if there are still the momentum.
SCROLL_UNLOCK	Enable the scroll of contents.
SCROLL_LOCK	Disable the scroll of contents.

You can set the display anchor of control.

Display position anchor flag	Description
ANCHOR_DEFAULT	Set the anchor position in the upper left Same as ANCHOR_LEFTTOP The default control center position is set to BASE_LEFT.
ANCHOR_LEFTTOP	Set the anchor position in the upper left The default control center position is set to BASE_LEFT.
ANCHOR_LEFT	Set the anchor position to the left. And vertical centering The default control center position is set to BASE_LEFT.
ANCHOR_LEFTBOTTOM	Set the anchor position to the left. Located along the lower edge The default control center position is set to BASE_LEFTBOTTOM.
ANCHOR_TOP	Set the anchor position to the upper side Centering at lateral. The default control center position is set to BASE_TOP.
ANCHOR_CENTER	Set the anchor position in the center of the window The default control center position is set to BASE_CENTER.
ANCHOR_BOTTOM	Set the anchor position at the bottom Centering at lateral. The default control center position is set to BASE_BOTTOM.
ANCHOR_RIGHTTOP	Set the anchor position in the upper right The default control center position is set to BASE_RIGHTBOTTOM.
ANCHOR_RIGHT	Set the anchor position to the right And vertical centering The default control center position is set to BASE_RIGHT.
ANCHOR_RIGHTBOTTOM	Set the anchor position to the right Located along the lower edge The default control center position is set to BASE_RIGHTBOTTOM.

You can set the center position of the control.

Base position change flag	Description
BASE_DEFAULT	It varies depending on the anchor flag . If you do not specifically set , this value is set . See the description of each anchor flag
BASE_LEFTTOP	Set the center position to the upper left side.
BASE_LEFT	Set the center position to the left side. and vertical centering.
BASE_LEFTBOTTOM	Set the center position to the bottom left side.
BASE_TOP	Set the center position to the upper side. and horizontal centering
BASE_CENTER	Set the center position to the center.
BASE_BOTTOM	Set the center position to the bottom side. And horizontal centering.
BASE_RIGHTTOP	Set the center position to the upper right side.
BASE_RIGHT	Set the center position to the right side. and horizontal centering
BASE_RIGHTBOTTOM	Set the center position to the bottom right side.

Style that limits the function as follows .

Function limit style	Description
HIDE	Hide.
DISABLE	It is not able to pressing the control. And the control color darken.
NOHIT	It is not able to pressing the control.
NOBOUNCES	When you’ve stopped it to scroll ,it is stopped even if there are still the momentum.
SCROLL_UNLOCK	Enable the scroll of contents.
SCROLL_LOCK	Disable the scroll of contents.