flash.desktop.SystemTrayIcon (Flex 3)

	属性	定义方
		bitmaps : Array 作为不同大小的 BitmapData 对象数组的图标图像。	SystemTrayIcon
		constructor : Object 对类对象或给定对象实例的构造函数的引用。	Object
		height : int [只读 (read-only)] 图标的当前显示高度，以像素为单位。	SystemTrayIcon
		menu : NativeMenu 系统任务栏图标菜单。	SystemTrayIcon
		prototype : Object [静态] 对类或函数对象的原型对象的引用。	Object
		tooltip : String 为系统任务栏图标弹出的工具提示。	SystemTrayIcon
		width : int [只读 (read-only)] 图标的当前显示宽度，以像素为单位。	SystemTrayIcon

	方法	定义方
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void 使用 EventDispatcher 对象注册事件侦听器对象，以使侦听器能够接收事件通知。	EventDispatcher
		dispatchEvent(event:Event):Boolean 将事件调度到事件流中。	EventDispatcher
		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
		toString():String 返回指定对象的字符串表示形式。	Object
		valueOf():Object 返回指定对象的原始值。	Object
		willTrigger(type:String):Boolean 检查是否用此 EventDispatcher 对象或其任何始祖为指定事件类型注册了事件侦听器。	EventDispatcher

摘要	定义方
activate	Flash Player 或 AIR 应用程序获得操作系统焦点并变为活动状态时调度。	EventDispatcher
click	在鼠标单击时由此 SystemTrayIcon 对象调度。	SystemTrayIcon
deactivate	Flash Player 或 AIR 应用程序失去操作系统焦点并变为非活动状态时调度。	EventDispatcher
mouseDown	在鼠标按下时由此 SystemTrayIcon 对象调度。	SystemTrayIcon
mouseUp	在鼠标弹起时由此 SystemTrayIcon 对象调度。	SystemTrayIcon
rightClick	在鼠标右键单击时由此 SystemTrayIcon 对象调度。	SystemTrayIcon
rightMouseDown	在鼠标右键按下时由此 SystemTrayIcon 对象调度。	SystemTrayIcon
rightMouseUp	在鼠标右键弹起时由此 SystemTrayIcon 对象调度。	SystemTrayIcon

	常量	定义方
		MAX_TIP_LENGTH : Number = 63 [静态] 允许的系统任务栏图标工具提示长度。	SystemTrayIcon

属性详细信息

bitmaps

属性

bitmaps:Array [读写]

作为不同大小的 BitmapData 对象数组的图标图像。

当在给定的操作系统上下文中显示图标时，将使用数组中最接近所显示大小的位图（必要时进行缩放）。常用的大小包括 16x16、32x32、48x48 和 128x128。（在不远的将来，某些操作系统将可以使用 512x512 像素的图标。）

在某些上下文中，如果没有为 bitmaps 属性分配任何数据，则操作系统可以使用默认的系统图标。在其他上下文中，不显示图标。

若要设置或更改图标外观，请将 BitmapData 对象数组分配给 bitmaps 属性：

  icon.bitmaps = new Array(icon16x16.bitmapData, icon128x128.bitmapData);

直接修改 bitmaps 数组没有任何效果。

若要清除图标图像，请为 bitmaps 属性分配一个空数组。

注意：在为图标加载图像文件时，PNG 文件格式通常提供最佳 Alpha 混合。GIF 格式只支持打开或关闭透明度（无混合）。JPG 格式完全不支持透明度。

height

属性

height:int [只读 (read-only)]

图标的当前显示高度，以像素为单位。

某些图标上下文支持动态大小。height 属性指示从当前上下文的 bitmaps 数组中选择的图标的高度。如果操作系统已缩放了该图标，则实际显示高度可能会有所不同。

属性

menu:NativeMenu [读写]

系统任务栏图标菜单。

tooltip

属性

tooltip:String [读写]

为系统任务栏图标弹出的工具提示。如果该字符串比 SystemTrayIcon.MAX_TIP_LENGTH 长，则将截断提示。

width

属性

width:int [只读 (read-only)]

图标的当前显示宽度，以像素为单位。

某些图标上下文支持动态大小。width 属性指示从当前上下文的 bitmaps 数组中选择的图标的宽度。如果操作系统已缩放了该图标，则实际显示宽度可能会有所不同。

事件详细信息

click

事件

事件对象类型: flash.events.MouseEvent
属性 MouseEvent.type = flash.events.MouseEvent.CLICK

在鼠标单击时由此 SystemTrayIcon 对象调度。

定义 click 事件对象的 type 属性值。

此事件具有以下属性：

