Home | О проекте | Новости | Рекламные статейки

ВернутьсяВ начало

1.Рекламка: s |

TextRange NN n/a   IE 4   DOM n/a
2.Рекламка: s | ;
x |   

Объект TextRange представляет текст из 0 или большего количества символов в документе (текстовый диапазон). Когда текстовый диапазон состоит из нулевых символов, онэто представляет собой курсор (точку ввода) между двумя символами (или перед первым символом, или после последнего символа).

Объект TextRange создаётся через метод createTextRange(), связанный с объектами BODY, BUTTON, text или TEXTAREA. Как только текстовый диапазон создан, используйте его методы корректировки начала и конечного пункта, чтобы охватить желательную долю текста (типа текста, который соответствует строке для поиска). Как только диапазон сужен к нужному тексту, назначьте значения на его свойства htmlText и text, чтобы изменять, удалять или вставлять текст. Библиотека прямых команд, которые исполняют определенные текстовые модификации, также может быть вызвана, чтобы воздействовать на данный текстовый диапазон.

Обратите внимание, что объект TextRange и все связанные с ним средства доступны только в Win32 версии Internet Explorer 4.

 
 
Объектно-ориентированная модель
IE objectRef.createTextRange( )

Свойства:


boundingHeight, boundingWidth NN n/a   IE 4   DOM n/a
 Только чтение
 

Возвращает размер в пикселах воображаемого пространства, занятого объектом TextRange. Хотя Вы не видите объект TextRange в документе (если сценарий не устанавливает это), область объекта TextRange идентична области, которую заняла бы подсветка выбора. Эти значения обеспечивают только такую ширину или высоту, как самая широкая и самая высокая часть диапазона.

 
Пример:

var rangeWidth = document.forms[0].myTextArea.createTextRange( ).boundingWidth

 
Возвращаемое значение:
Целое число.
 
Значение по умолчанию: Ничего.

boundingLeft, boundingTop NN n/a   IE 4   DOM n/a
 Только чтение
 

Возвращает расстояние в пикселах между верхней или левой гранью окна браузера или фрейма и верхней или левой гранью воображаемого пространства, занятого объектом TextRange. Хотя Вы не видите объект TextRange в документе (если это не определяет сценарий), область объекта TextRange идентична области, которую заняла бы подсветка выбора. Значения для этих свойств измеряются от граней окна или фрейма, а не документа, который может прокручиваться. Поэтому, поскольку документ прокручивается, эти значения изменяются.

 
Пример:

var rangeOffH = document.forms[0].myTextArea.createTextRange( ).boundingLeft

 
Возвращаемое значение:
Целое число.
 
Значение по умолчанию: Ничего.

htmlText NN n/a   IE 4   DOM n/a
 Только чтение
 

Весь HTML документа для данного элемента, который используется как основание для объекта TextRange. Например, если Вы создаете TextRange для элемента BODY (document.BODY.createTextRange()), свойство htmlText содержит все содержание HTML между тэгами (но не, включая их) элемента BODY.

 
Пример:

var rangeHTML = document.body.createTextRange( ).htmlText

 
Возвращаемое значение: Строка.
 
Значение по умолчанию: Ничего.

text NN n/a   IE 4   DOM n/a
 Чтение/Изменение
 

Текст, содержащийся в текстовом диапазоне. В случае объекта TextRange элемента BODY, свойство состоит только из текста, который представлен, но ни один из HTML тэгов не включён.

 
Пример:

var rangeText = document.body.createTextRange( ).text

 
Возвращаемое значение: Строка.
 
Значение по умолчанию: Ничего.

Методы:


collapse( ) NN n/a   IE 4   DOM n/a

collapse([start])

Уменьшает длину объекта TextRange до нуля (создание курсора (точки ввода)) в начале или в конце текстового диапазона.

 
Возвращаемое значение
None.
 
Параметры
start Дополнительное булево значение управляет, устанавливается ли курсор (точка ввода) в начало первоначального диапазона (true) или в конец (false). Значение по умолчанию - true.

