(仅限 AIR)
flash.desktop
public class SystemTrayIcon
继承SystemTrayIcon Inheritance InteractiveIcon Inheritance Icon Inheritance EventDispatcher Inheritance Object

语言版本: ActionScript 3.0
运行时版本: AIR 1.0

SystemTrayIcon 类表示 Windows® 任务栏通知区域(系统任务栏)样式的图标。

不是所有操作系统都有系统任务栏图标。检查 NativeApplication.supportsSystemTrayIcon 以确定在当前系统上是否支持系统任务栏图标。

无法创建 SystemTrayIcon 类的实例。从“全局的”NativeApplication 对象的 icon 属性中获取表示系统任务栏图标的对象。

如果支持系统任务栏图标,则 icon 将为 SystemTrayIcon 类型。否则,icon 的类型将是 InteractiveIcon 的另一个子类,通常是 DockIcon。

重要说明:在 AIR 不支持系统任务栏图标的操作系统上尝试对 NativeApplication.icon 对象调用 SystemTrayIcon 类方法将生成运行时异常。

另请参见

flash.desktop.NativeApplication.icon
flash.desktop.NativeApplication.supportsSystemTrayIcon
flash.desktop.DockIcon


公共属性
 属性定义方
  AIR-only bitmaps : Array
作为不同大小的 BitmapData 对象数组的图标图像。
SystemTrayIcon
 Inheritedconstructor : Object
对类对象或给定对象实例的构造函数的引用。
Object
  AIR-only height : int
[只读 (read-only)] 图标的当前显示高度,以像素为单位。
SystemTrayIcon
  AIR-only menu : NativeMenu
系统任务栏图标菜单。
SystemTrayIcon
 Inheritedprototype : Object
[静态] 对类或函数对象的原型对象的引用。
Object
  AIR-only tooltip : String
为系统任务栏图标弹出的工具提示。
SystemTrayIcon
  AIR-only width : int
[只读 (read-only)] 图标的当前显示宽度,以像素为单位。
SystemTrayIcon
公共方法
 方法定义方
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
使用 EventDispatcher 对象注册事件侦听器对象,以使侦听器能够接收事件通知。
EventDispatcher
 Inherited
将事件调度到事件流中。
EventDispatcher
 Inherited
检查 EventDispatcher 对象是否为特定事件类型注册了任何侦听器。
EventDispatcher
 Inherited
指示对象是否已经定义了指定的属性。
Object
 Inherited
指示 Object 类的实例是否在指定为参数的对象的原型链中。
Object
 Inherited
指示指定的属性是否存在、是否可枚举。
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
从 EventDispatcher 对象中删除侦听器。
EventDispatcher
 Inherited
设置循环操作动态属性的可用性。
Object
 Inherited
返回指定对象的字符串表示形式。
Object
 Inherited
返回指定对象的原始值。
Object
 Inherited
检查是否用此 EventDispatcher 对象或其任何始祖为指定事件类型注册了事件侦听器。
EventDispatcher
事件
 事件 摘要 定义方
 Inherited[广播事件] Flash Player 或 AIR 应用程序获得操作系统焦点并变为活动状态时将调度此事件。EventDispatcher
  在鼠标单击时由此 SystemTrayIcon 对象调度。SystemTrayIcon
 Inherited[广播事件] Flash Player 或 AIR 应用程序失去操作系统焦点并变为非活动状态时将调度此事件。EventDispatcher
  在鼠标按下时由此 SystemTrayIcon 对象调度。SystemTrayIcon
  在鼠标弹起时由此 SystemTrayIcon 对象调度。SystemTrayIcon
  在鼠标右键单击时由此 SystemTrayIcon 对象调度。SystemTrayIcon
  在鼠标右键按下时由此 SystemTrayIcon 对象调度。SystemTrayIcon
  在鼠标右键弹起时由此 SystemTrayIcon 对象调度。SystemTrayIcon
公共常量
 常量定义方
  AIR-only MAX_TIP_LENGTH : Number = 63
[静态] 允许的系统任务栏图标工具提示长度。
SystemTrayIcon
属性详细信息
AIR-only bitmaps属性
bitmaps:Array  [读写]

运行时版本: AIR 1.0

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

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

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

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

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

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

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

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



实现
    public function get bitmaps():Array
    public function set bitmaps(value:Array):void
AIR-only height属性 
height:int  [只读 (read-only)]

运行时版本: AIR 1.0

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

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



