在 iOS 上啟用安全區域配置指南

根據預設，.NET 多平臺應用程式 UI （.NET MAUI） 應用程式會自動將頁面內容放置在所有裝置安全畫面的區域。 這稱為安全區域配置指南，可確保內容不會被圓角、家用指示器或某些 i 電話 型號上的感測器住房裁剪。

此 iOS 平臺特定可啟用安全區域配置指南，如果先前已停用，並在 XAML 中藉由將附加屬性設定 Page.UseSafeArea 為 true來取用：

<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上執行。 命名空間 Page.SetUseSafeArea 中的 Microsoft.Maui.Controls.PlatformConfiguration.iOSSpecific 方法會控制是否停用安全區域配置指南。

注意

類別 Layout 會 IgnoreSafeArea 定義 屬性，以確保內容位於所有 iOS 裝置安全畫面的區域。 這個屬性可以在 任何配置類別上設定為 true ，例如 Grid 或 StackLayout，以執行這個平臺專屬的對等專案。