Using the CSV_Include Project > CSV_Include Reference > CSV_Include Functions > CSV_MessageBox

CSV_MessageBox

Displays a message box centered on the active monitor screen and waits for the user to select a button. Can display up to three buttons, as well as a checkbox. Can disappear after specified timeout. The maximum timeout is 30s if this is used. If 0 is passed in then no timeout applies.

When using 1,2 or 3 custom buttons: due to the way the underlying widget works, 1 or 2 button custom popups do not have the Cancel or Timeout Feature. The 3 button version does have Timeout. It is recommended when using 2 buttons to use this syntax :

"button1", "button2", "Cancel"

This will allow your 2 button selection to have a timeout feature. In this example your Cicode needs to use the '2' button reply as meaning cancel (299).

Error 359 is returned when a 2nd popup is attempts to display with the same title. The location of the message box is the same so multiple popup boxes // can be problematic.

Syntax

CSV_MessageBox(sTitle,sPrompt,iMode,iTimeout,sButton1Text,sButton2Text,sButton3Text,sCheckboxText)

#sTitle:

Message box title

#sPrompt:

Message box prompt

#iMode :

#iTimeout:

The number of seconds before the message box disappears.

#sButton1Text:

Text for first button

#sButton2Text:

Text for second button

#sButton3Text:

Text for third button

#sCheckBoxText:

Text for the checkbox

Return Value

If sButtonText1="" OR the 3 TextBoxes are in use then:

Return Value Description
0 OK button pressed
299 Cancel button pressed
359 A Popup with the same title is already displayed
512 A timeout has occurred
3 Abort button pressed
4 Retry button pressed
5 Ignore button pressed
6 Yes button pressed
7 No button pressed

Else:

Return Value Description
0 First button pressed
1 Second button pressed
2 Third button pressed
359 A Popup with the same title is already displayed

If sCheckBoxText <> "" then 1024 is added to the above return values.