实现
    public function get height():int
AIR-only menu属性 
menu:NativeMenu  [读写]

语言版本: ActionScript 3.0
运行时版本: AIR 1.0

系统任务栏图标菜单。



实现
    public function get menu():NativeMenu
    public function set menu(value:NativeMenu):void
AIR-only tooltip属性 
tooltip:String  [读写]

语言版本: ActionScript 3.0
运行时版本: AIR 1.0

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



实现
    public function get tooltip():String
    public function set tooltip(value:String):void
AIR-only width属性 
width:int  [只读 (read-only)]

运行时版本: AIR 1.0

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

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



实现
    public function get width():int
事件详细信息
AIR-only click 事件
事件对象类型: flash.events.ScreenMouseEvent
属性 ScreenMouseEvent.type = flash.events.ScreenMouseEvent.CLICK

运行时版本: AIR 1.0

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

ScreenMouseEvent.CLICK 常量定义 click 事件对象的 type 属性的值。

此事件具有以下相关属性:

属性
buttonDown 如果按下鼠标主按键,则为 true;否则为 false
ctrlKey 在 Windows 或 Linux 中,如果 Ctrl 键处于活动状态,则为 true。在 Mac 中,如果 Ctrl 键或 Command 键处于活动状态,则为 true。否则为 false
currentTarget 当前正在使用某个事件侦听器处理 Event 对象的对象。
shiftKey 如果 Shift 键处于活动状态,则为 true;如果处于非活动状态,则为 false
commandKey 在 Mac 中,如果 Command 键处于活动状态,则为 true;如果处于非活动状态,则为 false。在 Windows 中始终为 false
controlKey 如果 Ctrl 或 Control 键处于活动状态,则为 true,如果处于非活动状态,则为 false
screenX 事件发生点在屏幕坐标中的水平坐标。
screenY 事件发生点在屏幕坐标中的垂直坐标。
target 指针设备下的 SystemTrayIcon 对象。
AIR-only mouseDown 事件  
事件对象类型: flash.events.ScreenMouseEvent
属性 ScreenMouseEvent.type = flash.events.ScreenMouseEvent.MOUSE_DOWN

运行时版本: AIR 1.0

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

ScreenMouseEvent.MOUSE_DOWN 常量定义 mouseDown 事件对象的 type 属性的值。

此事件具有以下相关属性:

属性
buttonDown 如果按下鼠标主按键,则为 true;否则为 false
ctrlKey 在 Windows 或 Linux 中,如果 Ctrl 键处于活动状态,则为 true。在 Mac 中,如果 Ctrl 键或 Command 键处于活动状态,则为 true。否则为 false
currentTarget 当前正在使用某个事件侦听器处理 Event 对象的对象。
shiftKey 如果 Shift 键处于活动状态,则为 true;如果处于非活动状态,则为 false
commandKey 在 Mac 中,如果 Command 键处于活动状态,则为 true;如果处于非活动状态,则为 false。在 Windows 中始终为 false
controlKey 如果 Ctrl 或 Control 键处于活动状态,则为 true,如果处于非活动状态,则为 false
screenX 事件发生点在屏幕坐标中的水平坐标。
screenY 事件发生点在屏幕坐标中的垂直坐标。
target 指针设备下的 SystemTrayIcon 对象。
AIR-only mouseUp 事件  
事件对象类型: flash.events.ScreenMouseEvent
属性 ScreenMouseEvent.type = flash.events.ScreenMouseEvent.MOUSE_UP

运行时版本: AIR 1.0

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

ScreenMouseEvent.MOUSE_UP 常量定义 mouseUp 事件对象的 type 属性的值。

此事件具有以下相关属性:

属性
buttonDown 如果按下鼠标主按键,则为 true;否则为 false
ctrlKey 在 Windows 或 Linux 中,如果 Ctrl 键处于活动状态,则为 true。在 Mac 中,如果 Ctrl 键或 Command 键处于活动状态,则为 true。否则为 false
currentTarget 当前正在使用某个事件侦听器处理 Event 对象的对象。
shiftKey 如果 Shift 键处于活动状态,则为 true;如果处于非活动状态,则为 false
commandKey 在 Mac 中,如果 Command 键处于活动状态,则为 true;如果处于非活动状态,则为 false。在 Windows 中始终为 false
controlKey 如果 Ctrl 或 Control 键处于活动状态,则为 true,如果处于非活动状态,则为 false
screenX 事件发生点在屏幕坐标中的水平坐标。
screenY 事件发生点在屏幕坐标中的垂直坐标。
target 指针设备下的 SystemTrayIcon 对象。
AIR-only rightClick 事件  
事件对象类型: flash.events.ScreenMouseEvent
属性 ScreenMouseEvent.type = flash.events.ScreenMouseEvent.RIGHT_CLICK

