WM QUERYDLGCODE

This message is sent by the dialog manager to identify the type of control, to determine what kinds of messages the control understands, and also to determine whether an input message may be processed by the dialog manager or passed down to the control.

Syntax

param1
    PQMSG   pQmsg;      /* Message queue structure. */

param2
    ULONG   ulReserved; /* Reserved value, should be 0. */

Parameters

pQmsg (PQMSG) - input

Pointer to a QMSG structure.

ulReserved (ULONG) - input

Reserved value, should be 0.

Returns

ulDialogCode (ULONG) - returns

Dialog code information flags.

DLGC_ENTRYFIELD: Identifies an entry field control. Assumed to understand the EM_SETSEL message.

DLGC_BUTTON: Identifies a button item. Assumed to understand the BM_CLICK message.

DLGC_RADIOBUTTON: Identifies a radio button control. Used with the DLGC_BUTTON code.

DLGC_STATIC: Identifies a static control. Static controls are not included in arrow key enumeration.

DLGC_DEFAULT: Identifies a default push-button control.

DLGC_PUSHBUTTON: Identifies a nondefault push button.

DLGC_CHECKBOX: Identifies a check-box item. Used with the DLGC_BUTTON code.

DLGC_SCROLLBAR: Identifies a scroll bar control.

DLGC_MENU: Identifies a menu control.

DLGC_TABONCLICK: Used by static controls to indicate that a mouse click on this control will cause focus to be placed on the next control in the dialog that has the WP_TABSTOP style. This should be used in combination with the DLGC_STATIC code.

DLGC_MLE: Identifies a multiline entry field control.

Remarks

When processing user input, the dialog manager makes some assumptions about the operation of specific controls. The dialog manager sends the WM_QUERYDLGCODE message to obtain a code that governs what assumptions can be made.

If the window receiving this message is not a control as defined above, this message returns 0.

Default Processing

The default dialog procedure takes no action on this message, other than to set ulDialogCode to NULL.