Compartir a través de

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

  • Artículo

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.

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.

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

Consulte también

IDirectManipulationViewport