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.


  • WindowIndex, ControlIndex - the control’s reference

Return value: string, may be empty


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, accessing_gui_controls

Back to function index, GUIScript introduction.