ActionScript の使用方法の例

コードスニペット例

コードスニペット例を以下に示します。

var x:int = 5; 
trace(x); // 5

コードスニペットには、1 つの概念を示すのに十分なコードしか含まれていません。通常、package ステートメントや class ステートメントは含まれていません。

クラスの使用例

多くの例では、完全な ActionScript クラスのソースコードが示されています。クラスの使用例を以下に示します。

package { 
    public class Example1 { 
        public function Example1():void { 
            var x:int = 5; 
            trace(x); //5 
        } 
    } 
}

クラスの使用例を示すコードには、package ステートメント、クラス宣言およびコンストラクター関数が含まれています。

複数のソースファイルを含む実例

『ActionScript 3.0 開発ガイド』の多くのトピックでは、最後に実例が記載されています。そこでは、実際の現場で使える ActionScript 機能の使用例が示されています。通常、これらの例には次のような複数のファイルが含まれています。

通常、実例は ZIP 形式のアーカイブファイルで提供されます。

開発ガイドの例のリストを含む ZIP ファイル

Flash Professional CS5 および Flex 4 用の ZIP ファイル（ www.adobe.com/go/learn_programmingAS3samples_flash_jp からダウンロード）には、次の例が含まれています。

• AlarmClock（ イベント処理の例：Alarm Clock ）

• AlgorithmicVisualGenerator（ 描画 API の例：Algorithmic Visual Generator ）

• ASCIIArt（ ストリングの例：ASCII アート ）

• CapabilitiesExplorer（ 機能の例：システム機能の検出 ）

• CustomErrors（ エラー処理の例：CustomErrors アプリケーション ）

• DisplayObjectTransformer（ ジオメトリの例：マトリックス変換の表示オブジェクトへの適用 ）

• FilterWorkbench（ 表示オブジェクトのフィルター処理の例：Filter Workbench ）

• GlobalStockTicker（ 例：相場表示アプリケーションの国際化 ）

• IntrovertIM_HTML（ External API の例：Web ブラウザーでの ActionScript と JavaScript との通信 ）

• NewsLayout（ TextField の例：新聞形式のテキストフォーマット ）

• PlayList（ 配列の例：PlayList ）

• PodcastPlayer（ サウンドの例：Podcast Player ）

• ProjectionDragger（ 例：遠近法投影 ）

• ReorderByZ（ Matrix3D オブジェクトを使用した表示の並べ替え ）

• RSSViewer（ ActionScript 内の XML の例：インターネットからの RSS データのロード ）

• RuntimeAssetsExplorer（ ムービークリップの例：RuntimeAssetsExplorer ）

• SimpleClock（ 日付と時刻の例：単純なアナログ時計 ）

• SpinningMoon（ ビットマップの例：回転する月のアニメーション ）

• SpriteArranger（ 表示オブジェクトの例：SpriteArranger ）

• TelnetSocket（ TCP ソケットの例：Telnet クライアントの構築 ）

• VideoJukebox（ ビデオの例：ビデオジュークボックス ）

• WikiEditor（ 正規表現の例：Wiki パーサー ）

• WordSearch（ マウス入力の例：WordSearch ）

また、Flash デベロッパーセンターや Flex デベロッパーセンターの様々なクイックスタート記事でも実例を入手できます。

Flash Professional でのコードスニペット例の実行

Flash Professional でコードスニペット例を実行するには：

1. ファイル／新規を選択します。

2. 新規ドキュメントダイアログボックスで 「Flash ドキュメント」を選択し、「OK」をクリックします。

   新しい Flash ウィンドウが表示されます。

3. タイムラインパネルで、レイヤー 1 の最初のフレームをクリックします。

4. アクションパネルにコードスニペット例を入力するか貼り付けます。

5. ファイル／保存を選択します。ファイル名を指定し、「OK」をクリックします。

6. 例をテストするには、制御／ムービープレビューを選択します。

Flash Professional でのクラスの使用例の実行

Flash Professional でクラスの使用例を実行するには：

Flash Professional での実例の実行

通常、実例は ZIP 形式のアーカイブファイルで提供されます。Flash Professional で実例を実行するには：

1. アーカイブファイルを任意のフォルダーに解凍します。

2. Flash Professional で、ファイル／開くを選択します。

3. アーカイブファイルを解凍したフォルダーを参照します。そのフォルダー内にある FLA ファイルを選択して、「開く」をクリックします。

4. 例をテストするには、制御／ムービープレビューを選択します。

