Clase MovieClip

Disponibilidad

Flash Player 3.

Descripción

Los métodos de la clase MovieClip proporcionan la misma funcionalidad que las acciones que utilizan clips de película. También existen métodos adicionales que no tienen acciones equivalentes en la caja de herramientas Acciones del panel Acciones.

No es necesario utilizar un método constructor para poder llamar a los métodos de la clase MovieClip; en lugar de eso, haga referencia a las instancias de clip de película por nombre, mediante la sintaxis siguiente:

my_mc.play();
my_mc.gotoAndPlay(3);

Resumen de métodos para la clase MovieClip

Método	Descripción
`MovieClip.attachAudio()`	Captura y reproduce audio local desde el hardware de micrófono.
`MovieClip.attachMovie()`	Asocia un archivo SWF de la biblioteca.
`MovieClip.createEmptyMovieClip()`	Crea un clip de película vacío.
`MovieClip.createTextField()`	Crea un campo de texto vacío.
`MovieClip.duplicateMovieClip()`	Duplica el clip de película especificado.
`MovieClip.getBounds()`	Devuelve el máximo y el mínimo de las coordenadas x e y de un archivo SWF en un espacio de coordenadas especificado.
`MovieClip.getBytesLoaded()`	Devuelve el número de bytes cargados para el clip de película especificado.
`MovieClip.getBytesTotal()`	Devuelve el tamaño del clip de película en bytes.
`MovieClip.getDepth()`	Devuelve la profundidad de un clip de película.
`MovieClip.getInstanceAtDepth()`	Especifica si un clip de película ya ha ocupado una profundidad determinada.
`MovieClip.getNextHighestDepth()`	Especifica un valor de profundidad que se puede pasar a otros métodos para asegurarse de que Flash muestra el clip de película delante de todos los demás objetos del clip de película actual.
`MovieClip.getSWFVersion()`	Devuelve un número entero que indica la versión de Flash Player para la que se ha publicado el clip de película.
`MovieClip.getTextSnapshot()`	Devuelve un objeto TextSnapshot que contiene el texto en los campos de texto estático del clip de película especificado.
`MovieClip.getURL()`	Recupera un documento de una URL.
`MovieClip.globalToLocal()`	Convierte el objeto point de las coordenadas del escenario a las coordenadas locales del clip de película especificado.
`MovieClip.gotoAndPlay()`	Envía la cabeza lectora a un fotograma específico en el clip de película y reproduce el archivo SWF.
`MovieClip.gotoAndStop()`	Envía la cabeza lectora a un fotograma específico en el clip de película y detiene el archivo SWF.
`MovieClip.hitTest()`	Devuelve `true` si el recuadro de delimitación del clip de película especificado se cruza con el recuadro de delimitación del clip de película de destino.
`MovieClip.loadMovie()`	Carga el archivo SWF especificado en el clip de película.
`MovieClip.loadVariables()`	Carga variables de una URL u otra ubicación en el clip de película.
`MovieClip.localToGlobal()`	Convierte un objeto point de las coordenadas locales del clip de película a las coordenadas del escenario global.
`MovieClip.nextFrame()`	Envía la cabeza lectora al fotograma siguiente del clip de película.
`MovieClip.play()`	Reproduce el clip de película especificado.
`MovieClip.prevFrame()`	Envía la cabeza lectora al fotograma anterior del clip de película.
`MovieClip.removeMovieClip()`	Elimina el clip de película de la línea de tiempo si se ha creado con `duplicateMovieClip()`, `MovieClip.duplicateMovieClip()` o `MovieClip.attachMovie()`.
`MovieClip.setMask()`	Especifica un clip de película como una máscara para otro clip de película.
`MovieClip.startDrag()`	Especifica un clip de película como arrastrable y comienza a arrastrarlo.
`MovieClip.stop()`	Detiene la reproducción del archivo SWF.
`MovieClip.stopDrag()`	Detiene el arrastrado de cualquier clip de película que se esté arrastrando.
`MovieClip.swapDepths()`	Intercambia el nivel de profundidad de dos archivos SWF.
`MovieClip.unloadMovie()`	Elimina un archivo SWF que se había cargado con `loadMovie()`.

Resumen de métodos de dibujo para la clase MovieClip

Método	Descripción
`MovieClip.beginFill()`	Empieza a dibujar un relleno en el escenario.
`MovieClip.beginGradientFill()`	Empieza a dibujar un relleno en degradado en el escenario.
`MovieClip.clear()`	Elimina todos los comandos de dibujo asociados con una instancia de clip de película.
`MovieClip.curveTo()`	Dibuja una curva con el último estilo de línea.
`MovieClip.endFill()`	Finaliza el relleno especificado mediante `beginFill()` o `beginGradientFill()`.
`MovieClip.lineStyle()`	Define el trazo de las líneas creadas con los métodos `lineTo()` y `curveTo()`.
`MovieClip.lineTo()`	Dibuja una línea con el estilo de línea actual.
`MovieClip.moveTo()`	Mueve la posición actual del dibujo a las coordenadas especificadas.

Resumen de propiedades para la clase MovieClip

