TitleBar.BackRequested Ereignis

Definition

Namespace:
Microsoft.UI.Xaml.Controls
Bearbeiten

Tritt auf, wenn die Zurücknavigationsschaltfläche aufgerufen wird.

// Register
event_token BackRequested(TypedEventHandler<TitleBar, IInspectable const&> const& handler) const;

// Revoke with event_token
void BackRequested(event_token const* cookie) const;

// Revoke with event_revoker
TitleBar::BackRequested_revoker BackRequested(auto_revoke_t, TypedEventHandler<TitleBar, IInspectable const&> const& handler) const;
public event TypedEventHandler<TitleBar,object> BackRequested;
function onBackRequested(eventArgs) { /* Your code */ }
titleBar.addEventListener("backrequested", onBackRequested);
titleBar.removeEventListener("backrequested", onBackRequested);
- or -
titleBar.onbackrequested = onBackRequested;
Public Custom Event BackRequested As TypedEventHandler(Of TitleBar, Object)

Ereignistyp

TypedEventHandler<TitleBar,Object>

TypedEventHandler<TitleBar,IInspectable>

Beispiele

<!-- MainWindow.xaml -->

<Grid>
    <Grid.RowDefinitions>
        <RowDefinition Height="Auto" />
        <RowDefinition Height="*" />
    </Grid.RowDefinitions>
    <TitleBar Title="My App"
              IsBackButtonVisible="True"
              IsBackButtonEnabled="{x:Bind RootFrame.CanGoBack, Mode=OneWay}"
              BackRequested="TitleBar_BackRequested">
    </TitleBar>

    <NavigationView x:Name="RootNavigationView" Grid.Row="1"
                    IsBackButtonVisible="Collapsed">
        <Frame x:Name="RootFrame" />
    </NavigationView>
</Grid>

// MainWindow.xaml.cs

private void TitleBar_BackRequested(TitleBar sender, object args)
{
    if (RootFrame.CanGoBack)
    {
        RootFrame.GoBack();
    }
}

Hinweise

Wenn Sie das TitleBar-Steuerelement mit einem NavigationView-Steuerelement verwenden, sollten Sie die Zurück-Schaltfläche der Navigationsansicht durch die Zurück-Schaltfläche der Titelleiste ersetzen.

Wir empfehlen, dass Sie wie folgt vorgehen:

  • Blenden Sie die Schaltfläche "Zurück" im NavigationView Steuerelement aus. <NavigationView IsBackButtonVisible="Collapsed">
  • Zeigen Sie die Schaltfläche "Zurück" im TitleBar Steuerelement an. <TitleBar IsBackButtonVisible="True">
  • Behandeln Sie dieses Ereignis, um zurück zu navigieren.

Gilt für:

Weitere Informationen

  • IsBackButtonVisible
  • <xref:Microsoft.UI.Xaml.Controls.TitleBar.IsBackButtonEnabled+%5bNavigationView.IsBackButtonVisible%5d(%2fwindows%2fwindows-app-sdk%2fapi%2fwinrt%2fmicrosoft.ui.xaml.controls.navigationview.isbackbuttonvisible)>