属性	值
`bubbles`	`true`
`buttonDown`	如果按下鼠标主按键，则为 `true`；否则为 `false`。
`cancelable`	`false`；没有要取消的默认行为。
`ctrlKey`	在 Windows 中，如果 Ctrl 键处于活动状态，则为 `true`。在 Mac 中，如果 Ctrl 键或 Command 键处于活动状态，则为 `true`。否则为 `false`。
`currentTarget`	当前正在使用某个事件侦听器处理 Event 对象的对象。
`localX`	事件发生点的相对于包含 Sprite 的水平坐标。
`localY`	事件发生点的相对于包含 Sprite 的垂直坐标。
`shiftKey`	如果 Shift 键处于活动状态，则为 `true`；如果处于非活动状态，则为 `false`。
`commandKey`	在 Mac 中，如果 Command 键处于活动状态，则为 `true`；如果处于非活动状态，则为 `false`。在 Windows 中始终为 `false`。
`controlKey`	如果 Ctrl 键处于活动状态，则为 `true`；如果处于非活动状态，则为 `false`。
`stageX`	事件发生点在全局舞台坐标中的水平坐标。
`stageY`	事件发生点在全局舞台坐标中的垂直坐标。
`target`	指针设备下的 InteractiveObject 实例。`target` 不一定是显示列表中注册此事件侦听器的对象。请使用 `currentTarget` 属性来访问显示列表中当前正在处理此事件的对象。

mouseDown

事件

事件对象类型: flash.events.MouseEvent
属性 MouseEvent.type = flash.events.MouseEvent.MOUSE_DOWN

在鼠标按下时由此 SystemTrayIcon 对象调度。

定义 mouseDown 事件对象的 type 属性值。

此事件具有以下属性：

属性	值
`bubbles`	`true`
`buttonDown`	如果按下鼠标主按键，则为 `true`；否则为 `false`。
`cancelable`	`false`；不能取消默认行为。
`ctrlKey`	在 Windows 中，如果 Ctrl 键处于活动状态，则为 `true`。在 Mac 中，如果 Ctrl 键或 Command 键处于活动状态，则为 `true`。否则为 `false`。
`currentTarget`	当前正在使用某个事件侦听器处理 Event 对象的对象。
`localX`	事件发生点的相对于包含 Sprite 的水平坐标。
`localY`	事件发生点的相对于包含 Sprite 的垂直坐标。
`shiftKey`	如果 Shift 键处于活动状态，则为 `true`；如果处于非活动状态，则为 `false`。
`commandKey`	在 Mac 中，如果 Command 键处于活动状态，则为 `true`；如果处于非活动状态，则为 `false`。在 Windows 中始终为 `false`。
`controlKey`	如果 Ctrl 键处于活动状态，则为 `true`；如果处于非活动状态，则为 `false`。
`clickCount`	鼠标单击次数，指示该事件是否为多击序列的一部分。
`stageX`	事件发生点在全局舞台坐标中的水平坐标。
`stageY`	事件发生点在全局舞台坐标中的垂直坐标。
`target`	指针设备下的 InteractiveObject 实例。`target` 不一定是显示列表中注册此事件侦听器的对象。请使用 `currentTarget` 属性来访问显示列表中当前正在处理此事件的对象。

mouseUp

事件

事件对象类型: flash.events.MouseEvent
属性 MouseEvent.type = flash.events.MouseEvent.MOUSE_UP

在鼠标弹起时由此 SystemTrayIcon 对象调度。

定义 mouseUp 事件对象的 type 属性值。

此事件具有以下属性：

属性	值
`bubbles`	`true`
`buttonDown`	如果按下鼠标主按键，则为 `true`；否则为 `false`。
`cancelable`	`false`；不能取消默认行为。
`ctrlKey`	在 Windows 中，如果 Ctrl 键处于活动状态，则为 `true`。在 Mac 中，如果 Ctrl 键或 Command 键处于活动状态，则为 `true`。否则为 `false`。
`currentTarget`	当前正在使用某个事件侦听器处理 Event 对象的对象。
`localX`	事件发生点的相对于包含 Sprite 的水平坐标。
`localY`	事件发生点的相对于包含 Sprite 的垂直坐标。
`shiftKey`	如果 Shift 键处于活动状态，则为 `true`；如果处于非活动状态，则为 `false`。
`commandKey`	在 Mac 中，如果 Command 键处于活动状态，则为 `true`；如果处于非活动状态，则为 `false`。在 Windows 中始终为 `false`。
`controlKey`	如果 Ctrl 键处于活动状态，则为 `true`；如果处于非活动状态，则为 `false`。
`clickCount`	鼠标单击次数，指示该事件是否为多击序列的一部分。
`stageX`	事件发生点在全局舞台坐标中的水平坐标。
`stageY`	事件发生点在全局舞台坐标中的垂直坐标。
`target`	指针设备下的 InteractiveObject 实例。`target` 不一定是显示列表中注册此事件侦听器的对象。请使用 `currentTarget` 属性来访问显示列表中当前正在处理此事件的对象。

