StatusBarBehavior

Článek
04/02/2024

Umožňuje StatusBarBehavior přizpůsobit barvu a styl stavového řádku zařízení.

Při StatusBarBehavior aktualizaci vlastností se použijí hodnoty barev a stylů. Hodnoty se také použijí na ApplyOn základě vlastnosti. Tato vlastnost umožňuje definovat, která událost životního cyklu se používá:

StatusBarApplyOn.OnBehaviorAttachedTo - Použije barvu a styl, když je chování připojeno ke stránce. Toto je výchozí hodnota.
StatusBarApplyOn.OnPageNavigatedTo – Použije barvu a styl při přechodu na stránku.

Poznámka:

Pokud vaše aplikace změní vzhled stavového řádku na jednotlivých stránkách, měli byste použít StatusBarApplyOn.OnPageNavigatedTo hodnotu vlastnosti ApplyOn . V opačném případě při navigaci zpět systém zachová vzhled stavového řádku ze stránky, ze které uživatel přešl, a ne na.

Důležité

Chování sady nástrojů .NET MAUI Community Toolkit nenastavuje BindingContext chování, protože chování lze sdílet a použít u více ovládacích prvků prostřednictvím stylů. Další informace najdete v tématu Chování rozhraní .NET MAUI.

Syntaxe

XAML

Zahrnutí oboru názvů XAML

Pokud chcete použít sadu nástrojů v XAML, musíte do stránky nebo zobrazení přidat následující xmlns položky:

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

Proto platí následující:

<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>

Bylo by změněno tak, aby zahrnovalo xmlns následující:

<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>

Použití StatusBarBehavior

V XAML je možné ho StatusBarBehavior použít následujícím způsobem:

<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#

V StatusBarBehavior jazyce C# je možné ho použít následujícím způsobem:

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

Existuje jiný způsob, jak získat přístup k rozhraním API stavového řádku v jazyce C#, můžete metody volat přímo, jak je vidět v následujícím fragmentu kódu:

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

Upozorňující

Pokud chcete přidat tento kód MainPagekonstruktoru OnAppearing nebo OnNavigatedTo metody, použijte Behavior místo toho. Použití přímo na těchto místech může dojít k chybovému ukončení aplikace, protože komponenty specifické pro platformu nemusí být inicializovány.

Nejsou potřeba žádné změny.

Do souboru Platforms/iOS/Info.plist přidejte následující klíč a hodnotu:

    <key>UIViewControllerBasedStatusBarAppearance</key>
    <false/>

Vlastnosti

Vlastnost	Type	Popis
Použíton	StatusBarBehavior	Kdy použít barvu a styl stavového řádku
StatusBarColor	Color	Název `Color` z oboru názvů Microsoft.Maui.Graphics.
StatusBarStyle	StatusBarStyle	Styl používaný stavovými řádky může být LightContent, DarkContent nebo Default.

Příklady

Příklad tohoto chování v akci najdete v ukázkové aplikaci .NET MAUI Community Toolkit.

rozhraní API

Zdrojový kód StatusBarBehavior najdete v úložišti .NET MAUI Community Toolkit na GitHubu.

Sdílet prostřednictvím