UIElement.TryStartDirectManipulation(Pointer) Méthode
Définition
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.
Reprend le traitement de manipulation directe (panoramique/zoom défini par le système) sur n’importe quel parent ScrollViewer qui contient l’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 qui a lancé la manipulation.
Retours
bool
true si un parent ScrollViewer existe et si la valeur a abouti à la reprise de l’action 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 manipulation directe . Vous pouvez appeler CancelDirectManipulations au début d’une ScrollViewer interaction et gérer les événements de pointeur sur le thread d’interface utilisateur, ce qui vous donne la possibilité de gérer les entrées personnalisées dans un ScrollViewer.
Si vous annulez le traitement de manipulation directe au début d’une interaction ScrollViewer , vous pouvez appeler TryStartDirectManipulation pour reprendre le processus de manipulation directe du flux d’entrée. Cela vous permet d’effectuer d’abord un traitement d’entrée personnalisé, puis de reprendre la gestion des manipulations directes 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.
La spécification d’un contact tactile à transmettre à Direct Manipulation entraîne la marche à pied de la chaîne parente et la définition du contact sur la fenêtre d’affichage Manipulation directe de chaque ScrollViewer rencontrée dans l’ordre, jusqu’à ce que la marche atteigne n’importe quel élément (y compris l’élément cible d’origine) qui ne dispose pas d’un ManipulationMode qui contient ManipulationModes.System. Un contact tactile donné ne peut être associé qu’à une seule chaîne de visuels à la fois. L’appel TryStartDirectManipulation plusieurs fois sur le même contact entraîne la publication d’une chaîne précédente.