Flash Builder でのコードスニペット例の実行

Flash Builder でコードスニペット例を実行するには：

Flash Builder でのクラスの使用例の実行

Flash Builder でクラスの使用例を実行するには：

1. ファイル／新規／ActionScript プロジェクトを選択します。

2. 「プロジェクト名」フィールドに主要なクラスの名前（ContextMenuExample など）を入力します。他のフィールドではデフォルト値を使用（または固有の環境に合わせて変更）します。「終了」をクリックしてプロジェクトとメイン ActionScript ファイルを作成します。

3. ActionScript ファイルにコードが生成されている場合はすべて削除します。コード例（package および import ステートメントを含む）を ActionScript ファイルに貼り付けてファイルを保存します。

   注意： flashx.textLayout.container.ContainerController クラスの使用例 など、クラスの使用例にはパッケージの宣言に複数の階層がある（ package flashx.textLayout.container.examples { ）ものもあります。これらの例では、パッケージの宣言に一致するサブフォルダー（flashx/textLayout/container/examples）にファイルを保存するか、ActionScript の最初が package { のみになるようにパッケージ名を削除すると、このファイルをどの場所からでもテストできるようになります。

4. 例を実行するには、「実行」を選択して、メイン ActionScript クラス名の実行メニューオプション（例：実行／ContextMenuExample を実行）を選択します。

Flash Builder での実例の実行

通常、実例は ZIP 形式のアーカイブファイルで提供されます。Flash Builder で実例を実行するには：

ステージサイズ

モバイルデバイス上で例を実行するときに使用するステージのサイズは、モバイル以外のデバイスで使用する場合よりも、かなり小さくなります。多くの例では、ステージのサイズが指定されていません。SWF の作成時に、ご使用のデバイスに合わせてステージのサイズを指定してください。例えば、176 x 208 ピクセルと指定します。

『ActionScript 3.0 開発ガイド』の実例は、様々な ActionScript 3.0 の概念とクラスについて説明することを目的としています。そこで使用されるユーザーインターフェイスは、デスクトップまたはラップトップコンピューター上で正しく表示および動作できるように設計されています。例はモバイルデバイス上でも動作しますが、ステージのサイズやユーザーインターフェイスの設計は、小さな画面には適していません。アドビ システムズ社では、コンピューター上で実例を実行して ActionScript について学習し、付随するコードスニペットをモバイルアプリケーションで使用することをお勧めします。

テキストフィールドによる trace ステートメントの代替

モバイルデバイス上で例を実行する場合は、例の trace ステートメントからの出力を表示できません。出力を表示するには、TextField クラスのインスタンスを作成します。次に、trace ステートメントからのテキスト出力をテキストフィールドの text プロパティに追加します。

テキストフィールドを設定しトレースの代替機能として使用するには、次の関数を使用します。

function createTracingTextField(x:Number, y:Number, 
                                width:Number, height:Number):TextField { 
           
    var tracingTF:TextField = new TextField(); 
    tracingTF.x = x; 
    tracingTF.y = y; 
    tracingTF.width = width; 
    tracingTF.height = height; 
     
    // A border lets you more easily see the area the text field covers. 
    tracingTF.border = true; 
    // Left justifying means that the right side of the text field is automatically 
    // resized if a line of text is wider than the width of the text field. 
    // The bottom is also automatically resized if the number of lines of text 
    // exceed the length of the text field. 
    tracingTF.autoSize = TextFieldAutoSize.LEFT; 
     
    // Use a text size that works well on the device. 
    var myFormat:TextFormat = new TextFormat(); 
    myFormat.size = 18; 
    tracingTF.defaultTextFormat = myFormat; 
     
    addChild(tracingTF); 
    return tracingTF; 
}

例えば、この関数をドキュメントクラスに private 関数として追加します。次に、ドキュメントクラスの他のメソッドで次のようなコードを使用してデータをトレースします。

var traceField:TextField = createTracingTextField(10, 10, 150, 150); 
// Use the newline character "\n" to force the text to the next line. 
traceField.appendText("data to trace\n"); 
traceField.appendText("more data to trace\n"); 
// Use the following line to clear the text field. 
traceField.appendText("");

appendText() メソッドがパラメーターとして受け付ける値は 1 つだけです。その値はストリング（String インスタンスまたはストリングリテラル）にする必要があります。ストリング以外の変数の値を出力するには、まず値を String に変換する必要があります。このための最も簡単な方法は、オブジェクトの toString() メソッドを呼び出すことです。

var albumYear:int = 1999; 
traceField.appendText("albumYear = "); 
traceField.appendText(albumYear.toString());

テキストサイズ

多くの例では、概念を説明するのにテキストフィールドが使用されています。テキストフィールド内のテキストサイズを調整すると、モバイルデバイス上の表示が読みやすくなる場合があります。例えば、例で myTextField という名前のテキストフィールドインスタンスが使用されている場合は、そのテキストのサイズを次のコードで変更します。

// Use a text size that works well on the device. 
var myFormat:TextFormat = new TextFormat(); 
myFormat.size = 18; 
myTextField.defaultTextFormat = myFormat

ユーザー入力のキャプチャ

モバイル用オペレーティングシステムとブラウザーでは、SWF コンテンツでは受信されないいくつかのユーザー入力イベントをキャプチャします。イベント固有の動作はオペレーティングシステムとブラウザーによって異なりますが、モバイルデバイス上で例を実行したときに予期しない動作を示す可能性があります。詳しくは、 KeyboardEvent の優先度 を参照してください。

また、多くの例のユーザーインターフェイスは、デスクトップまたはラップトップコンピューターを対象として設計されています。例えば、『ActionScript 3.0 開発ガイド』で使用されている実例の多くは、デスクトップでの表示に適しています。したがって、モバイルデバイスの画面では、ステージ全体を表示できない場合があります。ブラウザーのコンテンツ全体をパンできるかどうかは、使用しているブラウザーによって異なります。さらに、例はスクロールまたはパンのイベントをキャッチして処理するように設計されていません。したがって、例で使用されているユーザーインターフェイスの一部は、小さな画面で実行するのには適していません。アドビ システムズ社では、コンピューター上で例を実行して ActionScript について学習し、付随するコードスニペットをモバイルアプリケーションで使用することをお勧めします。

詳しくは、 表示オブジェクトのパンとスクロール を参照してください。

フォーカスの処理

一部の例では、フィールドにフォーカスを設定する必要があります。フィールドにフォーカスを設定することにより、テキスト入力やボタン選択などを実行できます。フィールドにフォーカスを設定するには、指またはペンなどのモバイルデバイスのポインターデバイスを使用します。または、モバイルデバイスのナビゲーションキーを使用してフィールドにフォーカスを設定します。フォーカスの設定されているボタンを選択するには、モバイルデバイスの選択キーを使用します。コンピューターで Enter キーを使用するのと同じ要領です。一部のデバイスでは、ボタンを 2 回タップすると選択できます。

フォーカスについて詳しくは、 フォーカスの管理 を参照してください。

マウスイベントの処理

多くの例ではマウスイベントを監視します。コンピューターでは、例えば、ユーザーが表示オブジェクト上にマウスを移動したり、表示オブジェクト上でマウスボタンをクリックしたりしたときに、これらのマウスイベントが発生します。モバイルデバイスでは、指またはペンなどのポインターデバイスを使用したときに発生するイベントはタッチイベントと呼ばれます。Flash Player 10.1 では、タッチイベントをマウスイベントにマップします。このマッピングによって、Flash Player 10.1 より前に開発された SWF コンテンツでも引き続き動作することが保証されます。したがって、ポインターデバイスを使用して表示オブジェクトを選択したり、ドラッグしたりする場合でも、例は動作します。

パフォーマンス

モバイルデバイスの処理能力はデスクトップデバイスに劣ります。CPU に高い負荷のかかる例をモバイルデバイスで実行すると、パフォーマンスが低下します。例えば、 描画 API の例：Algorithmic Visual Generator の例では、フレームに入るたびに膨大な量の計算と描画が実行されます。この例をコンピューターで実行すると、様々な描画 API が例示されます。しかし、一部のモバイルデバイスはパフォーマンスに制限があるので、この例を実行するのに適していません。

モバイルデバイスでのパフォーマンスについて詳しくは、「 Flash Platform のパフォーマンスの最適化 」を参照してください。

ベストプラクティス

例では、モバイルデバイス向けアプリケーションを開発する上でのベストプラクティスを考慮していません。モバイルデバイスにおけるメモリおよび処理能力の制限は、特別な考慮を必要とします。同様に、小さい画面用のユーザーインターフェイスもデスクトップ表示とは異なる考慮が必要です。モバイルデバイス用のアプリケーション開発について詳しくは、 「 Flash Platform のパフォーマンスの最適化 」を参照してください。