UIElement.TryStartDirectManipulation(Pointer) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Setzt die direkte Manipulationsverarbeitung (systemdefiniertes Verschieben/Zoomen) für jedes übergeordnete ScrollViewer-Element fort, das das aktuelle UIElement enthält.
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 BooleanParameter
- value
- Pointer
Der aktive Touchpunkt, der die Manipulation initiiert hat.
Gibt zurück
bool
true wenn ein übergeordnetes ScrollViewer-Element vorhanden ist und das Festlegen des Werts dazu führte, dass die Verschiebungs-/Zoomaktion fortgesetzt wurde.
false wenn das Aufrufen der Methode zu keiner Aktion führt.
Hinweise
Standardmäßig werden Toucheingabeinteraktionen in ScrollViewer-Elementen vom Direct Manipulation-Modul aus dem UI-Thread behandelt. Eine App kann die zugeordneten Zeigerereignisse nicht direkt verarbeiten, nachdem die Direkte Manipulationsverarbeitung gestartet wurde. Sie können CancelDirectManipulations zu Beginn einer ScrollViewer Interaktion aufrufen und die Zeigerereignisse im UI-Thread behandeln, was Ihnen die Möglichkeit bietet, benutzerdefinierte Eingabebehandlung in einem ScrollViewer.
Wenn Sie die Direkte Manipulationsverarbeitung zu Beginn einer ScrollViewer-Interaktion abbrechen, können Sie aufrufen TryStartDirectManipulation , um den Direkten Manipulationsprozess des Eingabedatenstroms fortzusetzen. Auf diese Weise können Sie zuerst eine benutzerdefinierte Eingabeverarbeitung durchführen und dann die direkte Manipulationsbehandlung fortsetzen, um Ihre App reaktionsfähiger auf Touchinteraktionen wie Scrollen und Zoomen zu machen.
Nur aktive Touchkontakte können an die direkte Manipulation übergeben werden. Die Verwendung von nicht aktiven oder nicht touchbezogenen Kontakten bewirkt, dass eine Ausnahme ausgelöst wird.
Wenn Sie einen Touchkontakt angeben, der an direct Manipulation übergeben werden soll, führt das Framework dazu, die übergeordnete Kette zu durchlaufen, und legen Sie den Kontakt im DirectManipulation-Viewport jedes ScrollViewer-Elements in der Reihenfolge fest, bis der Walk ein Element (einschließlich des ursprünglichen Zielelements) erreicht, das keine ManipulationMode enthält, die ManipulationModes.System enthält. Ein gegebener Berührungskontakt kann jeweils nur einer einzelnen Kette visueller Elemente zugeordnet werden. Das Aufrufen TryStartDirectManipulation von mehr als einmal an demselben Kontakt führt dazu, dass alle vorherigen Ketten freigegeben werden.