Função SHAppBarMessage (shellapi.h)

Envia uma mensagem de barra de aplicativos para o sistema.

Sintaxe

UINT_PTR SHAppBarMessage(
  [in]      DWORD       dwMessage,
  [in, out] PAPPBARDATA pData
);

Parâmetros

[in] dwMessage

Tipo: DWORD

Valor da mensagem da barra de aplicativos a ser enviado. Esse parâmetro pode usar um dos valores a seguir.

ABM_NEW (0x00000000)

Registra uma nova barra de aplicativos e especifica o identificador de mensagem que o sistema deve usar para enviar mensagens de notificação para a barra de aplicativos.

ABM_REMOVE (0x00000001)

Cancela o registro de uma barra de aplicativos, removendo a barra da lista interna do sistema.

ABM_QUERYPOS (0x00000002)

Solicita um tamanho e uma posição de tela para uma barra de aplicativos.

ABM_SETPOS (0x00000003)

Define o tamanho e a posição da tela de uma barra de aplicativos.

ABM_GETSTATE (0x00000004)

Recupera os estados de ocultação automática e always-on-top da barra de tarefas do Windows.

ABM_GETTASKBARPOS (0x00000005)

Recupera o retângulo delimitador da barra de tarefas do Windows. Observe que isso se aplica somente à barra de tarefas do sistema. Outros objetos, particularmente barras de ferramentas fornecidas com software de terceiros, também podem estar presentes. Como resultado, parte da área de tela não coberta pela barra de tarefas do Windows pode não estar visível para o usuário. Para recuperar a área da tela não coberta pela barra de tarefas e por outras barras de aplicativos, a área de trabalho disponível para seu aplicativo, use a função GetMonitorInfo .

ABM_ACTIVATE (0x00000006)

Notifica o sistema para ativar ou desativar uma barra de aplicativos. O membro lParam do APPBARDATA apontado por pData é definido como TRUE para ativar ou FALSE para desativar.

ABM_GETAUTOHIDEBAR (0x00000007)

Recupera o identificador para a barra de aplicativos de ocultação automática associada a uma borda específica da tela.

ABM_SETAUTOHIDEBAR (0x00000008)

Registra ou cancela o registro de uma barra de aplicativos de ocultação automática para uma borda da tela.

ABM_WINDOWPOSCHANGED (0x00000009)

Notifica o sistema quando a posição de uma barra de aplicativos é alterada.

ABM_SETSTATE (0x0000000A)

Windows XP e posterior: Define o estado dos atributos autohide e always-on-top da barra de aplicativos.

ABM_GETAUTOHIDEBAREX (0x0000000B)

Windows XP e posterior: Recupera o identificador para a barra de aplicativos de ocultação automática associada a uma borda específica de um monitor específico.

ABM_SETAUTOHIDEBAREX (0x0000000C)

Windows XP e posterior: Registra ou cancela o registro de uma barra de aplicativos de ocultação automática para uma borda de um monitor específico.

[in, out] pData

Tipo: PAPPBARDATA

Um ponteiro para uma estrutura APPBARDATA . O conteúdo da estrutura na entrada e na saída depende do valor definido no parâmetro dwMessage . Consulte as páginas de mensagens individuais para obter detalhes.

Retornar valor

Tipo: UINT_PTR

Essa função retorna um valor dependente de mensagem. Para obter mais informações, consulte a documentação SDK do Windows para a mensagem específica da barra de aplicativos enviada. Os links para esses documentos são dados na seção Consulte Também.

Requisitos

Confira também

ABM_ACTIVATE

ABM_GETAUTOHIDEBAR

ABM_GETAUTOHIDEBAREX

ABM_GETSTATE

ABM_GETTASKBARPOS

ABM_NEW

ABM_QUERYPOS

ABM_REMOVE

ABM_SETAUTOHIDEBAR

ABM_SETAUTOHIDEBAREX

ABM_SETPOS

ABM_SETSTATE

ABM_WINDOWPOSCHANGED