Udostępnij za pośrednictwem

StatusBarBehavior

  • Artykuł

Zapewnia StatusBarBehavior możliwość dostosowywania koloru i stylu paska stanu urządzeń.

Element StatusBarBehavior stosuje wartości koloru i stylu podczas aktualizowania właściwości. Wartości są również stosowane na ApplyOn podstawie właściwości . Ta właściwość umożliwia zdefiniowanie, które zdarzenie cyklu życia jest używane:

  • StatusBarApplyOn.OnBehaviorAttachedTo — Stosuje kolor i styl, gdy zachowanie zostało dołączone do strony. Jest to wartość domyślna.
  • StatusBarApplyOn.OnPageNavigatedTo — Stosuje kolor i styl po przejściu do strony.

Uwaga

Jeśli aplikacja zmienia wygląd paska stanu dla poszczególnych stron, należy użyć StatusBarApplyOn.OnPageNavigatedTo wartości właściwości ApplyOn . W przeciwnym razie podczas przechodzenia z powrotem system zachowa wygląd paska stanu ze strony, z których użytkownik przechodził, a nie do.

Ważne

Zachowania zestawu narzędzi .NET MAUI Community Toolkit nie ustawiają BindingContext zachowania, ponieważ zachowania mogą być współużytkowane i stosowane do wielu kontrolek za pomocą stylów. Aby uzyskać więcej informacji, zobacz Zachowania maUI platformy .NET

Składnia

XAML

Dołączanie przestrzeni nazw XAML

Aby można było używać zestawu narzędzi w języku XAML, należy dodać następujące xmlns elementy do strony lub widoku:

xmlns:toolkit="http://schemas.microsoft.com/dotnet/2022/maui/toolkit"

W związku z tym następujące elementy:

<ContentPage
    x:Class="CommunityToolkit.Maui.Sample.Pages.MyPage"
    xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
    xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml">

</ContentPage>

Zostanie zmodyfikowana tak, aby zawierała następujące xmlns elementy:

<ContentPage
    x:Class="CommunityToolkit.Maui.Sample.Pages.MyPage"
    xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
    xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
    xmlns:toolkit="http://schemas.microsoft.com/dotnet/2022/maui/toolkit">

</ContentPage>

Używanie elementu StatusBarBehavior

Można StatusBarBehavior go użyć w następujący sposób w języku XAML:

<ContentPage xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
             xmlns:toolkit="http://schemas.microsoft.com/dotnet/2022/maui/toolkit"
             x:Class="MyLittleApp.MainPage">
    
    <ContentPage.Behaviors>
        <toolkit:StatusBarBehavior StatusBarColor="Fuchsia" StatusBarStyle="LightContent" />
    </ContentPage.Behaviors>

</ContentPage>

C#

Można StatusBarBehavior go użyć w następujący sposób w języku C#:

class MyPage : ContentPage
{
    public MyPage()
    {
        this.Behaviors.Add(new StatusBarBehavior
        {
            StatusBarColor = Colors.Red,
            StatusBarStyle = StatusBarStyle.LightContent
        });
    }
}

Istnieje inny sposób uzyskiwania dostępu do interfejsów API paska stanu w języku C#. Metody można wywołać bezpośrednio, jak widać w poniższym fragmencie kodu:

class MyPage : ContentPage
{
    protected override void OnNavigatedTo(NavigatedToEventArgs args)
    {
        base.OnNavigatedTo(args);
        CommunityToolkit.Maui.Core.Platform.StatusBar.SetColor(statusBarColor);
        CommunityToolkit.Maui.Core.Platform.StatusBar.SetStyle(StatusBarStyle.LightContent);
    }
}

Ostrzeżenie

Jeśli chcesz dodać ten kod jako MainPagekonstruktor OnAppearing lub OnNavigatedTo metody , użyj zamiast niego Behavior . Użycie bezpośrednio w tych miejscach może spowodować awarię aplikacji, ponieważ składniki specyficzne dla platformy mogą nie zostać zainicjowane.

Konfigurowanie

Nie są potrzebne żadne zmiany.

Właściwości

Właściwości Type Opis
Zastosuj StatusBarBehavior Kiedy należy zastosować kolor i styl paska stanu.
StatusBarColor Color Nazwa Color z przestrzeni nazw Microsoft.Maui.Graphics.
StatusBarStyle StatusBarStyle Styl używany przez pasek stanu może mieć wartość LightContent, DarkContent lub Default.

Przykłady

Przykład tego zachowania można znaleźć w przykładzie przykładowym aplikacji zestawu narzędzi .NET MAUI Community Toolkit.

interfejs API

Kod źródłowy można StatusBarBehavior znaleźć w repozytorium GitHub zestawu narzędzi .NET MAUI Community Toolkit.