ReplaceText

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

(HWND ReplaceText LPFINDREPLACE  lpfr / / вказівник на структуру з ініціалізації / / даних);
 

Параметри

lpfr
Вказівник на 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 в основний цикл вашого застосування забезпечити, що діалогове вікно правильно обробляє введення клавіатури, наприклад клавіші tab і 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.

Дивіться також

Загальний огляд бібліотеки діалогового вікна, Загальні діалоговому вікні функції, CommDlgExtendedError, FINDREPLACE, FRHookProc, IsDialogMessage, RegisterWindowMessage, WM_CTLCOLORDLG