rightClick

事件

事件对象类型: flash.events.MouseEvent
属性 MouseEvent.type = flash.events.MouseEvent.RIGHT_MOUSE_CLICK

在鼠标右键单击时由此 SystemTrayIcon 对象调度。

rightMouseDown

事件

事件对象类型: flash.events.MouseEvent
属性 MouseEvent.type = flash.events.MouseEvent.RIGHT_MOUSE_DOWN

在鼠标右键按下时由此 SystemTrayIcon 对象调度。

定义 rightMouseDown 事件对象的 type 属性值。

此事件具有以下属性：

属性	值
`bubbles`	`true`
`buttonDown`	如果按下鼠标右键，则为 `true`；否则为 `false`。
`cancelable`	`false`；不能取消默认行为。
`ctrlKey`	在 Windows 中，如果 Ctrl 键处于活动状态，则为 `true`。在 Mac 中，如果 Ctrl 键或 Command 键处于活动状态，则为 `true`。否则为 `false`。
`currentTarget`	当前正在使用某个事件侦听器处理 Event 对象的对象。
`localX`	事件发生点的相对于包含 Sprite 的水平坐标。
`localY`	事件发生点的相对于包含 Sprite 的垂直坐标。
`shiftKey`	如果 Shift 键处于活动状态，则为 `true`；如果处于非活动状态，则为 `false`。
`commandKey`	在 Mac 中，如果 Command 键处于活动状态，则为 `true`；如果处于非活动状态，则为 `false`。在 Windows 中始终为 `false`。
`controlKey`	如果 Ctrl 键处于活动状态，则为 `true`；如果处于非活动状态，则为 `false`。
`clickCount`	鼠标单击次数，指示该事件是否为多击序列的一部分。
`stageX`	事件发生点在全局舞台坐标中的水平坐标。
`stageY`	事件发生点在全局舞台坐标中的垂直坐标。
`target`	指针设备下的 InteractiveObject 实例。`target` 不一定是显示列表中注册此事件侦听器的对象。请使用 `currentTarget` 属性来访问显示列表中当前正在处理此事件的对象。

rightMouseUp

事件

事件对象类型: flash.events.MouseEvent
属性 MouseEvent.type = flash.events.MouseEvent.RIGHT_MOUSE_UP

在鼠标右键弹起时由此 SystemTrayIcon 对象调度。

定义 rightMouseUp 事件对象的 type 属性值。

此事件具有以下属性：

属性	值
`bubbles`	`true`
`buttonDown`	如果按下鼠标右键，则为 `true`；否则为 `false`。
`cancelable`	`false`；不能取消默认行为。
`ctrlKey`	在 Windows 中，如果 Ctrl 键处于活动状态，则为 `true`。在 Mac 中，如果 Ctrl 键或 Command 键处于活动状态，则为 `true`。否则为 `false`。
`currentTarget`	当前正在使用某个事件侦听器处理 Event 对象的对象。
`localX`	事件发生点的相对于包含 Sprite 的水平坐标。
`localY`	事件发生点的相对于包含 Sprite 的垂直坐标。
`shiftKey`	如果 Shift 键处于活动状态，则为 `true`；如果处于非活动状态，则为 `false`。
`commandKey`	在 Mac 中，如果 Command 键处于活动状态，则为 `true`；如果处于非活动状态，则为 `false`。在 Windows 中始终为 `false`。
`controlKey`	如果 Ctrl 键处于活动状态，则为 `true`；如果处于非活动状态，则为 `false`。
`clickCount`	鼠标单击次数，指示该事件是否为多击序列的一部分。
`stageX`	事件发生点在全局舞台坐标中的水平坐标。
`stageY`	事件发生点在全局舞台坐标中的垂直坐标。
`target`	指针设备下的 InteractiveObject 实例。`target` 不一定是显示列表中注册此事件侦听器的对象。请使用 `currentTarget` 属性来访问显示列表中当前正在处理此事件的对象。

常量详细信息

MAX_TIP_LENGTH

常量

static const MAX_TIP_LENGTH:Number = 63

允许的系统任务栏图标工具提示长度。

window.runtime 属性	window.runtime.flash.desktop.SystemTrayIcon

继承	SystemTrayIcon InteractiveIcon Icon EventDispatcher Object

针对 HTML 开发人员的 Adobe AIR 语言参考	索引 \| 框架无框架
SystemTrayIcon