display.safeScreenOriginX

类型 数字
display.*
版本 版本 2024.3703
关键词 屏幕,原点,安全区域
另请参阅 display.safeScreenOriginY
display.safeActualContentWidth
display.getSafeAreaInsets()

概述

返回从“安全区域”边界左侧到内容区域左侧的 **x** 距离,以 Corona 内容单位表示。“安全区域”是指可以安全放置重要 UI 元素的矩形区域,确保它们不会被状态栏、传感器栏或圆角等设备特性、软件按钮、电视过扫描区域等遮挡。

对于**不**具备安全区域概念的设备,此值与 display.screenOriginX 相同。

示例

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