Start Debugging
DE
2026-04-16 dotnet-mauidotnet-11xamlmobile

.NET MAUI 11 liefert einen eingebauten LongPressGestureRecognizer

.NET MAUI 11 Preview 3 fügt LongPressGestureRecognizer als First-Party-Geste hinzu, mit Duration, Bewegungs-Threshold, State-Events und Command-Binding - und ersetzt das übliche Community-Toolkit-Behavior.

Von Marius Bughiu · 2 Min. Lesezeit ·

Bis jetzt hieß Long Press in .NET MAUI zu erkennen, zu einem Drittanbieter-Behavior zu greifen, dem TouchBehavior des Community Toolkits, oder Platform Handler pro OS zu schreiben. .NET MAUI 11 Preview 3 erhebt das Pattern zu einer First-Party-API mit LongPressGestureRecognizer, eingelandet über dotnet/maui #33432.

Was Sie out of the box bekommen

Der neue Recognizer sitzt neben TapGestureRecognizer, PanGestureRecognizer und dem Rest der Familie. Er exponiert vier Dinge, die für echte UIs zählen:

Weil er an GestureRecognizers hängt, nimmt jede View, die bereits Gesten akzeptiert, ihn ohne Handler-Änderungen auf.

TouchBehavior in XAML ersetzen

Ein Kontextmenü auf einem Avatarbild ist der kanonische Fall. In .NET MAUI 10 brauchte das typischerweise ein TouchBehavior mit einem LongPressCommand. In .NET MAUI 11 kollabiert das zu:

<Image Source="avatar.png"
       HeightRequest="64"
       WidthRequest="64">
    <Image.GestureRecognizers>
        <LongPressGestureRecognizer
            MinimumPressDuration="650"
            MovementThreshold="10"
            Command="{Binding ShowContextMenuCommand}"
            CommandParameter="{Binding .}" />
    </Image.GestureRecognizers>
</Image>

Der Recognizer dispatcht auf dem UI-Thread und reicht den gebundenen Parameter direkt durch, sodass das View Model plattformagnostisch bleibt.

Auf State reagieren für Press-Feedback

Das StateChanged-Event ist das, was das nativ anfühlen lässt. Die meisten Plattform-Long-Presses animieren eine Scale oder dimmen das Target während des Halts und brechen sauber ab, wenn der Finger verrutscht. Mit der neuen API lebt diese Logik an einer Stelle:

var longPress = new LongPressGestureRecognizer
{
    MinimumPressDuration = 500
};

longPress.StateChanged += async (s, e) =>
{
    switch (e.State)
    {
        case GestureRecognizerState.Started:
            await card.ScaleTo(0.97, 80);
            break;
        case GestureRecognizerState.Completed:
            await HapticFeedback.Default.PerformAsync(HapticFeedbackType.LongPress);
            await card.ScaleTo(1.0, 80);
            ShowMenu();
            break;
        case GestureRecognizerState.Canceled:
            await card.ScaleTo(1.0, 80);
            break;
    }
};

card.GestureRecognizers.Add(longPress);

Dieses eine Event ersetzt drei Platform Handler und ein im MauiProgram verdrahtetes Behavior.

Warum das für Library-Autoren zählt

Control Libraries, die zuvor eigene Long-Press-Plumbing ausgeliefert haben, können sich jetzt auf einen gemeinsamen Contract stützen. Ein Microsoft.Maui.Controls-Recognizer bedeutet, dass Bindings, Input Transparency und IsEnabled-Propagation bereits so arbeiten, wie der Rest des Frameworks arbeitet, sodass Konsumenten nicht mehr auf Inkonsistenzen stoßen wie die Geste, die während eines CollectionView-Scrolls auslöst oder InputTransparent="True" an einem Parent ignoriert.

Wenn Sie noch auf dem Community-Toolkit-TouchBehavior sind, ist die Migration meist ein Ein-Zeilen-Tausch und ein Property-Rename. Schauen Sie in die vollständigen MAUI-Release-Notes für Preview 3 für die begleitenden Gesten- und XAML-Änderungen.

< Zurück