1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
|
<!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>
|
