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

Définit la configuration pour l’interaction d’entrée.

Syntaxe

HRESULT ActivateConfiguration(
  [in] DIRECTMANIPULATION_CONFIGURATION configuration
);

Paramètres

[in] configuration

Une ou plusieurs valeurs de DIRECTMANIPULATION_CONFIGURATION qui spécifient 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.

Exemples

L’exemple suivant montre comment configurer une fenêtre d’affichage pour un panoramique horizontal.

HRESULT hr = pViewport>ActivateConfiguration(
    DIRECTMANIPULATION_CONFIGURATION_INTERACTION | 
    DIRECTMANIPULATION_CONFIGURATION_TRANSLATION_X);

Configuration requise

Voir aussi

IDirectManipulationViewport