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

Caixas de diálogo

GetNextDlgTabItem

Referência