Difference between revisions of "ShowPopup"

From Dragon Age Toolset Wiki
Jump to: navigation, search
(formatting)
m (Fixing category)
 
(8 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 
{{dafunction
 
{{dafunction
|name=ShowPopup
+
|name         = ShowPopup
|brief= Shows the user a popup window with an optional text entry field and up to four buttons
+
|brief         = Show a pop-up message box.
|returntype=void
+
|param1type   = int
|param1type=int
+
|param1name   = nMessageStrRef
|param1name=nMessageStrRef
+
|param1desc   = a string reference to the text of the message box
|param1desc=a string reference to the text of the message box.
+
|param1default =
|param2type=int
+
|param2type   = int
|param2name=nPopupType
+
|param2name   = nPopupType
|param2desc=a reference to the popup type, defined in [[popups.xls]]
+
|param2desc   = a reference to the popup type, defined in [[popups 2da]]
|param3type=object
+
|param2default =
|param3name=oOwner
+
|param3type   = object
|param3desc=the owner of this popup
+
|param3name   = oOwner
|param3default=OBJECT_INVALID
+
|param3desc   = the owner of this popup
|param4type=int
+
|param3default = OBJECT_INVALID
|param4name=bShowInputField
+
|param4type   = int
|param4desc=a boolean which controls whether the pop-up will have a text-input field.
+
|param4name   = bShowInputField
|param4default=FALSE
+
|param4desc   = a boolean which controls whether the pop-up will have a text-input field
|param5type=int
+
|param4default = FALSE
|param5name=nDefaultInputStrRef
+
|param5type   = int
|param5desc=a string reference to the default text for the text-input. If 0, the input field will start empty.
+
|param5name   = nDefaultInputStrRef
|param5default=0
+
|param5desc   = a string reference to the default text for the text-input. If 0, the input field will start empty
|sourcefile=script.ldf
+
|param5default = 0
|sourcemodule=
+
|returntype    = void
 +
|returndesc    =
 +
|sourcefile   = script.ldf
 +
|sourcemodule =  
 
}}
 
}}
  
When a button is pressed and the pop-up is closed, the contents of the text-entry field will be returned as the 0th string argument to the [[EVENT_TYPE_POPUP_RESULT]] [[event]] to the [[module]].
+
<!-- == Description == -->
 +
<!-- This section contains the full description from the functions comments. Do not change unless you are confident these are incomplete or incorrect. -->
 +
== Remarks ==
 +
<!-- This section contains additional comments, observations and known issues. -->
 +
When a button is pressed and the pop-up is closed, the contents of the text-field will be returned as the 0th string argument to the [[EVENT_TYPE_POPUP_RESULT]] event to the module.
  
Text is filtered as it's typed using the same filter that's applied to the player's name; thus, you cannot enter spaces nor many forms of punctuation. The text-field is currently limited to 20 characters (same as the player name).
+
The text is filtered as it is typed using the same filter that is applied to the player's name; thus, you cannot enter spaces nor many forms of punctuation. The text-field is currently limited to 20 characters (same as the player name).  
 
+
<!-- == Examples == -->
[[Category:Scripts]]
+
<!-- This section contains examples transcluded from the snippet library. -->
 +
<!-- == See also == -->
 +
<!-- This section contains links to articles, functions or constant groups. -->
 +
[[Category:GUI functions]]

Latest revision as of 00:04, 11 February 2013

Show a pop-up message box.

void ShowPopup(
int nMessageStrRef,
int nPopupType,
object oOwner = OBJECT_INVALID,
int bShowInputField = FALSE,
int nDefaultInputStrRef = 0
);
Parameters:
nMessageStrRef
a string reference to the text of the message box
nPopupType
a reference to the popup type, defined in popups 2da
oOwner
the owner of this popup
bShowInputField
a boolean which controls whether the pop-up will have a text-input field
nDefaultInputStrRef
a string reference to the default text for the text-input. If 0, the input field will start empty
Returns:

Nothing.

Source:

script.ldf

Remarks

When a button is pressed and the pop-up is closed, the contents of the text-field will be returned as the 0th string argument to the EVENT_TYPE_POPUP_RESULT event to the module.

The text is filtered as it is typed using the same filter that is applied to the player's name; thus, you cannot enter spaces nor many forms of punctuation. The text-field is currently limited to 20 characters (same as the player name).