Objeto Document

Disponibilidad

Flash MX 2004

Descripción

El objeto Document representa el escenario. Es decir, únicamente los archivos FLA se consideran documentos. Para volver al objeto Document para el documento actual, utilice fl.getDocumentDOM().

Resumen de métodos

Puede emplear los métodos siguientes con el objeto Document:

Método

Descripción

document.addDataToDocument()

Almacena datos especificados con un documento.

document.addDataToSelection()

Almacena datos especificados con el objeto u objetos seleccionados.

document.addFilter()

Aplica un filtro a los objetos seleccionados.

document.addItem()

Añade un elemento desde cualquier documento o biblioteca abierta al objeto Document especificado.

document.addNewLine()

Añade un nuevo trazado entre dos puntos.

document.addNewOval()

Añade un nuevo objeto Oval al rectángulo de delimitación especificado.

document.addNewPrimitiveOval()

Añade un nuevo óvalo simple dentro de la delimitación especificada.

document.addNewPrimitiveRectangle()

Añade un nuevo rectángulo simple dentro de la delimitación especificada.

document.addNewPublishProfile()

Añade un nuevo perfil de publicación y lo convierte en el actual.

document.addNewRectangle()

Añade un nuevo rectángulo o rectángulo redondeado, ajustándolo a los límites especificados.

document.addNewScene()

Añade una nueva escena (Objeto Timeline) después de la escena seleccionada y la convierte en la seleccionada actualmente.

document.addNewText()

Inserta un nuevo campo de texto vacío.

document.align()

Alinea la selección.

document.allowScreens()

Utilice este método antes de usar la propiedad document.screenOutline.

document.arrange()

Organiza la selección en el escenario.

document.breakApart()

Realiza una operación de separación en la selección actual.

document.canEditSymbol()

Indica si el menú Editar símbolos y las funciones están activados.

document.canRevert()

Determina si puede utilizar correctamente el método document.revert() o fl.revertDocument().

document.canSaveAVersion()

Determina si una versión del documento especificado se puede guardar en el servidor Version Cue.

document.canTestMovie()

Determina si puede utilizar correctamente el método document.testMovie().

document.canTestScene()

Determina si puede utilizar correctamente el método document.testScene().

document.changeFilterOrder()

Cambia el índice del filtro de la lista Filtro.

document.clipCopy()

Copia la selección actual desde el documento hasta el Portapapeles.

document.clipCut()

Corta la selección actual del documento y la escribe en el Portapapeles.

document.clipPaste()

Pega el contenido del Portapapeles en el documento.

document.close()

Cierra el documento especificado.

document.convertLinesToFills()

Convierte líneas en rellenos en los objetos seleccionados.

document.convertToSymbol()

Convierte el elemento o elemento de escenario seleccionados en un símbolo nuevo.

document.crop()

Utiliza el objeto de dibujo seleccionado en la parte superior para recortar todos los objetos de dibujo seleccionados por debajo.

document.deleteEnvelope()

Elimina la envoltura (recuadro de delimitación que contiene uno o varios objetos) del objeto seleccionado.

document.deletePublishProfile()

Elimina el perfil activo actualmente, si hay más de uno.

document.deleteScene()

Elimina la escena actual (Objeto Timeline) y, si la escena eliminada no era la última, establece la siguiente como el objeto Timeline actual.

document.deleteSelection()

Elimina la selección actual en el escenario.

document.disableAllFilters()

Desactiva todos los filtros en los objetos seleccionados.

document.disableFilter()

Desactiva el filtro especificado en la lista Filtros.

document.disableOtherFilters()

Desactiva todos los filtros salvo el que se encuentra en la posición especificada en la lista Filtros.

document.distribute()

Distribuye la selección.

document.distributeToLayers()

Realiza una operación de distribución en capas en la selección actual; equivale a seleccionar Distribuir en capas.

document.documentHasData()

Comprueba si el documento contiene datos persistentes con el nombre especificado.

document.duplicatePublishProfile()

Duplica el perfil activo y selecciona la versión duplicada.

document.duplicateScene()

Realiza una copia de la escena seleccionada, asignando un nombre exclusivo a la nueva escena y convirtiéndola en la actual.

document.duplicateSelection()

Duplica la selección en el escenario.

document.editScene()

Convierte la escena especificada en la escena seleccionada actualmente para editar.

document.enableAllFilters()

Activa todos los filtros de la lista Filtros para el objeto u objetos seleccionados.

document.enableFilter()

Activa el filtro especificado para el objeto u objetos seleccionados.

document.enterEditMode()

Cambia la herramienta de edición al modo de edición especificado por el parámetro.

document.exitEditMode()

