onUpdate

Disponibilidad

Flash Player 6.

Sintaxis

function onUpdate() {
   ...sentencias...;
}

Parámetros

Ninguno.

Valor devuelto

Ninguno.

Descripción

Controlador de eventos; se define onUpdate para una película de vista previa dinámica utilizada con un componente. Cuando una instancia de un componente del escenario tiene una película de vista previa dinámica, la herramienta de edición invoca la función onUpdate de dicha película siempre que los parámetros de componente de la instancia de componente cambian. La herramienta de edición invoca la función onUpdate sin parámetros, y el valor que se devuelve se omite. La función onUpdate debe declararse en la línea de tiempo principal de la película de vista previa dinámica.

Definir una función onUpdate en una película de vista previa dinámica es algo opcional.

Para más información sobre las películas de vista previa dinámica, consulte Utilización de componentes.

Ejemplo

La función onUpdate otorga a la película de vista previa dinámica una oportunidad para actualizar su aspecto visual de modo que coincida con los nuevos valores de los parámetros del componente. Cuando el usuario cambia el valor de un parámetro en el Inspector de propiedades o el panel Parámetros de componentes del componente, se invoca onUpdate. La función onUpdate llevará a cabo una acción para actualizarse a sí misma. Por ejemplo, si el componente incluye un parámetro color, la función onUpdate puede alterar el color de un clip de película de la película en la vista previa dinámica para reflejar el nuevo valor del parámetro. Además, puede almacenar el nuevo color en una variable interna.

A continuación, se muestra un ejemplo del uso de la función onUpdate para pasar valores de parámetro a través de un clip de película vacío de la película de vista previa dinámica. Suponga que tiene un componente de botón etiquetado con una variable labelColor, que especifica el color de la etiqueta de texto. El código siguiente se encuentra en el primer fotograma de la línea de tiempo principal de la película del componente:

//Definir la variable del parámetro textColor para especificar el color del texto de la etiqueta del botón.
buttonLabel.textColor = labelColor;

En la película de vista previa dinámica, coloque un clip de película vacío denominado "xch". A continuación, coloque el código siguiente en el primer fotograma de la película de vista previa dinámica. Añada "xch" a la ruta de la variable labelColor para pasar la variable a través del clip de película my_mc:

//Escribir una función onUpdate, añadiendo "my_mc." a los nombres de variable de parámetro:
function onUpdate (){
  buttonLabel.textColor = my_mc.labelColor;
}