TextRange 对象

---

代表 HTML 元素中的文本。

DHTML元素属性列表

下面的表格列出了 TextRange 对象引出的成员。请单击左侧的标签来选择你想要查看的成员类型。

属性

属性	描述
boundingHeight	获取绑定 TextRange 对象的矩形的高度。
boundingLeft	获取绑定 TextRange 对象的矩形左边缘和包含 TextRange 对象的左侧之间的距离。
boundingTop	获取绑定 TextRange 对象的上边缘和包含 TextRange 对象的顶边之间的距离。
boundingWidth	Retrieves the width of the rectangle that bounds the TextRange object.
htmlText	获取绑定 TextRange 对象的矩形的宽度。
offsetLeft	获取对象相对于版面或由 offsetParent 属性指定的父坐标的计算左侧位置。
offsetTop	获取对象相对于版面或由 offsetTop 属性指定的父坐标的计算顶端位置。
text	设置或获取范围内包含的文本。

方法

方法	描述
collapse	将插入点移动到当前范围的开始或结尾。
compareEndPoints	比较 TextRange 对象的结束点和其它范围的结束点。
duplicate	返回 TextRange 的副本。
execCommand	在当前文档、当前选中区或给定范围上执行命令。
expand	扩展范围以便完全包含指定单位的范围。
findText	在文本中搜索文本并将范围的开始和结束点设置为包围搜索字符串。
getBookmark	获取可用于使 moveToBookmark 返回相同范围的书签(白底字符串)。
getBoundingClientRect	获取指定 TextRectangle 对象集合绑定的对象。
getClientRects	获取描述对象内容或客户区内布局的矩形集合。每个矩形都描述了一条直线。
inRange	返回一个范围是否被另一个范围包含。
isEqual	返回指定范围是否与当前范围相等。
move	折叠给定文本范围并将空范围移动给定单位数。
moveEnd	更改范围的结束位置。
moveStart	更改范围的开始位置。
moveToBookmark	移动到书签。
moveToElementText	移动文本范围以便范围的开始和结束位置能够完全包含给定元素的文本。
moveToPoint	将文本范围的开始和结束位置移动到给定点。
parentElement	获取给定文本范围的父元素。
pasteHTML	将 HTML 文本粘贴入给定文本范围，替换范围内任何先前的文本和 HTML 元素。
queryCommandEnabled	返回表明指定命令是否可于给定文档当前状态下使用 execCommand 命令成功执行的 Boolean 值。
queryCommandIndeterm	返回表明指定命令是否处于模糊状态的 Boolean 值。
queryCommandState	返回表明命令当前状态的 Boolean 值。
queryCommandSupported	返回表明当前命令是否在当前区域上支持的 Boolean 值。
queryCommandValue	返回文档、范围或当前选中区对于给定命令的当前值。
scrollIntoView	将对象滚动到可见范围内，将其排列到窗口顶部或底部。
select	将当前选中区置为当前对象。
setEndPoint	根据其它范围的结束点设置某范围的结束点。

注释

使用此对象可以获取并修改元素中的文本，定位文本中的指定字符串，以及执行影响文本外观的命令。

要获取一个文本范围对象，请对 body, button 或 textarea 元素或带有 type 文本的 input 元素应用 createTextRange 方法。

如果想要修改文本范围的延展范围，可以使用 move, movetoelementtext 和 findText 移动其起始和终止位置。在文本范围内，你可以获取并修改纯文本或 HTML 文本。这些格式的文本完全相同，只是 HTML 文本包含 HTML 标签，而春文本不包含。

此对象在 Microsoft^® Internet Explorer 4.0 的脚本中可用。

DHTML代码举例

下面的例子通过 TextRange 对象将 button 元素的文本更改为“已单击”。

<SCRIPT LANGUAGE="JScript">
var b = document.all.tags("BUTTON");
if (b!=null) {
var r = b[0].createTextRange();
if (r != null) {
r.text = "已单击";
}
}
</SCRIPT>

标准信息

此对象定义在 html 3.2  中。

参看

createTextRange