Partager via


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.

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.

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

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