Функция FindTextA (commdlg.h)

Статья
11/20/2024

Создает системное диалоговое окно "Поиск", позволяющее пользователю указать строку для поиска и параметров, используемых при поиске текста в документе.

Синтаксис

HWND FindTextA(
  [in] LPFINDREPLACEA unnamedParam1
);

Параметры

[in] unnamedParam1

Тип: LPFINDREPLACE

Указатель на структуру FINDREPLACE, содержащую сведения, используемые для инициализации диалогового окна. В диалоговом окне эта структура используется для отправки сведений о входных данных пользователя в приложение. Дополнительные сведения см. в следующем разделе "Примечания".

Возвращаемое значение

Тип: HWND

Если функция выполнена успешно, возвращаемое значение является дескриптором окна в диалоговом окне. Вы можете использовать дескриптор окна для взаимодействия или закрытия диалогового окна.

Если функция завершается ошибкой, возвращаемое значение равно NULL. Чтобы получить расширенные сведения об ошибке, вызовите функцию CommDlgExtendedError. CommDlgExtendedError может вернуть один из следующих кодов ошибок:

Замечания

Функция FindText не выполняет операцию поиска. Вместо этого диалоговое окно отправляет FINDMSGSTRING зарегистрированные сообщения в процедуру окна владельца диалогового окна. При создании диалогового окна hwndOwner элемент структуры FINDREPLACE является дескриптором окна владельца.

Перед вызовом FindTextнеобходимо вызвать функцию RegisterWindowMessage, чтобы получить идентификатор сообщения FINDMSGSTRING. Процедура диалогового окна использует этот идентификатор для отправки сообщений, когда пользователь нажимает кнопку Найти далее или при закрытии диалогового окна. Параметр lParam сообщения FINDMSGSTR ING содержит указатель на структуру FINDREPLACE. Флаги этой структуры указывают на событие, вызвавшее сообщение. Другие члены структуры указывают на входные данные пользователя.

Если вы создаете диалоговое окно "Поиск ", необходимо также использовать функцию IsDialogMessage в основном цикле сообщений приложения, чтобы убедиться, что диалоговое окно правильно обрабатывает ввод клавиатуры, такие как клавиши TAB и ESC. IsDialogMessage возвращает значение, указывающее, обрабатывается ли диалоговое окно поиска.

Вы можете предоставить процедуру перехватчика FRHookProc для диалогового окна Поиска. Процедура перехватчика может обрабатывать сообщения, отправленные в диалоговое окно. Чтобы включить процедуру перехватчика, задайте флаг FR_ENABLEHOOK в элементе флагов FINDREPLACE и укажите адрес процедуры перехватчика в элементе lpfnHook.

Примеры

Пример см. в разделе поиск текста.

Заметка

Заголовок commdlg.h определяет FindText как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 2000 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
целевая платформа	Виндоус
заголовка	commdlg.h (включая Windows.h)
библиотеки	Comdlg32.lib
DLL	Comdlg32.dll
набор API	ext-ms-win-shell-comdlg32-l1-1-1 (представлено в Windows 10 версии 10.0.14393)