TextField 类

可用性

Flash Player 6。

说明

SWF 文件中的所有动态文本字段和输入文本字段都是 TextField 类的实例。可以在属性检查器中为文本字段指定实例名称，并且可以在动作脚本中使用 TextField 类的方法和属性对文本字段进行操作。TextField 的实例名称显示在“影片管理器”中及“动作”面板的“插入目标路径”对话框中。

TextField 类继承自 Object 类。

若要动态创建文本字段，可以使用 MovieClip.createTextField()。

TextField 类的方法摘要

方法	说明
`TextField.addListener()`	注册一个对象，以便在调用 `onChanged` 和 `onScroller` 事件处理函数时接收通知。
`TextField.getFontList()`	返回播放器的主机系统上字体名称的数组。
`TextField.getDepth()`	返回文本字段的深度。
`TextField.getNewTextFormat()`	获取分配给新插入文本的默认文本格式。
`TextField.getTextFormat()`	返回包含文本字段中一些或全部文本的格式信息的 TextFormat 对象。
`TextField.removeListener()`	删除侦听器对象。
`TextField.removeTextField()`	删除使用 MovieClip.createTextField() 创建的文本字段。
`TextField.replaceSel()`	替换当前的所选内容。
`TextField.setNewTextFormat()`	为由用户或方法插入的文本设置 TextFormat 对象。
`TextField.setTextFormat()`	为文本字段中指定范围内的文本设置一个 TextFormat 对象。

TextField 类的属性摘要

属性	说明
`TextField._alpha`	文本字段实例的透明度值。
`TextField.autoSize`	控制文本字段的自动对齐和大小调整。
`TextField.background`	指示文本字段是否具有背景填充。
`TextField.backgroundColor`	指示背景填充的颜色。
`TextField.border`	指示文本字段是否具有边框。
`TextField.borderColor`	指示边框的颜色。
`TextField.bottomScroll`	文本字段中最下面的可见行。只读。
`TextField.embedFonts`	指示文本字段是使用嵌入字体轮廓还是使用设备字体。
`TextField._height`	文本字段实例的高度，以像素为单位。它只影响文本字段的边框，不影响边框的粗细和文本字体大小。
`TextField._highquality`	指示 SWF 文件的呈现品质。
`TextField.hscroll`	指示文本字段的水平滚动值。
`TextField.html`	指示文本字段是否包含 HTML 表示形式的标记
`TextField.htmlText`	包含文本字段内容的 HTML 表示形式。
`TextField.length`	文本字段中的字符数。只读。
`TextField.maxChars`	文本字段最多可容纳的字符数。
`TextField.maxhscroll`	`TextField.hscroll` 的最大值。只读。
`TextField.maxscroll`	`TextField.scroll` 的最大值。只读。
`TextField.menu`	将 ContextMenu 对象与文本字段关联。
`TextField.mouseWheelEnabled`	指示当鼠标指针停在文本字段上且用户滚动鼠标滚轮时，Flash Player 是否应自动滚动多行文本字段。
`TextField.multiline`	指示文本字段是否包含多行。
`TextField._name`	文本字段实例的实例名称。
`TextField._parent`	对此实例的父级实例的引用；其类型为 Button 或 MovieClip。
`TextField.password`	指示文本字段是否隐藏输入字符。
`TextField._quality`	指示 SWF 文件的呈现品质。
`TextField.restrict`	用户可输入文本字段的字符集。
`TextField._rotation`	文本字段实例的旋转度数。
`TextField.scroll`	指示文本字段的当前滚动位置。
`TextField.selectable`	指示文本字段是否可选。
`TextField._soundbuftime`	在声音进入流之前，必须预先缓冲的声音的时间量。
`TextField.tabEnabled`	指示影片剪辑是否包括在 Tab 键的自动排序中。
`TextField.tabIndex`	指示对象的 Tab 键顺序。
`TextField._target`	指定文本字段实例的目标路径。只读。
`TextField.text`	文本字段中的当前文本。
`TextField.textColor`	文本字段中当前文本的颜色。
`TextField.textHeight`	文本字段边框的高度。
`TextField.textWidth`	文本字段边框的宽度。
`TextField.type`	指示文本字段是输入文本字段还是动态文本字段。
`TextField._url`	创建文本字段实例的 SWF 文件的 URL。只读。
`TextField.variable`	与文本字段关联的变量名。
`TextField._visible`	确定文本字段实例是隐藏还是可见的布尔值。
`TextField._width`	文本字段实例的宽度，以像素为单位。它只影响文本字段的边框，不影响边框的粗细和文本字体大小。
`TextField.wordWrap`	指示文本字段是否自动换行。
`TextField._x`	文本字段实例的 x 坐标
`TextField._xmouse`	指针相对于文本字段实例的 x 坐标。只读。
`TextField._xscale`	指定水平缩放文本字段实例的百分比的值。
`TextField._y`	文本字段实例的 y 坐标。
`TextField._ymouse`	指针相对于文本字段实例的 y 坐标。只读。
`TextField._yscale`	指定垂直缩放文本字段实例的百分比的值。

TextField 类的事件处理函数摘要

事件处理函数	说明
`TextField.onChanged`	在文本字段更改时调用。
`TextField.onKillFocus`	在文本字段失去焦点时调用。
`TextField.onScroller`	在文本字段滚动属性之一发生更改时调用。
`TextField.onSetFocus`	在文本字段接收焦点时调用。

TextField 类的侦听器摘要

方法	说明
`TextField.onChanged`	在文本字段更改时获得通知。
`TextField.onScroller`	在文本字段的 `scroll` 或 `maxscroll` 属性更改时获得通知。