Función GetNextDlgGroupItem (winuser.h)
Recupera un identificador al primer control de un grupo de controles que precede (o sigue) al control especificado en un cuadro de diálogo.
Sintaxis
HWND GetNextDlgGroupItem(
[in] HWND hDlg,
[in, optional] HWND hCtl,
[in] BOOL bPrevious
);
Parámetros
[in] hDlg
Tipo: HWND
Identificador del cuadro de diálogo que se va a buscar.
[in, optional] hCtl
Tipo: HWND
Identificador del control que se va a usar como punto de partida para la búsqueda. Si este parámetro es NULL, la función usa el último control (o primero) del cuadro de diálogo como punto de partida de la búsqueda.
[in] bPrevious
Tipo: BOOL
Indica cómo la función es buscar en el grupo de controles del cuadro de diálogo. Si este parámetro es TRUE, la función busca el control anterior en el grupo. Si es FALSE, la función busca el siguiente control del grupo.
Valor devuelto
Tipo: HWND
Si la función se realiza correctamente, el valor devuelto es un identificador del control anterior (o siguiente) del grupo de controles.
Si la función no se realiza correctamente, el valor devuelto es NULL. Para obtener información de error extendida, llame a GetLastError.
Comentarios
La función GetNextDlgGroupItem busca controles en el orden (o orden inverso) que se crearon en la plantilla del cuadro de diálogo. El primer control del grupo debe tener el estilo WS_GROUP ; Todos los demás controles del grupo deben haberse creado de forma consecutiva y no deben tener el estilo WS_GROUP .
Al buscar el control anterior, la función devuelve el primer control que busca que está visible y no deshabilitado. Si el control especificado por hCtl tiene el estilo WS_GROUP , la función invierte temporalmente la búsqueda para buscar el primer control que tiene el estilo de WS_GROUP y, a continuación, reanuda la búsqueda en la dirección original, devolviendo el primer control que busca que está visible y no deshabilitado, o devolviendo hCtl si no se encuentra dicho control.
Al buscar el siguiente control, la función devuelve el primer control que busca visible, no deshabilitado y no tiene el estilo WS_GROUP . Si encuentra un control que tiene el estilo WS_GROUP , la función invierte la búsqueda, busca el primer control que tiene el estilo WS_GROUP y devuelve este control si está visible y no deshabilitado. De lo contrario, la función reanuda la búsqueda en la dirección original y devuelve el primer control que localiza visible y no deshabilitado, o devuelve hCtl si no se encuentra dicho control.
Si la búsqueda del siguiente control del grupo encuentra una ventana con el estilo WS_EX_CONTROLPARENT , el sistema busca recursivamente los elementos secundarios de la ventana.
Requisitos
| Cliente mínimo compatible | Windows 2000 Professional [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows 2000 Server [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | winuser.h (incluir Windows.h) |
| Library | User32.lib |
| Archivo DLL | User32.dll |
Consulte también
Conceptual
Referencia