Méthode IDirectManipulationDragDropBehavior ::SetConfiguration (directmanipulation.h)
Définit la configuration de l’interaction glisser-déplacer pour la fenêtre d’affichage à laquelle ce comportement est attaché.
Syntaxe
HRESULT SetConfiguration(
[in] DIRECTMANIPULATION_DRAG_DROP_CONFIGURATION configuration
);
Paramètres
[in] configuration
Combinaison de valeurs de DIRECTMANIPULATION_DRAG_DROP_CONFIGURATION.
Pour que la configuration soit valide, la configuration doit contenir exactement l’une des trois valeurs suivantes :
- DIRECTMANIPULATION_DRAG_DROP_CONFIGURATION_SELECT_ONLY
- DIRECTMANIPULATION_DRAG_DROP_CONFIGURATION_SELECT_DRAG
- DIRECTMANIPULATION_DRAG_DROP_CONFIGURATION_HOLD_DRAG
Si DIRECTMANIPULATION_DRAG_DROP_CONFIGURATION_SELECT_ONLY ou DIRECTMANIPULATION_DRAG_DROP_CONFIGURATION_SELECT_DRAG est spécifié, l’un des DIRECTMANIPULATION_DRAG_DROP_CONFIGURATION_VERTICAL ou DIRECTMANIPULATION_DRAG_DROP_CONFIGURATION_HORIZONTAL est requis.
Si DIRECTMANIPULATION_DRAG_DROP_CONFIGURATION_HOLD_DRAG est spécifié, DIRECTMANIPULATION_DRAG_DROP_CONFIGURATION_VERTICAL et DIRECTMANIPULATION_DRAG_DROP_CONFIGURATION_HORIZONTAL sont requis.
Valeur retournée
Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.
Remarques
La configuration du comportement peut être définie avant ou après son ajout à une fenêtre d’affichage. Si une modification de configuration est apportée pendant qu’une interaction se produit, la nouvelle configuration prend effet sur l’interaction suivante.
IDirectManipulationViewport ::ActivateConfiguration ne doit pas être appelé avant d’appeler IDirectManipulationDragDropBehavior ::SetConfiguration. Cela entraîne un comportement inattendu.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 8.1 [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2012 R2 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | directmanipulation.h |