Recursos de Flash CS4

Objeto flash (fl)

Disponibilidad

Flash MX 2004

Descripción

El objeto flash representa la aplicación Flash. Puede utilizar flash o fl para hacer referencia a este objeto. Esta documentación utiliza fl en los ejemplos de código.

Resumen de métodos

Pueden emplearse los métodos siguientes con el objeto flash:

Método	Descripción
`fl.addEventListener()`	Registra una función que se llamará cuando tenga lugar un evento concreto.
`fl.browseForFileURL()`	Abre el cuadro de diálogo del sistema Abrir archivo o Guardar archivo y permite que el usuario especifique un archivo para abrir o guardar.
`fl.browseForFolderURL()`	Muestra el cuadro de diálogo Buscar carpeta y permite que el usuario seleccione una carpeta.
`fl.clipCopyString()`	Copia la cadena especificada en el Portapapeles.
`fl.closeAll()`	Cierra todos los documentos abiertos y aparece el cuadro de diálogo Guardar como para todos los documentos que no se guardaron previamente.
`fl.closeAllPlayerDocuments()`	Cierra todos los archivos SWF que estaban abiertos con Control > Probar película.
`fl.closeDocument()`	Cierra el documento especificado.
`fl.createDocument()`	Abre un documento nuevo y lo selecciona.
`fl.downloadLatestVersion()`	Descarga del servidor Version Cue la última versión de un archivo que no esté actualmente abierto.
`fl.fileExists()`	Comprueba si el archivo ya existe en el disco.
`fl.findDocumentDOM()`	Permite buscar un archivo específico utilizando su identificador único.
`fl.findDocumentIndex()`	Devuelve un conjunto de enteros que representan la posición de un documento en el conjunto `fl.documents`.
`fl.findObjectInDocByName()`	Expone los elementos con nombres de instancias que coinciden con texto especificado.
`fl.findObjectInDocByType()`	Busca en un documento elementos de un tipo especificado.
`fl.getAppMemoryInfo()`	Devuelve un entero que representa el número de bytes que se están utilizando en un área especificada de memoria Flash.exe.
`fl.getDocumentDOM()`	Recupera el DOM (Objeto Document) del documento activo actualmente.
`fl.isFontInstalled()`	Determina si está instalada una fuente especificada.
`fl.mapPlayerURL()`	Asigna una URL Unicode de escape a una URL UTF-8 o MBCS.
`fl.openDocument()`	Abre un documento de Flash (archivo FLA) para editarlo en una nueva ventana de documento de Flash y lo selecciona.
`fl.openScript()`	Abre un archivo de script (JSFL, AS, ASC) o de otro tipo (XML, TXT) en el editor de texto de Flash.
`fl.quit()`	Sale de Flash y pregunta al usuario si desea guardar los documentos modificados.
`fl.reloadTools()`	Recrea el panel Herramientas a partir del archivo toolconfig.xml. Sólo se utiliza para crear herramientas ampliables.
`fl.removeEventListener()`	Anula el registro de una función que se registró con `fl.addEventListener()`.
`fl.resetAS3PackagePaths()`	Restablece la configuración de ruta de clases global en el cuadro de diálogo Configuración de ActionScript 3.0 con el valor predeterminado.
`fl.resetPackagePaths()`	Restablece la configuración de ruta de clases global en el cuadro de diálogo Configuración de ActionScript 2.0 con el valor predeterminado.
`fl.revertDocumentToLastVersion()`	Devuelve el documento especificado a la versión del servidor Version Cue.
`fl.runScript()`	Ejecuta un archivo JavaScript.
`fl.saveAll()`	Guarda todos los documentos abiertos y aparece el cuadro de diálogo Guardar como para todos los documentos que no se guardaron previamente.
`fl.saveAVersionOfDocument()`	Guarda una versión del documento especificado en el servidor Version Cue.
`fl.saveDocument()`	Guarda el documento especificado como documento FLA.
`fl.saveDocumentAs()`	Muestra el cuadro de diálogo Guardar como para el documento especificado.
`fl.selectElement()`	Activa la selección o edición de un elemento.
`fl.selectTool()`	Selecciona la herramienta especificada en el panel Herramientas.
`fl.setActiveWindow()`	Establece el documento especificado como ventana activa.
`fl.showIdleMessage()`	Permite desactivar la advertencia sobre un script con una ejecución demasiado larga.
`fl.synchronizeDocumentWithHeadVersion()`	Sincroniza el documento especificado con la versión más reciente en el servidor Version Cue.
`fl.trace()`	Envía una cadena de texto al panel Salida.

