Share via

StatusBarBehavior

  • 아티클

장치 StatusBarBehavior 상태 막대의 색과 스타일을 사용자 지정하는 기능을 제공합니다.

StatusBarBehavior 속성이 업데이트되면 색 및 스타일 값이 적용됩니다. 값은 속성에 ApplyOn 따라 적용됩니다. 이 속성을 사용하면 사용되는 수명 주기 이벤트를 정의할 수 있습니다.

  • StatusBarApplyOn.OnBehaviorAttachedTo - 동작이 페이지에 연결되었을 때 색과 스타일을 적용합니다. 기본값입니다.
  • StatusBarApplyOn.OnPageNavigatedTo - 페이지가 탐색될 때 색과 스타일을 적용합니다.

참고 항목

애플리케이션 페이지별로 상태 표시줄 모양을 변경 하는 경우 속성에 StatusBarApplyOn.OnPageNavigatedTo 대 한 ApplyOn 값을 사용 해야 합니다. 그렇지 않으면 시스템을 다시 탐색할 때 사용자가 이동한 페이지의 상태 막대 모양이 유지됩니다.

Important

동작을 공유하고 스타일을 통해 여러 컨트롤에 적용할 수 있으므로 .NET MAUI 커뮤니티 도구 키트 동작은 동작을 설정 BindingContext 하지 않습니다. 자세한 내용은 .NET MAUI 동작을 참조 하세요.

구문

XAML

XAML 네임스페이스 포함

XAML에서 도구 키트를 사용하려면 페이지 또는 보기에 다음 xmlns 을 추가해야 합니다.

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

따라서 다음을 수행합니다.

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

다음과 같이 포함 xmlns 하도록 수정됩니다.

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

StatusBarBehavior 사용

XAML StatusBarBehavior 에서 다음과 같이 사용할 수 있습니다.

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

StatusBarBehavior C#에서 다음과 같이 사용할 수 있습니다.

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

C#의 Statusbar API에 액세스하는 또 다른 방법이 있습니다. 아래 코드 조각에서 볼 수 있듯이 메서드를 직접 호출할 수 있습니다.

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

Warning

이 코드를 MainPage's 생성자 OnAppearing 또는 OnNavigatedTo 메서드에 추가하려면 대신 사용 Behavior 하세요. 이러한 위치에서 직접 사용하면 플랫폼별 구성 요소가 초기화되지 않을 수 있으므로 애플리케이션이 충돌할 수 있습니다.

구성

변경이 필요하지 않습니다.

속성

속성 Type 설명
ApplyOn StatusBarBehavior 상태 막대 색과 스타일을 적용하는 경우
StatusBarColor Color Color Microsoft.Maui.Graphics 네임스페이스의 이름입니다.
StatusBarStyle StatusBarStyle 상태bar에서 사용하는 스타일은 LightContent, DarkContent 또는 Default일 수 있습니다.

예제

.NET MAUI 커뮤니티 도구 키트 샘플 애플리케이션에서 이 동작의 예를 찾을 수 있습니다.

API

.NET MAUI 커뮤니티 도구 키트 GitHub 리포지토리에서 오버에 대한 StatusBarBehavior 소스 코드를 찾을 수 있습니다.