Shows a modal dialog to edit a multiline text.

Creation and Show

int IupGetText(const char* title, char *text, int maxsize); [in C]
iup.GetText(title, text: string[, maxsize: number]) -> (text: string) [in Lua]

text: It contains the initial value of the text and the returned text. It must have room for the edited string with at least maxsize lenght. In Lua the default maxsize if 10240. (maxsize since 3.17)

Returns: a non zero value if successful. In Lua returns the text or nil if an error occurred.


The function does not allocate memory space to store the text entered by the user. Therefore, the text parameter must be large enough to contain the user input. The returned string is limited to maxsize characters. In Lua the

The dialog uses a global attribute called "PARENTDIALOG" as the parent dialog if it is defined. It also uses a global attribute called "ICON" as the dialog icon if it is defined.


See Also

IupMessage, IupScanf, IupListDialog, IupAlarm, IupSetLanguage.