UIElement.TryStartDirectManipulation(Pointer) Méthode

Référence

Définition

Espace de noms:: Windows.UI.Xaml

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Modifier

Reprend le traitement de manipulation directe (mouvement panoramique/zoom défini par le système) sur n’importe quel parent ScrollViewer qui contient l’élément UIElement actuel.

public:
 static bool TryStartDirectManipulation(Pointer ^ value);

 static bool TryStartDirectManipulation(Pointer const& value);

public static bool TryStartDirectManipulation(Pointer value);

function tryStartDirectManipulation(value)

Public Shared Function TryStartDirectManipulation (value As Pointer) As Boolean

Paramètres

value: Pointer

Point tactile actif à l’origine de la manipulation.

Retours

Boolean

bool

true si un parent ScrollViewer existe et si la définition de la valeur a entraîné la reprise de l’action de mouvement panoramique/zoom. false si l’appel de la méthode n’entraîne aucune action.

Remarques

Par défaut, les interactions d’entrée tactile dans les éléments ScrollViewer sont gérées par le moteur de manipulation directe hors du thread d’interface utilisateur. Une application ne peut pas traiter directement les événements de pointeur associés après le démarrage du traitement de la manipulation directe . Vous pouvez appeler CancelDirectManipulations au début d’une interaction ScrollViewer et gérer les événements de pointeur sur le thread d’interface utilisateur, ce qui vous donne la possibilité d’effectuer une gestion d’entrée personnalisée dans un ScrollViewer.

Si vous annulez le traitement de la manipulation directe au début d’une interaction ScrollViewer , vous pouvez appeler TryStartDirectManipulation pour reprendre le traitement du flux d’entrée par la manipulation directe . Cela vous permet d’effectuer d’abord un traitement d’entrée personnalisé, puis de reprendre la gestion de la manipulation directe pour rendre votre application plus réactive aux interactions tactiles telles que le défilement et le zoom.

Seuls les contacts tactiles actifs peuvent être passés à La manipulation directe. L’utilisation de contacts non actifs ou non tactiles entraîne la levée d’une exception.

Si vous spécifiez un contact tactile à passer à Direct Manipulation , l’infrastructure remonte la chaîne parente et définit le contact sur la fenêtre d’affichage Manipulation directe de chaque ScrollViewer rencontré dans l’ordre, jusqu’à ce que la marche atteigne tout élément (y compris l’élément cible d’origine) qui n’a pas de ManipulationMode contenant ManipulationModes.System. Un contact tactile donné ne peut être associé qu’à une seule chaîne de visuels à la fois. L’appel de TryStartDirectManipulation plusieurs fois sur le même contact entraîne la publication de toute chaîne précédente.

S’applique à