Функция RegisterWindowMessage

Функция 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.

Пример

Пример смотри в статье Поиск текста.

Смотри также

Обзор Сообщения и очереди сообщений,  PostMessageSendMessage

Размещение и совместимость 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

Нет

Замечания по платформе

Не имеется

 

Назад в оглавление
На главную страницу
На оглавление справки

Hosted by uCoz