MovieClip.getTextSnapshot()

可用性

创作:Flash MX 2004。

回放:以 Flash Player 6 或更高版本为目标播放器发布的 SWF 文件,在 Flash Player 7 或更高版本中播放。

用法

my_mc.getTextSnapshot();

参数

无。

返回

一个包含来自 my_mc 的静态文本的 TextSnapshot 对象;或者,如果 my_mc 不包含任何静态文本,则为空字符串。

说明

方法;返回一个 TextSnapshot 对象,该对象包含指定影片剪辑的所有静态文本字段中的文本;不包括子影片剪辑中的文本。

Flash 连接文本并将文本放置于 TextSnapshot 对象中,放置的顺序反映影片剪辑中静态文本字段的 Tab 键索引顺序。没有 Tab 键索引值的文本字段将以随机的顺序放置于该对象中,并且放在来自具有 Tab 键索引值的字段的所有文本前。没有换行符或格式指示一个字段从哪里结束、另一个字段从哪里开始。

注意:您不能在 Flash 中为静态文本指定 Tab 键索引值。不过,其它产品可以这样做;例如 Macromedia FlashPaper 就可以。

TextSnapshot 对象的内容不是动态的;即,如果影片剪辑移到不同的帧,或者以某种方式被更改(例如,影片剪辑中的对象被添加或删除),则 TextSnapshot 对象可能不表示影片剪辑中的当前文本。若要确保该对象的内容是最新的,应根据需要重新发出此命令。

另请参见

TextSnapshot 对象