menubutton
A button showing the user a mousemenu when pressed. This requires a ds_list to be used, which cannot be set trough the designer and MUST be set trough code using the variable dslist. Can draw some optional text.
- dslist[-1]: Which ds list to use for the menu. Each item in this ds_list will be one item inside inside the menu. The list can contain both strings and reals.
- actionlist[-1]: A ds list that holds references to scripts that will be executed when the corresponding item in the menu has been clicked. See mousemenu for more info.
- enabledlist[-1]: A list which should contain booleans which specify if an item in the mouse list is either enabled or disabled. See mousemenu for more info.
- menutemplate[-1]: Set to a script which can act to change the style of the mousemenu if you desire this. One argument will be passed which is the instance id of the menuobject. Leave at -1 for no script and the default look of the mousemenu.
- text[""]: What text to draw on the center of the button. Leave this empty if you don't want text.
- textcolor[c_black]: The color text should have.
- font[-1]: The font to use, a value of -1 means font will be ignored.
This object has a background, and all it's associated variables about which you can learn more here
These default background values are used in this object:
texturescript = uiz_back_sprite
texturescript_over = -1
texturescript_in = -1
texturescript_out = -1
sprite_normal = spr_uiZ_menudots
color_normal = c_white
margin_normal = 0
sprite_texturemode = uiz_texturemode_fill
border_texturemode = -1
sprite_over = -1
color_over = c_ltgray
margin_over = -1
sprite_in = -1
color_in = c_gray
margin_in = -1
sprite_out = -1
color_out = c_dkgray
margin_out = -1
-
uiz_mousebutton_setlist(instanceid,list,actionlist,enabledlist):
- instanceid: the instance id of the instance you want to modify
- list[-1]: Which ds list to use for the menu. Each item in this ds_list will be one item inside inside the menu. The list can contain both strings and reals.
- actionlist[-1]: A ds list that holds references to scripts that will be executed when the corresponding item in the menu has been clicked. See mousemenu for more info.
- enabledlist[-1]: A list which should contain booleans which specify if an item in the mouse list is either enabled or disabled. See mousemenu for more info.
-
uiz_mousebutton_settext(instanceid,text):
- instanceid: the instance id of the instance you want to modify
- text[""]: What text to draw on the center of the button. Set this to a blank string if you don't want text.
-
uiz_mousebutton_settextsettings(instanceid,color,font):
- instanceid: the instance id of the instance you want to modify
- color[c_black]: The color text should have.
- font[-1]: The font to use, a value of -1 means font will be ignored.
-
uiz_mousebutton_setmenutemplate(instanceid,menutemplate):
- menutemplate[-1]: Set to a script which can act to change the style of the mousemenu if you desire this. One argument will be passed which is the instance id of the menuobject. Leave at -1 for no script and the default look of the mousemenu.
- meunuis: Whether the item selection menu is showing right now.
- update: True whenever the user has clicked the button to open the menu.
- updated: True whenever the user has clicked an item in the menu.
- selected: The ds list position of the item that has been clicked in the menu. (only usable while updated is set to true)
