display.safeScreenOriginY

类型 数字
库 display.*
修订版 发行版 2024.3703
关键词 屏幕、原点、安全区域
另请参阅 display.safeScreenOriginX
display.safeActualContentHeight
display.getSafeAreaInsets()

概述

返回“安全区域”边界的顶部到内容区域顶部之间的y距离，以 Corona 内容单位为单位。“安全区域”是放置重要 UI 元素的矩形区域，确保其不受状态栏、传感器栏或圆角等设备外观、软件按钮、电视过扫描区域等遮挡。

对于不支持安全区域概念的设备，此值与 display.screenOriginY 相同。

示例

-- Create a vector rectangle sized exactly to the "safe area"
local safeArea = display.newRect(
    display.safeScreenOriginX,
    display.safeScreenOriginY,
    display.safeActualContentWidth,
    display.safeActualContentHeight
)
safeArea:translate( safeArea.width*0.5, safeArea.height*0.5 )