Sale del modo de edición de símbolos y vuelve a seleccionar el siguiente nivel superior desde el modo de edición.

document.exportPNG()

Exporta el documento como uno o varios archivos PNG.

document.exportPublishProfile()

Exporta el perfil activo actualmente a un archivo XML.

document.exportPublishProfileString()

Devuelve una cadena que especifica el perfil indicado en formato XML.

document.exportSWF()

Exporta el documento en formato SWC de Flash.

document.getAlignToDocument()

Equivale a recuperar el valor del botón En escenario en el panel Alinear.

document.getBlendMode()

Devuelve una cadena que especifica el modo de mezcla para el objeto u objetos seleccionados.

document.getCustomFill()

Recupera el objeto de relleno de la forma seleccionada, o bien, el panel Herramientas y el inspector de propiedades, si se especifica.

document.getCustomStroke()

Recupera el objeto de trazo de la forma seleccionada, o bien, el panel Herramientas y el inspector de propiedades, si se especifica.

document.getDataFromDocument()

Recupera el valor de los datos especificados.

document.getElementProperty()

Obtiene la propiedad Element especificada para la selección actual.

document.getElementTextAttr()

Obtiene una propiedad TextAttrs específica de los objetos de texto seleccionados.

document.getFilters()

Devuelve un conjunto que contiene la lista de filtros aplicados al objeto u objetos seleccionados actualmente.

document.getMetadata()

Devuelve una cadena que contiene los metadatos XML asociados al documento.

document.getMobileSettings()

Devuelve la cadena transmitida a document.setMobileSettings().

document.getPlayerVersion()

Devuelve una cadena que representa la versión del reproductor identificado del documento especificado.

document.getSelectionRect()

Obtiene el rectángulo de delimitación de la selección actual.

document.getTextString()

Obtiene el texto seleccionado actualmente.

document.getTimeline()

Recupera el Objeto Timeline actual en el documento.

document.getTransformationPoint()

Obtiene la ubicación del punto de transformación de la selección actual.

document.group()

Convierte la selección actual en un grupo.

document.importFile()

Importa un archivo en el documento.

document.importPublishProfile()

Importa un perfil desde un archivo.

document.importPublishProfileString()

Importa una cadena XML que representa un perfil de publicación y lo establece como perfil actual.

document.importSWF()

Importa un archivo SWF en el documento.

document.intersect()

Crea un objeto de dibujo de intersección a partir de todos los objetos de dibujo seleccionados.

document.match()

Iguala el tamaño de los objetos seleccionados.

document.mouseClick()

Ejecuta un clic de ratón desde la herramienta Selección.

document.mouseDblClk()

Ejecuta un doble clic de ratón desde la herramienta Selección.

document.moveSelectedBezierPointsBy()

Si la selección contiene como mínimo un trazado con al menos un punto Bézier seleccionado, este método mueve todos los puntos Bézier seleccionados en todos los trazados seleccionados con la cantidad especificada.

document.moveSelectionBy()

Mueve los objetos seleccionados una distancia especificada.

document.optimizeCurves()

Optimiza el suavizado de la selección actual, permitiendo varias pasadas, si se especifican, para obtener un suavizado óptimo; equivale a seleccionar Modificar > Forma > Optimizar.

document.publish()

Publica el documento según la configuración de publicación activa (Archivo > Configuración de publicación); equivale a seleccionar Archivo > Publicar.

document.punch()

Utiliza el objeto de dibujo seleccionado en la parte superior para perforar todos los objetos de dibujo seleccionados por debajo.

document.removeAllFilters()

Elimina todos los filtros del objeto u objetos seleccionados.

document.removeDataFromDocument()

Elimina datos persistentes con el nombre especificado que se han asociado al documento.

document.removeDataFromSelection()

Elimina datos persistentes con el nombre especificado que se han asociado a la selección.

document.removeFilter()

Elimina el filtro especificado de la lista Filtros del objeto u objetos seleccionados.

document.renamePublishProfile()

Cambia el nombre del perfil actual.

document.renameScene()

Cambia el nombre de la escena seleccionada actualmente en el panel Escenas.

document.reorderScene()

Mueve la escena especificada delante de otra escena especificada.

document.resetOvalObject()

Establece todos los valores del inspector de propiedades con la configuración predeterminada del objeto Oval.

document.resetRectangleObject()

Establece todos los valores del inspector de propiedades con la configuración predeterminada del objeto Rectangle.

document.resetTransformation()

Restablece la matriz de transformación; equivale a seleccionar Modificar > Transformar > Eliminar transformación.

document.revert()

Devuelve el documento especificado a su versión guardada con anterioridad; equivale a seleccionar Archivo > Descartar cambios.

