Функция RegisterWindowMessage определяет новое сообщение окна, которое, является гарантией того, что оно будет уникальным повсюду в системе. Возвращенное значение сообщения может быть использовано, когда сообщение помещается в очередь или отправляется.
Синтаксис
UINT RegisterWindowMessage( LPCTSTR lpString ); |
Параметры
lpString
[in] Указывает на строку с символом нуля в конце, которая определяет сообщение для регистрации.
Возвращаемые значения
Если сообщение успешно зарегистрировано, величина возвращаемого значения - код сообщения в диапазоне от 0xC000 до 0xFFFF.
Если функция завершилась ошибкой, величина возвращаемого значения нулевая. Чтобы получить дополнительные сведения об ошибке, вызовите функцию GetLastError.
Замечания
Функция RegisterWindowMessage обычно используется, чтобы регистрировать сообщения для связи между двумя сотрудничающими прикладными программами.
Если две различные прикладные программы регистрируют ту же самую строку сообщения, они возвращают то же самое значение сообщения. Сообщение остается зарегистрированным до конца сессии.
Используйте RegisterWindowMessage только тогда, когда больше чем одна прикладная программа должны обработать то же самое сообщение. Для отправки собственных сообщений в пределах класса окна, приложение может использовать любое целое число в диапазоне от WM_USER до 0x7FFF. (Сообщения в этом диапазоне являются собственностью класса окна, а не к прикладной программы. Например, предопределенные классы органов управления типа BUTTON, EDIT, LISTBOX и COMBOBOX могут использовать значения в этом диапазоне).
Windows 95/98/Me: RegisterWindowMessageW поддерживается подпрограммой Microsoft Layer for Unicode (MSLU). Чтобы использовать подпрограмму, Вы должны добавить некоторые файлы к вашему приложению, как это определено в Microsoft Layer for Unicode для систем Windows 95/98/Me.
Пример
Пример смотри в статье Поиск текста.
Смотри также
Обзор Сообщения и очереди сообщений, PostMessage, SendMessage
Размещение и совместимость RegisterWindowMessage |
|
Windows. NET Server |
Да |
Windows XP |
Да |
Windows 2000 |
Да |
Windows NT |
Да версии 3.1 и выше |
Windows Me |
Да |
Windows 98 |
Да |
Windows 95 |
Да |
Используемая библиотека |
User32.lib |
Заголовочный файл |
|
- объявлено в |
Winuser.h |
- включено в |
Windows.h |
Unicode |
Нет |
Замечания по платформе |
Не имеется |