Função GetAltTabInfoW (winuser.h)

Artigo
11/20/2024

Recupera informações de status da janela especificada se for a janela alt+TAB (comutação de aplicativo).

Sintaxe

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

Parâmetros

[in, optional] hwnd

Tipo: HWND

Um identificador para a janela para a qual as informações de status 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 csSize membro para 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 de pszItemText .

Valor de retorno

Tipo: BOOL

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

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

Observações

A janela de alternância de aplicativo 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 o ALT pressionado e pressione TAB para percorrer a lista. Adicione SHIFT à direção inversa por meio da lista.

Nota

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 do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 2000 Professional [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows 2000 Server [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	winuser.h (inclua Windows.h)
biblioteca	User32.lib
de DLL	User32.dll

Consulte também

ALTTABINFO

Conceitual

de referência de

Windows

Compartilhar via