Método IDirectManipulationViewport::AddConfiguration (directmanipulation.h)
Agrega una configuración de interacción para la ventanilla.
Sintaxis
HRESULT AddConfiguration(
[in] DIRECTMANIPULATION_CONFIGURATION configuration
);
Parámetros
[in] configuration
Uno de los valores de DIRECTMANIPULATION_CONFIGURATION que especifica la configuración de interacción de 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.
Un objeto de comportamiento de arrastrar y colocar no se puede adjuntar después de llamar correctamente a este método.
No se puede agregar otro comportamiento de arrastrar y colocar después de que ya se haya agregado uno existente.
Este método está diseñado para permitir que una aplicación cambie las configuraciones agregadas previamente, ya que no se puede cambiar una configuración mientras se produce una manipulación. En la mayoría de las circunstancias, es mejor actualizar la configuración mediante ActivateConfiguration.
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 |