# Find Dialog

## Creating the Dialog

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:

Example:
Above dialog was created with this line of code:
`result = dialog.findDialog(self)
`

Argument | Data type/Notes
self | the window (background) that is the parent for the dialog
OPTIONAL searchText | String defining the text for which to search
OPTIONAL wholeWordsOnly | 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
OPTIONAL caseSensitive | 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

## Interacting With the Dialog

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.

Name of value | Description
accepted | True = user clicked OK False = user clicked Cancel
searchText | String containing the text entered by the user for which the search is to be conducted
wholeWordsOnly | True = user checked "Whole Words Only" checkbox False = user did not check the checkbox
caseSensitive | True = user checked "Case Sensitive" checkbox False = user did not check the checkbox

Example:
The sample dialog shown at the top of this page returns the following results:
accepted: True
searchText: PythonCard
wholeWordsOnly: True
caseSensitive: False