Skip to content

UIScreenMode ​

UIScreenMode 表示屏幕的一种显示模式:一种分辨率和像素形状。

手机自己的屏幕只有一种显示模式。外接显示器可能支持好几种,从屏幕的 availableModes 读到全部,写 currentMode 换一种。

继承关系:EventTarget → NSObject → UIScreenMode

构造函数 ​

不能用 new 创建。new UIScreenMode() 抛 TypeError: Illegal constructor: UIScreenMode is created by the runtime, not by new。从屏幕的 availableModes、currentMode、preferredMode 读。

实例属性 ​

属性说明
size 只读这种模式的大小,单位是像素
pixelAspectRatio 只读一个像素的宽高比

示例 ​

js
application.addEventListener('sceneconnect', (e) => {
  for (const mode of e.scene.screen.availableModes) {
    console.log(mode.size.width, mode.size.height, mode.pixelAspectRatio);
  }
});

结果:在 iPhone Air 模拟器(iOS 27.2)上输出一行 1260 2736 1。

对应的 iOS API ​

ObjCJS
screen.availableModesscreen.availableModes
mode.sizemode.size
mode.pixelAspectRatiomode.pixelAspectRatio

参见 ​