运行时版本: AIR 1.0

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

ScreenMouseEvent.RIGHT_CLICK 常量定义 rightClick 事件对象的 type 属性的值。

此事件具有以下相关属性:

属性
buttonDown 如果按下鼠标主按键,则为 true;否则为 false
ctrlKey 在 Windows 或 Linux 中,如果 Ctrl 键处于活动状态,则为 true。在 Mac 中,如果 Ctrl 键或 Command 键处于活动状态,则为 true。否则为 false
currentTarget 当前正在使用某个事件侦听器处理 Event 对象的对象。
shiftKey 如果 Shift 键处于活动状态,则为 true;如果处于非活动状态,则为 false
commandKey 在 Mac 中,如果 Command 键处于活动状态,则为 true;如果处于非活动状态,则为 false。在 Windows 中始终为 false
controlKey 如果 Ctrl 或 Control 键处于活动状态,则为 true,如果处于非活动状态,则为 false
screenX 事件发生点在屏幕坐标中的水平坐标。
screenY 事件发生点在屏幕坐标中的垂直坐标。
target 指针设备下的 SystemTrayIcon 对象。
AIR-only rightMouseDown 事件  
事件对象类型: flash.events.ScreenMouseEvent
属性 ScreenMouseEvent.type = flash.events.ScreenMouseEvent.RIGHT_MOUSE_DOWN

运行时版本: AIR 1.0

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

ScreenMouseEvent.RIGHT_MOUSE_DOWN 常量定义 rightMouseDown 事件对象的 type 属性的值。

此事件具有以下相关属性:

属性
buttonDown 如果按下鼠标主按键,则为 true;否则为 false
ctrlKey 在 Windows 或 Linux 中,如果 Ctrl 键处于活动状态,则为 true。在 Mac 中,如果 Ctrl 键或 Command 键处于活动状态,则为 true。否则为 false
currentTarget 当前正在使用某个事件侦听器处理 Event 对象的对象。
shiftKey 如果 Shift 键处于活动状态,则为 true;如果处于非活动状态,则为 false
commandKey 在 Mac 中,如果 Command 键处于活动状态,则为 true;如果处于非活动状态,则为 false。在 Windows 中始终为 false
controlKey 如果 Ctrl 或 Control 键处于活动状态,则为 true,如果处于非活动状态,则为 false
screenX 事件发生点在屏幕坐标中的水平坐标。
screenY 事件发生点在屏幕坐标中的垂直坐标。
target 指针设备下的 SystemTrayIcon 对象。
AIR-only rightMouseUp 事件  
事件对象类型: flash.events.ScreenMouseEvent
属性 ScreenMouseEvent.type = flash.events.ScreenMouseEvent.RIGHT_MOUSE_UP

运行时版本: AIR 1.0

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

ScreenMouseEvent.RIGHT_MOUSE_UP 常量定义 rightMouseUp 事件对象的 type 属性的值。

此事件具有以下相关属性:

属性
buttonDown 如果按下鼠标主按键,则为 true;否则为 false
ctrlKey 在 Windows 或 Linux 中,如果 Ctrl 键处于活动状态,则为 true。在 Mac 中,如果 Ctrl 键或 Command 键处于活动状态,则为 true。否则为 false
currentTarget 当前正在使用某个事件侦听器处理 Event 对象的对象。
shiftKey 如果 Shift 键处于活动状态,则为 true;如果处于非活动状态,则为 false
commandKey 在 Mac 中,如果 Command 键处于活动状态,则为 true;如果处于非活动状态,则为 false。在 Windows 中始终为 false
controlKey 如果 Ctrl 或 Control 键处于活动状态,则为 true,如果处于非活动状态,则为 false
screenX 事件发生点在屏幕坐标中的水平坐标。
screenY 事件发生点在屏幕坐标中的垂直坐标。
target 指针设备下的 SystemTrayIcon 对象。
常量详细信息
AIR-only MAX_TIP_LENGTH常量
public static const MAX_TIP_LENGTH:Number = 63

语言版本: ActionScript 3.0
运行时版本: AIR 1.0

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