TextRange 對象

---

代表 HTML 元素中的文本。

成員表

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

屬性

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

方法

方法	描述
collapse	將插入點移動到當(dāng)前范圍的開始或結(jié)尾。
compareEndPoints	比較 TextRange 對象的結(jié)束點和其它范圍的結(jié)束點。
duplicate	返回 TextRange 的副本。
execCommand	在當(dāng)前文檔、當(dāng)前選中區(qū)或給定范圍上執(zhí)行命令。
expand	擴(kuò)展范圍以便完全包含指定單位的范圍。
findText	在文本中搜索文本并將范圍的開始和結(jié)束點設(shè)置為包圍搜索字符串。
getBookmark	獲取可用于使 moveToBookmark 返回相同范圍的書簽(白底字符串)。
getBoundingClientRect	獲取指定 TextRectangle 對象集合綁定的對象。
getClientRects	獲取描述對象內(nèi)容或客戶區(qū)內(nèi)布局的矩形集合。每個矩形都描述了一條直線。
inRange	返回一個范圍是否被另一個范圍包含。
isEqual	返回指定范圍是否與當(dāng)前范圍相等。
move	折疊給定文本范圍并將空范圍移動給定單位數(shù)。
moveEnd	更改范圍的結(jié)束位置。
moveStart	更改范圍的開始位置。
moveToBookmark	移動到書簽。
moveToElementText	移動文本范圍以便范圍的開始和結(jié)束位置能夠完全包含給定元素的文本。
moveToPoint	將文本范圍的開始和結(jié)束位置移動到給定點。
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ū)對于給定命令的當(dāng)前值。
scrollIntoView	將對象滾動到可見范圍內(nèi)，將其排列到窗口頂部或底部。
select	將當(dāng)前選中區(qū)置為當(dāng)前對象。
setEndPoint	根據(jù)其它范圍的結(jié)束點設(shè)置某范圍的結(jié)束點。

注釋

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

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

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

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

示例

下面的例子通過 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>

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

此對象定義在 HTML 3.2  中。

參看

createTextRange