Функция IsDialogMessage

Функция IsDialogMessage определяет, предназначено ли сообщение для заданного блока диалога и, если это так, обрабатывает его.

Синтаксис

BOOL IsDialogMessage(
    HWND hDlg,
    LPMSG lpMsg
);

Параметры

hDlg

[in] Дескриптор диалогового окна.

lpMsg

[in] Указатель на структуру MSG, содержащую сообщение, которое будет проверено.

Возвращаемое значение

Если сообщение было обработано, возвращаемое значение не нуль.

Если сообщение не было обработано, возвращаемое значение равняется нулю.

Замечания

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

Когда IsDialogMessage обрабатывает сообщение, она проверяет  сообщения клавиатуры и преобразует их в вариант для соответствующего диалогового окна. Например, когда нажимается клавиша TAB, то выбирается следующий орган управления или их группа, и когда нажимается  клавиша  DOWN ARROW (СТРЕЛКА ВНИЗ), выбирается следующий орган управления в группе.

Поскольку функция IsDialogMessage исполняет все необходимые преобразования и диспетчеризацию сообщений, сообщение, обработанное IsDialogMessage, нельзя передавать в функции TranslateMessage или DispatchMessage.

IsDialogMessage отправляет сообщениям WM_GETDLGCODE процедуре диалогового окна, чтобы определить, какие клавиши должны быть обработаны.

IsDialogMessage может отправлять в окно сообщения DM_GETDEFID и DM_SETDEFID. Эти сообщения определены в заголовочном файле WINUSER.H как WM_USER и WM_USER + 1, так что возможны конфликты с определяемыми программой сообщениями, имеющими те же самые значения.

Windows 95/98/Me: IsDialogMessageW поддерживается программой Microsoft Layer for Unicode. Чтобы использовать ее, Вы должны добавить некоторые файлы к вашему приложению, как изложено в описании Microsoft Layer for Unicode для системы Windows 95/98/Me.

Смотри также 

Обзор Диалоговые окнаФункции, используемые диалоговыми окнами DispatchMessageDM_GETDEFIDDM_SETDEFIDMSGTranslateMessageWM_GETDLGCODEWM_USER

Размещение и совместимость IsDialogMessage  

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