popup_string

uiz_popup_string(text,windowtext,blockbackground,default string,[optional]font)

Allows you to create a quick popup message with an "ok" button. The size of the popup will be automatically adjusted depending on the string.

Returns the id of a windowid or frameid, depending on the value of argument 2(block background).

Function

• uiz_popup_string(text,windowtext,blockbackground,default string,[optional]font):
  • text: The text to be displayed withing the message.
  • windowtext: the name of the window displayed in the left top.
  • block background: bool whether to create a half opaque gray pane preventing any mouse clicks in the background.
  • default string: The pre-filled string to be put into the obj_uiZ_stringbox object.
  • font: optional. Set the font of argument 0(text).

How to customize even further

The window exists out of the following objects:

• obj_uiZ_window
• obj_uiZ_text
• obj_uiZ_square: if block background is on.
• obj_uiZ_popupok
• obj_uiZ_stringbox

In the examples below, "r" refers to the returned item by uiz_popup_ok(). You can use the following variables:

• The obj_uiZ_window object can always be accessed trough "r.window".
• The obj_uiZ_text object can always be accessed trough "r.textlines".
• The obj_uiZ_square can be accessed trough "r.square", but only if argument2 is true.
• The obj_uiZ_stringbox can be accessed trough "r.stringbox".
• The obj_uiZ_popupok object can always be accessed trough "r.popup"

Look at the other articles on how these objects work, and how they can be customized.

obj_uiZ_popupok acts as the ok button has the following customizable properties:

• color: the image blend of the sprite used for the button
• sprite: the sprite used for the button (img 0=normal,1=mouseover,2=mousein)
• spraddto: if you have a sprite with multiple buttons in it you can set this to "3" for example to make: (img 3=normal,4=mouseover,5=mousein);
• text: The text on the button, not in the window;
• textcolor:** the color of the text in the button;

Detecting when "ok" has been pressed

this can be done using the following if statement in a step event:

if instance_exists(r) and r.indestroy=1 then{
string=r.str;
}

One thing to note is that the window needs to have an animation that takes at least one step, which is true by default.