FindDialog

Object List Hierarchy Next Object

Definition:

FindDialog is a common dialog that gathers information from the user that is useful for performing a text-based search.

Specialized Features:

The following tables list and describe the properties, methods, and events added by FindDialog:

---

Properties Use to...

---

DisableMatchCase Control the enabling of the “Match Case” checkbox.

DisableUpDown Control the enabling of the “Direction” option buttons.

DisableWholeWord Control the enabling of the “Whole Word” checkbox.

FindString Set the default or indicate the value of the “Find String” textbox.

HideMatchCase Control the visibility of the “Match Case” checkbox.

HideUpDown Control the visibility of the “Direction” option buttons.

HideWholeWord Control the visibility of the “WholeWord” checkbox.

MatchCase Set the default or indicate the value of the “Match Case” checkbox.

MatchWholeWord Set the default or indicate the value of the “Match Case” checkbox.

SearchDown Set the default or indicate the value of the “Direction” option buttons.

---

Methods Use to...

---

Hide Remove the FindDialog from the screen.

Show Display the FindDialog on the screen.

---

Events Use to...

---

Find Perform an action each time the “Find Next” button is pressed.

Copied Features:

Properties Methods Events

Details:

The FindDialog displays a dialog that gathers information from a user that is useful in conducting a text-based search. Users can indicate a string to be searched for by typing in the “Find String” textbox. Checkboxes allow the user to inidcate whether or not to consider case in searching, and whether or not the search string must match whole words only. The user may also indicate in which direction, up or down, the search will go.

Before posting the dialog with the “Show” method, the search choices presented to the user on the dialog can be configured. By setting the appropriate properties, the checkboxes and option buttons on the dialog can be enabled, disabled, or even hidden. For example, to hide the “Match Case” check box, simpy set the HideMatchCase property to True prior to showing the dialog.

Each time the “Find Next” button is pressed, the Find event is triggered. The values of the MatchWholeWord, MatchCase, SearchDown, and FindString properties indicate the current state of the user’s choices for each option. The dialog disappears whenever the user clicks the “Cancel” button or the dialog’s Hide method is invoked.