Flash CS3 文件

ActionScript 3.0 程式設計 > ActionScript 快速入門 > 執行後續的範例

執行後續的範例

在開發並執行 "Hello World" ActionScript 3.0 應用程式之後，您應對如何執行本手冊的其它程式碼範例有了基本的認識。

副主題

測試章節內的範例程式碼列表

當您研讀本手冊時，可能會想要嘗試執行用來說明各種主題的範例程式碼列表。這項測試可能需要顯示程式中特定位置上的變數值，也可能需要檢視螢幕上的內容或者與之互動。測試視覺內容或互動時，在程式碼列表前頭或內部會有必要元素的相關說明，您只需依照說明建立含有這些元素的文件，就能測試該程式碼。如果您想要檢視程式中指定位置的變數值，有幾個方式可以達成這個目的。其中一個方式就是使用除錯程式，例如 Flex Builder 和 Flash 內建的除錯程式。不過，如果只要簡單測試即可，最容易的辦法可能就只是將變數值列印至您看得到結果的地方。

下列步驟將協助您建立可用於測試程式碼列表和檢視變數值的 Flash 文件：

建立 Flash 文件以便測試章節內列出的範例：

1. 建立新的 Flash 文件，並儲存在硬碟上。
2. 若要在「舞台」上的文字欄位中顯示測試值，請啟動「文字」工具，並在「舞台」上建立新的動態文字欄位。字行類型設為「多行」且開啟邊框的高闊文字欄位將最為實用。在「屬性」檢測器中，請指定文字欄位的實體名稱 (例如 "outputText")。若要在文字欄位中寫入值，您可以將呼叫 appendText() 方法的程式碼加入範例程式碼 (如下所述)。
3. 或者，也可以將 trace() 函數呼叫加入程式碼列表 (如下所述)，以便檢視範例的結果。
4. 若要測試指定的範例，請將程式碼列表複製到「動作」面板中；如有必要，請增加 trace() 函數呼叫，或使用其 appendText() 方法在文字欄位中加入一個值。
5. 從主選單中選擇「控制＞測試影片」，建立 SWF 檔並檢視結果。

因為這個方法是為了要檢視變數的值，您可以使用兩種方式，很輕鬆地在嘗試執行範例時檢視變數值：將值寫入「舞台」上的文字欄位實體，或使用 trace() 函數，將值列印至「輸出」面板。

• trace() 函數：ActionScript trace() 函數會把傳遞給它的任何參數值 (不論是變數或常值運算式) 寫入「輸出」面板。本手冊中的許多範例列表已經包含 trace() 函數呼叫，因此使用這些列表項目時，您只需將程式碼複製到文件中，再測試專案。如果您想要使用 trace() 來測試程式碼列表中某個變數的值，但程式碼列表並未包含 trace()，則只需將此函數呼叫加入程式碼列表中，並傳遞該變數當做參數即可。例如，如果您在章節中遇到像這樣的程式碼列表，

  var albumName:String = "Three for the money";
  

  就可以將該程式碼複製到「動作」面板中，然後像下列程式碼一樣，加入 trace() 函數呼叫來測試程式碼列表的結果：

  var albumName:String = "Three for the money";
  trace("albumName =", albumName);
  

  當您執行程式時，便會列印出這一行：

  albumName = Three for the money
  

  每個 trace() 函數呼叫可以接受多個參數，它們會全部串連在一起，以單獨一行印出。在每個 trace() 函數呼叫的結尾加上斷行符號，如此，不同的 trace() 呼叫便會列印在不同的行上。

• 「舞台」上的文字欄位：如果您不想使用 trace() 函數，則可以使用「文字」工具在「舞台」上增加動態文字欄位，然後將值寫出至文字欄位，以便檢視程式碼列表的結果。您可以使用 TextField 類別的 appendText() 方法，將字串值加在文字欄位內容的結尾處。若要使用 ActionScript 來存取文字欄位，您必須在「屬性」檢測器中指定該欄位的實體名稱。例如，如果文字欄位的實體名稱為 outputText，則可以使用下列程式碼來檢查 albumName 變數的值：

  var albumName:String = "Three for the money";
  outputText.appendText("albumName = ");
  outputText.appendText(albumName);
  

  這個程式碼會將下列文字寫入名為 outputText 的文字欄位：

  albumName = Three for the money
  

  如範例所示，appendText() 方法會在上述內容的同一行增加文字，因此使用多個 appendText() 呼叫，就能將多個值加入同一行的文字。若要強制文字移至下一行，您可以附加換行字元 ("\n")：

  outputText.appendText("\n"); // adds a line break to the text field
  

  不同於 trace() 函數的是，appendText() 方法只接受一個值做為參數。這個值必須是字串 (字串實體或字串常值)。若要列印非字串變數的值，您必須先轉換該值為字串。最簡單的轉換方式就是呼叫物件的 toString() 方法：

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

使用本章最後的範例

本手冊大部分章節都和本章一樣，最後都會提供一個重要範例，將本章所討論的多項概念結合起來。然而和本章 Hello World 範例不同的是，其它範例並不以步驟式的教學格式呈現。文中會說明和討論每個範例中的相關 ActionScript 3.0 程式碼，但不會提供如何在特定開發環境中執行範例的指示。不過，本手冊所提供的範例檔案會包含完整檔案，讓您能夠在所選擇的開發環境中輕鬆編譯和執行範例。

Flash CS3

有新的意見加入至這個頁面時，傳送電子郵件給我 | 意見報告

目前頁面: http://livedocs.adobe.com/flash/9.0_tw/main/00000036.html

加入意見