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

Ajoute une configuration d’interaction pour la fenêtre d’affichage.

Syntaxe

HRESULT AddConfiguration(
  [in] DIRECTMANIPULATION_CONFIGURATION configuration
);

Paramètres

[in] configuration

L’une des valeurs de DIRECTMANIPULATION_CONFIGURATION qui spécifie la configuration d’interaction pour la fenêtre d’affichage.

Valeur retournée

Si la méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

Une configuration d’interaction spécifie la façon dont le moteur de manipulation répond à l’entrée et les manipulations prises en charge. Vous pouvez ajouter n’importe quel nombre de configurations possibles à la fenêtre d’affichage à l’aide de AddConfiguration avant de traiter l’entrée.

Les configurations peuvent être commutées par l’application au moment de l’exécution à l’aide d’ActivateConfiguration.

Lorsqu’une configuration n’est plus requise (et n’est pas active actuellement), elle peut être supprimée à l’aide de RemoveConfiguration.

Si aucune configuration n’a été ajoutée à l’aide d’AddConfiguration, elle peut être automatiquement ajoutée, puis activée en appelant ActivateConfiguration.

Note Si le traitement d’entrée est en cours, cet appel échoue.

 

Cette méthode échoue si un comportement de glisser-déplacer a été spécifié.

Un objet de comportement de glisser-déplacer ne peut pas être attaché après avoir correctement appelé cette méthode.

Vous ne pouvez pas ajouter un autre comportement de glisser-déplacer une fois qu’un comportement existant a déjà été ajouté.

Cette méthode est conçue pour permettre à une application de basculer des configurations pré-ajoutées, car une configuration ne peut pas être modifiée pendant qu’une manipulation se produit. Dans la plupart des cas, il est préférable de mettre à jour la configuration à l’aide d’ActivateConfiguration.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 8 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2012 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	directmanipulation.h

Voir aussi

IDirectManipulationViewport