Compartilhar via


Função GetNextDlgTabItem (winuser.h)

Recupera um identificador para o primeiro controle que tem o estilo WS_TABSTOP que precede (ou segue) o controle especificado.

Sintaxe

HWND GetNextDlgTabItem(
  [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 falhará.

[in] bPrevious

Tipo: BOOL

Indica como a função é pesquisar a caixa de diálogo. Se esse parâmetro for TRUE, a função procurará o controle anterior na caixa de diálogo. Se esse parâmetro for FALSE, a função procurará o próximo controle na caixa de diálogo.

Valor retornado

Digite: HWND

Se a função for bem-sucedida, o valor retornado será o identificador de janela do controle anterior (ou próximo) que tem o estilo WS_TABSTOP definido.

Se a função falhar, o valor retornado será NULL. Para obter informações de erro estendidas, chame GetLastError.

Comentários

A função GetNextDlgTabItem pesquisa controles na ordem (ou ordem inversa) que foram criados no modelo da caixa de diálogo. A função retorna o primeiro controle que localiza que está visível, não desabilitado e tem o estilo WS_TABSTOP . Se esse controle não existir, a função retornará hCtl.

Se a pesquisa do próximo controle com o estilo WS_TABSTOP encontrar uma janela com o estilo WS_EX_CONTROLPARENT , o sistema pesquisa 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
Conjunto de APIs ext-ms-win-ntuser-dialogbox-l1-1-2 (introduzido no Windows 10, versão 10.0.10240)

Confira também

Conceitual

Caixas de diálogo

Getdlgitem

GetNextDlgGroupItem

Referência