DisplayObjectTrait

包	org.osmf.traits
类	public class DisplayObjectTrait
继承	DisplayObjectTrait MediaTraitBase EventDispatcher Object

语言版本:

ActionScript 3.0

产品版本:

OSMF 1.0

运行时版本:

Flash Player 10, AIR 1.5

DisplayObjectTrait 定义可公开 DisplayObject 和具有固有尺寸的媒体的特征界面。媒体片段的固有尺寸指的是其尺寸，不管其投影到舞台上看到的尺寸。

例如，对于一个图像，固有尺寸是此图像存储时的高度和宽度。

使用 MediaElement.hasTrait(MediaTraitType.DISPLAY_OBJECT) 方法查询媒体元素是否具有此类型的特征。如果 hasTrait(MediaTraitType.DISPLAY_OBJECT) 返回 true，则使用 MediaElement.getTrait(MediaTraitType.DISPLAY_OBJECT) 方法获取一个此类型的对象。

公共属性

隐藏继承的公共属性

显示继承的公共属性

	属性		由以下参数定义
		constructor : Object 对类对象或给定对象实例的构造函数的引用。	Object
		displayObject : DisplayObject [只读] 媒体的显示对象。	DisplayObjectTrait
		mediaHeight : Number [只读] 媒体的固有高度。	DisplayObjectTrait
		mediaWidth : Number [只读] 媒体的固有宽度。	DisplayObjectTrait
		traitType : String [只读] 此特征的 MediaTraitType。	MediaTraitBase

公共方法

隐藏继承的公共方法

显示继承的公共方法

	方法		由以下参数定义
		DisplayObjectTrait(displayObject:DisplayObject, mediaWidth:Number = 0, mediaHeight:Number = 0) 构造函数。	DisplayObjectTrait
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void 使用 EventDispatcher 对象注册事件侦听器对象，以使侦听器能够接收事件通知。	EventDispatcher
		dispatchEvent(event:Event):Boolean 将事件调度到事件流中。	EventDispatcher
		dispose():void 处理此特征使用的任何资源。	MediaTraitBase
		hasEventListener(type:String):Boolean 检查 EventDispatcher 对象是否为特定事件类型注册了任何侦听器。	EventDispatcher
		hasOwnProperty(name:String):Boolean 表示对象是否已经定义了指定的属性。	Object
		isPrototypeOf(theClass:Object):Boolean 表示 Object 类的实例是否在指定为参数的对象的原型链中。	Object
		propertyIsEnumerable(name:String):Boolean 表示指定的属性是否存在、是否可枚举。	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void 从 EventDispatcher 对象中删除侦听器。	EventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void 设置循环操作动态属性的可用性。	Object
		toLocaleString():String 返回此对象的字符串表示形式，其格式设置遵守区域设置特定的约定。	Object
		toString():String 返回指定对象的字符串表示形式。	Object
		valueOf():Object 返回指定对象的原始值。	Object
		willTrigger(type:String):Boolean 检查是否用此 EventDispatcher 对象或其任何祖代为指定事件类型注册了事件侦听器。	EventDispatcher

受保护的方法

	方法		由以下参数定义
		displayObjectChangeEnd(oldDisplayObject:DisplayObject):void 在 displayObject 属性更改后立即调用。	DisplayObjectTrait
		displayObjectChangeStart(newView:DisplayObject):void 在 displayObject 属性更改的前一刻调用。	DisplayObjectTrait
		mediaSizeChangeEnd(oldMediaWidth:Number, oldMediaHeight:Number):void 在 setMediaSize() 应用新 mediaWidth 和/或 mediaHeight 值后立即调用。	DisplayObjectTrait
		mediaSizeChangeStart(newMediaWidth:Number, newMediaHeight:Number):void 在调用 setMediaSize() 的前一刻调用。	DisplayObjectTrait
		setDisplayObject(value:DisplayObject):void 定义特征的 displayObject。	DisplayObjectTrait
		setMediaSize(mediaWidth:Number, mediaHeight:Number):void 设置特征的宽度和高度。	DisplayObjectTrait

事件

单击此处了解有关事件的更多信息

隐藏继承的事件

显示继承的事件

	摘要	由以下参数定义
activate	[广播事件] Flash Player 或 AIR 应用程序获得操作系统焦点并变为活动状态时将调度此事件。	EventDispatcher
deactivate	[广播事件] Flash Player 或 AIR 应用程序失去操作系统焦点并变为非活动状态时将调度此事件。	EventDispatcher
displayObjectChange	在特征的 displayObject 属性发生变化时调度。	DisplayObjectTrait
mediaSizeChange	在特征的 mediaWidth 和/或 mediaHeight 属性发生变化时调度。	DisplayObjectTrait

属性详细信息

displayObject

属性

displayObject:DisplayObject [只读]

语言版本:

ActionScript 3.0

产品版本:

OSMF 1.0

运行时版本:

Flash Player 10, AIR 1.5

媒体的显示对象。

实现
public function get displayObject():DisplayObject

mediaHeight

属性

mediaHeight:Number [只读]

语言版本:

ActionScript 3.0

产品版本:

OSMF 1.0

运行时版本:

Flash Player 10, AIR 1.5

