Уведомление FINDMSGSTRING

Диалоговое окно Найти (Find) или Заменить (Replace) отправляет зарегистрированное сообщение FINDMSGSTRING оконной процедуре своего окна владельца, когда пользователь щелкает по кнопке Искать дальше (Find Next), Заменить (Replace) или Заменить все (Replace All), или закрывает диалоговое окно.

Синтаксис

FINDMSGSTRING
    WPARAM wParam
    lpFindReplace = (LPFINDREPLACE) lParam;

Параметры

wParam

Этот параметр не используется.

lpFindReplace

Указатель на структуру FINDREPLACE. Члены этой структуры содержат последний пользовательский ввод данных, включая строку поиска, строку замены (если она есть) и параметры поиска и замены.

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

Это сообщение значения не возвращает.

Замечания

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

Когда Вы создаете диалоговое окно, используете член hwndOwner структуры FINDREPLACE, чтобы идентифицировать окно, которое получает сообщения FINDMSGSTRING.

Член Flags структуры FINDREPLACE включает один из ниже перечисленных флажков, чтобы обозначить событие, которое стало причиной сообщения.

Флажок Предназначение

FR_DIALOGTERM Диалоговое окно закрывается. После того, как окно владелец обрабатывает это сообщение, дескриптор блока диалога больше не допустим.

FR_FINDNEXT Пользователь нажал кнопку Найти далее (Find Next) в диалоговом окне Найти (Find) или Заменить (Replace). Элемент lpstrFindWhat определяет строку для поиска.

FR_REPLACE Пользователь нажал кнопку Заменить (Replace) в диалоговом окне Заменить (Replace). Член структуры lpstrFindWhat задает символьную строку, которая заменяется, а член структуры lpstrReplaceWith задает строку замены.

FR_REPLACEALL Пользователь нажал кнопку Заменить все (Replace All) в диалоговом окне Заменить (Replace). Член структуры lpstrFindWhat определяет строку, которую надо заменить, а член lpstrReplaceWith определяет строку, которой надо заменить.

В сообщениях от кнопок Найти далее (Find Next) или Заменить все (Replace All), член структуры Flags, чтобы обозначить параметры поиска, может включать один или несколько следующих флажков:

Флажок Предназначение

FR_DOWN .Если установлен, среди "радио"-кнопок направления выбрана кнопка В конец документа (Down), указывая, что пользователь хочет искать от текущего расположения курсора до конца документа. Если FR_DOWN не установлен, выбрана кнопка В начало документа (Up), то есть пользователь хочет искать от курсора в начало документа.

FR_MATCHCASE Если установлен, в окошке флажка С учетом регистра (Match Case) проставляется "галочка", указывая, что пользователь хочет, чтобы поиск был чувствительным к регистру. Если FR_MATCHCASE не установлен, окошко флажка без "галочки", так что поиск должен осуществляться без учета регистра.

FR_WHOLEWORD Если установлен, в отмечаемом окошке Только слово целиком (Match Whole word only) проставляется "галочка", указывая, что пользователь хочет искать только целые слова, которые соответствуют строке для поиска. Если FR_WHOLEWORD не установлен, окошко для флажка без "галочки", так что вы будете также искать фрагменты слов, которые соответствуют строке для поиска.

Флажок	Предназначение
FR_DIALOGTERM	Диалоговое окно закрывается. После того, как окно владелец обрабатывает это сообщение, дескриптор блока диалога больше не допустим.
FR_FINDNEXT	Пользователь нажал кнопку Найти далее (Find Next) в диалоговом окне Найти (Find) или Заменить (Replace). Элемент *lpstrFindWhat* определяет строку для поиска.
FR_REPLACE	Пользователь нажал кнопку Заменить (Replace) в диалоговом окне Заменить (Replace). Член структуры lpstrFindWhat задает символьную строку, которая заменяется, а член структуры lpstrReplaceWith задает строку замены.
FR_REPLACEALL	Пользователь нажал кнопку Заменить все (Replace All) в диалоговом окне Заменить (Replace). Член структуры *lpstrFindWhat* определяет строку, которую надо заменить, а член *lpstrReplaceWith* определяет строку, которой надо заменить.

Флажок	Предназначение
FR_DOWN	.Если установлен, среди "радио"-кнопок направления выбрана кнопка В конец документа (Down), указывая, что пользователь хочет искать от текущего расположения курсора до конца документа. Если FR_DOWN не установлен, выбрана кнопка В начало документа (Up), то есть пользователь хочет искать от курсора в начало документа.
FR_MATCHCASE	Если установлен, в окошке флажка С учетом регистра (Match Case) проставляется "галочка", указывая, что пользователь хочет, чтобы поиск был чувствительным к регистру. Если FR_MATCHCASE не установлен, окошко флажка без "галочки", так что поиск должен осуществляться без учета регистра.
FR_WHOLEWORD	Если установлен, в отмечаемом окошке Только слово целиком (Match Whole word only) проставляется "галочка", указывая, что пользователь хочет искать только целые слова, которые соответствуют строке для поиска. Если FR_WHOLEWORD не установлен, окошко для флажка без "галочки", так что вы будете также искать фрагменты слов, которые соответствуют строке для поиска.

Смотри также

Обзор Библиотека стандартных диалоговых окон, Уведомления, используемые библиотекой стандартных диалоговых окон, CDN_FILEOK, FINDREPLACE, RegisterWindowMessage

Размещение и совместимость FINDMSGSTRING
Windows. NET Server	Да
Windows XP	Да
Windows 2000	Да
Windows NT	Да версии 3.1 и выше
Windows Me	Да
Windows 98	Да
Windows 95	Да
Минимальная версия DLL	Нет
Заголовочный файл
- объявлено в	Commdlg.h
- включено в	Windows.h
Unicode	Нет
Замечания по платформе	Не имеется

Назад в оглавление

На главную страницу

На оглавление справки