compareEndPoints( ) NN n/a   IE 4   DOM n/a

compareEndPoints(type, comparisonRange)

Сравнивает относительную позицию границы (начало и конец) точек двух диапазонов (текущий диапазон и тот, который был предварительно сохранен в переменной). Первый параметр определяет, какие граничные точки в каждом диапазоне Вы желаете сравнить. Если результат сравнения - то, что первая точка появляется ранее, чем другая точка, возвращается значение -1; если результат показывает обе точки в одном и том же местоположении, возвращается значение 0; если результат показывает первую точку позже в диапазоне, чем другую точку, возвращается значение 1. Например, если Вы сохранили первый диапазон в переменной r1 и создали новый диапазон r2, Вы можете увидеть физические отношения между концом r2 и началом r1:

r1.compareEndPoints("EndToStart", r2)

Если r1 заканчивается там, где начинается r2 (курсор между двумя символами), то возвращенное значение - 0.

 
Возвращаемое значение
-1, 0 или 1.
 
Параметры
type одна из следующих констант (как строка): StartToEnd | StartToStart | EndToStart | EndToEnd.
comparisonRange Объект TextRange, созданный ранее и сохранённый в переменной.

duplicate( ) NN n/a   IE 4   DOM n/a

Создает новый объект TextRange с теми же самыми значениями, как и текущий диапазон. Новый объект - независимый объект (старый и новый не равняются друг другу), но их значения изначально идентичны (пока Вы не начинаете изменять один диапазон или другой).

 
Возвращаемое значение
Объект TextRange.
 
Параметры
None.

execCommand( ) NN n/a   IE 4   DOM n/a

execCommand("commandName"[, UIFlag[, value]])

Выполняет названную команду с текущим объектом TextRange. Много команд работают лучше всего, когда объект TextRange - курсор (точка ввода).

 
Возвращаемое значение
Булево значение: true, если команда успешна; false, если неудачно.
 
Параметры
commandName Название команды (строка без учета регистра)..
UIFlag Дополнительное булево значение: true, чтобы отобразить любой интерфейс пользователя, вызванный командой; false, чтобы предотвратить такое отображение.
value Значение параметра для команды.

expand( ) NN n/a   IE 4   DOM n/a

expand(unit)

Разворачивает текущий текстовый диапазон, чтобы охватить текстовый модуль, прошедший как параметр. Например, если кто-то выбирает некоторые символы из документа, Вы можете создать диапазон и разворачивать его, чтобы охватить полное предложение, в котором имеет место выбор:

var rng = document.selection.createRange( ) rng.expand("sentence")

Если стартовый диапазон простирается поперек многих модулей, метод expand( ) разворачивает диапазон наружу до следующего самого близкого аналогичного модуля.

 
Возвращаемое значение
Булево значение: true, если успешно; false, если неудачно.
 
Параметры
unit Строковое значение модуля без учета регистра: character | word | sentence | textedit. Значение textedit разворачивает диапазон до полного первоначального диапазона.

findText( ) NN n/a   IE 4   DOM n/a

findText(string)

Ищет соответствие текущего объекта TextRange прошедшей как параметр строке. Соответствие ищется без учета регистра. Если есть соответствие, объект TextRange снова устанавливает свою начальную и конечную точки, чтобы окружить найденный текст. Чтобы продолжать искать, Вы должны снова установить точку начала текстового диапазона к концу найденной строки (методом collapse( )).

 
Возвращаемое значение
Булево значение: true, если соответствие найдено; false, если не найдено
 
Параметры
string Строка без учета регистра, которая будет отыскана.

getBookmark( ), moveToBookmark( ) NN n/a   IE 4   DOM n/a

getBookmark( )

moveToBookmark(bookmarkString)

Эти два метода работают вместе как способ временно сохранить текстовую спецификацию диапазона и восстанавливают её, когда необходимо. Метод getBookmark() возвращает непрозрачную строку (содержащую двоичные данные, которые не имеют никакго представления пользователям). Как только это значение сохранено в переменной, диапазон может изменяться, как необходимо для сценария. Некоторое время спустя отмеченный текстовый диапазон может быть восстановлен методом moveToBookmark():