媒体的固有高度。

实现
public function get mediaHeight():Number

mediaWidth

属性

mediaWidth:Number [只读]

语言版本:

ActionScript 3.0

产品版本:

OSMF 1.0

运行时版本:

Flash Player 10, AIR 1.5

媒体的固有宽度。

实现
public function get mediaWidth():Number

构造函数详细信息

()

构造函数

public function DisplayObjectTrait(displayObject:DisplayObject, mediaWidth:Number = 0, mediaHeight:Number = 0)

语言版本:

ActionScript 3.0

产品版本:

OSMF 1.0

运行时版本:

Flash Player 10, AIR 1.5

构造函数。

参数

	`displayObject:DisplayObject`

	`mediaWidth:Number` (default = `0`)

	`mediaHeight:Number` (default = `0`)

方法详细信息

displayObjectChangeEnd

()

方法

protected function displayObjectChangeEnd(oldDisplayObject:DisplayObject):void

语言版本:

ActionScript 3.0

产品版本:

OSMF 1.0

运行时版本:

Flash Player 10, AIR 1.5

在 displayObject 属性更改后立即调用。调度 change 事件。

进行覆盖的子类应调用此方法以调度 displayObjectChange 事件。

参数

oldDisplayObject:DisplayObject — 上一个 displayObject 值。

displayObjectChangeStart

()

方法

protected function displayObjectChangeStart(newView:DisplayObject):void

语言版本:

ActionScript 3.0

产品版本:

OSMF 1.0

运行时版本:

Flash Player 10, AIR 1.5

在 displayObject 属性更改的前一刻调用。

子类可以覆盖此方法以将更改传送到媒体。

参数

newView:DisplayObject — 新 displayObject 值。

mediaSizeChangeEnd

()

方法

protected function mediaSizeChangeEnd(oldMediaWidth:Number, oldMediaHeight:Number):void

语言版本:

ActionScript 3.0

产品版本:

OSMF 1.0

运行时版本:

Flash Player 10, AIR 1.5

在 setMediaSize() 应用新 mediaWidth 和/或 mediaHeight 值后立即调用。调度 change 事件。

进行覆盖的子类应调用此方法以调度 mediaSizeChange 事件。

参数

	`oldMediaWidth:Number` — 上一个 `mediaWidth` 值。

	`oldMediaHeight:Number` — 上一个 `mediaHeight` 值。

mediaSizeChangeStart

()

方法

protected function mediaSizeChangeStart(newMediaWidth:Number, newMediaHeight:Number):void

语言版本:

ActionScript 3.0

产品版本:

OSMF 1.0

运行时版本:

Flash Player 10, AIR 1.5

在调用 setMediaSize() 的前一刻调用。子类可以覆盖此方法以将更改传送到媒体。

参数

	`newMediaWidth:Number` — 新 `mediaWidth` 值。

	`newMediaHeight:Number` — 新 `mediaHeight` 值。

setDisplayObject

()

方法

protected final function setDisplayObject(value:DisplayObject):void

语言版本:

ActionScript 3.0

产品版本:

OSMF 1.0

运行时版本:

Flash Player 10, AIR 1.5

定义特征的 displayObject。如果 displayObject 与当前设置的不同，将调度 displayObjectChange 事件。

参数

value:DisplayObject

setMediaSize

()

方法

protected final function setMediaSize(mediaWidth:Number, mediaHeight:Number):void

语言版本:

ActionScript 3.0

产品版本:

OSMF 1.0

运行时版本:

Flash Player 10, AIR 1.5

设置特征的宽度和高度。

将非数字值和负值强制归零。

如果宽度或高度与上一个宽度或高度不同，则调度 mediaSizeChange 事件。

参数

	`mediaWidth:Number` — 新的宽度。

	`mediaHeight:Number` — 新的高度。

事件详细信息

displayObjectChange

事件

事件对象类型: org.osmf.events.DisplayObjectEvent
属性 DisplayObjectEvent.type = org.osmf.events.DisplayObjectEvent.DISPLAY_OBJECT_CHANGE

语言版本:

ActionScript 3.0

产品版本:

OSMF 1.0

运行时版本:

Flash Player 10, AIR 1.5

在特征的 displayObject 属性发生变化时调度。在指定其它 DisplayObject 表示媒体时发生此情况。

DisplayObjectEvent.DISPLAY_OBJECT_CHANGE 常量为 displayObjectChange 事件定义事件对象的 type 属性的值。

mediaSizeChange

事件

事件对象类型: org.osmf.events.DisplayObjectEvent
属性 DisplayObjectEvent.type = org.osmf.events.DisplayObjectEvent.MEDIA_SIZE_CHANGE

语言版本:

ActionScript 3.0

产品版本:

OSMF 1.0

运行时版本:

Flash Player 10, AIR 1.5

在特征的 mediaWidth 和/或 mediaHeight 属性发生变化时调度。

DisplayObjectEvent.MEDIA_SIZE_CHANGE 常量为 mediaSizeChange 事件定义事件对象的 type 属性的值。

法律声明 | 在线隐私策略

DisplayObjectTrait - AS3 OSMF

类 x

displayObject

mediaHeight

mediaWidth