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

Cuadros de diálogo

GetNextDlgTabItem

Referencia