FindText

Функция FindText создает определяемые системой modeless диалоговое окно Поиск , позволяет пользователю указать строку поиска и опции для поиска текста в документе.

() HWND FindText LPFINDREPLACE  переобучение / / указатель на структуру с инициализации / / данные);
 

Параметры

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

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

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

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

CDERR_FINDRESFAILURE CDERR_MEMLOCKFAILURE
CDERR_INITIALIZATION CDERR_NOHINSTANCE
CDERR_LOCKRESFAILURE CDERR_NOHOOK
CDERR_LOADRESFAILURE CDERR_NOTEMPLATE
CDERR_LOADSTRFAILURE CDERR_STRUCTSIZE
CDERR_MEMALLOCFAILURE FRERR_BUFFERLENGTHZERO

Примечания

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

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

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

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

QuickInfo

nbsp; Windows &NT: требует версии 3.1 или более поздней версии.
Windows:Требует Windows 95 или более поздней версии.
Windows CE:Не поддерживается.
Заголовок:Объявленные в commdlg.h.
Импорта библиотеки:Используйте comdlg32.lib.
Юникод:В версии Юникода и ANSI в Windows NT.

Родственные слова

Общие диалогового окна Обзор библиотеки, Общие функции диалогового окна Box, CommDlgExtendedError, FINDMSGSTRING, FINDREPLACE, FRHookProc, IsDialogMessage, RegisterWindowMessage, ReplaceText

Index