アイコンのコンテキストメニューの作成

Adobe AIR 1.0 およびそれ以降

Adobe AIR アプリケーションでは、アプリケーションウィンドウ内の DOM エレメント用のコンテキストメニューに加えて、他の 2 つの特別なコンテキストメニューをサポートしています。ドックアイコンメニューと、システムトレイを用いるオペレーティングシステムのシステムトレイアイコンメニューです。これらのメニューを設定するには、まず、 Menu.createFromXML() メソッドまたは Menu.createFromJSON() メソッドを使用して NativeMenu を作成します。次に、 Menu.setAsIconMenu() メソッドを呼び出して、その NativeMenu をドックアイコンメニューまたはシステムトレイアイコンメニューとして割り当てます。

このメソッドでは 2 つの引数を使用します。最初の引数は必須で、アイコンメニューとして使用する NativeMenu です。2 番目の引数は Array で、アイコンとして使用する画像へのファイルパスのストリングまたはアイコンの画像データを含む BitmapData オブジェクトが入ります。この引数は、application.xml ファイルにデフォルトアイコンが指定されていない場合は、必須になります。application.xml ファイルにデフォルトアイコンが指定されている場合は、そのアイコンがシステムトレイアイコンのデフォルトとして使用されます。

次の例では、メニューデータを読み込み、そのメニューをドックアイコンまたはシステムトレイアイコンのコンテキストメニューとして割り当てる方法を示します。

// Assumes that icons are specified in the application.xml file. 
// Otherwise the icons would need to be specified using a second 
// parameter to the setAsIconMenu() function. 
var iconMenu = air.ui.Menu.createFromXML("iconMenu.xml"); 
air.ui.Menu.setAsIconMenu(iconMenu);
注意: Mac OS X では、アプリケーションのドックアイコン用に標準のコンテキストメニューが定義されています。メニューをドックアイコンのコンテキストメニューとして割り当てると、メニュー内のアイテムが OS の標準メニューアイテムの上に表示されます。標準のメニューアイテムの削除、アクセスまたは変更を行うことはできません。