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.

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

Voir aussi

IDirectManipulationViewport