跳到主要内容

egret.StageScaleMode

包    egret

类    public class StageScaleMode

StageScaleMode 类为舞台缩放模式提供值。

公共属性​

属性
EXACT_FIT : string
[静态]不保持原始宽高比缩放应用程序内容，缩放后应用程序内容正好填满播放器视口
FIXED_HEIGHT : string
[静态]保持原始宽高比缩放应用程序内容，缩放后应用程序内容在水平和垂直方向都填满播放器视口，但只保持应用程序内容的原始高度不变，宽度可能会改变
FIXED_NARROW : string
[静态]保持原始宽高比缩放应用程序内容，缩放后应用程序内容在水平和垂直方向都填满播放器视口，应用程序内容的较窄方向可能会不够宽而填充
FIXED_WIDE : string
[静态]保持原始宽高比缩放应用程序内容，缩放后应用程序内容在水平和垂直方向都填满播放器视口，应用程序内容的较宽方向的两侧可能会超出播放器视口而被裁切
FIXED_WIDTH : string
[静态]保持原始宽高比缩放应用程序内容，缩放后应用程序内容在水平和垂直方向都填满播放器视口，但只保持应用程序内容的原始宽度不变，高度可能会改变
NO_BORDER : string
[静态]保持原始宽高比缩放应用程序内容，缩放后应用程序内容的较窄方向填满播放器视口，另一个方向的两侧可能会超出播放器视口而被裁切
NO_SCALE : string
[静态]不缩放应用程序内容
SHOW_ALL : string
[静态]保持原始宽高比缩放应用程序内容，缩放后应用程序内容的较宽方向填满播放器视口，另一个方向的两侧可能会不够宽而留有黑边

属性详细信息​

EXACT_FIT​

EXACT_FIT : string = "exactFit"

  • 支持版本:all
  • 运行平台:Web,Native

不保持原始宽高比缩放应用程序内容，缩放后应用程序内容正好填满播放器视口。

在此模式下，舞台尺寸(Stage.stageWidth,Stage.stageHeight)始终等于初始化时外部传入的应用程序内容尺寸。

FIXED_HEIGHT​

FIXED_HEIGHT : string = "fixedHeight"

  • 支持版本:all
  • 运行平台:Web,Native

保持原始宽高比缩放应用程序内容，缩放后应用程序内容在水平和垂直方向都填满播放器视口，但只保持应用程序内容的原始高度不变，宽度可能会改变。

在此模式下，舞台高度(Stage.stageHeight)始终等于初始化时外部传入的应用程序内容高度。舞台宽度(Stage.stageWidth)由当前的缩放比例与播放器视口宽度决定。

FIXED_NARROW​

FIXED_NARROW : string = "fixedNarrow"

  • 支持版本:all
  • 运行平台:Web,Native

保持原始宽高比缩放应用程序内容，缩放后应用程序内容在水平和垂直方向都填满播放器视口，应用程序内容的较窄方向可能会不够宽而填充。

在此模式下，舞台高度(Stage.stageHeight)和舞台宽度(Stage.stageWidth)由当前的缩放比例与播放器视口宽高决定。

FIXED_WIDE​

FIXED_WIDE : string = "fixedWide"

  • 支持版本:all
  • 运行平台:Web,Native

保持原始宽高比缩放应用程序内容，缩放后应用程序内容在水平和垂直方向都填满播放器视口，应用程序内容的较宽方向的两侧可能会超出播放器视口而被裁切。

在此模式下，舞台高度(Stage.stageHeight)和舞台宽度(Stage.stageWidth)由当前的缩放比例与播放器视口宽高决定。

FIXED_WIDTH​

FIXED_WIDTH : string = "fixedWidth"

  • 支持版本:all
  • 运行平台:Web,Native

保持原始宽高比缩放应用程序内容，缩放后应用程序内容在水平和垂直方向都填满播放器视口，但只保持应用程序内容的原始宽度不变，高度可能会改变。

在此模式下，舞台宽度(Stage.stageWidth)始终等于初始化时外部传入的应用程序内容宽度。舞台高度(Stage.stageHeight)由当前的缩放比例与播放器视口高度决定。

NO_BORDER​

NO_BORDER : string = "noBorder"

  • 支持版本:all
  • 运行平台:Web,Native

保持原始宽高比缩放应用程序内容，缩放后应用程序内容的较窄方向填满播放器视口，另一个方向的两侧可能会超出播放器视口而被裁切。

在此模式下，舞台尺寸(Stage.stageWidth,Stage.stageHeight)始终等于初始化时外部传入的应用程序内容尺寸。

NO_SCALE​

NO_SCALE : string = "noScale"

  • 支持版本:all
  • 运行平台:Web,Native

不缩放应用程序内容。即使在更改播放器视口大小时，它仍然保持不变。如果播放器视口比内容小，则可能进行一些裁切。

在此模式下，舞台尺寸（Stage.stageWidth,Stage.stageHeight）始终跟播放器视口大小保持一致。

SHOW_ALL​

SHOW_ALL : string = "showAll"

  • 支持版本:all
  • 运行平台:Web,Native

保持原始宽高比缩放应用程序内容，缩放后应用程序内容的较宽方向填满播放器视口，另一个方向的两侧可能会不够宽而留有黑边。

在此模式下，舞台尺寸(Stage.stageWidth,Stage.stageHeight)始终等于初始化时外部传入的应用程序内容尺寸。

示例​

/*
 * 以下示例演示了设置屏幕适配方式。
 * 游戏默认的适配方式在egret_loader.js和native_require.js中修改
 */
class  StageScaleModeExample  extends  egret.DisplayObjectContainer  {
  public  constructor()  {
    super();
    this.addEventListener(egret.Event.ADDED_TO_STAGE,  this.onAddToStage,  this);
  }
  private  onAddToStage():void  {
    this.removeEventListener(egret.Event.ADDED_TO_STAGE,  this.onAddToStage,  this);
    //设置屏幕适配方式为 EXACT_FIT
    this.stage.scaleMode  = egret.StageScaleMode.EXACT_FIT;
  }
}