Função GetAltTabInfoA (winuser.h)

Recupera status informações para a janela especificada se for a janela de alternância de aplicativo (ALT+TAB).

Sintaxe

BOOL GetAltTabInfoA(
  [in, optional]  HWND        hwnd,
  [in]            int         iItem,
  [in, out]       PALTTABINFO pati,
  [out, optional] LPSTR       pszItemText,
  [in]            UINT        cchItemText
);

Parâmetros

[in, optional] hwnd

Digite: HWND

Um identificador para a janela para a qual status informações serão recuperadas. Essa janela deve ser a janela de alternância de aplicativo.

[in] iItem

Tipo: int

O índice do ícone na janela de alternância de aplicativo. Se o parâmetro pszItemText não for NULL, o nome do item será copiado para a cadeia de caracteres pszItemText . Se esse parâmetro for –1, o nome do item não será copiado.

[in, out] pati

Tipo: PALTTABINFO

Um ponteiro para uma estrutura ALTTABINFO para receber as informações de status. Observe que você deve definir o membro csSize como sizeof(ALTTABINFO) antes de chamar essa função.

[out, optional] pszItemText

Tipo: LPTSTR

O nome do item. Se esse parâmetro for NULL, o nome do item não será copiado.

[in] cchItemText

Tipo: UINT

O tamanho, em caracteres, do buffer pszItemText .

Valor retornado

Tipo: BOOL

Se a função for bem-sucedida, o valor retornado será diferente de zero.

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

Comentários

A janela de alternância de aplicativos permite que você alterne para a janela de aplicativo usada mais recentemente. Para exibir a janela de alternância de aplicativo, pressione ALT+TAB. Para selecionar um aplicativo na lista, continue a manter a tecla ALT pressionada e pressione TAB para percorrer a lista. Adicione SHIFT para inverter a direção por meio da lista.

Observação

O cabeçalho winuser.h define GetAltTabInfo como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

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

ALTTABINFO

Conceitual

Referência

Windows