Alert Dialog

Creating the Dialog

Create an Alert Dialog by calling dialog.alertDialog with the three arguments shown in the following table.

Argument	Data type/notes
self	the window (background) that is the parent for the dialog
message	quoted string of alert message to be displayed inside dialog
title	quoted string of text to be displayed in dialog's title bar

Example:

Above dialog was created with this line of code:

result = dialog.alertDialog(self, 'a message', 'a title')

Interacting With the Dialog

The alertDialog component returns two values, stored as elements of the Python dictionary called "results" returned by all PythonCard dialogs. These results are as shown in the following table.

Name of value	Description
accepted	True = user clicked OK False = user clicked Cancel
returned	string containing the name of the button clicked by the user

Example:

The sample dialog shown at the top of this page returns the following results when the user clicks its only button:

accepted: True
returned: Ok