select() [1/2]

int select	(	char const *	titleText,
		char const *	messageText,
		char const *	itemsText,
		char	separator = ';',
		char const *	buttonCancelText = "Cancel",
		char const *	buttonOKText = "OK",
		int	OKAfter = 0
	)

Shows a dialog with a label and a list box.

Parameters

titleText	Optional title of the dialog (nullptr = the dialogs hasn't a title)
messageText	Message to show
itemsText	String containing a separated list of items to show into the listbox
separator	Optional items separator. Default is ';'
buttonCancelText	Optional text for CANCEL button (nullptr = hasn't CANCEL button). Default is "Cancel".
buttonOKText	Optional text for OK button (nullptr = hasn't OK button). Default is "OK".
OKAfter	If >0, OK is automatically trigged after specified number of seconds

Returns

Index of the selected item or -1 if dialog has been canceled

Example:

InputBox ib;
ib.begin();
int s = ib.select("Download Boot Disk", "Select boot disk to download", "FreeDOS;Minix 2.0;MS-DOS 3.3");
ib.messageFmt("", nullptr, "OK", "You have selected %d", s);
ib.end();

Definition at line 138 of file inputbox.cpp.