通过

在 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 方法控制是否禁用安全区域布局指南。

注意

该 Layout 类定义一个 IgnoreSafeArea 属性，该属性可确保内容放置在对所有 iOS 设备都安全的屏幕区域中。 此属性可在任何布局类（例如 Grid 或 StackLayout）设置为 true，以执行这个特定于平台的操作的等效项。