Método IDirectManipulationViewport::SetContact (directmanipulation.h)
Especifica una asociación entre un contacto y la ventanilla.
Sintaxis
HRESULT SetContact(
[in] UINT32 pointerId
);
Parámetros
[in] pointerId
Identificador del puntero.
Valor devuelto
Si el método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.
Comentarios
Llame a este método cuando se reciba un mensaje de WM_POINTERDOWN . Al recibir un WM_POINTERDOWN, la aplicación puede usar las coordenadas de la entrada para realizar la prueba de posicionamiento y determinar las ventanillas a las que está asociado el contacto.
Se debe llamar a DeferContact antes de SetContact.
Después de la inicialización, la manipulación directa no es consciente de las relaciones de z-order o parent-child entre ventanillas. El orden de las llamadas a SetContact define el árbol de ventanilla. Para establecer la jerarquía de ventanilla correcta, se debe llamar a SetContact primero en la ventanilla secundaria, seguida de la primaria, la primaria, etc.
Use GET_POINTERID_WPARAM para obtener el identificador de puntero desde un mensaje de puntero. El contacto se quita automáticamente cuando se recibe WM_POINTERUP .
Si un contacto está asociado a una o varias ventanillas mediante el método SetContact , la manipulación directa examinará más la entrada de ese contacto e intentará identificar una manipulación adecuada en función de la configuración de las ventanillas asociadas. Si se reconoce una manipulación, la aplicación recibirá un mensaje de WM_POINTERCAPTURECHANGED para este contacto. En este contexto, el mensaje de WM_POINTERCAPTURECHANGED indica que La manipulación directa ha capturado el contacto y la aplicación no recibirá la entrada de este contacto que se consume para esta manipulación.
Requisitos
| Cliente mínimo compatible | Windows 8 [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2012 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | directmanipulation.h |