На главную

On-line справка по Win32 API

Написать письмо
БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО!
Список всех статей A-B-C-D-E-F-G-H-I-J-K-L-M-N-O-P-Q-R-S-T-U-V-W-X-Y-Z | Скачать Вниз

ReplaceText



The ReplaceText function creates a system-defined modeless dialog box that lets the user specify a string to search for and a replacement string, as well as options to control the find and replace operations.

HWND ReplaceText(

LPFINDREPLACE lpfr // pointer to structure with initialization data
);


Parameters

lpfr

Pointer to a FINDREPLACE structure that contains information used to initialize the dialog box. The dialog box uses this structure to send information about the user's input to your application. For more information, see the following Remarks section.



Return Values

If the function succeeds, the return value is the window handle to the dialog box. You can use the window handle to communicate with the dialog box or close it.
If the function fails, the return value is NULL. To get extended error information, call the CommDlgExtendedError function, which can return one of the following error codes:

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


Remarks

The ReplaceText function does not perform a text replacement operation. Instead, the dialog box sends FINDMSGSTRING registered messages to the window procedure of the owner window of the dialog box. When you create the dialog box, the hwndOwner member of the FINDREPLACE structure identifies the owner window.
Before calling ReplaceText, you must call the RegisterWindowMessage function to get the identifier for the FINDMSGSTRING message. The dialog box procedure uses this identifier to send messages when the user clicks the Find Next, Replace, or Replace All buttons, or when the dialog box is closing. The lParam parameter of a FINDMSGSTRING message contains a pointer to the FINDREPLACE structure. The Flags member of this structure indicates the event that caused the message. Other members of the structure indicate the user's input.

If you create a Replace dialog box, you must also use the IsDialogMessage function in the main message loop of your application to ensure that the dialog box correctly processes keyboard input, such as the TAB and ESC keys. The IsDialogMessage function returns a value that indicates whether the Replace dialog box processed the message.
You can provide an FRHookProc hook procedure for a Replace dialog box. The hook procedure can process messages sent to the dialog box. To enable a hook procedure, set the FR_ENABLEHOOK flag in the Flags member of the FINDREPLACE structure and specify the address of the hook procedure in the lpfnHook member.

See Also

CommDlgExtendedError, FINDREPLACE, FRHookProc, IsDialogMessage, RegisterWindowMessage, WM_CTLCOLORDLG


Пригласи друзей и счет твоего мобильника всегда будет положительным!
Предыдущая статья
 
Сайт Народ.Ру Интернет
Следующая статья
Пригласи друзей и счет твоего мобильника всегда будет положительным!

ReplaceText



Функция ReplaceText создает определенный системный независимый диалоговый ящик, который позволяет, чтобы потребитель определяет строку, чтобы искать и строку замены, а также выборы, чтобы управлять находить и заменять действия.

HWND ReplaceText(

LPFINDREPLACE lpfr // УКАЗАТЕЛЬ в структуру с данными инициализации
);


Параметры

lpfr

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



Обратные Величины

Если функция добивается успеха, обратная величина является ручкой окна диалоговому блоку. Вы можете использовать ручку окна, чтобы связываться с диалоговым блоком или закрывать это.
Если функция терпит неудачу, обратная величина НЕДЕЙСТВИТЕЛЬНА. Для того, чтобы расширять информацию ошибки, назовите функцию 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. Диалоговый блок процедуры использует этот идентификатор, чтобы посылать сообщения когда пользователь щелкает Find Затем, Заменяет, или Заменяет Все кнопки, или когда диалоговый блок заключительный. Параметр lParam сообщения FINDMSGSTRING содержит указатель в структуру FINDREPLACE. Элемент Флагов этой структуры указывает событие, которое вызывало сообщение. Другие участники структуры указывают ввод пользователя.

Если Вы создаете диалогового блока Replace, Вы должны также использовать функцию IsDialogMessage в основном цикле сообщения вашего приложения, чтобы проверять, что диалоговый блок правильно обрабатывает ввод данных с клавиатуры, как например, ТАБ. и клавиши ESC. Функция IsDialogMessage возвращает величину, которая указывает обрабатывал диалоговый блок Replace сообщение.
Вы можете обеспечить процедуру захвата FRHookProc для диалогового блока Replace. Рычажная процедура может обработать сообщения посланные диалоговому блоку. Для того, чтобы приспосабливаться рычажную процедуру, установите флаг FR_ENABLEHOOK в элементе Флагов структуры FINDREPLACE и определяйте адрес рычажной процедуры в элементе lpfnHook.

Смотри Также

CommDlgExtendedError, FINDREPLACE, FRHookProc, IsDialogMessage, RegisterWindowMessage, WM_CTLCOLORDLG


Вверх Version 1.3, Oct 26 2010 © 2007, 2010, mrhx Вверх
 mrhx software  Русский перевод OpenGL  Русский перевод Win32 API
 
Используются технологии uCoz