Win32 API. Справочник по стандартному диалоговому окну
Страница 31. Зарегистрированное сообщение FINDMSGSTRING


Зарегистрированное сообщение FINDMSGSTRING

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

Синтаксис

MessageID = RegisterWindowMessage(FINDMSGSTRING);
wParam = 0;
lpfr = (LPFINDREPLACE) lParam;

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

Возвращаемые значения
Возвращаемых значений нет.

Замечания
Вы должны определить константу FINDMSGSTRING при вызове функции RegisterWindowMessage, чтобы получить идентификатор для сообщения, переданного диалоговым окном.
Когда вы создаете блок диалога, чтобы идентифицировать окно, которое примет сообщения FINDMSGSTRING, используете элемент hwndOwner структуры FINDREPLACE.
Элемент Flags структуры FINDREPLACE включает в себя один из следующих флажков, чтобы указать событие, которое стало причиной сообщения:

  • FR_DIALOGTERM - Диалоговое окно закрывается. После того, как окно владельца обрабатывает это сообщение, дескриптор блока диалога больше не правилен.
  • FR_FINDNEXT - Пользователь нажал кнопку Найти далее (Find Next) в диалоговом окне Найти (Find) или Заменить (Replace). Элемент lpstrFindWhat определяет строку, для поиска.
  • 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 не установлен, окошко для флажка без "галочки", так что вы должны также искать фрагменты слова, которые соответствуют строке для поиска.

Смотри также
FINDREPLACE, RegisterWindowMessage

Размещение и совместимость FINDMSGSTRING

Windows NTДа 
Win95Да
Win32sДа
Импортируемая библиотека-
Заголовочный файлcommdlg.h
UnicodeWinNT
Замечания по платформеНе имеется

 

 
« Предыдущая статья   Следующая статья »