windows_programming_notes.nbk: Home | Index | Next Page: DragDetect | Previous Page: DM_GETDEFID

 DM_SETDEFID

An application sends a DM_SETDEFID message to change the identifier of the default push button for a dialog box.

Syntax

To send this message, call the SendMessage function as follows.

    lResult = SendMessage(      // returns LRESULT in lResult     
        (HWND)   hWndControl,   // handle to destination control     
        (UINT)   DM_SETDEFID,   // message ID     
        (WPARAM) wParam,        // = (WPARAM) () wParam;    
        (LPARAM) lParam         // = 0; not used, must be zero 
    );  

Parameters

• wParam
  Specifies the identifier of a push button control that will become the default.
• lParam
  This parameter is not used.

Return Value

The return value is always TRUE.

Remarks

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 specified 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.

Message Information

• Header Declared in Winuser.h, include Windows.h
• Minimum operating systems Windows 95, Windows NT 3.1

windows_programming_notes.nbk: Home | Index | Next Page: DragDetect | Previous Page: DM_GETDEFID

Notebook exported on Monday, 7 July 2008, 18:56:50 PM Eastern Daylight Time