包 | flash.text |
类 | public final class StageText |
继承 | StageText EventDispatcher Object |
语言版本: | ActionScript 3.0 |
运行时版本: | AIR 3 |
此类启用移动应用程序以收集用户使用移动设备上的本机文本输入控件进行的输入。移动设备上的输入控件通常有桌面上不存在的详细用户界面和支持行为。例如,许多移动设备支持如下文本输入功能:
- 自动完成
- 自动更正
- 基于触摸的文本选择
- 可自定义的软键盘
基础操作系统(或者与操作系统捆绑在一起的组件库)绘制本机文本输入字段。本机文本输入字段提供的体验与使用同一设备上的其他应用程序的任何人的体验类似。不过,由于操作系统绘制文本输入字段而不是播放器,因此您无法使用嵌入字体。
AIR 配置文件支持:在 iOS 和 Android 平台上支持此功能。StageText 在 Android 和 iOS 移动设备上使用本机文本输入字段。在其他平台上,StageText 使用 Flash Runtime TextField。
当使用本机输入时,StageText 对象不是显示对象且无法添加到 Flash 显示列表。相反,您应通过使用 stage
属性将 StageText 对象直接附加到舞台来显示该对象。附加到舞台的 StageText 实例显示在任何 Flash 显示对象的前面。您使用 viewPort
属性控制呈现区域的大小和位置。无法控制不同 StageText 对象的深度顺序。不建议重叠两个实例。
当 StageText 对象具有焦点时,它可以第一时间处理键盘输入。StageText 对象附加到的舞台将不会调度任何键盘输入事件。
由于 StageText 类在每个平台上包装一个不同的本机控件,因此每个平台支持的控件的功能级别也各不相同。对于支持的功能,在不同的平台之间其行为也可能不相同。当尝试在特定平台上使用特定功能时,最好先测试其行为。只有在不使用本机控件的桌面平台上,StageText 行为才与 Flash 运行时文本行为类似。
默认情况下需要关注 Apple TV 上的 StageText 。要管理您的应用程序中不同对象之间的焦点,请注意下面事项:
- 要忽略来自 StageText 的默认焦点,或将焦点分配给任何其他显示对象,请使用 stage.focus
- 要将焦点分配给 StageText,请使用 stageText.assignFocus()
属性 | 由以下参数定义 | ||
---|---|---|---|
autoCapitalize : String
控制设备如何将自动大写应用于用户输入。 | StageText | ||
autoCorrect : Boolean
指示设备是否自动更正用户输入的拼写或标点符号错误。 | StageText | ||
clearButtonMode : String [只写]
当前 StageText 对象的 clearButton 模式。 | StageText | ||
color : uint
指定文本颜色。 | StageText | ||
constructor : Object
对类对象或给定对象实例的构造函数的引用。 | Object | ||
displayAsPassword : Boolean
指示文本字段是否为密码文本字段。 | StageText | ||
editable : Boolean
指示用户是否可以编辑文本字段。 | StageText | ||
fontFamily : String
指示当前字体系列的名称。 | StageText | ||
fontPosture : String
使用 FontPosture 类中定义的常量指定字体姿势。 | StageText | ||
fontSize : int
当前字体系列的大小(以像素为单位)。 | StageText | ||
fontWeight : String
使用 FontWeight 类中定义的常量指定字体粗细。 | StageText | ||
locale : String
指示文本的区域设置。 | StageText | ||
maxChars : int
指示用户可输入到文本字段中的最多字符数。 | StageText | ||
multiline : Boolean [只读]
指示 StageText 对象是否可以显示多行文本。 | StageText | ||
restrict : String
限制用户可输入到文本字段中的字符集。 | StageText | ||
returnKeyLabel : String
指示提供软键盘功能的设备的 Return 键上的标签。 | StageText | ||
selectionActiveIndex : int [只读]
当前所选内容中最后一个字符从零开始的字符索引值。 | StageText | ||
selectionAnchorIndex : int [只读]
当前所选内容中第一个字符从零开始的字符索引值。 | StageText | ||
softKeyboardType : String
控制软键盘的外观。 | StageText | ||
stage : Stage
显示此 StageText 对象的舞台。 | StageText | ||
text : String
文本字段中的当前文本。 | StageText | ||
textAlign : String
指示段落对齐方式。 | StageText | ||
viewPort : Rectangle
舞台上显示 StageText 对象的区域。 | StageText | ||
visible : Boolean
指示 StageText 对象是否可见。 | StageText |
方法 | 由以下参数定义 | ||
---|---|---|---|
创建 StageText 对象。 | StageText | ||
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
使用 EventDispatcher 对象注册事件侦听器对象,以使侦听器能够接收事件通知。 | EventDispatcher | ||
向 StageText 对象分配焦点。 | StageText | ||
将事件调度到事件流中。 | EventDispatcher | ||
StageText 对象的处置。 | StageText | ||
将 StageText 的视口绘制到位图。 | StageText | ||
检查 EventDispatcher 对象是否为特定事件类型注册了任何侦听器。 | EventDispatcher | ||
表示对象是否已经定义了指定的属性。 | Object | ||
表示 Object 类的实例是否在指定为参数的对象的原型链中。 | Object | ||
表示指定的属性是否存在、是否可枚举。 | Object | ||
从 EventDispatcher 对象中删除侦听器。 | EventDispatcher | ||
选择由第一个和最后一个字符的索引值指定的文本。 | StageText | ||
设置循环操作动态属性的可用性。 | Object | ||
返回此对象的字符串表示形式,其格式设置遵守区域设置特定的约定。 | Object | ||
返回指定对象的字符串表示形式。 | Object | ||
返回指定对象的原始值。 | Object | ||
检查是否用此 EventDispatcher 对象或其任何祖代为指定事件类型注册了事件侦听器。 | EventDispatcher |
事件 | 摘要 | 由以下参数定义 | ||
---|---|---|---|---|
[广播事件] Flash Player 或 AIR 应用程序获得操作系统焦点并变为活动状态时将调度此事件。 | EventDispatcher | |||
在文本内容更改之后调度。 | StageText | |||
在设置非 null 舞台和非空 viewPort 之后调度。 | StageText | |||
[广播事件] Flash Player 或 AIR 应用程序失去操作系统焦点并变为非活动状态时将调度此事件。 | EventDispatcher | |||
当用户在编辑文本并且控件有键盘焦点时调度。 | StageText | |||
当用户不再编辑文本并且控件不再有键盘焦点时调度。 | StageText | |||
用户按下某个键时调度。 | StageText | |||
用户释放某个键时调度。 | StageText | |||
作为 StageText 对象获得焦点的结果,在激活软键盘之后调度。 | StageText | |||
作为 StageText 对象获得焦点的结果,在软键盘激活之前调度。 | StageText | |||
作为 StageText 对象失去焦点的结果,在停用软键盘之后调度。 | StageText |
autoCapitalize | 属性 |
autoCapitalize:String
语言版本: | ActionScript 3.0 |
运行时版本: | AIR 3 |
控制设备如何将自动大写应用于用户输入。有效值定义为 AutoCapitalize 类中的常量:
- "none"
- "word"
- "sentence"
- "all"
此属性仅暗示基础平台,因为并不是所有设备和操作系统都支持此功能。
注意:如果当文本正在编辑中或成为焦点时启用 autoCapitalize
,更新的行为不会生效,直到焦点被释放并重新建立。
默认值为 AutoCapitalize.NONE。
实现
public function get autoCapitalize():String
public function set autoCapitalize(value:String):void
引发
ArgumentError — 如果设置的值不是 AutoCapitalize 的成员
|
相关 API 元素
autoCorrect | 属性 |
clearButtonMode | 属性 |
clearButtonMode:String
[只写] 语言版本: | ActionScript 3.0 |
运行时版本: | AIR 23 |
当前 StageText 对象的 clearButton 模式。此属性有四种模式:
-
编辑时显示 clearButton:
StageTextClearButtonMode.WHILE_EDITING
-
从不显示 clearButton:
StageTextClearButtonMode.NEVER
-
始终显示 clearButton:
StageTextClearButtonMode.ALWAYS
-
不编辑时显示 clearButton:
StageTextClearButtonMode.UNLESS_EDITING
clearButtonMode
属性设置为 StageTextClearButtonMode.WHILE_EDITING
。
注意:此属性仅获得 iOS 的支持。
实现
public function set clearButtonMode(value:String):void
color | 属性 |
displayAsPassword | 属性 |
displayAsPassword:Boolean
语言版本: | ActionScript 3.0 |
运行时版本: | AIR 3 |
指示文本字段是否为密码文本字段。如果为 true
,则文本字段使用置换字符(如星号)隐藏输入字符。
注意:如果当文本正在编辑中或成为焦点时启用 displayAsPassword
,更新的行为不会生效,直到焦点被释放并重新建立。
重要说明:在 iOS 上,即使此属性的值为 true
,多行舞台文本对象也不会显示置换字符。
默认值为 false。
实现
public function get displayAsPassword():Boolean
public function set displayAsPassword(value:Boolean):void
editable | 属性 |
fontFamily | 属性 |
fontPosture | 属性 |
fontPosture:String
语言版本: | ActionScript 3.0 |
运行时版本: | AIR 3 |
使用 FontPosture 类中定义的常量指定字体姿势。
默认值为 FontPosture.NORMAL。
实现
public function get fontPosture():String
public function set fontPosture(value:String):void
引发
ArgumentError — 如果设置的任何值都不是 FontPosture 的成员
|
相关 API 元素
fontSize | 属性 |
fontWeight | 属性 |
fontWeight:String
语言版本: | ActionScript 3.0 |
运行时版本: | AIR 3 |
使用 FontWeight 类中定义的常量指定字体粗细。
默认值为 FontWeight.NORMAL。
实现
public function get fontWeight():String
public function set fontWeight(value:String):void
引发
ArgumentError — 如果设置的任何值都不是 FontWeight 的成员
|
相关 API 元素
locale | 属性 |
locale:String
语言版本: | ActionScript 3.0 |
运行时版本: | AIR 3 |
指示文本的区域设置。StageText 使用标准区域设置标识符。例如,"en"、"en_US" 和 "en-US" 均表示英语;"ja" 表示日语。有关区域设置代码列表的信息,请参阅 iso639-2 代码列表。
默认值为 en。
实现
public function get locale():String
public function set locale(value:String):void
maxChars | 属性 |
multiline | 属性 |
restrict | 属性 |
restrict:String
语言版本: | ActionScript 3.0 |
运行时版本: | AIR 3 |
限制用户可输入到文本字段中的字符集。系统从左到右扫描 restrict
字符串。
restrict
的值指定以下文本输入限制规则:
- 如果值为
null
,则用户可以输入任何字符。 - 如果值为空字符串,则用户不能输入任何字符。
- 如果值为字符字符串,则用户只能在字符串中输入字符。
- 如果值包括尖号 (^),则用户不能在尖号之后输入任何字符。
- 该值可以使用连字符 (-) 指定允许输入的字符的范围。
- 该值可以使用
\u
转义序列构建一个restrict
字符串。
特殊字符:
使用反斜杠输入尖号 (^) 或短划线 (-) 字符。认可的反斜杠序列为 \-、\^ 和 \\。反斜杠必须是字符串中的实际字符。在 ActionScript 中指定一个反斜杠时,请使用双反斜杠。
restrict
属性设置的示例:
以下示例仅允许用户输入短划线 (-) 和尖号 (^) 字符:
my_txt.restrict = "\\-\\^";
以下示例仅允许用户输入大写字符、空格和数字:
my_txt.restrict = "A-Z 0-9";
以下示例仅排除小写字母:
my_txt.restrict = "^a-z";
以下示例仅允许用户输入大写字母,但排除大写字母 Q:
my_txt.restrict = "A-Z^Q";
以下示例仅允许用户输入从 ASCII 32(空格)到 ASCII 126(代字号)的字符。
my_txt.restrict = "\u0020-\u007E";
注意:限制仅适用于用户输入;使用脚本可以将任何字符插入文本字段。
默认值为 null。
实现
public function get restrict():String
public function set restrict(value:String):void
returnKeyLabel | 属性 |
returnKeyLabel:String
语言版本: | ActionScript 3.0 |
运行时版本: | AIR 3 |
指示提供软键盘功能的设备的 Return 键上的标签。可用值为 ReturnKeyLabel
类中定义的常量:
- "default"
- "done"
- "go"
- "next"
- "search"
此属性仅暗示基础平台,因为并不是所有设备和操作系统都支持这些值。此属性对不提供软键盘功能的设备无任何影响。
默认值为 ReturnKeyLabel.DEFAULT。
实现
public function get returnKeyLabel():String
public function set returnKeyLabel(value:String):void
引发
ArgumentError — 如果设置的任何值都不是 ReturnKeyLabel 的成员
|
相关 API 元素
selectionActiveIndex | 属性 |
selectionAnchorIndex | 属性 |
softKeyboardType | 属性 |
softKeyboardType:String
语言版本: | ActionScript 3.0 |
运行时版本: | AIR 3 |
控制软键盘的外观。
具有软键盘的设备可以自定义键盘的按钮以与所需的输入类型匹配。例如,如果需要数字输入,设备可以使用 SoftKeyboardType.NUMBER
在软键盘上仅显示数字。有效值定义为 SoftKeyboardType 类中的常量:
- "default"
- "punctuation"
- "url"
- "number"
- "contact"
- "email"
- "phone"
- "decimalpad"
这些值用作提示,帮助设备显示当前操作的最佳键盘。
默认值为 SoftKeyboardType.DEFAULT。
实现
public function get softKeyboardType():String
public function set softKeyboardType(value:String):void
引发
ArgumentError — 如果设置的任何值都不是 SoftKeyboardType 的成员
|
相关 API 元素
stage | 属性 |
text | 属性 |
textAlign | 属性 |
textAlign:String
语言版本: | ActionScript 3.0 |
运行时版本: | AIR 3 |
指示段落对齐方式。有效值定义为 TextFormatAlign 类中的常量:
- "left"
- "center"
- "right"
- "justify"
- "start"
- "end"
并非所有平台都支持每个 textAlign
值。对于不支持的 textAlign
值,平台使用默认值 (TextFormatAlign.START
)。
默认值为 TextFormatAlign.START。
实现
public function get textAlign():String
public function set textAlign(value:String):void
引发
ArgumentError — 如果设置的任何值都不是 TextFormatAlign 的成员
|
相关 API 元素
viewPort | 属性 |
viewPort:Rectangle
语言版本: | ActionScript 3.0 |
运行时版本: | AIR 3 |
舞台上显示 StageText 对象的区域。默认为零个矩形。
实现
public function get viewPort():Rectangle
public function set viewPort(value:Rectangle):void
引发
RangeError — 矩形值无效。
|
visible | 属性 |
StageText | () | 构造函数 |
public function StageText(initOptions:flash.text:StageTextInitOptions = null)
语言版本: | ActionScript 3.0 |
运行时版本: | AIR 3 |
创建 StageText 对象。
在将 StageText 对象附加到舞台并设置 viewPort
属性之前,该对象不可见。
initOptions:flash.text:StageTextInitOptions (default = null )
|
assignFocus | () | 方法 |
public function assignFocus():void
语言版本: | ActionScript 3.0 |
运行时版本: | AIR 3 |
向 StageText 对象分配焦点。对于不可编辑的对象,assignFocus()
不执行任何操作。
dispose | () | 方法 |
public function dispose():void
语言版本: | ActionScript 3.0 |
运行时版本: | AIR 3 |
StageText 对象的处置。
调用 dispose()
是可选的。如果您不维护对此 StageText 实例的引用,它将符合垃圾回收条件。调用 dispose()
会使垃圾回收更快发生,或者在更方便的时间发生。
drawViewPortToBitmapData | () | 方法 |
public function drawViewPortToBitmapData(bitmap:BitmapData):void
语言版本: | ActionScript 3.0 |
运行时版本: | AIR 3.0 |
将 StageText 的视口绘制到位图。
捕获位图并将舞台设置为 null
,以便在 StageText 对象上显示内容。
位图通常与视口具有相同的宽度和高度。从 AIR 15.0 开始,当在 HiDPI 显示屏上使用播放器时,位图的宽度和高度可以是视口宽度和高度的 contentsScaleFactor
倍。例如,在 Mac retina 显示屏上,contentsScaleFactor
为 2,由于舞台的像素分辨率加倍,因此位图相应会是视口大小的两倍。
如果在 Event.COMPLETE
事件之前调用此方法,该方法可能会错误地绘制视口。
参数
bitmap:BitmapData — 对其绘制 StageText 视口的可见部分的 BitmapData 对象。
|
引发
ArgumentError — 位图的宽度或高度不同于视口的宽度或高度。
| |
Error — 位图为空。
|
selectRange | () | 方法 |
public function selectRange(anchorIndex:int, activeIndex:int):void
语言版本: | ActionScript 3.0 |
运行时版本: | AIR 3 |
选择由第一个和最后一个字符的索引值指定的文本。在 anchorIndex
和 activeIndex
参数中指定选区的第一个和最后一个字符。如果两个参数值相同,则此方法将设置插入点。
在 iOS 上,对于非多行 StageText 对象,此函数不受支持且始终返回 -1。如果您调用此方法选择完整文本字符串,则可以看见选区。然而,如果您调用此方法选择部分文本字符串,则无法看见选区。
对于某些设备或操作系统,仅当 StageText 对象具有焦点时选区才可见。
参数
anchorIndex:int — 选区中第一个字符的基于零的索引值(第一个字符的索引值为 0)。
| |
activeIndex:int — 所选内容中最后一个字符从零开始的索引值。
|
相关 API 元素
change | 事件 |
flash.events.Event
属性 Event.type =
flash.events.Event.CHANGE
语言版本: | ActionScript 3.0 |
运行时版本: | AIR 3 |
在文本内容更改之后调度。可以在每次更改或者一组更改完成之后调度此事件。
Event.CHANGE
常量定义 change
事件对象的 type
属性值。
此事件具有以下属性:
属性 | 值 |
---|---|
bubbles | true |
cancelable | false ;没有要取消的默认行为。 |
currentTarget | 当前正在使用某个事件侦听器处理 Event 对象的对象。 |
target | 已修改其值的对象。target 不一定是显示列表中注册此事件侦听器的对象。请使用 currentTarget 属性来访问显示列表中当前正在处理此事件的对象。 |
complete | 事件 |
flash.events.Event
属性 Event.type =
flash.events.Event.COMPLETE
语言版本: | ActionScript 3.0 |
运行时版本: | AIR 3 |
在设置非 null 舞台和非空 viewPort 之后调度。指示该实现已完成 StageText 对象的布局,现在可以调用 drawViewPortToBitmapData
方法。可以使用 stage
和/或 viewPort
的设置同步或异步调度此事件,具体取决于平台。
Event.COMPLETE
常量定义 complete
事件对象的 type
属性值。
此事件具有以下属性:
属性 | 值 |
---|---|
bubbles | false |
cancelable | false ;没有要取消的默认行为。 |
currentTarget | 当前正在使用某个事件侦听器处理 Event 对象的对象。 |
target | 已完成加载的网络对象。 |
focusIn | 事件 |
flash.events.FocusEvent
属性 FocusEvent.type =
flash.events.FocusEvent.FOCUS_IN
语言版本: | ActionScript 3.0 |
运行时版本: | AIR 3 |
当用户在编辑文本并且控件有键盘焦点时调度。
定义focusIn
事件对象的 type
属性值。
此事件具有以下属性:
属性 | 值 |
---|---|
bubbles | true |
cancelable | false ;没有要取消的默认行为。 |
currentTarget | 当前正在使用某个事件侦听器处理 Event 对象的对象。 |
keyCode | 0;仅应用于 keyFocusChange 事件。 |
relatedObject | 受焦点更改影响的补充 InteractiveObject 实例。 |
shiftKey | false ;仅应用于 keyFocusChange 事件。 |
target | 刚刚获得焦点的 InteractiveObject 实例。target 不一定是显示列表中注册此事件侦听器的对象。请使用 currentTarget 属性来访问显示列表中当前正在处理此事件的对象。
|
direction | 焦点的分配方向。此属性报告舞台的 assignFocus() 方法的 direction 参数。如果通过其他方式更改焦点,则该值将始终为 FocusDirection.NONE 。仅适用于 focusIn 事件。对于所有其他焦点事件,该值将为 FocusDirection.NONE 。 |
focusOut | 事件 |
flash.events.FocusEvent
属性 FocusEvent.type =
flash.events.FocusEvent.FOCUS_OUT
语言版本: | ActionScript 3.0 |
运行时版本: | AIR 3 |
当用户不再编辑文本并且控件不再有键盘焦点时调度。
定义focusOut
事件对象的 type
属性值。
此事件具有以下属性:
属性 | 值 |
---|---|
bubbles | true |
cancelable | false ;没有要取消的默认行为。 |
currentTarget | 当前正在使用某个事件侦听器处理 Event 对象的对象。 |
keyCode | 0;仅应用于 keyFocusChange 事件。 |
relatedObject | 受焦点更改影响的补充 InteractiveObject 实例。 |
shiftKey | false ;仅应用于 keyFocusChange 事件。 |
target | 刚刚失去焦点的 InteractiveObject 实例。target 不一定是显示列表中注册此事件侦听器的对象。请使用 currentTarget 属性来访问显示列表中当前正在处理此事件的对象。
|
keyDown | 事件 |
flash.events.KeyboardEvent
属性 KeyboardEvent.type =
flash.events.KeyboardEvent.KEY_DOWN
语言版本: | ActionScript 3.0 |
运行时版本: | AIR 3 |
用户按下某个键时调度。
按键与特定字符之间的映射因设备和操作系统而异。此事件类型是在此类映射发生之后、输入法编辑器 (IME) 处理之前生成的。IME 用于输入标准 QWERTY 键盘无法生成的字符(例如,汉语象形字)。
此事件在 keyUp
事件之前发生。
不是按所有键均会调度此事件。导致调度此事件的键因平台而异。
在 AIR 中,取消此事件会禁止将字符输入到文本字段中。
KeyboardEvent.KEY_DOWN
常量定义 keyDown
事件对象的 type
属性的值。
此事件具有以下属性:
属性 | 值 |
---|---|
bubbles | true |
cancelable | 在 AIR 中为 true ,在 Flash Player 中为 false ;在 AIR 中,取消此事件会禁止将字符输入到文本字段中。 |
charCode | 按下或释放的键的字符代码值。 |
commandKey | 在 Mac 中,如果 Command 键处于活动状态,则为 true 。否则为 false |
controlKey | 在 Windows 和 Linux 中,如果 Ctrl 键处于活动状态,则为 true 。在 Mac 中,如果 Control 键处于活动状态,则为 true 。否则为 false |
ctrlKey | 在 Windows 和 Linux 中,如果 Ctrl 键处于活动状态,则为 true 。在 Mac 中,如果 Ctrl 键或 Command 键处于活动状态,则为 true 。否则为 false 。 |
currentTarget | 当前正在使用某个事件侦听器处理 Event 对象的对象。 |
keyCode | 按下或释放的键的键控代码值。 |
keyLocation | 按键在键盘上的位置。 |
shiftKey | 如果 Shift 键处于活动状态,则为 true ;如果处于非活动状态,则为 false 。 |
target | 具有焦点的 InteractiveObject 实例。target 不一定是显示列表中注册此事件侦听器的对象。请使用 currentTarget 属性来访问显示列表中当前正在处理此事件的对象。 |
keyUp | 事件 |
flash.events.KeyboardEvent
属性 KeyboardEvent.type =
flash.events.KeyboardEvent.KEY_UP
语言版本: | ActionScript 3.0 |
运行时版本: | AIR 3 |
用户释放某个键时调度。
按键与特定字符之间的映射因设备和操作系统而异。此事件类型是在此类映射发生之后、输入法编辑器 (IME) 处理之前生成的。IME 用于输入标准 QWERTY 键盘无法生成的字符(例如,汉语象形字)。
此事件在 keyDown
事件之后发生。
不是按所有键均会调度此事件。导致调度此事件的键因平台而异。
KeyboardEvent.KEY_UP
常量定义 keyUp
事件对象的 type
属性值。
此事件具有以下属性:
属性 | 值 |
---|---|
bubbles | true |
cancelable | false ;没有要取消的默认行为。 |
charCode | 包含按下或释放的键的字符代码值。 |
commandKey | 在 Mac 中,如果 Command 键处于活动状态,则为 true 。否则为 false |
controlKey | 在 Windows 和 Linux 中,如果 Ctrl 键处于活动状态,则为 true 。在 Mac 中,如果 Control 键处于活动状态,则为 true 。否则为 false |
ctrlKey | 在 Windows 中,如果 Ctrl 键处于活动状态,则为 true 。在 Mac 中,如果 Ctrl 键或 Command 键处于活动状态,则为 true 。否则为 false 。 |
currentTarget | 当前正在使用某个事件侦听器处理 Event 对象的对象。 |
keyCode | 按下或释放的键的键控代码值。 |
keyLocation | 按键在键盘上的位置。 |
shiftKey | 如果 Shift 键处于活动状态,则为 true ;如果处于非活动状态,则为 false 。 |
target | 具有焦点的 InteractiveObject 实例。target 不一定是显示列表中注册此事件侦听器的对象。请使用 currentTarget 属性来访问显示列表中当前正在处理此事件的对象。 |
softKeyboardActivate | 事件 |
flash.events.SoftKeyboardEvent
属性 SoftKeyboardEvent.type =
flash.events.SoftKeyboardEvent.SOFT_KEYBOARD_ACTIVATE
语言版本: | ActionScript 3.0 |
运行时版本: | AIR 3 |
作为 StageText 对象获得焦点的结果,在激活软键盘之后调度。
SoftKeyboardEvent.SOFT_KEYBOARD_ACTIVATE
常量定义软键盘显示时 SoftKeyboardEvent 对象的 type
属性值。对于此事件,cancellable = false
。
此事件具有以下属性:
属性 | 值 |
---|---|
type | SOFT_KEYBOARD_ACTIVATE |
bubbles | true |
cancelable | false ;没有要取消的默认行为。 |
relatedObjectVal | 对与事件相关的显示列表对象的引用。 |
triggerTypeVal | 表示键盘事件由应用程序还是用户触发。 |
currentTarget | 当前正在使用某个事件侦听器处理 Event 对象的对象。 |
softKeyboardActivating | 事件 |
flash.events.SoftKeyboardEvent
属性 SoftKeyboardEvent.type =
flash.events.SoftKeyboardEvent.SOFT_KEYBOARD_ACTIVATING
语言版本: | ActionScript 3.0 |
运行时版本: | AIR 3 |
作为 StageText 对象获得焦点的结果,在软键盘激活之前调度。
SoftKeyboardEvent.SOFT_KEYBOARD_ACTIVATING
常量定义软键盘显示前的瞬间 SoftKeyboardEvent 对象的 type
属性值。对于此事件,cancellable = true
。
此事件具有以下属性:
属性 | 值 |
---|---|
type | SOFT_KEYBOARD_ACTIVATING |
bubbles | true |
cancelable | 仅当事件由 StageText 对象调度时为 true 。对于 StageText 对象,事件不是 cancellable。 |
relatedObjectVal | 对与事件相关的显示列表对象的引用。 |
triggerTypeVal | 表示键盘事件由应用程序还是用户触发。 |
currentTarget | 当前正在使用某个事件侦听器处理 Event 对象的对象。 |
softKeyboardDeactivate | 事件 |
flash.events.SoftKeyboardEvent
属性 SoftKeyboardEvent.type =
flash.events.SoftKeyboardEvent.SOFT_KEYBOARD_DEACTIVATE
语言版本: | ActionScript 3.0 |
运行时版本: | AIR 3 |
作为 StageText 对象失去焦点的结果,在停用软键盘之后调度。
SoftKeyboardEvent.SOFT_KEYBOARD_DEACTIVATE
常量定义隐藏软键盘时 SoftKeyboardEvent 对象的 type
属性值。对于此事件,cancellable = false
。
此事件具有以下属性:
属性 | 值 |
---|---|
type | SOFT_KEYBOARD_DEACTIVATE |
bubbles | true |
cancelable | false ;没有要取消的默认行为。 |
relatedObjectVal | 对与事件相关的显示列表对象的引用。 |
triggerTypeVal | 表示键盘事件由应用程序还是用户触发。 |
currentTarget | 当前正在使用某个事件侦听器处理 Event 对象的对象。 |
Tue Jun 12 2018, 11:04 AM Z