UIElement.TryStartDirectManipulation(Pointer) Methode

Referenz

Definition

Namespace:: Windows.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 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 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 Verschiebungs-/Zoomaktion fortgesetzt wurde. false , wenn der Aufruf der -Methode zu keiner Aktion führt.

Hinweise

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

Wenn Sie die Verarbeitung der direkten Manipulation am Anfang einer ScrollViewer-Interaktion abbrechen, können Sie TryStartDirectManipulation aufrufen, um den Eingabedatenstrom mit der direkten 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. Die Verwendung nicht aktiver oder nicht berührungsfreier Kontakte führt dazu, dass eine Ausnahme ausgelöst wird.

Wenn Sie einen Berührungskontakt angeben, der an die direkte Bearbeitung übergeben werden soll, führt das Framework dazu, dass die übergeordnete Kette nach oben bewegt wird und der Kontakt für den Ansichtsport "Direkte Manipulation " der einzelnen ScrollViewer-Instanzen in der richtigen Reihenfolge festgelegt wird, bis der Walk ein Element (einschließlich des ursprünglichen Zielelements) erreicht, das keinen ManipulationMode enthält, der ManipulationModes.System enthält. Ein gegebener Touchkontakt kann jeweils nur einer einzelnen Kette von Visuals zugeordnet werden. Wenn TryStartDirectManipulation mehrmals für denselben Kontakt aufgerufen wird, wird jede vorherige Kette freigegeben.

Gilt für: