(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
[override] さまざまなサイズの BitmapData オブジェクトの配列としてのアイコンイメージです。
SystemTrayIcon
 Inheritedconstructor : Object
指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクタ関数への参照です。
Object
  AIR-only height : int
[override] [読み取り専用] アイコンの現在の表示の高さです (ピクセル単位)。
SystemTrayIcon
  AIR-only menu : NativeMenu
システムトレイアイコンメニューです。
SystemTrayIcon
 Inheritedprototype : Object
[静的] クラスまたは関数オブジェクトのプロトタイプオブジェクトへの参照です。
Object
  AIR-only tooltip : String
システムトレイアイコンにポップアップ表示されるツールヒントです。
SystemTrayIcon
  AIR-only width : int
[override] [読み取り専用] アイコンの現在の表示幅です (ピクセル単位)。
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[override]

ランタイムバージョン: AIR 1.0

さまざまなサイズの BitmapData オブジェクトの配列としてのアイコンイメージです。

指定されたオペレーティングシステムのコンテキストでアイコンを表示する場合、表示するサイズに最も近い配列のビットマップが使用されます (必要に応じて伸縮)。一般的なサイズには、16x16、32x32、48x48 および 128x128 があります (512x512 ピクセルのアイコンは、近い将来にいくつかのオペレーティングシステムアイコンで使用される可能性があります)。

一部のコンテキストでは、bitmaps プロパティに何も割り当てられていない場合、オペレーティングシステムがデフォルトのシステムアイコンを使用することがあります。その他のコンテキストでは、アイコンは表示されません。

アイコンの外観を設定または変更するには、BitmapData オブジェクトの配列を bitmaps プロパティに割り当てます。

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

bitmaps 配列を直接変更しても効果はありません。

アイコンイメージを消去するには、bitmaps プロパティに空の配列を割り当てます。

メモ : アイコン用のイメージファイルをロードする場合、通常、最も適切なアルファブレンドが提供されるのは PNG ファイル形式です。GIF 形式は透明度のオンまたはオフのみをサポートし、ブレンドは行いません。JPG 形式は、透明度をまったくサポートしません。



実装
    override public function get bitmaps():Array
    override public function set bitmaps(value:Array):void
AIR-only heightプロパティ 
height:int  [読み取り専用] [override]

ランタイムバージョン: AIR 1.0

アイコンの現在の表示の高さです (ピクセル単位)。

一部のアイコンのコンテキストでは、動的なサイズ調整がサポートされます。height プロパティは、現在のコンテキストの bitmaps 配列から選択されたアイコンの高さを示します。オペレーティングシステムによってアイコンが伸縮されている場合は、実際の表示の高さはこれとは異なります。



実装
    override 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  [読み取り専用] [override]

ランタイムバージョン: AIR 1.0

アイコンの現在の表示幅です (ピクセル単位)。

一部のアイコンのコンテキストでは、動的なサイズ調整がサポートされます。width プロパティは、現在のコンテキストの bitmaps 配列から選択されたアイコンの幅を示します。オペレーティングシステムによってアイコンが伸縮されている場合は、実際の表示幅はこれとは異なります。



実装
    override public function get width():int
イベントの詳細
AIR-only click イベント
イベントオブジェクトの型: flash.events.ScreenMouseEvent
プロパティ ScreenMouseEvent.type = flash.events.ScreenMouseEvent.CLICK

ランタイムバージョン: AIR 1.0

マウスをクリックしたときに、この SystemTrayIcon オブジェクトによって送出されます。

ScreenMouseEvent.CLICK 定数は、type プロパティ(click イベントオブジェクト)の値を定義します。

このイベントには、次の関連するプロパティがあります。

プロパティ
buttonDownマウスの主ボタンが押されている場合は true、それ以外の場合は false です。
ctrlKeyWindows または Linux では Ctrl キーがアクティブになっている場合は、true です。Macintosh では Ctrl キーまたは Command キーがアクティブになっている場合は、true です。それ以外の場合は false を返します。
currentTargetイベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。
shiftKeyShift キーがアクティブになっている場合は true、非アクティブになっている場合は false です。
commandKeyMacintosh で Command キーがアクティブになっている場合は true、非アクティブになっている場合は false です。 Windows では常に false になります。
controlKeyCtrl キーまたは 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 定数は、type プロパティ(mouseDown イベントオブジェクト)の値を定義します。

このイベントには、次の関連するプロパティがあります。

プロパティ
buttonDownマウスの主ボタンが押されている場合は true、それ以外の場合は false です。
ctrlKeyWindows または Linux では Ctrl キーがアクティブになっている場合は、true です。Macintosh では Ctrl キーまたは Command キーがアクティブになっている場合は、true です。それ以外の場合は false を返します。
currentTargetイベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。
shiftKeyShift キーがアクティブになっている場合は true、非アクティブになっている場合は false です。
commandKeyMacintosh で Command キーがアクティブになっている場合は true、非アクティブになっている場合は false です。 Windows では常に false になります。
controlKeyCtrl キーまたは 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 定数は、type プロパティ(mouseUp イベントオブジェクト)の値を定義します。

このイベントには、次の関連するプロパティがあります。

プロパティ
buttonDownマウスの主ボタンが押されている場合は true、それ以外の場合は false です。
ctrlKeyWindows または Linux では Ctrl キーがアクティブになっている場合は、true です。Macintosh では Ctrl キーまたは Command キーがアクティブになっている場合は、true です。それ以外の場合は false を返します。
currentTargetイベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。
shiftKeyShift キーがアクティブになっている場合は true、非アクティブになっている場合は false です。
commandKeyMacintosh で Command キーがアクティブになっている場合は true、非アクティブになっている場合は false です。 Windows では常に false になります。
controlKeyCtrl キーまたは 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 定数は、type プロパティ(rightClick イベントオブジェクト)の値を定義します。

このイベントには、次の関連するプロパティがあります。

プロパティ
buttonDownマウスの主ボタンが押されている場合は true、それ以外の場合は false です。
ctrlKeyWindows または Linux では Ctrl キーがアクティブになっている場合は、true です。Macintosh では Ctrl キーまたは Command キーがアクティブになっている場合は、true です。それ以外の場合は false を返します。
currentTargetイベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。
shiftKeyShift キーがアクティブになっている場合は true、非アクティブになっている場合は false です。
commandKeyMacintosh で Command キーがアクティブになっている場合は true、非アクティブになっている場合は false です。 Windows では常に false になります。
controlKeyCtrl キーまたは 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 定数は、type プロパティ(rightMouseDown イベントオブジェクト)の値を定義します。

このイベントには、次の関連するプロパティがあります。

プロパティ
buttonDownマウスの主ボタンが押されている場合は true、それ以外の場合は false です。
ctrlKeyWindows または Linux では Ctrl キーがアクティブになっている場合は、true です。Macintosh では Ctrl キーまたは Command キーがアクティブになっている場合は、true です。それ以外の場合は false を返します。
currentTargetイベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。
shiftKeyShift キーがアクティブになっている場合は true、非アクティブになっている場合は false です。
commandKeyMacintosh で Command キーがアクティブになっている場合は true、非アクティブになっている場合は false です。 Windows では常に false になります。
controlKeyCtrl キーまたは 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 定数は、type プロパティ(rightMouseUp イベントオブジェクト)の値を定義します。

このイベントには、次の関連するプロパティがあります。

プロパティ
buttonDownマウスの主ボタンが押されている場合は true、それ以外の場合は false です。
ctrlKeyWindows または Linux では Ctrl キーがアクティブになっている場合は、true です。Macintosh では Ctrl キーまたは Command キーがアクティブになっている場合は、true です。それ以外の場合は false を返します。
currentTargetイベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。
shiftKeyShift キーがアクティブになっている場合は true、非アクティブになっている場合は false です。
commandKeyMacintosh で Command キーがアクティブになっている場合は true、非アクティブになっている場合は false です。 Windows では常に false になります。
controlKeyCtrl キーまたは 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

システムトレイアイコンのツールヒントに対して許可されている最大の長さです。





 

 

このページに新しいコメントが追加された場合に、電子メールでの通知を希望する。 | コメントレポート

現在のページ: http://livedocs.adobe.com/flex/3_jp/langref/flash/desktop/SystemTrayIcon.html