TSearchFindFirst Class

TSearchFindFirst is the standard action for displaying a find dialog that looks for the first occurrence of a string.

Pascal

TSearchFindFirst = class(TSearchFind);

C++

class TSearchFindFirst : public TSearchFind;

File

StdActns

Description

Add TSearchFindFirst to an action list to add a modeless find dialog to your application. Controls such as menu items and tool buttons linked to this action cause the application to display the find dialog or bring it to the fore.

TSearchFindFirst is designed to work with an edit control (TCustomEdit descendant) as a target. It automatically disables itself if the active control in a form is not an edit control.

Search actions represent a modeless dialog. As a result, the OnAccept event occurs not when the user exits the dialog, but when the dialog first appears or comes into focus. When the user directs the dialog to search for a string, TSearchFindFirst automatically performs that search, selecting the specified text in the target edit control. Unlike the TSearchFind action, which locates the first occurrence of the search string following the cursor position in the edit control, TSearchFindFirst locates the first occurrence of the search string, regardless of the cursor position.