UIElement.TryStartDirectManipulation(Pointer) Methode

Referenz

Definition

Namespace:: Microsoft.UI.Xaml

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.

Bearbeiten

Setzt die direkte Bearbeitungsverarbeitung (systemdefiniertes Schwenken/Zoomen) für ein beliebiges übergeordnetes 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 Boolean

Parameter

value: Pointer

Der aktive Touchpunkt, der die Bearbeitung initiiert hat.

Gibt zurück

Boolean

bool

true , wenn ein übergeordnetes ScrollViewer-Element vorhanden ist und das Festlegen des Werts dazu führte, dass die Aktion "Schwenken/Zoomen" fortgesetzt wurde. false , wenn das Aufrufen der -Methode zu keiner Aktion führt.

Hinweise

Standardmäßig werden Toucheingabeinteraktionen in ScrollViewer-Elementen von der Direct Manipulation-Engine aus dem UI-Thread verarbeitet. Eine App kann die zugeordneten Zeigerereignisse nicht direkt verarbeiten, nachdem die Verarbeitung der direkten Bearbeitung gestartet wurde. Sie können CancelDirectManipulations am Anfang einer ScrollViewer Interaktion aufrufen und die Zeigerereignisse im UI-Thread behandeln, wodurch Sie die Möglichkeit haben, benutzerdefinierte Eingabebehandlung in einem ScrollViewerdurchzuführen.

Wenn Sie die Verarbeitung der direkten Bearbeitung zu Beginn einer ScrollViewer-Interaktion abbrechen, können Sie aufrufen TryStartDirectManipulation , um den Eingabedatenstrom mit direkter Bearbeitung fortzusetzen. Auf diese Weise können Sie zuerst eine benutzerdefinierte Eingabeverarbeitung durchführen und dann die Verarbeitung der direkten Bearbeitung fortsetzen, um Ihre App besser auf Touchinteraktionen wie Scrollen und Zoomen reagieren zu lassen.

Nur aktive Touchkontakte können an die direkte Bearbeitung übergeben werden. Wenn Sie nicht aktive Kontakte oder Kontakte ohne Toucheingabe verwenden, wird eine Ausnahme ausgelöst.

Wenn Sie einen Berührungskontakt angeben, der an die direkte Bearbeitung übergeben werden soll, führt das Framework dazu, die übergeordnete Kette nach oben zu bewegen und den Kontakt für den Ansichtsport "Direkte Bearbeitung " für jeden gefundenen ScrollViewer in der richtigen Reihenfolge festzulegen, bis der Walk ein Element (einschließlich des ursprünglichen Zielelements) erreicht, das nicht über einen ManipulationMode verfügt, der ManipulationModes.System enthält. Ein gegebener Berührungskontakt kann nur einer einzelnen Kette von Visuals gleichzeitig zugeordnet werden. Wenn Sie mehr als einmal für denselben Kontakt aufrufen TryStartDirectManipulation , wird jede vorherige Kette freigegeben.

Gilt für:

Share via