Cómo usar el Document Class en Flash

Document Class en Flash

El Document Class es un nuevo concepto introducido con ActionScript 3, básicamente un Document Class extiende de Sprite o MovieClip y se usa como clase principal para el swf. Cuando el swf se carga, se llamará al constructor de dicha clase. Ese será el punto de partida para cualquier cosa que se desee hacer en la película, como crear MovieClips adicionales, dibujar gráficos, cargar archivos, etc.

Crear un nuevo fla para ActionScript 3 y lo guardan en la carpeta que deseen por ejemplo con el nombre helloWorld.fla, luego de esto crearemos una clase HelloWorld la cual usaremos como DocumentClass del archivo anterior [helloWorld.fla], para esto ir a la opción File -> New y seleccionar la opción ActionScript 3.0 Class, como estoy usando Flash CS5 aparecerá la siguiente ventana solicitando ingrese el nombre de la clase que se va a crear:

Crear Clase ActionScript 3.0 - Flash CS5

Ahí se ingresará el nombre de la clase, en este caso "HelloWorld" y presionar la tecla Enter o hacer clic en el botón OK, aparecerá un archivo con el siguiente contenido:

package  {
 
	public class HelloWorld {
 
		public function HelloWorld() {
			// constructor code
		}
 
	}
 
}

En caso esten usando una versión anterior de Flash no aparecerá nada de esto y tendrán que  seleccionar la opción ActionScript File y escribirlo todo, es muy recomendable usen la última versión ya que trae muchas mejoras en su editor de código.

Ahora modificaremos este código para hacer un clásico Hello World usando el DocumentClass de Flash, guardamos el archivo con el nombre "HelloWorld.as" en la misma carpeta donde se guardó el fla, la clase HelloWorld.as debe modificarse con este contenido:

package  {
	import flash.display.Sprite;
 
	public class HelloWorld extends Sprite {
 
		public function HelloWorld() {
			trace("Hello World!");
		}
 
	}
 
}

Ahora la explicación del código anterior:

Esto indica que lo que viene a continuación es un paquete de código/funciones definido como clase. Sólo recuerden siempre escribir esto como primera línea.

package  {

Importa la clase Sprite, para poder usarlo posteriormente en el código.

import flash.display.Sprite;

Define la clase principal de este archivo: HelloWorld. Tenga en cuenta que el nombre del archivo y el nombre de la clase son iguales.
public significa que la clase puede ser llamada desde fuera.
extends Sprite significa que nuestra clase será construída en base a la clase Sprite, esto permite que nuestra clase HelloWorld tenga todas las propiedades y métodos de la clase Sprite.

public class HelloWorld extends Sprite {

Se define la función principal de la clase. Tenga en cuenta que el nombre de la función es el mismo nombre que el de la clase, en este caso HelloWorld. Recuerde agregar los paréntesis ( ) al nombre de la función

public function HelloWorld() {
	trace("Hello World!");
}

Envía un mensaje a la ventana de salida de IDE Flash

trace("Hello World!");

Y ahora lo más importante, volvemos al archivo helloWorld.fla y en las propiedades del stage hay un campo llamado Class en el caso de Flash CS5 y Document Class en el caso de versiones anteriores, es ahí donde se debe indicar el nombre de la clase que será adjuntada con el FLA.

Hello World

Ahora para probar el fla presionar CRTL + Enter y el resultado se mostrará en la ventana de salida del IDE Flash [Output].

Hello World Output

Terminando este tutorial, nació una idea... iniciar una serie de tutoriales de ActionScript 3 desde cero, los cuales serán hechos teniendo en cuenta que la persona no tiene conocimientos de programación y serán publicados dentro de poco.

Trackback URL for this post:

http://shadowjah.com/trackback/como_usar_el_document_class_en_flash