Método IDirectManipulationViewport::SetContact (directmanipulation.h)
Especifica uma associação entre um contato e o visor.
Sintaxe
HRESULT SetContact(
[in] UINT32 pointerId
);
Parâmetros
[in] pointerId
A ID do ponteiro.
Valor retornado
Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.
Comentários
Chame esse método quando uma mensagem de WM_POINTERDOWN for recebida. Ao receber uma WM_POINTERDOWN, o aplicativo pode usar as coordenadas da entrada para testar e determinar os visores aos quais o contato está associado.
DeferContact deve ser chamado antes de SetContact.
Após a inicialização, a Manipulação Direta não está ciente das relações entre viewport z-order ou pai-filho entre visores. A ordem das chamadas SetContact define a árvore de visor. Para estabelecer a hierarquia de visor correta, SetContact deve ser chamado primeiro no visor mais filho, seguido pelo pai, pai-avô e assim por diante.
Use GET_POINTERID_WPARAM para obter o identificador de ponteiro de uma mensagem de ponteiro. O contato é removido automaticamente quando WM_POINTERUP é recebido.
Se um contato estiver associado a um ou mais visores usando o método SetContact , a Manipulação Direta examinará mais informações desse contato e tentará identificar uma manipulação apropriada com base na configuração dos visores associados. Se uma manipulação for reconhecida, o aplicativo receberá uma mensagem WM_POINTERCAPTURECHANGED para esse contato. Nesse contexto, a mensagem WM_POINTERCAPTURECHANGED indica que a Manipulação Direta capturou o contato e o aplicativo não receberá entrada desse contato consumido para essa manipulação.
Requisitos
| Cliente mínimo com suporte | Windows 8 [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2012 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | directmanipulation.h |