Compartilhar via


Método ITaskbarList::SetActiveAlt (shobjidl_core.h)

Marca um item da barra de tarefas como ativo, mas não o ativa visualmente.

Sintaxe

HRESULT SetActiveAlt(
  HWND hwnd
);

Parâmetros

hwnd

Tipo: HWND

Um identificador para a janela a ser marcada como ativa.

Valor de retorno

Tipo: HRESULT

Se esse método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Observações

SetActiveAlt marca o item associado a hwnd como o item ativo atualmente para o processo da janela sem alterar o estado pressionado de qualquer item. Qualquer ação do usuário que ativaria uma guia diferente nesse processo ativará a guia associada a hwnd. Não há garantia de que o estado ativo do item da janela seja preservado quando o processo associado a hwnd não estiver ativo. Para garantir que uma determinada guia esteja sempre ativa, chame SetActiveAlt sempre que qualquer uma das janelas for ativada. Chamar SetActiveAlt com um null limpar esse estado.

Requisitos

Requisito Valor
de cliente com suporte mínimo Windows 2000 Professional, Windows XP [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 shobjidl_core.h (inclua Shobjidl.h)
de DLL Shell32.dll (versão 4.71 ou posterior)