Propiedad	Descripción
`MovieClip._alpha`	Valor de transparencia de una instancia de clip de película.
`MovieClip._currentframe`	Número de fotograma en el que se encuentra la cabeza lectora.
`MovieClip._droptarget`	Ruta absoluta en notación de sintaxis con barras de la instancia de clip de película en la que se soltó un clip de película que se puede arrastrar.
`MovieClip.enabled`	Indica si el clip de película de botón está activado.
`MovieClip.focusEnabled`	Permite que un clip de película puede seleccionarse.
`MovieClip._focusrect`	Indica si un clip de película seleccionado tiene un rectángulo amarillo a su alrededor.
`MovieClip._framesloaded`	Número de fotogramas que se han cargado de un archivo SWF de flujo.
`MovieClip._height`	Altura de una instancia de clip de película en píxeles.
`MovieClip.hitArea`	Designa otro clip de película que sirve como el área activa para un clip de película de botón.
`MovieClip._highquality`	Establece la calidad de representación de un archivo SWF.
`MovieClip.menu`	Asocia un objeto ContextMenu con un clip de película.
`MovieClip._name`	Nombre de instancia de una instancia de clip de película.
`MovieClip._parent`	Referencia al clip de película que incluye el clip de película.
`MovieClip._rotation`	Grado de rotación de una instancia de clip de película.
`MovieClip._soundbuftime`	Número de segundos que transcurrirán antes de que empiece el sonido.
`MovieClip.tabChildren`	Indica si los elementos secundarios de un clip de película se incluyen en el orden de tabulación automático.
`MovieClip.tabEnabled`	Indica si un clip de película se incluye en el orden de tabulación.
`MovieClip.tabIndex`	Indica el orden de tabulación de un objeto.
`MovieClip._target`	Ruta de destino de una instancia de clip de película.
`MovieClip._totalframes`	Número total de fotogramas de una instancia de clip de película.
`MovieClip.trackAsMenu`	Indica si otros botones pueden recibir eventos al soltar el ratón.
`MovieClip._url`	La URL del archivo SWF de la que se ha descargado un clip de película.
`MovieClip.useHandCursor`	Determina si la mano aparece cuando un usuario se sitúa sobre un clip de película de botón.
`MovieClip._visible`	Valor booleano que determina si una instancia de clip de película está oculta o visible.
`MovieClip._width`	Anchura de una instancia de clip de película en píxeles.
`MovieClip._x`	Coordenada x de una instancia de clip de película.
`MovieClip._xmouse`	Coordenada x del puntero del ratón en una instancia de clip de película.
`MovieClip._xscale`	Valor que especifica el porcentaje de una escala horizontal de un clip de película.
`MovieClip._y`	Coordenada y de una instancia de clip de película.
`MovieClip._ymouse`	Coordenada y del puntero del ratón en una instancia de clip de película.
`MovieClip._yscale`	Valor que especifica el porcentaje de escala vertical de un clip de película.

Resumen de controladores de eventos para la clase MovieClip

Controlador de eventos	Descripción
`MovieClip.onData`	Se invoca cuando todos los datos se han cargado en un clip de película.
`MovieClip.onDragOut`	Se invoca mientras el puntero se encuentra fuera del botón; el botón del ratón se presiona dentro y, a continuación, se desplaza fuera del área del botón.
`MovieClip.onDragOver`	Se invoca mientras el puntero se encuentra sobre el botón; se ha presionado el botón del ratón, se ha desplazado fuera del botón y, a continuación, se ha vuelto a desplazar sobre el botón.
`MovieClip.onEnterFrame`	Se invoca de forma continua a la velocidad de los fotogramas del archivo SWF. Las acciones asociadas con el evento de clip enterFrame se procesan antes que cualquiera de las acciones de fotogramas asociadas a los fotogramas afectados.
`MovieClip.onKeyDown`	Se invoca cuando se presiona una tecla. Utilice los métodos `Key.getCode()` y `Key.getAscii()` para recuperar información sobre la última tecla que se ha presionado.
`MovieClip.onKeyUp`	Se invoca cuando se suelta una tecla.
`MovieClip.onKillFocus`	Se invoca cuando se deja de seleccionar un botón.
`MovieClip.onLoad`	Se invoca cuando se crea una instancia del clip de película y aparece en la línea de tiempo.
`MovieClip.onMouseDown`	Se invoca cuando se presiona el botón izquierdo del ratón.
`MovieClip.onMouseMove`	Se invoca cada vez que se mueve el ratón.
`MovieClip.onMouseUp`	Se invoca cuando se suelta el botón izquierdo del ratón.
`MovieClip.onPress`	Se invoca cuando se presiona el ratón mientras el puntero está sobre un botón.
`MovieClip.onRelease`	Se invoca cuando se suelta el ratón mientras el puntero está sobre un botón.
`MovieClip.onReleaseOutside`	Se invoca cuando se suelta el ratón mientras el puntero está fuera del botón después de presionar el botón mientras el puntero está dentro del botón.
`MovieClip.onRollOut`	Se invoca cuando el puntero se desplaza fuera del área de un botón.
`MovieClip.onRollOver`	Se invoca cuando el puntero del ratón se desplaza sobre un botón.
`MovieClip.onSetFocus`	Se invoca cuando un botón se selecciona en el momento de la entrada y se suelta una tecla.
`MovieClip.onUnload`	Se invoca en el primer fotograma después de eliminar el clip de película de la línea de tiempo. Las acciones asociadas con el evento de clip de película Unload se procesan antes de que se asocien acciones al fotograma afectado.