Função GetNextDlgGroupItem (winuser.h)
Recupera um identificador para o primeiro controle em um grupo de controles que precede (ou segue) o controle especificado em uma caixa de diálogo.
Sintaxe
HWND GetNextDlgGroupItem(
[in] HWND hDlg,
[in, optional] HWND hCtl,
[in] BOOL bPrevious
);
Parâmetros
[in] hDlg
Digite: HWND
Um identificador para a caixa de diálogo a ser pesquisada.
[in, optional] hCtl
Digite: HWND
Um identificador para o controle a ser usado como ponto de partida para a pesquisa. Se esse parâmetro for NULL, a função usará o último (ou primeiro) controle na caixa de diálogo como o ponto de partida para a pesquisa.
[in] bPrevious
Tipo: BOOL
Indica como a função deve pesquisar o grupo de controles na caixa de diálogo. Se esse parâmetro for TRUE, a função pesquisa o controle anterior no grupo. Se for FALSE, a função pesquisa o próximo controle no grupo.
Valor retornado
Digite: HWND
Se a função for bem-sucedida, o valor retornado será um identificador para o controle anterior (ou próximo) no grupo de controles.
Se a função falhar, o valor retornado será NULL. Para obter informações de erro estendidas, chame GetLastError.
Comentários
A função GetNextDlgGroupItem pesquisa controles na ordem (ou ordem inversa) em que foram criados no modelo da caixa de diálogo. O primeiro controle no grupo deve ter o estilo WS_GROUP ; todos os outros controles no grupo devem ter sido criados consecutivamente e não devem ter o estilo WS_GROUP .
Ao pesquisar o controle anterior, a função retorna o primeiro controle que localiza que está visível e não está desabilitado. Se o controle especificado por hCtl tiver o estilo WS_GROUP , a função inverte temporariamente a pesquisa para localizar o primeiro controle com o estilo WS_GROUP , depois retoma a pesquisa na direção original, retornando o primeiro controle que localiza que está visível e não está desabilitado ou retornando hCtl se nenhum controle desse tipo for encontrado.
Ao pesquisar o próximo controle, a função retorna o primeiro controle que localiza que está visível, não desabilitado e não tem o estilo WS_GROUP . Se encontrar um controle com o estilo WS_GROUP , a função reverterá a pesquisa, localizará o primeiro controle com o estilo WS_GROUP e retornará esse controle se ele estiver visível e não estiver desabilitado. Caso contrário, a função retomará a pesquisa na direção original e retornará o primeiro controle localizado que está visível e não desabilitado ou retornará hCtl se nenhum controle desse tipo for encontrado.
Se a pesquisa pelo próximo controle no grupo encontrar uma janela com o estilo WS_EX_CONTROLPARENT , o sistema pesquisará recursivamente os filhos da janela.
Requisitos
| Cliente mínimo com suporte | Windows 2000 Professional [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows 2000 Server [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | winuser.h (inclua Windows.h) |
| Biblioteca | User32.lib |
| DLL | User32.dll |
Confira também
Conceitual
Referência