Método IDirectManipulationDragDropBehavior::SetConfiguration (directmanipulation.h)
Define a configuração da interação de arrastar e soltar para o visor ao qual esse comportamento está anexado.
Sintaxe
HRESULT SetConfiguration(
[in] DIRECTMANIPULATION_DRAG_DROP_CONFIGURATION configuration
);
Parâmetros
[in] configuration
Combinação de valores de DIRECTMANIPULATION_DRAG_DROP_CONFIGURATION.
Para que a configuração seja válida, a configuração deve conter exatamente um dos três valores a seguir:
- DIRECTMANIPULATION_DRAG_DROP_CONFIGURATION_SELECT_ONLY
- DIRECTMANIPULATION_DRAG_DROP_CONFIGURATION_SELECT_DRAG
- DIRECTMANIPULATION_DRAG_DROP_CONFIGURATION_HOLD_DRAG
Se DIRECTMANIPULATION_DRAG_DROP_CONFIGURATION_SELECT_ONLY ou DIRECTMANIPULATION_DRAG_DROP_CONFIGURATION_SELECT_DRAG for especificado, um dos DIRECTMANIPULATION_DRAG_DROP_CONFIGURATION_VERTICAL ou DIRECTMANIPULATION_DRAG_DROP_CONFIGURATION_HORIZONTAL será necessário.
Se DIRECTMANIPULATION_DRAG_DROP_CONFIGURATION_HOLD_DRAG for especificado, DIRECTMANIPULATION_DRAG_DROP_CONFIGURATION_VERTICAL e DIRECTMANIPULATION_DRAG_DROP_CONFIGURATION_HORIZONTAL serão necessários.
Retornar valor
Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.
Comentários
A configuração do comportamento pode ser definida antes ou depois de ter sido adicionada a um visor. Se uma alteração de configuração for feita enquanto uma interação estiver ocorrendo, a nova configuração entrará em vigor na próxima interação.
IDirectManipulationViewport::ActivateConfiguration não deve ser chamado antes de chamar IDirectManipulationDragDropBehavior::SetConfiguration. Isso resultará em um comportamento inesperado.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 8.1 [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2012 R2 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | directmanipulation.h |