Vcl.StdActns.TSearchFindFirst

From RAD Studio API Documentation
Jump to: navigation, search

Vcl.StdActns.TSearchFindVcl.StdActns.TSearchActionVcl.StdActns.TCommonDialogActionVcl.ActnList.TCustomActionSystem.Actions.TContainedActionSystem.Classes.TBasicActionTSearchFindFirst

Delphi

TSearchFindFirst = class(TSearchFind)

C++

class PASCALIMPLEMENTATION TSearchFindFirst : public TSearchFind

Properties

Type Visibility Source Unit Parent
class public
Vcl.StdActns.pas
Vcl.StdActns.hpp
Vcl.StdActns Vcl.StdActns

Description

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

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.

See Also