TextRange 對(duì)象

---

代表 HTML 元素中的文本。

成員表

下面的表格列出了 TextRange 對(duì)象引出的成員。請(qǐng)單擊左側(cè)的標(biāo)簽來(lái)選擇你想要查看的成員類(lèi)型。

屬性

屬性	描述
boundingHeight	獲取綁定 TextRange 對(duì)象的矩形的高度。
boundingLeft	獲取綁定 TextRange 對(duì)象的矩形左邊緣和包含 TextRange 對(duì)象的左側(cè)之間的距離。
boundingTop	獲取綁定 TextRange 對(duì)象的上邊緣和包含 TextRange 對(duì)象的頂邊之間的距離。
boundingWidth	Retrieves the width of the rectangle that bounds the TextRange object.
htmlText	獲取綁定 TextRange 對(duì)象的矩形的寬度。
offsetLeft	獲取對(duì)象相對(duì)于版面或由 offsetParent 屬性指定的父坐標(biāo)的計(jì)算左側(cè)位置。
offsetTop	獲取對(duì)象相對(duì)于版面或由 offsetTop 屬性指定的父坐標(biāo)的計(jì)算頂端位置。
text	設(shè)置或獲取范圍內(nèi)包含的文本。

方法

方法	描述
collapse	將插入點(diǎn)移動(dòng)到當(dāng)前范圍的開(kāi)始或結(jié)尾。
compareEndPoints	比較 TextRange 對(duì)象的結(jié)束點(diǎn)和其它范圍的結(jié)束點(diǎn)。
duplicate	返回 TextRange 的副本。
execCommand	在當(dāng)前文檔、當(dāng)前選中區(qū)或給定范圍上執(zhí)行命令。
expand	擴(kuò)展范圍以便完全包含指定單位的范圍。
findText	在文本中搜索文本并將范圍的開(kāi)始和結(jié)束點(diǎn)設(shè)置為包圍搜索字符串。
getBookmark	獲取可用于使 moveToBookmark 返回相同范圍的書(shū)簽(白底字符串)。
getBoundingClientRect	獲取指定 TextRectangle 對(duì)象集合綁定的對(duì)象。
getClientRects	獲取描述對(duì)象內(nèi)容或客戶(hù)區(qū)內(nèi)布局的矩形集合。每個(gè)矩形都描述了一條直線(xiàn)。
inRange	返回一個(gè)范圍是否被另一個(gè)范圍包含。
isEqual	返回指定范圍是否與當(dāng)前范圍相等。
move	折疊給定文本范圍并將空范圍移動(dòng)給定單位數(shù)。
moveEnd	更改范圍的結(jié)束位置。
moveStart	更改范圍的開(kāi)始位置。
moveToBookmark	移動(dòng)到書(shū)簽。
moveToElementText	移動(dòng)文本范圍以便范圍的開(kāi)始和結(jié)束位置能夠完全包含給定元素的文本。
moveToPoint	將文本范圍的開(kāi)始和結(jié)束位置移動(dòng)到給定點(diǎn)。
parentElement	獲取給定文本范圍的父元素。
pasteHTML	將 HTML 文本粘貼入給定文本范圍，替換范圍內(nèi)任何先前的文本和 HTML 元素。
queryCommandEnabled	返回表明指定命令是否可于給定文檔當(dāng)前狀態(tài)下使用 execCommand 命令成功執(zhí)行的 Boolean 值。
queryCommandIndeterm	返回表明指定命令是否處于模糊狀態(tài)的 Boolean 值。
queryCommandState	返回表明命令當(dāng)前狀態(tài)的 Boolean 值。
queryCommandSupported	返回表明當(dāng)前命令是否在當(dāng)前區(qū)域上支持的 Boolean 值。
queryCommandValue	返回文檔、范圍或當(dāng)前選中區(qū)對(duì)于給定命令的當(dāng)前值。
scrollIntoView	將對(duì)象滾動(dòng)到可見(jiàn)范圍內(nèi)，將其排列到窗口頂部或底部。
select	將當(dāng)前選中區(qū)置為當(dāng)前對(duì)象。
setEndPoint	根據(jù)其它范圍的結(jié)束點(diǎn)設(shè)置某范圍的結(jié)束點(diǎn)。

注釋

使用此對(duì)象可以獲取并修改元素中的文本，定位文本中的指定字符串，以及執(zhí)行影響文本外觀的命令。

要獲取一個(gè)文本范圍對(duì)象，請(qǐng)對(duì) body, button 或 textArea 元素或帶有 TYPE 文本的 input 元素應(yīng)用 createTextRange 方法。

如果想要修改文本范圍的延展范圍，可以使用 move, moveToElementText 和 findText 移動(dòng)其起始和終止位置。在文本范圍內(nèi)，你可以獲取并修改純文本或 HTML 文本。這些格式的文本完全相同，只是 HTML 文本包含 HTML 標(biāo)簽，而春文本不包含。

此對(duì)象在 Microsoft^® Internet Explorer 4.0 的腳本中可用。

示例

下面的例子通過(guò) TextRange 對(duì)象將 button 元素的文本更改為“已單擊”。

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

標(biāo)準(zhǔn)信息

此對(duì)象定義在 HTML 3.2  中。

參看

createTextRange