TitleBar.IsBackButtonEnabled Propriedade

Definição

Namespace:
Microsoft.UI.Xaml.Controls
Editar

Obtém ou define um valor que indica se o botão para navegar de volta está habilitado.

public:
 property bool IsBackButtonEnabled { bool get(); void set(bool value); };
/// [get: Microsoft.UI.Xaml.CustomAttributes.MUXPropertyDefaultValue(value="true")]
/// [set: Microsoft.UI.Xaml.CustomAttributes.MUXPropertyDefaultValue(value="true")]
bool IsBackButtonEnabled();

void IsBackButtonEnabled(bool value);
/// [Microsoft.UI.Xaml.CustomAttributes.MUXPropertyDefaultValue(value="true")]
/// [get: Microsoft.UI.Xaml.CustomAttributes.MUXPropertyDefaultValue(value="true")]
/// [set: Microsoft.UI.Xaml.CustomAttributes.MUXPropertyDefaultValue(value="true")]
bool IsBackButtonEnabled();

void IsBackButtonEnabled(bool value);
public bool IsBackButtonEnabled { [Microsoft.UI.Xaml.CustomAttributes.MUXPropertyDefaultValue(value="true")] get; [Microsoft.UI.Xaml.CustomAttributes.MUXPropertyDefaultValue(value="true")] set; }
[Microsoft.UI.Xaml.CustomAttributes.MUXPropertyDefaultValue(value="true")]
public bool IsBackButtonEnabled { [Microsoft.UI.Xaml.CustomAttributes.MUXPropertyDefaultValue(value="true")] get; [Microsoft.UI.Xaml.CustomAttributes.MUXPropertyDefaultValue(value="true")] set; }
var boolean = titleBar.isBackButtonEnabled;
titleBar.isBackButtonEnabled = boolean;
Public Property IsBackButtonEnabled As Boolean

Valor da propriedade

Boolean

bool

true se o botão para navegar de volta estiver habilitado; caso contrário, false. O padrão é true.

Atributos
Microsoft.UI.Xaml.CustomAttributes.MUXPropertyDefaultValueAttribute

Exemplos

<!-- 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();
    }
}

Comentários

Normalmente, você deve associar a IsBackButtonEnabled propriedade à propriedade CanGoBack do Frame que executará a navegação de volta. Isso desabilitará automaticamente o botão voltar quando a navegação de volta não for possível e habilitará o botão quando for possível.

Ao usar o controle TitleBar com um controle NavigationView , você deve substituir o botão voltar do modo de exibição de navegação pelo botão voltar da barra de título.

É recomendável que você:

  • Oculte o botão Voltar no NavigationView controle. <NavigationView IsBackButtonVisible="Collapsed">
  • Mostrar o botão voltar no TitleBar controle. <TitleBar IsBackButtonVisible="True">
  • Manipule o evento TitleBar.BackRequested para navegar de volta.

Aplica-se a

Confira também

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