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 (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
bool
true
si un parent ScrollViewer existe et que la définition de la valeur a entraîné la reprise de l’action de 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 ScrollViewer
interaction 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 ManipulationModecontenant ManipulationModes.System. Un contact tactile donné ne peut être associé qu’à une seule chaîne de visuels à la fois. L’appel TryStartDirectManipulation
de plusieurs fois sur le même contact entraîne la libération de toute chaîne précédente.