Clase TextField

Disponibilidad

Flash Player 6.

Descripción

Todos los campos de texto dinámico y de introducción de texto de un archivo SWF son instancias de la clase TextField. Puede asignar un nombre de instancia a un campo de texto en el inspector de propiedades y utilizar los métodos y las propiedades de la clase TextField para manipularlo con ActionScript. Los nombres de instancia del objeto TextField se muestran en el Explorador de películas y en el cuadro de diálogo Insertar ruta de destino del panel Acciones.

La clase TextField hereda de la Clase Object.

Para crear un campo de texto dinámicamente, puede utilizar MovieClip.createTextField().

Resumen de métodos para la clase TextField

Método	Descripción
`TextField.addListener()`	Registra un objeto para recibir una notificación cuando se invocan los controladores de eventos `onChanged` y `onScroller`.
`TextField.getFontList()`	Este método devuelve los nombres de las fuentes del sistema host del reproductor en forma de matriz.
`TextField.getDepth()`	Devuelve la profundidad de un campo de texto.
`TextField.getNewTextFormat()`	Obtiene el formato de texto predeterminado asignado al texto que se acaba de insertar.
`TextField.getTextFormat()`	Devuelve un objeto TextFormat que contiene información sobre el formato de parte o la totalidad del texto de un campo de texto.
`TextField.removeListener()`	Elimina un objeto detector.
`TextField.removeTextField()`	Elimina un campo de texto que se ha creado con `MovieClip.createTextField()`.
`TextField.replaceSel()`	Reemplaza la selección actual.
`TextField.setNewTextFormat()`	Establece un objeto TextFormat para el texto insertado por un usuario o por un método.
`TextField.setTextFormat()`	Establece un objeto TextFormat para una parte especificada del texto de un campo de texto.

Resumen de propiedades para la clase TextField

Propiedad	Descripción
`TextField._alpha`	Valor de transparencia de una instancia de campo de texto.
`TextField.autoSize`	Controla la alineación automática y la definición del tamaño de un campo de texto.
`TextField.background`	Indica si el campo de texto tiene un relleno de fondo.
`TextField.backgroundColor`	Indica el color del relleno de fondo.
`TextField.border`	Indica si el campo de texto tiene un borde.
`TextField.borderColor`	Indica el color del borde.
`TextField.bottomScroll`	Última línea visible de un campo de texto. Es de sólo lectura.
`TextField.embedFonts`	Indica si el campo de texto utiliza contornos de fuentes incorporadas o fuentes de dispositivo.
`TextField._height`	Altura de una instancia de campo de texto en píxeles. Sólo afecta al recuadro de delimitación del campo de texto, no al grosor del borde ni al tamaño de fuente del texto.
`TextField._highquality`	Indica la calidad de representación del archivo SWF.
`TextField.hscroll`	Indica el valor de desplazamiento horizontal de un campo de texto.
`TextField.html`	Indica la posición de desplazamiento máxima de un campo de texto.
`TextField.htmlText`	Contiene la representación HTML del contenido de un campo de texto.
`TextField.length`	Número de caracteres de un campo de texto. Es de sólo lectura.
`TextField.maxChars`	Número máximo de caracteres que puede contener un campo de texto.
`TextField.maxhscroll`	Valor máximo de `TextField.hscroll`. Es de sólo lectura.
`TextField.maxscroll`	Valor máximo de `TextField.scroll`. Es de sólo lectura.
`TextField.menu`	Asocia un objeto ContextMenu con un campo de texto.
`TextField.mouseWheelEnabled`	Indica si Flash Player debe desplazar automáticamente el contenido de los campos de texto multilínea cuando el puntero del ratón se coloca sobre un campo de texto y el usuario hace girar la rueda del ratón.
`TextField.multiline`	Indica si el campo de texto contiene varias líneas.
`TextField._name`	Nombre de instancia de una instancia de campo de texto.
`TextField._parent`	Referencia a la instancia principal de esta instancia; ya sea de tipo Button o MovieClip.
`TextField.password`	Indica si un campo de texto debe ocultar los caracteres introducidos.
`TextField._quality`	Indica la calidad de representación de un archivo SWF.
`TextField.restrict`	Conjunto de caracteres que puede introducir un usuario en un campo de texto.
`TextField._rotation`	Grado de rotación de una instancia de campo de texto.
`TextField.scroll`	Indica la posición de desplazamiento actual de un campo de texto.
`TextField.selectable`	Indica si un campo de texto se puede seleccionar.
`TextField._soundbuftime`	Tiempo durante el cual un sonido debe almacenarse previamente en una memoria intermedia antes de empezar a fluir.
`TextField.tabEnabled`	Indica si se incluye un clip de película en el orden de tabulación automático.
`TextField.tabIndex`	Indica el orden de tabulación de un objeto.
`TextField._target`	Ruta de destino de la instancia del campo de texto especificada. Es de sólo lectura.
`TextField.text`	Texto actual del campo de texto.
`TextField.textColor`	Color del texto actual en el campo de texto.
`TextField.textHeight`	Altura del recuadro de delimitación del campo de texto.
`TextField.textWidth`	Anchura del recuadro de delimitación del campo de texto.
`TextField.type`	Indica si un campo de texto es un campo de introducción de texto o un campo de texto dinámico.
`TextField._url`	URL del archivo SWF que ha creado la instancia de campo de texto. Es de sólo lectura.
`TextField.variable`	Nombre de variable asociado con el campo de texto.
`TextField._visible`	Valor booleano que determina si una instancia de campo de texto está oculta o visible.
`TextField._width`	Anchura de una instancia de campo de texto en píxeles. Sólo afecta al recuadro de delimitación del campo de texto, no al grosor del borde ni al tamaño de fuente del texto.
`TextField.wordWrap`	Indica si el texto de un campo de texto se ajusta.
`TextField._x`	Coordenada x de una instancia de campo de texto.
`TextField._xmouse`	Coordenada x del puntero en relación con una instancia de campo de texto. Sólo lectura.
`TextField._xscale`	Valor que especifica el porcentaje de escala horizontal que se aplicará a una instancia de campo de texto.
`TextField._y`	Coordenada y de una instancia de campo de texto.
`TextField._ymouse`	Coordenada y del puntero en relación con una instancia de campo de texto. Sólo lectura.
`TextField._yscale`	Valor que especifica el porcentaje de escala vertical que se aplicará a una instancia de campo de texto.

Resumen de controladores de eventos de la clase TextField

Controlador de eventos	Descripción
`TextField.onChanged`	Se invoca cuando se cambia el campo de texto.
`TextField.onKillFocus`	Se invoca cuando el campo de texto deja de estar seleccionado.
`TextField.onScroller`	Se invoca cuando una de las propiedades de desplazamiento del campo de texto cambia.
`TextField.onSetFocus`	Se invoca cuando el campo de texto pasa a estar seleccionado.

Resumen de detectores para la clase TextField

Método	Descripción
`TextField.onChanged`	Se notifica cuando cambia el campo de texto.
`TextField.onScroller`	Se notifica cuando cambia la propiedad `scroll` o `maxscroll` de un campo de texto.