egret.BitmapText
包 egret
类 public class BitmapText
继承 egret.BitmapText → egret.DisplayObject → egret.EventDispatcher → egret.HashObject
位图字体采用了Bitmap+SpriteSheet的方式来渲染文字。
公共属性
| 属性 |
|---|
| EMPTY_FACTOR : number [静态]一个空格字符的宽度比例 |
| font : Object 要使用的字体的名称或用逗号分隔的字体名称列表，类型必须是 BitmapFont |
| letterSpacing : number 一个整数，表示字符之间的距离 |
| lineSpacing : number 一个整数，表示行与行之间的垂直间距量 |
| smoothing : boolean 控制在缩放时是否进行平滑处理 |
| text : string 要显示的文本内容 |
| textAlign : string 文本的水平对齐方式 |
| textHeight : number 获取位图文本测量高度 |
| textWidth : number 获取位图文本测量宽度 |
| verticalAlign : string 文字的垂直对齐方式 |
公共方法
| 方法 |
|---|
| BitmapText() 创建一个 egret.BitmapText 对象 |
事件
| Events |
|---|
| egret.Event.ADDED 将显示对象添加到显示列表中时调度。 |
| egret.Event.ADDED_TO_STAGE 在将显示对象直接添加到舞台显示列表或将包含显示对象的子树添加至舞台显示列表中时调度。 |
| egret.Event.REMOVED 将要从显示列表中删除显示对象时调度。 |
| egret.Event.REMOVED_FROM_STAGE 在从显示列表中直接删除显示对象或删除包含显示对象的子树时调度。 |
| egret.Event.ENTER_FRAME [广播事件] 播放头进入新帧时调度。 |
| egret.Event.RENDER [广播事件] 将要更新和呈现显示列表时调度。 |
| egret.TouchEvent.TOUCH_MOVE 当用户触碰设备时进行调度，而且会连续调度，直到接触点被删除。 |
| egret.TouchEvent.TOUCH_BEGIN 当用户第一次触摸启用触摸的设备时（例如，用手指触摸手机屏幕）调度。 |
| egret.TouchEvent.TOUCH_END 当用户移除与启用触摸的设备的接触时（例如，将手指从屏幕上抬起）调度。 |
| egret.TouchEvent.TOUCH_TAP 当用户在启用触摸设备上的已启动接触的同一 DisplayObject 实例上抬起接触点时（例如，手机点击屏幕后抬起）调度。 |
| egret.TouchEvent.TOUCH_RELEASE_OUTSIDE 当用户在启用触摸设备上的已启动接触的不同 DisplayObject 实例上抬起接触点时（例如，按住屏幕上的某个对象,然后从它上面挪开后再松开手指）调度。 |
属性详细信息
EMPTY_FACTOR
EMPTY_FACTOR : number = 0.33
- 支持版本:Egret 2.4
- 运行平台:Web,Native
一个空格字符的宽度比例。这个数值乘以第一个字符的高度即为空格字符的宽。
font
font : Object = null
- 支持版本:Egret 2.4
- 运行平台:Web,Native
要使用的字体的名称或用逗号分隔的字体名称列表，类型必须是 BitmapFont。
letterSpacing
letterSpacing : number = 0
- 支持版本:Egret 2.4
- 运行平台:Web,Native
一个整数，表示字符之间的距离。
lineSpacing
lineSpacing : number = 0
- 支持版本:Egret 2.4
- 运行平台:Web,Native
一个整数，表示行与行之间的垂直间距量
smoothing
smoothing : boolean = true。
- 支持版本:Egret 3.0
- 运行平台:Web
控制在缩放时是否进行平滑处理。
text
text : string
- 支持版本:Egret 2.4
- 运行平台:Web,Native
要显示的文本内容
textAlign
textAlign : string
- 支持版本:Egret 2.5.6
- 运行平台:Web,Native
文本的水平对齐方式。
textHeight
textHeight : number
- 支持版本:Egret 2.4
- 运行平台:Web,Native
获取位图文本测量高度
textWidth
textWidth : number
- 支持版本:Egret 2.4
- 运行平台:Web,Native
获取位图文本测量宽度
verticalAlign
verticalAlign : string
- 支持版本:Egret 2.5.6
- 运行平台:Web,Native
文字的垂直对齐方式。
方法详细信息
BitmapText()
public BitmapText()
创建一个 egret.BitmapText 对象
- 支持版本:Egret 2.4
- 运行平台:Web,Native
示例
/*
* 以下示例演示了使用 BitmapText 显示特殊字体。
*/
class BitmapTextExample extends egret.DisplayObjectContainer {
public constructor() {
super();
RES.getResByUrl("resource/assets/font.fnt", this.onLoadComplete, this,
RES.ResourceItem.TYPE_FONT);
}
private onLoadComplete(font:egret.BitmapFont):void {
var bitmapText:egret.BitmapText = new egret.BitmapText();
bitmapText.font = font;
this.addChild(bitmapText);
bitmapText.text = "Hello Egret";
}
}
