Método IDirectManipulationDragDropBehavior::SetConfiguration (directmanipulation.h)
Establece la configuración de la interacción de arrastrar y colocar para la ventanilla a la que se adjunta este comportamiento.
Sintaxis
HRESULT SetConfiguration(
[in] DIRECTMANIPULATION_DRAG_DROP_CONFIGURATION configuration
);
Parámetros
[in] configuration
Combinación de valores de DIRECTMANIPULATION_DRAG_DROP_CONFIGURATION.
Para que la configuración sea válida, la configuración debe contener exactamente uno de los tres valores siguientes:
- DIRECTMANIPULATION_DRAG_DROP_CONFIGURATION_SELECT_ONLY
- DIRECTMANIPULATION_DRAG_DROP_CONFIGURATION_SELECT_DRAG
- DIRECTMANIPULATION_DRAG_DROP_CONFIGURATION_HOLD_DRAG
Si se especifica DIRECTMANIPULATION_DRAG_DROP_CONFIGURATION_SELECT_ONLY o DIRECTMANIPULATION_DRAG_DROP_CONFIGURATION_SELECT_DRAG , se requiere uno de DIRECTMANIPULATION_DRAG_DROP_CONFIGURATION_VERTICAL o DIRECTMANIPULATION_DRAG_DROP_CONFIGURATION_HORIZONTAL .
Si se especifica DIRECTMANIPULATION_DRAG_DROP_CONFIGURATION_HOLD_DRAG , se requieren DIRECTMANIPULATION_DRAG_DROP_CONFIGURATION_VERTICAL y DIRECTMANIPULATION_DRAG_DROP_CONFIGURATION_HORIZONTAL .
Valor devuelto
Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.
Comentarios
La configuración del comportamiento se puede establecer antes o después de que se haya agregado a una ventanilla. Si se realiza un cambio de configuración mientras se produce una interacción, la nueva configuración surte efecto en la siguiente interacción.
No se debe llamar a IDirectManipulationViewport::ActivateConfiguration antes de llamar a IDirectManipulationDragDropBehavior::SetConfiguration. Esto dará lugar a un comportamiento inesperado.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 8.1 [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2012 R2 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | directmanipulation.h |