ReplaceText

ReplaceText функция создает определенный системой немодальное диалоговое окно, позволяет пользователю указать строку поиска и строку замены, а также опции для управления поиска и замены операций.

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

Параметры

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

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

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

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

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

Примечания

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

Перед вызовом ReplaceText, необходимо вызвать функцию 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, FINDREPLACE, FRHookProc, IsDialogMessage, RegisterWindowMessage, WM_CTLCOLORDLG

Index