Important Notice

The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.

◄Function Group►  ◄Overview►  ◄Changes►               ◄Up► ◄Next► ◄Previous►
────────────────────────────────────────────────────────────────────────────
 
#define INCL_WINDIALOGS
 
HWND WinEnumDlgItem(hwndDlg, hwnd, code, fLock)
HWND hwndDlg;    /* handle of the dialog window  */
HWND hwnd;       /* handle of the child window   */
USHORT code;     /* dialog item to return        */
BOOL fLock;      /* lock/unlock flag             */
 
The WinEnumDlgItem function returns the handle of a dialog item within a
dialog window.
 
Parameter  Description
────────────────────────────────────────────────────────────────────────────
 
hwndDlg    Identifies the dialog window that contains the dialog item.
 
hwnd       Identifies the child window of the dialog window. This may be an
           immediate child window or a window lower in the hierarchy, such
           as a child of a child window.
 
code       Specifies which dialog item to return. This parameter is one of
           the following values:
 
           Value               Meaning
           ─────────────────────────────────────────────────────────────────
           EDI_FIRSTGROUPITEM  First item in same group.
 
           EDI_FIRSTTABITEM    First item in dialog window with style
                               WS_TABSTOP. The hwnd window is ignored.
 
           EDI_LASTGROUPITEM   Last item in same group.
 
           EDI_LASTTABITEM     Last item in dialog box with style
                               WS_TABSTOP. The hwnd window is ignored.
 
           EDI_NEXTGROUPITEM   Next item in same group. Wraps to beginning
                               of group when end of group is reached.
 
           EDI_NEXTTABITEM     Next item with style WS_TABSTOP. Wraps around
                               to beginning of dialog-item list when end is
                               reached.
 
           EDI_PREVGROUPITEM   Previous item in same group. Wraps to end of
                               group when start of group is reached.
 
           EDI_PREVTABITEM     Previous item with style WS_TABSTOP. Wraps to
                               end of dialog-item list when beginning is
                               reached.
 
fLock      This parameter is ignored by MS OS/2 versions 1.2 and later.
 
Return Value
 
The return value is the item handle obtained by this function, specified by
the code parameter. The window is always an immediate child window of the
window identified by the hwndDlg parameter.
 
See Also
 
WinBeginEnumWindows, WinLockWindow
 
                                      ♦