var rangeMark = myRange.getBookmark( ) ... myRange.moveToBookmark(rangeMark)

 
Возвращаемое значение
Булево значение: true, если команда успешна; false, если неудачно.
 
Параметры
bookmarkString Непрозрачная строка, возвращенная методом getBookmark().

inRange( ) NN n/a   IE 4   DOM n/a

inRange(comparisonRange)

Определяет, является ли диапазон сравнения равным или приблизительно равным физическому текстовому диапазону.

 
Возвращаемое значение
Булево значение: true, если диапазон сравнения является равным или приблизительно равным физическому диапазону; false, если нет
 
Параметры
comparisonRange Объект TextRange, созданный ранее и сохраненный в переменной.

isEqual( ) NN n/a   IE 4   DOM n/a

isEqual(comparisonRange)

Определяет, является ли диапазон сравнения идентичным текущему текстовому диапазону.

 
Возвращаемое значение
Булево значение:true, если диапазон сравнения равен текущему диапазону; false, если нет.
 
Параметры
comparisonRange Объект TextRange, созданный ранее и сохраненный в переменной.

Move() NN n/a   IE 4   DOM n/a

move(unit[, count])

Сворачивает текущий текстовый диапазон в курсор (точку ввода) в конце текущего диапазона и продвигает вперёд или назад от текущей позиции на один или более модуль.

 
Возвращаемое значение
Целое число модулей, на которое точка передвигалась.
 
Параметры
unit Строковое значение модуля без учета регистра: character | word | sentence | textedit. Значение textedit перемещает указатель на начало или конец первоначального диапазона.
count Дополнительное целое число модулей, на которые нужно переместить точку ввода. Положительные значения продвигают указатель (точку ввода); отрицательные значения перемещают указатель назад. Значение по умолчанию 1.

moveEnd( ), moveStart( ) NN n/a   IE 4   DOM n/a

moveEnd(unit[, count])

moveStart(unit[, count])

Перемещает только конечную или начальную точку (соответственно) текущего текстового диапазона на один или более модуль. Дополнительный параметр позволяет Вам определять и число модулей, и направление. Чтобы переместить точку начала текстового диапазона к началу первоначального диапазона, убедитесь, что установили отрицательное значение. При перемещении конечной точки направо на слово знайте, что слово заканчивается символом пробела (включая период). Поэтому, если метод findText() устанавливает диапазон на найденную строку, которая не заканчивается пробелом, первый метод moveEnd ("word") перемещает конечную точку в ячейку мимо пробела после найденной строки.

 
Возвращаемое значение
Целое число модулей
 
Параметры
unit Строковое значение модуля без учета регистра: character | word | sentence | textedit. Значение textedit перемещает указатель на начало или конец первоначального диапазона.
count Дополнительное целое число модулей, на которые нужно переместить точку ввода. Положительные значения продвигают указатель (точку ввода); отрицательные значения перемещают указатель назад. Значение по умолчанию 1.

moveToElementText( ) NN n/a   IE 4   DOM n/a

moveToElementText(elementObject)

Перемещает текущие начальную и конечную точки объекта TextRange, чтобы упаковать указанный объект в элемент HTML. Результирующий текстовый диапазон включает также HTML.

 
Возвращаемое значение
None.
 
Параметры
elementObject Сценарная ссылка на объект. Это может быть в форме прямой ссылки(document.all.elementID) или переменной, содержащей то же самое значение.

moveToPoint( ) NN n/a   IE 4   DOM n/a

moveToPoint(x, y)

Сворачивает текстовый диапазон в указатель вставки и устанавливает его местоположение в ячейке, обозначенной горизонтальными и вертикальными координатами в окне браузера или фрейме. Это - то, как будто пользователь щелкнул на ячейку в окне, чтобы определить курсор (точку ввода).

 
Возвращаемое значение
None.
 
