Структура FINDREPLACEA (commdlg.h)
Содержит сведения о функциях FindText и ReplaceText, используемых для инициализации диалоговых окон Поиска и замены. Зарегистрированное сообщение
Синтаксис
typedef struct tagFINDREPLACEA {
DWORD lStructSize;
HWND hwndOwner;
HINSTANCE hInstance;
DWORD Flags;
LPSTR lpstrFindWhat;
LPSTR lpstrReplaceWith;
WORD wFindWhatLen;
WORD wReplaceWithLen;
LPARAM lCustData;
LPFRHOOKPROC lpfnHook;
LPCSTR lpTemplateName;
} FINDREPLACEA, *LPFINDREPLACEA;
Члены
lStructSize
Тип: DWORD
Длина структуры в байтах.
hwndOwner
Тип: HWND
Дескриптор окна, которому принадлежит диалоговое окно. Процедура окна указанного окна получает сообщения FINDMSGSTRING из диалогового окна. Этот элемент может быть любым допустимым дескриптором окна, но он не должен быть NULL.
hInstance
Тип: HINSTANCE
Если флаг
Flags
Тип: DWORD
Набор битовых флагов, которые можно использовать для инициализации диалогового окна. В диалоговом окне задаются эти флаги при отправке FINDMSGSTRING зарегистрированное сообщение, указывающее входные данные пользователя. Этот элемент может быть одним или несколькими из следующих значений.
| Ценность | Значение |
|---|---|
|
Если задано в сообщении findMSGSTRING |
|
Если задано, кнопка |
|
Включает функцию перехватчика, указанную в элементе lpfnHook. Этот флаг используется только для инициализации диалогового окна. |
|
Указывает, что элементы hInstance |
|
Указывает, что элемент hInstance |
|
Если задано в сообщении FINDMSGSTRING, указывает, что пользователь нажимал кнопку "Найти следующую" в диалоговом окне "Найти" или "Заменить". Элемент lpstrFindWhat указывает строку для поиска. |
|
Если задано при инициализации диалогового окна поиска, скрывает переключатели направления поиска. |
|
Если задано при инициализации диалогового окна |
|
Если задано при инициализации диалогового окна "Найти" или "Заменить", скроется флажок Совпадение всего слова. |
|
Если задано, установлен флажок Регистр соответствия, указывающий, что поиск должен быть учитывает регистр. Если этот флажок не задан, флажок не выбран, поэтому поиск должен быть нечувствительным к регистру. Этот флаг можно задать для инициализации диалогового окна. Если задано в сообщении FINDMSGSTRING |
|
Если задано при инициализации диалогового окна "Найти |
|
Если задано при инициализации диалогового окна "Поиск" |
|
Если задано при инициализации диалогово |
|
Если задано в сообщении FINDMSGSTRING |
|
Если задано в сообщении |
|
Вызывает диалоговое окно для отображения кнопки справки. Элемент |
|
Если задано, установлен флажок Совпадение всего слова только, указывающий, что следует искать только целые слова, соответствующие строке поиска. Если не задано, флажок не выбран, поэтому следует также искать фрагменты слов, соответствующие строке поиска. Этот флаг можно задать для инициализации диалогового окна. Если задано в сообщении FINDMSGSTRING |
lpstrFindWhat
Тип: LPTSTR
Строка поиска, введенная пользователем в элементе управления Find What edit. Необходимо динамически выделить буфер или использовать глобальный или статический массив, чтобы он не вышел из области, прежде чем диалоговое окно закрывается. Буфер должен содержать не менее 80 символов. Если буфер содержит строку при инициализации диалогового окна, строка отображается в элементе управления Find What edit. Если сообщение
lpstrReplaceWith
Тип: LPTSTR
Строка замены, введенная пользователем в элементе управления Replace With edit. Необходимо динамически выделить буфер или использовать глобальный или статический массив, чтобы он не вышел из области, прежде чем диалоговое окно закрывается. Если буфер содержит строку при инициализации диалогового окна, строка отображается в элементе управления "Заменить на".
Если сообщение
Функция FindText игнорирует этот элемент.
wFindWhatLen
Тип: WORD
Длина буфера в байтах, на которую указывает элемент lpstrFindWhat.
wReplaceWithLen
Тип: WORD
Длина буфера в байтах, на который указывает элемент lpstrReplaceWith.
lCustData
Тип: LPARAM
Определяемые приложением данные, которые система передает процедуре перехватчика, определяемой элементом lpfnHook. Когда система отправляет сообщение WM_INITDIALOG в процедуру перехватчика, параметр lParam сообщения является указателем на структуру FINDREPLACE, указанную при создании диалогового окна. Процедура перехватчика может использовать этот указатель для получения значения lCustData.
lpfnHook
Тип: LPFRHOOKPROC
Указатель на процедуру перехватчика FRHookProc, которая может обрабатывать сообщения, предназначенные для диалогового окна. Этот элемент игнорируется, если флаг FR_ENABLEHOOK не задан в элементе Flags. Если процедура перехватчика возвращает FALSE в ответ на сообщение WM_INITDIALOG, процедура перехватчика должна отображать диалоговое окно или другое диалоговое окно не будет отображаться. Для этого сначала выполните другие операции рисования, а затем вызовите функции ShowWindow и UpdateWindow.
lpTemplateName
Тип: LPCTSTR
Имя ресурса шаблона диалогового окна в модуле, определяемом элементом hInstance. Этот шаблон заменен стандартным шаблоном диалогового окна. Для ресурсов нумерованного диалогового окна это может быть значением, возвращаемым макросом MAKEINTRESOURCE. Этот элемент игнорируется, если флаг FR_ENABLETEMPLATE не задан в элементе Flags.
Замечания
Заметка
Заголовок commdlg.h определяет FINDREPLACE как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Windows 2000 Профессиональный [только классические приложения] |
| минимальный поддерживаемый сервер | Windows 2000 Server [только классические приложения] |
| заголовка | commdlg.h (включая Windows.h) |
См. также
библиотека общих диалоговых окон
концептуальные
Справочник