FindText

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

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

Параметри

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

Повернення значень

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

Якщо функцію не вдається, значення, що повертається, є NULL. Для отримання інформації розширена помилка, викликати функцію CommDlgExtendedError . CommDlgExtendedError може повернути один з таких кодів помилки:

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

Зауваження

Функція FindText виконує операцію пошуку. Замість того, діалогове вікно надсилання FINDMSGSTRING зареєстрованих повідомлень вікна процедура діалогового вікна власника. Під час створення діалогового вікна, член hwndOwner FINDREPLACE структури ідентифікує власника вікна.

Перед викликом FindText, ви повинні викликати функцію 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, FINDMSGSTRING, FINDREPLACE, FRHookProc, IsDialogMessage, RegisterWindowMessage, ReplaceText

Index