|
Overview |
|
|
|
Group |
|
|
|
Quick Info
Windows NT
| Yes
| Win95
| Yes
| Win32s
| Yes
| Import Library
| user32.lib
| Header File
| winuser.h
| Unicode
| WinNT
| Platform Notes
| None
|
|
|
IsDialogMessage
The IsDialogMessage function determines whether a message is intended for the specified dialog
box and, if it is, processes the message.
BOOL IsDialogMessage(
HWND hDlg,
| // handle of dialog box
| LPMSG lpMsg
| // address of structure with message
| );
|
|
Parameters
hDlg
Identifies the dialog box.
lpMsg
Points to an MSG structure that contains the message to be checked.
Return Values
If the message has been processed, the return value is nonzero.
If the message has not been processed, the return value is zero.
Remarks
Although the IsDialogMessage function is intended for modeless dialog boxes, you can use it with any
window that contains controls, enabling the windows to provide the same keyboard
selection as is used in a dialog box.
When IsDialogMessage processes a message, it checks for keyboard messages and converts them into
selection commands for the corresponding dialog box. For example, the TAB key, when pressed, selects the next control or group of controls, and the DOWN ARROW key, when pressed, selects the next control in a group.
Because the IsDialogMessage function performs all necessary translating and dispatching of messages, a
message processed by IsDialogMessage must not be passed to the TranslateMessage or DispatchMessage function.
IsDialogMessage sends WM_GETDLGCODE messages to the dialog box procedure to determine which keys should be
processed.
IsDialogMessage can send DM_GETDEFID and DM_SETDEFID messages to the window. These messages are defined in the WINUSER.H header
file as WM_USER and WM_USER + 1, so conflicts are possible with application-defined messages
having the same values.
See Also
DispatchMessage, DM_GETDEFID, DM_SETDEFID, MSG, TranslateMessage, WM_GETDLGCODE, WM_USER
Related Links
Software for Delphi and C++ Builder developers
Software for Visual Studio .NET developers
Software for Visual Basic 6 developers
Delphi Tips&Tricks
MegaDetailed.NET
TMS Scripter Studio Pro components for Delphi/C++Builder
More Online Helps
Win32 Multimedia Programmer's Reference (mmedia.hlp)
OLE Programmer's Reference (ole.hlp)
Microsoft Windows Pen API Programmer's Reference (penapi.hlp)
Microsoft Windows Sockets 2 Reference (sock2.hlp)
Microsoft Windows Telephony API (TAPI) Programmer's Reference (tapi.hlp)
Unix Manual Pages
|
