Documentación de Flash CS3

Aprendizaje de ActionScript 2.0 en Adobe Flash > Clases > Ejemplo: Escritura de clases personalizadas

Ejemplo: Escritura de clases personalizadas

Ahora que ya conoce los principios básicos de un archivo de clase y su contenido, es el momento de que conozca algunas de las directrices generales para la creación de un archivo de clase. El primer ejemplo de este capítulo muestra cómo escribir clases y empaquetarlas. El segundo ejemplo muestra cómo utilizar dichos archivos de clase con un archivo FLA.

Como se ha descrito en Escritura de archivos de clases personalizadas, una clase consta de dos partes principales: la declaración y el cuerpo. La declaración de la clase consta como mínimo de la sentencia class seguida de un identificador para el nombre de clase y, a continuación, llaves de apertura y cierre ({}). Todo lo que se encuentra dentro de las llaves es el cuerpo de la clase, como se muestra en el siguiente ejemplo:

class className {
  // Cuerpo de la clase
}

Recuerde: sólo puede definir clases en archivos ActionScript. Por ejemplo, no puede definir una clase en un script de fotograma en un archivo FLA. Por consiguiente, debe crear un nuevo archivo para este ejemplo.

En su forma más básica, una declaración de clase consta de la palabra clave class, seguida del nombre de la clase (en este caso, Person) y después llaves de apertura y cierre ({}). Todo lo que está entre llaves se denomina el cuerpo de la clase y es donde se definen las propiedades y los métodos de la clase.

Al final de este ejemplo, el orden básico de los archivos de clase es el siguiente:

• Comentarios de documentación
• Declaración de clase
• Función constructora
• Cuerpo de la clase

En este capítulo no se escriben subclases. Para más información sobre herencia y subclases, consulte el Herencia

Este ejemplo contiene los siguientes temas:

• Directrices generales para la creación de una clase
• Creación y empaquetado de archivos de clases
• Escritura de la función constructora
• Adición de métodos y propiedades
• Control del acceso de miembros en las clases
• Documentación de las clases

Para ver ejemplos que ilustran la creación de un menú dinámico con datos XML y un archivo de clase personalizado, visite la página de ejemplos de Flash en www.adobe.com/go/learn_fl_samples_es. El ejemplo llama al constructor XmlMenu() de ActionScript y le pasa dos parámetros: la ruta al archivo de menú XML y una referencia a la línea de tiempo actual. Descargue y descomprima el archivo zip Samples y vaya a la carpeta ActionScript2.0/XML_Menu para acceder a los ejemplos.

• XmlMenu.as
• xmlmenu.fla

Directrices generales para la creación de una clase

Los siguientes puntos son directrices que deberá seguir al escribir archivos de clases personalizadas. Le ayudarán a escribir clases correctas y bien formadas. Podrá practicar estas directrices en los ejemplos siguientes.

• En general, incluya una sola declaración por línea y no coloque la misma declaración o distintos tipos de declaración en una sola línea. Aplique formato a las declaraciones como se muestra en el siguiente ejemplo:

  private var SKU:Number; // número de identificación de SKU del producto
  private var quantity:Number; // cantidad de producto
  

• Inicialice las variables locales al declararlas, a menos que el valor inicial se determine mediante un cálculo. Para más información sobre la inicialización de variables, consulte Adición de métodos y propiedades.
• Declare las variables antes de utilizarlas por primera vez (incluidos los bucles). Por ejemplo, el siguiente código establece una declaración previa de la variable de repetidor de bucle (i) antes de utilizarla en el buclefor:

  var my_array:Array = new Array("one", "two", "three");
  var i:Number;
  for (i = 0 ; i < my_array.length; i++) {
      trace(i + " = " + my_array[i]);
  }
  

• Evite utilizar declaraciones locales que oculten declaraciones de nivel superior. Por ejemplo, no declare una variable dos veces, como se muestra en el siguiente ejemplo:

  // código incorrecto
  var counter:Number = 0;
  function myMethod() {
      var counter:Number;
      for (counter = 0; counter <= 4; counter++) {
          // sentencias;
      }
  }
  

  Este código declara la misma variable dentro de un bloque interno.

• No asigne muchas variables a un solo valor de una sentencia, porque es difícil de leer, como puede observarse en las siguientes muestras de código ActionScript:

  // forma incorrecta
  xPos = yPos = 15;
  

  o

  // forma incorrecta
  class User {
      private var m_username:String, m_password:String;
  }
  

• Cree variables de instancia públicas o clases o variables de miembro estáticas públicas sólo cuando sea estrictamente necesario. Asegúrese de que estas variables sean públicas de manera explícita antes de crearlas de esta forma.
• Defina como privadas la mayoría de las variables de miembros a menos que haya un buen motivo para hacerlas públicas. Desde el punto de vista del diseño, es mucho mejor definir variables de miembros privadas y permitir el acceso a las variables únicamente a través de un grupo reducido de funciones getter y setter.

Asignación de nombre a los archivos de clases

Los nombres de clase deben ser identificadores; es decir, que el primer carácter debe ser una letra, un carácter de subrayado (_) o un símbolo de dólar ($), y los caracteres siguientes deben ser una letra, un número, un carácter de subrayado o un símbolo de dólar. Se recomienda utilizar solamente letras en los nombres de clases.

El nombre de la clase debe coincidir exactamente con el nombre del archivo ActionScript que la contiene, incluidas mayúsculas y minúsculas. En el siguiente ejemplo, si crea una clase llamada Rock, el archivo ActionScript que contiene la definición de clase debe llamarse Rock.as:

// En el archivo Rock.as
class Rock {
  // Cuerpo de la clase Rock
}

En la siguiente sección asignará nombre y creará una definición de clase. Consulte la sección Creación y empaquetado de archivos de clases para crear, asignar nombre y empaquetar archivos de clase. Para más información sobre la asignación de nombre a archivos de clases, consulte Asignación de nombre a clases y objetos.

Flash CS3

Enviarme un mensaje de correo electrónico cuando se añadan comentarios a esta página | Informe de comentarios

Página actual: http://livedocs.adobe.com/flash/9.0_es/main/00000789.html

Añadir comentario