<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="content-type"
content="text/html; charset=ISO-8859-1">
<meta name="author" content="Dan Shafer">
<title>Multiple Choice Dialog</title>
</head>
<body>
<h1>Multiple Choice Dialog</h1>
<img src="images/dialogsfig1.png"
alt="Multiple Choice Dialog Sample" width="200" height="200">
<br>
<br>
<h2>Creating the Dialog</h2>
Create a Multiple Choice Dialog by calling dialog.multipleChoiceDialog
with the four arguments shown in the following table.<br>
<br>
<table cellpadding="2" cellspacing="2" border="1" width="50%">
<tbody>
<tr>
<td valign="top"><b>Argument</b><br>
</td>
<td valign="top"><b>Data type/notes</b><br>
</td>
</tr>
<tr>
<td valign="top">self<br>
</td>
<td valign="top">the window (background) that is the parent for
the dialog<br>
</td>
</tr>
<tr>
<td valign="top">message<br>
</td>
<td valign="top">string to be displayed inside the dialog as
a prompt for the user<br>
</td>
</tr>
<tr>
<td valign="top">title<br>
</td>
<td valign="top">string to be displayed in the title bar of the
dialog<br>
</td>
</tr>
<tr>
<td valign="top">lst<br>
</td>
<td valign="top">list of strings containing the choices to be presented
to the user<br>
</td>
</tr>
</tbody>
</table>
<br>
<b>Example:<br>
<br>
</b>Above dialog was created with this line of code:<br>
<br>
<code>result = dialog.multipleChoiceDialog(self, "message", "title",
['one', 'two', 'three'])</code><br>
<h2>Interacting With the Dialog</h2>
The multipleChoiceDialog 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.<br>
<br>
<table cellpadding="2" cellspacing="2" border="1" width="50%">
<tbody>
<tr>
<td valign="top"><b>Name of value</b><br>
</td>
<td valign="top"><b>Description</b><br>
</td>
</tr>
<tr>
<td valign="top">accepted<br>
</td>
<td valign="top">True = user clicked OK<br>
False = user clicked Cancel<br>
</td>
</tr>
<tr>
<td valign="top">selection<br>
</td>
<td valign="top">list of strings containing the options
chosen by the user. <br>
</td>
</tr>
</tbody>
</table>
<br>
<b>Example:<br>
<br>
</b> The sample dialog shown at the top of this page returns the following
results:<b><br>
<br>
</b>accepted: True<br>
selection: ('one', 'three')<br>
<br>
<br>
<br>
<br>
</body>
</html>
distrib
>
Mandriva
>
2010.0
>
i586
>
media
>
contrib-release
>
by-pkgid
>
5f5d88c6b2988e78ee210e72f14d11ca
>
files
>
828
