iOS で安全領域レイアウト ガイドを有効化する

既定では、.NET マルチプラットフォーム アプリ UI (.NET MAUI) アプリは、すべてのデバイスで安全な画面領域にページ コンテンツを自動的に配置します。 これは安全領域レイアウト ガイドとして知られており、一部の iPhone モデルのデバイスの丸い角、ホーム インジケーター、またはセンサー ハウジングによってコンテンツが切り取られないようにします。

この iOS プラットフォーム固有の機能を使用すると、安全領域レイアウト ガイドが以前に無効化されている場合に有効化できます。この機能は、Page.UseSafeArea 添付プロパティを true に設定することにより XAML で使用されます。

<ContentPage ...
             xmlns:ios="clr-namespace:Microsoft.Maui.Controls.PlatformConfiguration.iOSSpecific;assembly=Microsoft.Maui.Controls"
             ios:Page.UseSafeArea="True">
    <StackLayout>
        ...
    </StackLayout>
</ContentPage>

あるいは、Fluent API を使用して C# から使用することもできます。

using Microsoft.Maui.Controls.PlatformConfiguration;
using Microsoft.Maui.Controls.PlatformConfiguration.iOSSpecific;

On<iOS>().SetUseSafeArea(true);

Page.On<iOS> メソッドは、このプラットフォーム固有が iOS でのみ実行されるように指定します。 Microsoft.Maui.Controls.PlatformConfiguration.iOSSpecific 名前空間の Page.SetUseSafeArea メソッドは、安全領域レイアウト ガイドを無効にするかどうかを制御します。

Note

Layout クラスは、すべての iOS デバイスにとって安全な画面領域にコンテンツが配置されるようにする IgnoreSafeArea プロパティを定義します。 このプロパティは、Grid や StackLayout など、任意のレイアウト クラスで true に設定して、このプラットフォーム固有の機能と同等の機能を実行できます。