Função DwmShowContact (dwmapi.h)

Artigo
08/02/2024

Chamado por um aplicativo ou estrutura para especificar o tipo de comentários visuais a ser desenhado em resposta a um contato de toque ou caneta específico.

Sintaxe

HRESULT DwmShowContact(
  [in] DWORD           dwPointerID,
  [in] DWM_SHOWCONTACT eShowContact
);

Parâmetros

[in] dwPointerID

A ID do ponteiro do contato. Cada contato de toque ou caneta recebe uma ID exclusiva quando é detectada.

[in] eShowContact

Uma ou mais das visualizações de DWM_SHOWCONTACT a seguir que o DWM deve mostrar para esse contato.

DWMSC_NONE (0x00000000)

Nenhum comentário visual deve ser mostrado em resposta ao contato.

DWMSC_DOWN (0x00000001)

Mostre a animação "contact down", como seria usado em uma tecla de tecla.

DWMSC_UP (0x00000002)

Mostre a animação "contact up", como seria usada em uma versão de botão.

DWMSC_DRAG (0x00000004)

Mostrar a animação "arrastar contato" quando o elemento de interface do usuário selecionado pelo toque ou caneta for arrastado.

DWMSC_HOLD (0x00000008)

Mostrar um visual enquanto o contato está retido, como segurar um botão.

DWMSC_PENBARREL (0x00000010)

Mostrar o visual do barril de caneta quando o botão de barril de caneta é pressionado.

DWMSC_ALL (0xFFFFFFFF)

Mostrar qualquer uma das animações, se for chamado.

Valor de retorno

Se dwPointerID não corresponder ao de um contato atualmente presente na tela, essa função retornará E_INVALIDARG; caso contrário, ele retornará S_OK.

Observações

É seguro chamar essa função no thread da interface do usuário.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 8 [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows Server 2012 [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	dwmapi.h
biblioteca	Dwmapi.lib
de DLL	Dwmapi.dll

Compartilhar via