WM_NEXTDLGCTL

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This message is sent to a dialog box procedure to set the keyboard focus to a different control in the dialog box.

Syntax

WM_NEXTDLGCTL wCtlFocus = wParam; 
    fHandle = (BOOL) LOWORD(lParam);

Parameters

  • wCtlFocus
    If the fHandle parameter is TRUE, the wCtlFocus parameter identifies the control that receives the focus. If fHandle is FALSE, wCtlFocus is a flag that indicates whether the next or previous control with the WS_TABSTOP style receives the focus. If wCtlFocus is zero, the next control receives the focus; otherwise, the previous control with the WS_TABSTOP style receives the focus.
  • fHandle
    Boolean value that indicates how the system uses the wCtlFocus parameter. If the fHandle parameter is TRUE, wCtlFocus is a handle associated with the control that receives the focus; otherwise, wCtlFocus is a flag that indicates whether the next or previous control with the WS_TABSTOP style receives the focus.

Return Value

An application should return zero if it processes this message.

Remarks

The effect of this message differs from that of the SetFocus function because WM_NEXTDLGCTL modifies the border around the control.

Do not use the SendMessage function to send a WM_NEXTDLGCTL message if your application will concurrently process other messages that set the focus. Use the PostMessage function instead.

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

PostMessage
SendMessage
SetFocus
Dialog Boxes Messages