Control_QueryText

Prototype: GemRB.QueryText (WindowIndex, ControlIndex)

Metaclass Prototype: QueryText ()

Description: Returns the Text of a TextEdit/TextArea/Label control. In case of a TextArea, it will return the selected row, not the entire textarea.

Parameters:

• WindowIndex, ControlIndex - the control’s reference

Return value: string, may be empty

Examples:

Name = NameField.QueryText ()
GemRB.SetToken ('CHARNAME', Name)

The above example retrieves the character’s name typed into the TextEdit control and stores it in a Token (a string variable accessible to gamescripts, the engine core and to the guiscripts too).

GemRB.SetToken ('VoiceSet', TextAreaControl.QueryText ())

The above example sets the VoiceSet token to the value of the selected string in a TextArea control. Later this voiceset could be stored in the character sheet.

See also: Control_SetText, SetToken

---

Back to function index, GUIScript introduction.