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
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
|
<!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>Find Dialog</title>
<meta name="generator" content="Namo WebEditor v5.0(Trial)">
</head>
<body>
<h1>Find Dialog</h1>
<img src="images/dialogsfig4.png" alt="Find Dialog Sample"
width="370" height="120">
<br>
<br>
<h2>Creating the Dialog</h2>
Create a Find Dialog by calling dialog.findDialog with the one required
and any or all of the three optional arguments shown in the table below:
<p><br>
<b>Example:<br>
<br>
</b>Above dialog was created with this line of code:<br>
<br>
<code>result = dialog.findDialog(self)<br>
</code><br>
</p>
<table border="1" width="80%">
<tr>
<td>
<p><b>Argument</b></p>
</td>
<td>
<p><b>Data type/Notes</b></p>
</td>
</tr>
<tr>
<td>
<p>self</p>
</td>
<td>the window (background) that is the parent
for the dialog
</td>
</tr>
<tr>
<td>
<p>OPTIONAL searchText</p>
</td>
<td>
<p>String defining the text for which to search</p>
</td>
</tr>
<tr>
<td>
<p>OPTIONAL wholeWordsOnly</p>
</td>
<td>
<p>Boolean value indicating whether to confine the search to strings
that contain the search text as a whole word rather than a substring.
True = search for whole words only; False = find all occurrences of the
search text</p>
</td>
</tr>
<tr>
<td>
<p>OPTIONAL caseSensitive</p>
</td>
<td>
<p>Boolean value indicating whether to confine the search to strings
that contain the search text exactly as provided including upper
and lower case letter sensitivity.. True = search for exact capitalization
match; False = find all occurrences of the search text</p>
</td>
</tr>
</table>
<h2>Interacting With the Dialog</h2>
The findDialog component returns four 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">searchText<br>
</td>
<td valign="top">String containing the text entered by the user
for which the search is to be conducted<br>
</td>
</tr>
<tr>
<td valign="top">wholeWordsOnly<br>
</td>
<td valign="top">True = user checked "Whole Words Only" checkbox<br>
False = user did not check the checkbox<br>
</td>
</tr>
<tr>
<td valign="top">caseSensitive<br>
</td>
<td valign="top">True = user checked "Case Sensitive" checkbox<br>
False = user did not check the checkbox<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:<br>
<b><br>
</b>accepted: True<br>
searchText: PythonCard<br>
wholeWordsOnly: True<br>
caseSensitive: False<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
</body>
</html>
|