document.revertToLastVersion()

Devuelve el documento especificado a la versión almacenada en el servidor Version Cue y registra todos los errores en el panel Salida.

document.rotate3DSelection()

Aplica un giro 3D a la selección.

document.rotateSelection()

Gira la selección el número de grados especificado.

document.save()

Guarda el documento en su ubicación predeterminada; equivale a seleccionar Archivo > Guardar.

document.saveAndCompact()

Guarda y compacta el archivo; equivale a seleccionar Archivo > Guardar y compactar.

document.saveAVersion()

Guarda una versión del documento especificado en el servidor Version Cue.

document.scaleSelection()

Escala la selección en la cantidad especificada; equivale al uso de la herramienta Transformación libre para aplicar escala al objeto.

document.selectAll()

Selecciona todos los elementos en el escenario; equivale a presionar Control+A (Windows), Comando+A (Macintosh) o seleccionar Edición > Seleccionar todo.

document.selectNone()

Anula la selección de los elementos seleccionados.

document.setAlignToDocument()

Define las preferencias de document.align(), document.distribute(), document.match() y document.space() para que actúen en el documento; equivale a la activación del botón En escenario del panel Alinear.

document.setBlendMode()

Establece el modo de mezcla para los objetos seleccionados.

document.setCustomFill()

Establece la configuración de relleno para el panel Herramientas, el inspector de propiedades y cualquier forma seleccionada.

document.setCustomStroke()

Establece la configuración de trazo para el panel Herramientas, el inspector de propiedades y cualquier forma seleccionada.

document.setElementProperty()

Establece la propiedad Element especificada en el objeto u objetos seleccionados en el documento.

document.setElementTextAttr()

Establece la propiedad textAttrs especificada de los elementos de texto seleccionados con el valor especificado.

document.setFillColor()

Cambia el color de relleno de la selección al especificarlo.

document.setFilterProperty()

Establece una propiedad de filtro especificada para los objetos seleccionados actualmente.

document.setFilters()

Aplica filtros a los objetos seleccionados.

document.setInstanceAlpha()

Establece la opacidad de la instancia.

document.setInstanceBrightness()

Establece el brillo de la instancia.

document.setInstanceTint()

Establece la tinta de la instancia.

document.setMetadata()

Establece los metadatos XML para el documento especificado, sobrescribiendo los metadatos existentes.

document.setMobileSettings()

Establece el valor de una cadena de configuración XML en un archivo FLA móvil.

document.setOvalObjectProperty()

Especifica un valor para la propiedad indicada de objetos Oval simples.

document.setPlayerVersion()

Establece la versión de Flash Player del documento especificado.

document.setRectangleObjectProperty()

Especifica un valor para la propiedad indicada de objetos Rectangle simples.

document.setSelectionBounds()

Mueve y cambia el tamaño de la selección en una única operación.

document.setSelectionRect()

Dibuja un recuadro de delimitación rectangular en relación con el escenario, empleando las coordenadas especificadas.

document.setStageVanishingPoint()

Especifica el punto de desvanecimiento para visualizar objetos 3D.

document.setStageViewAngle()

Especifica el ángulo de perspectiva para visualizar objetos 3D.

document.setStroke()

Establece el color, el ancho y el estilo de los trazos seleccionados.

document.setStrokeColor()

Cambia el color de trazo de la selección al especificado.

document.setStrokeSize()

Cambia el tamaño de trazo de la selección al especificado.

document.setStrokeStyle()

Cambia el estilo de trazo de la selección al especificado.

document.setTextRectangle()

Cambia el rectángulo de delimitación para el elemento de texto seleccionado al tamaño especificado.

document.setTextSelection()

Establece la selección de texto del campo de texto seleccionado actualmente con los valores especificados por los valores startIndex y endIndex.

document.setTextString()

Inserta una cadena de texto.

document.setTransformationPoint()

Mueve el punto de transformación de la selección actual.

document.skewSelection()

Sesga la selección en la cantidad especificada.

document.smoothSelection()

Suaviza la curva de cada línea curva o contorno de relleno seleccionado.

document.space()

Distribuye los objetos de la selección de manera uniforme.

document.straightenSelection()

Endereza los trazos seleccionados actualmente; equivale al uso del botón Enderezar del panel Herramientas.

document.swapElement()

Cambia la selección actual por la especificada.

document.swapStrokeAndFill()

Intercambia los colores de Trazo y Relleno.

document.synchronizeWithHeadVersion()

Sincroniza el documento especificado con la versión más actual en el servidor Version Cue y registra cualquier error en el panel Salida.

document.testMovie()

