SendDlgItemMessage function (Windows)

Applies to: desktop apps only

Sends a message to the specified control in a dialog box.

Syntax

LRESULT WINAPI SendDlgItemMessage(
  __in  HWND hDlg,
  __in  int nIDDlgItem,
  __in  UINT Msg,
  __in  WPARAM wParam,
  __in  LPARAM lParam
);

Parameters

hDlg [in]

Type: HWND

A handle to the dialog box that contains the control.

nIDDlgItem [in]

Type: int

The identifier of the control that receives the message.

Msg [in]

Type: UINT

The message to be sent.

For lists of the system-provided messages, see System-Defined Messages.

wParam [in]

Type: WPARAM

Additional message-specific information.

lParam [in]

Type: LPARAM

Additional message-specific information.

Return value

Type: LRESULT

The return value specifies the result of the message processing and depends on the message sent.

Remarks

The SendDlgItemMessage function does not return until the message has been processed.

Using SendDlgItemMessage is identical to retrieving a handle to the specified control and calling the SendMessage function.

Examples

For an example, see Creating a Modeless Dialog Box.

Requirements

See also

Reference

SendMessage

Conceptual

Dialog Boxes

Send comments about this topic to Microsoft

Build date: 2/10/2012