Resumen de propiedades

Pueden emplearse las propiedades siguientes con el objeto flash.

Propiedad	Descripción
`fl.actionsPanel`	Sólo lectura; un Objeto actionsPanel.
`fl.as3PackagePaths`	Una cadena que corresponde a la configuración de rutas de clases global en el cuadro de diálogo Configuración de ActionScript 3.0.
`fl.compilerErrors`	Sólo lectura; un Objeto compilerErrors.
`fl.componentsPanel`	Sólo lectura; un Objeto componentsPanel que representa el panel Componentes.
`fl.configDirectory`	Sólo lectura; cadena que especifica la ruta completa de la carpeta Configuration del usuario local con la ruta específica de la plataforma.
`fl.configURI`	Sólo lectura; cadena que especifica la ruta completa de la carpeta Configuration del usuario local como URI file:///.
`fl.contactSensitiveSelection`	Un valor booleano que especifica si el modo de selección Por contacto está activado.
`fl.createNewDocList`	Sólo lectura; conjunto de cadenas que representa los distintos tipos de documentos que se pueden crear.
`fl.createNewDocListType`	Sólo lectura; conjunto de cadenas que representa las extensiones de archivo de los tipos de documentos que se pueden crear.
`fl.createNewTemplateList`	Sólo lectura; conjunto de cadenas que representa los distintos tipos de plantillas que se pueden crear.
`fl.documents`	Sólo lectura; conjunto de objetos Document (consulte Objeto Document) que representa los documentos (archivos FLA) que están abiertos para editar.
`fl.drawingLayer`	Sólo lectura; el Objeto drawingLayer que una herramienta ampliable debe utilizar cuando el usuario desee dibujar temporalmente mientras arrastra el ratón.
`fl.externalLibraryPath`	Cadena que contiene una lista de elementos de la ruta de biblioteca externa global de ActionScript 3.0, donde se especifica la ubicación de los archivos SWC utilizados como bibliotecas compartidas de tiempo de ejecución.
`fl.flexSDKPath`	Cadena que especifica la ruta de la carpeta Flex SDK, que contiene, entre otras, las carpetas bin, frameworks y lib.
`fl.libraryPath`	Cadena que contiene una lista de elementos de la ruta de biblioteca global de ActionScript 3.0, donde se especifica la ubicación de los archivos SWC o de las carpetas que contienen los archivos SWC.
`fl.Math`	Sólo lectura; el Objeto Math proporciona métodos para operaciones de matrices y puntos.
`fl.mruRecentFileList`	Sólo lectura; conjunto de los nombres completos de archivo de la lista Usados recientemente (MRU) que gestiona la herramienta de edición de Flash.
`fl.mruRecentFileListType`	Sólo lectura; conjunto de los tipos de archivo de la lista MRU que gestiona la herramienta de edición de Flash.
`fl.packagePaths`	Cadena que corresponde a la configuración de rutas de clases global en el cuadro de diálogo Configuración de ActionScript 2.0.
`fl.objectDrawingMode`	Un entero que representa el modo de dibujo del objeto que está activado.
`fl.outputPanel`	Sólo lectura; referencia al Objeto outputPanel.
`fl.presetPanel`	Sólo lectura; un Objeto presetPanel.
`fl.scriptURI`	Sólo lectura; cadena que representa la ruta del script JSFL que se ejecuta actualmente, expresada como URI file:///.
`fl.sourcePath`	Cadena que contiene una lista de elementos de la ruta de origen global de ActionScript 3.0, donde se especifica la ubicación de los archivos de clases de ActionScript.
`fl.swfPanels`	Conjunto de objetos swfPanel registrados (consulte Objeto swfPanel).
`fl.tools`	Sólo lectura; conjunto de objetos Tools.
`fl.version`	Sólo lectura; la versión de cadena larga de la herramienta de edición de Flash, incluida la plataforma.
`fl.xmlui`	Sólo lectura; un Objeto XMLUI.