ActionScript 3.0でのFireworksイベントの処理
作成日
12 November 2007
ページ ツール |
必要条件
この記事に必要な予備知識
ActionScript 3.0、Fireworks DOM、またFireworksでのJavaScriptを使用した作業についての基礎知識を持っていることが推奨されます。ActionScript 2.0を使用したカスタムパネルの作成方法についてさらに詳しくは、Trevor McCauleyによる次の記事を参照してください。
ユーザーレベル
上級
必要な製品
- Fireworks CS3 (Download trial)
- Flash Professional CS3 (Download trial)
サンプルファイル
- fw_events_as3.zip (692 KB)
カスタムパネルは、Fireworksを拡張して新機能をツールに導入したり、ワークフローをチームの手順に導入できる機能の１つです。Flash CS3 Professionalでカスタムパネルを作成または修正して、Fireworks CS3で使用するためのSWFファイルとしてエクスポートします。ActionScript 2.0またはActionScript 3.0を使用してこれらのパネルを拡張しFireworksイベントを処理することができます。
この記事では、ActionScript 3.0を使用したカスタムパネルでのFireworksイベントの処理について重点的に説明します。
イベントの受信
Fireworksでイベントが生成されると、FireworksはActionScript 3.0 SWFファイルのIsFwCallbackInstalled関数を呼び出し、イベント処理コードがカスタムパネルで記述されたものであるかどうか確認します。関数がtrueを返すと、Fireworksはまずカスタムパネルで記述されたイベントコードを実行してから、Fireworksのイベント処理コードを実行します。図１はFireworksイベントの制御フローを示しています。
Trevorの「Creating Fireworks panels」のパート２シリーズでは、Fireworksによって生成されたすべてのイベント*を含むテーブルを示しています。Fireworks CS3で発生したこれらのイベントをActionScript 3.0で利用するには、カスタムパネルに次の２つの関数を記述する必要があります。
- IsFwCallbackInstalled： この関数はFireworksによって呼び出され、生成されたイベントに対してイベントハンドラが記述されたかどうかチェックします。
次の例では、開いているまたは閉じているFireworksドキュメントに関連したイベントがないかFireworksがチェックするときに
trueを返します。これにより、アクションが発生したときにカスタムパネルのイベントに対してハンドラを呼び出すようにFireworksに指示します。
function IsFwCallbackInstalled( funcName:String ):Boolean
{
switch( funcName )
{
case "onFwDocumentOpen":
return true;
case "onFwDocumentClose":
return true;
case "setfwActiveToolForSWFs":
return true;
}
return false;
}
- イベント関数： イベントを処理するためのコードです。これは、Fireworksでイベントが発生したときにイベントに関連するコマンドを実行するために定義する関数です。次の例では、
onFwDocumentOpenおよびOnFwDocumentCloseのイベントに対するイベントハンドラを示しています。ドキュメントを開いたとき（図２を参照）または閉じたとき（図３を参照）は常に警告メッセージが表示されます。
function OpenDoc()
{
MMExecute('alert("Opening Document");');
}
function CloseDoc ()
{
MMExecute('alert("Closing Document");');
}
関数の登録
Fireworksが呼び出す、ActionScript 3.0で記述されたすべての関数を登録する必要があります。Fireworksでは、登録されていない関数をカスタムパネルで呼び出すことはできません。関数を登録するには、次のコード行を関数に追加します。
ExternalInterface.addCallback("<alias name>",<function name>);
ここで、
- <alias name>はFireworksが呼び出すイベント関数名です。
- <function name>はActionScript 3.0で記述される関数の名前です。
例えば、IsFwCallbackInstalledを登録するには、次のコード行を追加する必要があります。
ExternalInterface.addCallback("IsFwCallbackInstalled",IsFwCallbackInstalled);
同様に、OpenDocおよびCloseDocを登録するには、次のコード行をそれぞれ追加する必要があります。
ExternalInterface.addCallback("onFwDocumentOpen",OpenDoc);
ExternalInterface.addCallback("onFwDocumentClose",CloseDoc);
イベントを処理するActionScript 3.0の関数は、その関数とIsFwCallbackInstalledが登録された場合、またイベントが生成されたときにIsFwCallbackInstalledがtrueを返した場合にのみFireworksで実行されます。
サンプルファイルの使用
この記事に付属のサンプルファイル（fw_events_as3.zip）には次の２つのファイルが含まれます。
- ActionScript.swf： このファイルを次のFireworksのインストールフォルダにコピーします。
- Windows： C:\Program Files\Adobe\Adobe Fireworks CS3\Configuration\Command Panels
- Macintosh： Hard Drive:Applications:Adobe Fireworks CS3:Configuration:Command Panels
これでFireworksを再起動したときに新しいパネルが追加されます。ウィンドウ／ActionScriptを選択してこの新しいパネルを開きます（図４を参照）。このパネルでは、現在使用中のツールを一覧表示し、ドキュメントを開いたときまたは閉じたときに常に警告メッセージを表示します。
- ActionScript.fla： このFlash CS3 ProfessionalファイルにはFireworksパネルのソースコードが含まれています。このファイルにはFireworksイベントのキャプチャおよび処理方法が記述されています。
More Like This
Tutorials & Samples |
Tutorials
- Creating and exporting Fireworks graphics as FXG files for Flash Catalyst
- Creating jQuery Mobile website themes in Fireworks
- Extracting CSS properties from Fireworks design objects
Fireworks Forum |
More |
| 12/16/2008 | Disappearing Mouse Cursor? |
|---|---|
| 01/13/2012 | Survey: Blend mode options in Brush tool? |
| 01/25/2012 | after a update of cs3 to 9.0.1 styles are broken |
| 08/15/2011 | CS5 plagued with many bugs in Lion |
Fireworks Cookbooks |
More |
| 09/07/2011 | How do I use FXG XML markup in Shape subclasses? |
|---|---|
| 10/15/2010 | Flex4 Dotted Line |
| 06/25/2010 | ComboBox that uses a NativeMenu (Air API) |
| 05/21/2010 | Localizing a Creative Suite 5 extension |
