7.7.8.12. GEL_Dialog()

Display a dialog in Code Composer Studio, or other tool if supported.

Syntax

GEL_Dialog( "dialog_text", "icon_type", "default_button", "button0_text", ["button1_text"], ... );

Parameters

dialog_text: The text to be displayed in the dialog.

icon_type: The icon to be displayed in the dialog. Must be one of "EXCLAMATION", "INFORMATION", "QUESTION", or "STOP".

default_button: The index of the button to be selected by default. The buttons are index starting at 0.

buttonN_text: The text of the N-th button. There must be at least one button.

Description

Requests an interactive dialog be presented to the user. This requires support from the tool using the debugger, like Code Composer Studio. This function will block until the dialog is closed. The index of the button clicked by the user will be returned. An error will be thrown if there is no support for dialogs or if the user dismisses the dialog.

Synchronous

Synchronous from GEL: Yes

Completely synchronous: No

Example

GEL_Dialog("I am a dialog!", "INFORMATION", 0, "OK", "CANCEL")