DM_SETDEFID

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This message is sent by an application to change the identifier of the default push button for a dialog box.

Syntax

DM_SETDEFID wParam = idControl;

Parameters

  • idControl
    Specifies the identifier of a push button control that becomes the default.

Return Value

The return value is always TRUE.

Remarks

This message should not be used to change the default style when calling SetFocus on a dialog control. Use the WM_NEXTDLGCTL message instead.

This message is processed by the DefDlgProc function. To set the default push button, the function can send WM_GETDLGCODE and BM_SETSTYLE messages to the given control and the current default push button.

Using the DM_SETDEFID message can result in more than one button appearing to have the default push button state. When the system brings up a dialog, it draws the first push button in the dialog template with the default state border. Sending a DM_SETDEFID message to change the default button will not always remove the default state border from the first push button. In these cases, the application should send a BM_SETSTYLE message to change the first push button border style.

Requirements

Header winuser.h
Windows Embedded CE Windows CE 1.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

DefDlgProc
BM_SETSTYLE
DM_GETDEFID
WM_GETDLGCODE
WM_NEXTDLGCTL
Dialog Boxes Messages