Параметры
x Горизонтальная координата курсора (точки ввода) в пикселах относительно левого края окна или фрейма.
y Вертикальная координата курсора(точки ввода) в пикселах относительно верхнего края окна или фрейма.

parentElement( ) NN n/a   IE 4   DOM n/a

Возвращает ссылку на родительский элемент, который содержит объект TextRange полностью.

 
Возвращаемое значение
Ссылка на объект.
 
Параметры
None.

pasteHTML( ) NN n/a   IE 4   DOM n/a

pasteHTML(HTMLText)

Заменяет текущий текстовый диапазон содержанием HTML, определённым как строка параметра. Обычно этот метод используется на объекте диапазона текста нулевой длины, действующем как точка ввода. Все тэги представляются так, как будто они были частью первоначального исходного текста.

 
Возвращаемое значение
None.
 
Параметры
HTMLText Исходный текст документа, который будет в него вставлен.

queryCommandEnabled( ) NN n/a   IE 4   DOM n/a

queryCommandEnabled("commandName")

Может ли команда быть вызвана в текущем состоянии документа или выбора. Доступно только в IE 4 для Win32 ..

 
Возвращаемое значение
Булево значение: true if enabled; false if not.
 
Параметры
commandName Название команды (строка без учета регистра)..

queryCommandIndeterm( ) NN n/a   IE 4   DOM n/a

queryCommandIndeterm("commandName")

Находится ли команда в неопределенном состоянии. Доступно только в IE 4 для Win32 ..

 
Возвращаемое значение
Булево значение: true | false.
 
Параметры
commandName Название команды (строка без учета регистра)..

queryCommandState( ) NN n/a   IE 4   DOM n/a

queryCommandState("commandName")

Определяет текущее состояние названной команды. Доступно только в IE 4 для Win32 ..

 
Возвращаемое значение
true, если команда была закончена; false, если команда не завершилась; null, если состояние не может быть точно определено.
 
Параметры
commandName Название команды (строка без учета регистра)..

queryCommandSupported( ) NN n/a   IE 4   DOM n/a

queryCommandSupported("commandName")

Определяет, поддерживается ли названная команда объектом document. Доступно только в IE 4 для Win32 ..

 
Возвращаемое значение
Булево значение: true | false.
 
Параметры
commandName Название команды (строка без учета регистра)..

queryCommandText( ) NN n/a   IE 4   DOM n/a

queryCommandText("commandName")

Возвращает текст, связанный с командой. Доступно только в IE 4 для Win32 ..

 
Возвращаемое значение
Строка
 
Параметры
commandName Название команды (строка без учета регистра)..

queryCommandValue( ) NN n/a   IE 4   DOM n/a

queryCommandValue("commandName")

Возвращает значение, связанное с командой, типа названия шрифта выбора. Доступно только в IE 4 для Win32 ..

 
Возвращаемое значение
Зависит от команды.
 
Параметры
commandName Название команды (строка без учета регистра)..

select() NN n/a   IE 4   DOM n/a

Выбирает весь текст, который включен в текущий объект TextRange. Этот метод приносит некоторое визуальное подтверждение пользователям, что сценарий знает о специфическом блоке текста. Например, если бы Вы писали сценарий поиска с методом findText() , Вы использовали бы тогда на этом диапазоне методы scrollIntoView() и select(), чтобы показать пользователю, где находится текст соответствия.

 
Возвращаемое значение
None.
 
Параметры
None.

setEndPoint( ) NN n/a   IE 4   DOM n/a

setEndPoint(type, comparisonRange)

Устанавливает конечную точку текущего объекта TextRange к конечной точке другого диапазона, который предварительно был сохранён как переменная ссылка.

 
Возвращаемое значение
None.
 
Параметры
type одна из следующих констант (как строка): StartToEnd | StartToStart | EndToStart | EndToEnd.
comparisonRange Объект TextRange, который создан ранее и сохранён в переменной.

footer:
Rambler's Top100