| パッケージ | flash.desktop |
| クラス | public class SystemTrayIcon |
| 継承 | SystemTrayIcon InteractiveIcon Icon EventDispatcher Object |
| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 |
システムトレイアイコンのないオペレーティングシステムもあります。 現在のシステムでシステムトレイアイコンがサポートされているかどうかを確認するには、NativeApplication.supportsSystemTrayIcon を調べます。
SystemTrayIcon クラスのインスタンスは作成できません。"グローバルな" NativeApplication オブジェクトの icon プロパティからシステムトレイアイコンを表すオブジェクトを取得します。
システムトレイアイコンがサポートされている場合は、icon プロパティのタイプが SystemTrayIcon に設定されています。サポートされていない場合、icon のタイプは、InteractiveIcon の別のサブクラスである DockIcon などに設定されています。
重要:AIR がシステムトレイアイコンをサポートしていないオペレーティングシステムで NativeApplication.icon オブジェクトの SystemTrayIcon クラスのメソッドを呼び出そうとすると、ランタイム例外が生成されます。
関連項目
| プロパティ | 定義元 | ||
|---|---|---|---|
[override]
さまざまなサイズの BitmapData オブジェクトの配列としてのアイコンイメージです。 | SystemTrayIcon | ||
![]() | constructor : Object
指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクタ関数への参照です。 | Object | |
[override] [読み取り専用]
アイコンの現在の表示の高さです (ピクセル単位)。 | SystemTrayIcon | ||
システムトレイアイコンメニューです。 | SystemTrayIcon | ||
![]() | prototype : Object [静的]
クラスまたは関数オブジェクトのプロトタイプオブジェクトへの参照です。 | Object | |
システムトレイアイコンにポップアップ表示されるツールヒントです。 | SystemTrayIcon | ||
[override] [読み取り専用]
アイコンの現在の表示幅です (ピクセル単位)。 | SystemTrayIcon | ||
| イベント | 概要 | 定義元 | ||
|---|---|---|---|---|
![]() | [ブロードキャスト イベント] Flash Player または AIR アプリケーションがオペレーティングシステムのフォーカスを取得して、アクティブになったときに送出されます。 | EventDispatcher | ||
| マウスをクリックしたときに、この SystemTrayIcon オブジェクトによって送出されます。 | SystemTrayIcon | |||
![]() | [ブロードキャスト イベント] Flash Player または AIR アプリケーションがオペレーティングシステムのフォーカスを失って、非アクティブになったときに送出されます。 | EventDispatcher | ||
| マウスを押したときに、この SystemTrayIcon オブジェクトによって送出されます。 | SystemTrayIcon | |||
| マウスを離したときに、この SystemTrayIcon オブジェクトによって送出されます。 | SystemTrayIcon | |||
| マウスを右クリックしたときに、この SystemTrayIcon オブジェクトによって送出されます。 | SystemTrayIcon | |||
| マウスの右ボタンを押したときに、この SystemTrayIcon オブジェクトによって送出されます。 | SystemTrayIcon | |||
| マウスの右ボタンを離したときに、この SystemTrayIcon オブジェクトによって送出されます。 | SystemTrayIcon | |||
| 定数 | 定義元 | ||
|---|---|---|---|
[静的]
システムトレイアイコンのツールヒントに対して許可されている最大の長さです。 | SystemTrayIcon | ||
| プロパティ |
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| プロパティ |
height:int [読み取り専用] [override] | ランタイムバージョン: | AIR 1.0 |
アイコンの現在の表示の高さです (ピクセル単位)。
一部のアイコンのコンテキストでは、動的なサイズ調整がサポートされます。height プロパティは、現在のコンテキストの bitmaps 配列から選択されたアイコンの高さを示します。オペレーティングシステムによってアイコンが伸縮されている場合は、実際の表示の高さはこれとは異なります。
override public function get height():int| プロパティ |
menu:NativeMenu| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 |
システムトレイアイコンメニューです。
public function get menu():NativeMenu public function set menu(value:NativeMenu):void| プロパティ |
tooltip:String| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 |
システムトレイアイコンにポップアップ表示されるツールヒントです。ストリングが SystemTrayIcon.MAX_TIP_LENGTH より長い場合、ツールヒントは切り詰められます。
public function get tooltip():String public function set tooltip(value:String):void| プロパティ |
width:int [読み取り専用] [override] | ランタイムバージョン: | AIR 1.0 |
アイコンの現在の表示幅です (ピクセル単位)。
一部のアイコンのコンテキストでは、動的なサイズ調整がサポートされます。width プロパティは、現在のコンテキストの bitmaps 配列から選択されたアイコンの幅を示します。オペレーティングシステムによってアイコンが伸縮されている場合は、実際の表示幅はこれとは異なります。
override public function get width():int| イベント |
flash.events.ScreenMouseEventflash.events.ScreenMouseEvent.CLICK| ランタイムバージョン: | AIR 1.0 |
マウスをクリックしたときに、この SystemTrayIcon オブジェクトによって送出されます。
ScreenMouseEvent.CLICK 定数は、type プロパティ(click イベントオブジェクト)の値を定義します。
このイベントには、次の関連するプロパティがあります。
| プロパティ | 値 |
|---|---|
buttonDown | マウスの主ボタンが押されている場合は true、それ以外の場合は false です。 |
ctrlKey | Windows または Linux では Ctrl キーがアクティブになっている場合は、true です。Macintosh では Ctrl キーまたは Command キーがアクティブになっている場合は、true です。それ以外の場合は false を返します。 |
currentTarget | イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。 |
shiftKey | Shift キーがアクティブになっている場合は true、非アクティブになっている場合は false です。 |
commandKey | Macintosh で Command キーがアクティブになっている場合は true、非アクティブになっている場合は false です。 Windows では常に false になります。 |
controlKey | Ctrl キーまたは Control キーがアクティブになっている場合は true、非アクティブになっている場合は false です。 |
screenX | 画面座標を基準とするイベント発生位置の水平座標です。 |
screenY | 画面座標を基準とするイベント発生位置の垂直座標です。 |
target | ポインティングデバイスの下にある SystemTrayIcon オブジェクトです。 |
| イベント |
flash.events.ScreenMouseEventflash.events.ScreenMouseEvent.MOUSE_DOWN| ランタイムバージョン: | AIR 1.0 |
マウスを押したときに、この SystemTrayIcon オブジェクトによって送出されます。
ScreenMouseEvent.MOUSE_DOWN 定数は、type プロパティ(mouseDown イベントオブジェクト)の値を定義します。
このイベントには、次の関連するプロパティがあります。
| プロパティ | 値 |
|---|---|
buttonDown | マウスの主ボタンが押されている場合は true、それ以外の場合は false です。 |
ctrlKey | Windows または Linux では Ctrl キーがアクティブになっている場合は、true です。Macintosh では Ctrl キーまたは Command キーがアクティブになっている場合は、true です。それ以外の場合は false を返します。 |
currentTarget | イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。 |
shiftKey | Shift キーがアクティブになっている場合は true、非アクティブになっている場合は false です。 |
commandKey | Macintosh で Command キーがアクティブになっている場合は true、非アクティブになっている場合は false です。 Windows では常に false になります。 |
controlKey | Ctrl キーまたは Control キーがアクティブになっている場合は true、非アクティブになっている場合は false です。 |
screenX | 画面座標を基準とするイベント発生位置の水平座標です。 |
screenY | 画面座標を基準とするイベント発生位置の垂直座標です。 |
target | ポインティングデバイスの下にある SystemTrayIcon オブジェクトです。 |
| イベント |
flash.events.ScreenMouseEventflash.events.ScreenMouseEvent.MOUSE_UP| ランタイムバージョン: | AIR 1.0 |
マウスを離したときに、この SystemTrayIcon オブジェクトによって送出されます。
ScreenMouseEvent.MOUSE_UP 定数は、type プロパティ(mouseUp イベントオブジェクト)の値を定義します。
このイベントには、次の関連するプロパティがあります。
| プロパティ | 値 |
|---|---|
buttonDown | マウスの主ボタンが押されている場合は true、それ以外の場合は false です。 |
ctrlKey | Windows または Linux では Ctrl キーがアクティブになっている場合は、true です。Macintosh では Ctrl キーまたは Command キーがアクティブになっている場合は、true です。それ以外の場合は false を返します。 |
currentTarget | イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。 |
shiftKey | Shift キーがアクティブになっている場合は true、非アクティブになっている場合は false です。 |
commandKey | Macintosh で Command キーがアクティブになっている場合は true、非アクティブになっている場合は false です。 Windows では常に false になります。 |
controlKey | Ctrl キーまたは Control キーがアクティブになっている場合は true、非アクティブになっている場合は false です。 |
screenX | 画面座標を基準とするイベント発生位置の水平座標です。 |
screenY | 画面座標を基準とするイベント発生位置の垂直座標です。 |
target | ポインティングデバイスの下にある SystemTrayIcon オブジェクトです。 |
| イベント |
flash.events.ScreenMouseEventflash.events.ScreenMouseEvent.RIGHT_CLICK| ランタイムバージョン: | AIR 1.0 |
マウスを右クリックしたときに、この SystemTrayIcon オブジェクトによって送出されます。
ScreenMouseEvent.RIGHT_CLICK 定数は、type プロパティ(rightClick イベントオブジェクト)の値を定義します。
このイベントには、次の関連するプロパティがあります。
| プロパティ | 値 |
|---|---|
buttonDown | マウスの主ボタンが押されている場合は true、それ以外の場合は false です。 |
ctrlKey | Windows または Linux では Ctrl キーがアクティブになっている場合は、true です。Macintosh では Ctrl キーまたは Command キーがアクティブになっている場合は、true です。それ以外の場合は false を返します。 |
currentTarget | イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。 |
shiftKey | Shift キーがアクティブになっている場合は true、非アクティブになっている場合は false です。 |
commandKey | Macintosh で Command キーがアクティブになっている場合は true、非アクティブになっている場合は false です。 Windows では常に false になります。 |
controlKey | Ctrl キーまたは Control キーがアクティブになっている場合は true、非アクティブになっている場合は false です。 |
screenX | 画面座標を基準とするイベント発生位置の水平座標です。 |
screenY | 画面座標を基準とするイベント発生位置の垂直座標です。 |
target | ポインティングデバイスの下にある SystemTrayIcon オブジェクトです。 |
| イベント |
flash.events.ScreenMouseEventflash.events.ScreenMouseEvent.RIGHT_MOUSE_DOWN| ランタイムバージョン: | AIR 1.0 |
マウスの右ボタンを押したときに、この SystemTrayIcon オブジェクトによって送出されます。
ScreenMouseEvent.RIGHT_MOUSE_DOWN 定数は、type プロパティ(rightMouseDown イベントオブジェクト)の値を定義します。
このイベントには、次の関連するプロパティがあります。
| プロパティ | 値 |
|---|---|
buttonDown | マウスの主ボタンが押されている場合は true、それ以外の場合は false です。 |
ctrlKey | Windows または Linux では Ctrl キーがアクティブになっている場合は、true です。Macintosh では Ctrl キーまたは Command キーがアクティブになっている場合は、true です。それ以外の場合は false を返します。 |
currentTarget | イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。 |
shiftKey | Shift キーがアクティブになっている場合は true、非アクティブになっている場合は false です。 |
commandKey | Macintosh で Command キーがアクティブになっている場合は true、非アクティブになっている場合は false です。 Windows では常に false になります。 |
controlKey | Ctrl キーまたは Control キーがアクティブになっている場合は true、非アクティブになっている場合は false です。 |
screenX | 画面座標を基準とするイベント発生位置の水平座標です。 |
screenY | 画面座標を基準とするイベント発生位置の垂直座標です。 |
target | ポインティングデバイスの下にある SystemTrayIcon オブジェクトです。 |
| イベント |
flash.events.ScreenMouseEventflash.events.ScreenMouseEvent.RIGHT_MOUSE_UP| ランタイムバージョン: | AIR 1.0 |
マウスの右ボタンを離したときに、この SystemTrayIcon オブジェクトによって送出されます。
ScreenMouseEvent.RIGHT_MOUSE_UP 定数は、type プロパティ(rightMouseUp イベントオブジェクト)の値を定義します。
このイベントには、次の関連するプロパティがあります。
| プロパティ | 値 |
|---|---|
buttonDown | マウスの主ボタンが押されている場合は true、それ以外の場合は false です。 |
ctrlKey | Windows または Linux では Ctrl キーがアクティブになっている場合は、true です。Macintosh では Ctrl キーまたは Command キーがアクティブになっている場合は、true です。それ以外の場合は false を返します。 |
currentTarget | イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。 |
shiftKey | Shift キーがアクティブになっている場合は true、非アクティブになっている場合は false です。 |
commandKey | Macintosh で Command キーがアクティブになっている場合は true、非アクティブになっている場合は false です。 Windows では常に false になります。 |
controlKey | Ctrl キーまたは Control キーがアクティブになっている場合は true、非アクティブになっている場合は false です。 |
screenX | 画面座標を基準とするイベント発生位置の水平座標です。 |
screenY | 画面座標を基準とするイベント発生位置の垂直座標です。 |
target | ポインティングデバイスの下にある SystemTrayIcon オブジェクトです。 |
| 定数 |
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