GetNextDlgGroupItem

A função GetNextDlgGroupItem recupera o identificador do Controlarar primeiro em um grupo de controles que precede (ou segue) do Controlarar especificado na caixa de diálogo.

(HWND GetNextDlgGroupItem HWND  hDlg, / / identificador da caixa de diálogoHWNDhCtl, / / identificador do controleBOOLbPrevious / / direção bandeira);
 

Parâmetros

hDlg
Identifica a caixa de diálogo que está sendo pesquisada.
hCtl
Identifica o Controlarar a ser usado como ponto de partida para a pesquisa. Se este parâmetro é NULL, a função usa o controle último (ou primeiro) na caixa de diálogo como ponto de partida para a pesquisa.
bPrevious
Especifica como a função deve pesquisar o AAgruparar de controles na caixa de diálogo. Se este parâmetro for TRUE, a função procura o Controlarar anterior no grupo. Se for FALSE, a função procura o próximo controle no grupo.

Retornar valores

Se GetNextDlgGroupItem for bem-sucedido, o valor de retorno é o identificador do controle anterior (ou posterior) no grupo de controles.

Se a função falhar, o valor de retorno é NULL. Para informações de erro estendidas get, chamar GetLastError.

Observações

A função GetNextDlgGroupItem procura controles na ordem (ou ordem inversa) foram criados no modelo de caixa de diálogo. O primeiro controle no grupo deve ter o estilo WS_GROUP; todos os outros controles no grupo deve ter sido criados consecutivamente e deve não ter o estilo WS_GROUP.

Ao fazer a pesquisa para o controle anterior, a função retorna o primeiro controle que ele localiza que é visível e não deficientes. Se o controle fornecido por hCtl tem o estilo WS_GROUP, a função temporariamente inverte a pesquisa para localizar o primeiro controle com o estilo WS_GROUP, em seguida, reinicia a pesquisa no sentido original, retornando o primeiro controle localiza que é visível e não deficientes ou retornando hwndCtrl se nenhum tal controlo é encontrado.

Ao fazer a pesquisa para o próximo controle, a função retorna o primeiro controle que ele localiza que é visível, não desativado, e o faz não têm o estilo WS_GROUP. Se ele encontrar um Controlarar com o estilo WS_GROUP, a função inverte a pesquisa localiza o primeiro controle com o estilo WS_GROUP e retorna esse controle se ele estiver visível e não deficientes. Caso contrário, a função continua a pesquisa no sentido original e retorna o primeiro controle que ele localiza que é visível e não deficientes, ou retorna hCtl não se for encontrado nenhum tal controle.

QuickInfo

nbsp; Windows &NT: requer a versão 3.1 ou posterior.
Windows:Requer o Windows 95 ou posterior.
Windows CE:Requer versão 1.0 ou posterior.
Cabeçalho:Declarado em WinUser. h.
Biblioteca de importação:Use user32.lib.

Ver também

Visão geral de caixas de diálogo, funções de caixa de diálogo, GetNextDlgTabItem

Index