Método IDirectManipulationViewport::ActivateConfiguration (directmanipulation.h)

Establece la configuración para la interacción de entrada.

Sintaxis

HRESULT ActivateConfiguration(
  [in] DIRECTMANIPULATION_CONFIGURATION configuration
);

Parámetros

[in] configuration

Uno o varios valores de DIRECTMANIPULATION_CONFIGURATION que especifican la configuración de interacción para la ventanilla.

Valor devuelto

Si el método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

Una configuración de interacción especifica cómo responde el motor de manipulación a la entrada y qué manipulaciones se admiten. Se puede agregar cualquier número de configuraciones posibles a la ventanilla mediante AddConfiguration antes de procesar la entrada.

La aplicación puede cambiar las configuraciones en tiempo de ejecución mediante ActivateConfiguration.

Cuando una configuración ya no es necesaria (y no está activa actualmente), se puede quitar mediante RemoveConfiguration.

Si no se ha agregado una configuración mediante AddConfiguration, se puede agregar automáticamente y, a continuación, activarla llamando a ActivateConfiguration.

Nota Si se está produciendo el procesamiento de entrada, se producirá un error en esta llamada.

 

Este método produce un error si se ha especificado un comportamiento de arrastrar y colocar .

Un objeto de comportamiento de arrastrar y colocar no se puede adjuntar después de llamar correctamente a este método.

Ejemplos

En el ejemplo siguiente se muestra cómo configurar una ventanilla para el movimiento panorámico horizontal.

HRESULT hr = pViewport>ActivateConfiguration(
    DIRECTMANIPULATION_CONFIGURATION_INTERACTION | 
    DIRECTMANIPULATION_CONFIGURATION_TRANSLATION_X);

Requisitos

Requisito	Value
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

Consulte también

IDirectManipulationViewport