Ejecuta una operación Probar película en el documento.

document.testScene()

Ejecuta una operación Probar escena en la escena actual del documento.

document.traceBitmap()

Realiza un mapa de bits de traza en la selección actual; equivale a seleccionar Modificar > Mapa de bits > Trazar mapa de bits.

document.transformSelection()

Realiza una transformación general en la selección actual aplicando la matriz especificada en los argumentos.

document.translate3DCenter()

Define la posición XYZ alrededor de la cual se transforma y se gira la selección.

document.translate3DSelection()

Aplica una transformación 3D a la selección.

document.unGroup()

Desagrupa la selección actual.

document.union()

Combina todas las formas seleccionadas en un objeto de dibujo.

document.unlockAllElements()

Desbloquea todos los elementos bloqueados en el fotograma seleccionado actualmente.

document.xmlPanel()

Envía un cuadro de diálogo XMLUI.

Resumen de propiedades

Puede emplear las propiedades siguientes con el objeto Document.

Propiedad

Descripción

document.accName

Una cadena que equivale al campo Nombre del panel Accesibilidad.

document.as3AutoDeclare

Valor booleano que describe si las instancias situadas en el escenario se añaden automáticamente a las clases de línea de tiempo definidas por el usuario.

document.as3Dialect

Cadena que describe el “dialecto” de ActionScript 3.0 empleado en el documento especificado.

document.as3ExportFrame

Entero que especifica el fotograma al que se exportarán las clases de ActionScript 3.0.

document.as3StrictMode

Valor booleano que especifica si el compilador de ActionScript 3.0 debe compilar con la opción Modo estricto activada o desactivada.

document.as3WarningsMode

Valor booleano que especifica si el compilador de ActionScript 3.0 debe compilar con la opción Modo de advertencias activada o desactivada.

document.asVersion

Entero que especifica qué versión de ActionScript se está utilizando en el archivo especificado.

document.autoLabel

Valor booleano que equivale a la casilla de verificación Etiquetado automático del panel Accesibilidad.

document.backgroundColor

Cadena, valor hexadecimal o entero que representa el color de fondo.

document.currentPublishProfile

Cadena que especifica el nombre del perfil de publicación activo para el documento especificado.

document.currentTimeline

Entero que especifica el índice de la línea de tiempo activa.

document.description

Una cadena que equivale al campo Descripción del panel Accesibilidad.

document.docClass

Especifica la clase de ActionScript 3.0 de nivel superior asociada al documento.

document.externalLibraryPath

Cadena que contiene una lista de elementos de la ruta de biblioteca externa de ActionScript 3.0 del documento, donde se especifica la ubicación de los archivos SWC utilizados como bibliotecas compartidas de tiempo de ejecución.

document.forceSimple

Valor booleano que especifica si los elementos secundarios del objeto especificado son accesibles.

document.frameRate

Valor flotante que especifica el número de fotogramas mostrados por segundo cuando se reproduce el archivo SWF; el valor predeterminado es 12.

document.height

Entero que especifica la altura del documento (escenario) en píxeles.

document.id

Entero exclusivo (asignado automáticamente) que identifica a un documento durante una sesión de Flash.

document.library

Sólo lectura; el Objeto library para un documento.

document.libraryPath

Cadena que contiene una lista de elementos de la ruta de biblioteca de ActionScript 3.0 del documento, donde se especifica la ubicación de los archivos SWC o de las carpetas que contienen los archivos SWC.

document.livePreview

Valor booleano que especifica si está activada la opción Vista previa dinámica.

document.name

Sólo lectura; cadena que representa el nombre de un documento (archivo FLA).

document.path

Sólo lectura; cadena que representa la ruta del documento con el formato específico de la plataforma.

document.pathURI

Sólo lectura; cadena que representa la ruta del documento, expresada como URI file:///.

document.publishProfiles

Sólo lectura; conjunto de los nombres del perfil de publicación para el documento.

document.screenOutline

Sólo lectura; el objeto actual Objeto ScreenOutline para el documento.

document.selection

Conjunto de los objetos seleccionados en el documento.

document.silent

Un valor booleano que especifica si el objeto es accesible.

document.sourcePath

Cadena que contiene una lista de elementos de la ruta de origen de ActionScript 3.0 del documento, donde se especifica la ubicación de los archivos de clases de ActionScript.

document.timelines

Sólo lectura; conjunto de objetos Timeline (consulte Objeto Timeline).

document.viewMatrix

Sólo lectura; un Objeto Matrix.

document.width

Entero que especifica la anchura del documento (escenario) en píxeles.

document.zoomFactor

Especifica el porcentaje de zoom del escenario en tiempo de edición.