TextSnapshot - Adobe ActionScript® 3 (AS3 )

Пакет	flash.text
Класс	public class TextSnapshot
Наследование	TextSnapshot Object

Язык версии:

ActionScript 3.0

Версии среды выполнения:

AIR 1.0, Flash Player 9, Flash Lite 4

Объекты TextSnapshot позволяют работать со статическим текстом во фрагменте ролика. Их можно использовать, например, для более точной раскладки текста, чем позволяет динамический текст, не отменяя доступа к нему «только для чтения».

Не создавайте объект TextSnapshot с помощью конструктора. Он возвращается свойством flash.display.DisplayObjectContainer.textSnapshot.

Связанные элементы API

flash.display.DisplayObjectContainer.textSnapshot

Общедоступные свойства

Скрыть унаследованные общедоступные свойства

Показать унаследованные общедоступные свойства

	Свойство		Определено
		charCount : int [только для чтения] Число знаков в объекте TextSnapshot.	TextSnapshot
		constructor : Object Ссылка на объект класса или функцию конструктора для данного экземпляра объекта.	Object

Общедоступные методы

Скрыть унаследованные общедоступные методы

Показать унаследованные общедоступные методы

	Метод		Определено
		findText(beginIndex:int, textToFind:String, caseSensitive:Boolean):int Выполняет поиск по объекту TextSnapshot и возвращает положение первого вхождения textToFind, обнаруженного в положении beginIndex или после него.	TextSnapshot
		getSelected(beginIndex:int, endIndex:int):Boolean Возвращает логическое значение, показывающее, содержит ли объект TextSnapshot выделенный текст в заданном диапазоне.	TextSnapshot
		getSelectedText(includeLineEndings:Boolean = false):String Возвращает строку, содержащую все символы, заданные соответствующим методом setSelected().	TextSnapshot
		getText(beginIndex:int, endIndex:int, includeLineEndings:Boolean = false):String Возвращает строку, содержащую все символы, заданные параметрами beginIndex и endIndex.	TextSnapshot
		getTextRunInfo(beginIndex:int, endIndex:int):Array Возвращает массив объектов, содержащий сведения о непрерывной последовательности текста.	TextSnapshot
		hasOwnProperty(name:String):Boolean Показывает, определено ли заданное свойство для объекта.	Object
		hitTestTextNearPos(x:Number, y:Number, maxDistance:Number = 0):Number Позволяет определить, какой символ в пределах объекта TextSnapshot находится в точке с заданными координатами x, y или рядом с ней во фрагменте ролика, содержащем текст в объекте TextSnapshot.	TextSnapshot
		isPrototypeOf(theClass:Object):Boolean Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра.	Object
		propertyIsEnumerable(name:String):Boolean Показывает наличие заданного свойства и его перечисляемость.	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Задает доступность динамического свойства для операций цикла.	Object
		setSelectColor(hexColor:uint = 0xFFFF00):void Задает цвет для выделения символов, выбранных с помощью метода setSelected().	TextSnapshot
		setSelected(beginIndex:int, endIndex:int, select:Boolean):void Задает диапазон символов в объекте TextSnapshot для выбора или отмены выбора.	TextSnapshot
		toLocaleString():String Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали.	Object
		toString():String Возвращает строковое представление заданного объекта.	Object
		valueOf():Object Возвращает элементарное значение заданного объекта.	Object

Сведения о свойстве

charCount

свойство

charCount:int [только для чтения]

Язык версии:

ActionScript 3.0

Версии среды выполнения:

AIR 1.0, Flash Player 9, Flash Lite 4

Число знаков в объекте TextSnapshot.

Реализация
public function get charCount():int

Связанные элементы API

flash.text.TextSnapshot.getText()

Сведения о методе

findText

()

метод

public function findText(beginIndex:int, textToFind:String, caseSensitive:Boolean):int

Язык версии:

ActionScript 3.0

Версии среды выполнения:

AIR 1.0, Flash Player 9, Flash Lite 4

Выполняет поиск по объекту TextSnapshot и возвращает положение первого вхождения textToFind, обнаруженного в положении beginIndex или после него. Если значение textToFind не найдено, метод возвращает -1.

Параметры

	`beginIndex:int` — Задает начальную точку для поиска заданного текста.

	`textToFind:String` — Задает искомый текст. Если вместо переменной типа String задается литерал строки, то строку необходимо заключить в кавычки.

	`caseSensitive:Boolean` — Указывает, должен ли при поиске учитываться регистр текста строки в `textToFind`.

Возвращает

int — Отсчитываемая от нуля позиция индекса первого вхождения заданного текста или -1.

Связанные элементы API

flash.text.TextSnapshot.getText()

getSelected

()

метод

public function getSelected(beginIndex:int, endIndex:int):Boolean

Язык версии:

ActionScript 3.0

Версии среды выполнения:

AIR 1.0, Flash Player 9, Flash Lite 4

Возвращает логическое значение, показывающее, содержит ли объект TextSnapshot выделенный текст в заданном диапазоне.

Чтобы выполнить поиск по всем символам, передайте значение 0 для start и charCount (или любое очень большое число) для end. Чтобы выполнить поиск по одному символу, передайте параметру end значение, которое на одну единицу больше параметра start.

Параметры

	`beginIndex:int` — Указывает позицию первого рассматриваемого символа. Допустимые значения `beginIndex` находятся в диапазоне от `0` до `TextSnapshot.charCount - 1`. Если в качестве `beginIndex` выбрано отрицательное значение, используется `0` .

	`endIndex:int` — Значение, которое на одну единицу больше индекса последнего рассматриваемого символа. Действительные значения параметра `endIndex` лежат в диапазоне от `0` до `charCount`. Символ, индексированный параметром `endIndex`, не включен в извлеченную строку. Если этот параметр пропустить, используется параметр `charCount`. Если это значение меньше или равно значению `beginIndex`, используется `beginIndex + 1`.

Возвращает

Boolean — Логическое значение, показывающее, выделен ли хотя бы один символ в данном диапазоне соответствующим методом setSelected() (true); если нет, значение - false.

Связанные элементы API

flash.text.TextSnapshot.charCount
flash.text.TextSnapshot.getText()
flash.text.TextSnapshot.getSelectedText()
flash.text.TextSnapshot.setSelected()

getSelectedText

()

метод

public function getSelectedText(includeLineEndings:Boolean = false):String

Язык версии:

ActionScript 3.0

Версии среды выполнения:

AIR 1.0, Flash Player 9., Flash Lite 4

Возвращает строку, содержащую все символы, заданные соответствующим методом setSelected(). Если символы не заданы (методом setSelected()), возвращается пустая строка.

Если параметр includeLineEndings имеет значение true, символы новой строки вставляются в возвращаемую строку, которая может оказаться длиннее, чем введенный диапазон. Если параметр includeLineEndings имеет значение false или опущен, метод возвращает выделенный текст, не добавляя никаких символов.

Параметры

includeLineEndings:Boolean (default = false) — Необязательное логическое значение, указывающее, вставляются ли символы новой строки в возвращенную строку, где это уместно. Значение по умолчанию false.

Возвращает

String — Строка, содержащая все символы, заданные соответствующим методом setSelected().

Связанные элементы API

flash.text.TextSnapshot.getSelected()
flash.text.TextSnapshot.setSelected()

getText

()

метод

public function getText(beginIndex:int, endIndex:int, includeLineEndings:Boolean = false):String

Язык версии:

ActionScript 3.0

Версии среды выполнения:

AIR 1.0, Flash Player 9., Flash Lite 4

Возвращает строку, содержащую все символы, заданные параметрами beginIndex и endIndex. Если нет выделенных символов, возвращается пустая строка.

Чтобы метод вернул все символы, передайте значение 0 для beginIndex и charCount (или любое очень большое число) для endIndex. Чтобы метод вернул один символ, передайте значение beginIndex + 1 для параметра endIndex.

Если передать значение true параметру includeLineEndings, в возвращаемую строку вставляются символы новой строки, где это требуется. В данном случае возвращенная строка может быть длиннее введенного диапазона. Если параметр includeLineEndings имеет значение false или опущен, выделенный текст возвращается без дополнительных символов.

Параметры

	`beginIndex:int` — Указывает позицию первого символа, который должен быть включен в возвращаемую строку. Действительные значения параметра `beginIndex` лежат в диапазоне от `0` до `charCount - 1`. Если в качестве `beginIndex` выбрано отрицательное значение, используется `0` .

	`endIndex:int` — Значение, которое на одну единицу больше индекса последнего рассматриваемого символа. Действительные значения параметра `endIndex` лежат в диапазоне от `0` до `charCount`. Символ, индексированный параметром `endIndex`, не включен в извлеченную строку. Если этот параметр пропустить, используется параметр `charCount`. Если это значение меньше или равно значению `beginIndex`, используется `beginIndex + 1`.

	`includeLineEndings:Boolean` (default = `false`) — Необязательное логическое значение, которое указывает, вставляются символы новой строки (`true`) или нет (`false`) в возвращаемую строку. Значение по умолчанию `false`.

Возвращает

String — Строка, содержащая символы заданного диапазона, или пустая строка, если в этом диапазоне нет символов.

Связанные элементы API

flash.text.TextSnapshot.charCount
flash.text.TextSnapshot.getSelectedText()

getTextRunInfo

()

метод

public function getTextRunInfo(beginIndex:int, endIndex:int):Array

Язык версии:

ActionScript 3.0

Версии среды выполнения:

AIR 1.0, Flash Player 9, Flash Lite 4

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

Примечание. При использовании метода getTextRunInfo() для большого диапазона текста может быть возвращен большой объект. Adobe рекомендует ограничивать диапазон текста параметрами beginIndex и endIndex.

Параметры

	`beginIndex:int` — Значение индекса первого символа в диапазоне в объекте TextSnapshot.

	`endIndex:int` — Значение индекса последнего символа в диапазоне в объекте TextSnapshot.

Возвращает

Array — Массив объектов, каждый из которых содержит сведения о конкретном символе в диапазоне, заданном параметрами beginIndex и endIndex. Каждый объект содержит следующие одиннадцать свойств.

Свойство indexInRun — отсчитываемый от нуля индекс символа, представленный целым числом (определяется относительно всей строки, а не выделенного фрагмента текста).
Свойство selected — логическое значение, указывающее на то, что символ выделен true или не выделен false.
Свойство font — имя шрифта символа.
Свойство color — комбинированное значение прозрачности и цвета для символа. Первые две шестнадцатеричные цифры представляют альфа-значение, а остальные - цвет.
Свойство height — высота символа (в пикселях).
Свойства matrix_a, matrix_b, matrix_c, matrix_d, matrix_tx и matrix_ty — значения матрицы, определяющие геометрическое преобразование символа. Обычный вертикальный текст всегда имеет матрицу вида [1 0 0 1 x y], где x и y - это позиция символа в родительском фрагменте ролика независимо от высоты текста. Матрица находится в системе координат родительского фрагмента ролика и не включает преобразований, которые может иметь сам фрагмент ролика (или его родительский элемент).
Свойства corner0x, corner0y, corner1x, corner1y, corner2x, corner2y, corner3x и corner3y — углы ограничительного блока символа на основе системы координат родительского фрагмента ролика. Эти значения доступны, только если используемый символом шрифт встроен в SWF-файл.

Связанные элементы API

Класс Matrix

hitTestTextNearPos

()

метод

public function hitTestTextNearPos(x:Number, y:Number, maxDistance:Number = 0):Number

Язык версии:

ActionScript 3.0

Версии среды выполнения:

AIR 1.0, Flash Player 9., Flash Lite 4

Позволяет определить, какой символ в пределах объекта TextSnapshot находится в точке с заданными координатами x, y или рядом с ней во фрагменте ролика, содержащем текст в объекте TextSnapshot.

Если опустить свойство maxDistance или передать ему значение 0, место, заданное координатами x, y, может находится внутри ограничительного блока объекта TextSnapshot.

Этот метод работает правильно только с шрифтами, включающими информацию о метриках символа. Однако по умолчанию инструмент разработки Flash не включает эту информацию для статически текстовых полей. По этой причине метод может вернуть -1 вместо значения индекса. Чтобы гарантировать возврат значения индекса, можно заставить инструмент разработки Flash включать для шрифта информацию о метриках символов. Для этого нужно добавить динамическое текстовое поле, использующее данный шрифт, выбрать параметры символа для этого поля и затем указать, что контуры шрифта, должны быть встроены хотя бы для одного символа. (Не имеет значения, какие заданы символы и используются ли они в статическом текстовом поле.)

Параметры

	`x:Number` — Число, представляющее координату `x` фрагмента ролика, содержащего текст.

	`y:Number` — Число, представляющее координату `y` фрагмента ролика, содержащего текст.

	`maxDistance:Number` (default = `0`) — (Необязательно) число, представляющее максимальное расстояние от точки с координатами `x`, `y`, на котором может выполняться поиск текста. Расстояние отмеряется от центральной точки каждого символа. По умолчанию используется значение `0`.

Возвращает

Number — Число, представляющее значение индекса символа, который находится ближе остальных к заданной точке с координатами x, y. Возвращает -1, если такой символ не найден, либо если шрифт не содержит информации о метриках символа.

Связанные элементы API

flash.display.DisplayObject.x
flash.display.DisplayObject.y

setSelectColor

()

метод

public function setSelectColor(hexColor:uint = 0xFFFF00):void

Язык версии:

ActionScript 3.0

Версии среды выполнения:

AIR 1.0, Flash Player 9., Flash Lite 4

Задает цвет для выделения символов, выбранных с помощью метода setSelected(). Цвет всегда непрозрачный. Значение прозрачности задать нельзя.

Этот метод работает правильно только с шрифтами, включающими информацию о метриках символа. Однако по умолчанию инструмент разработки Flash не включает эту информацию для статически текстовых полей. По этой причине метод может вернуть -1 вместо значения индекса.Чтобы гарантировать возврат значения индекса, можно заставить инструмент разработки Flash включать для шрифта информацию о метриках символов. Для этого нужно добавить динамическое текстовое поле, использующее данный шрифт, выбрать параметры символа для этого поля и затем указать, что контуры шрифта, должны быть встроены хотя бы для одного символа. (Не имеет значения, какие заданы символы и используются ли они в статическом текстовом поле.)

Параметры

hexColor:uint (default = 0xFFFF00) — Шестнадцатеричное значение цвета, используемый для рамки вокруг символов, выбранных соответствующей командой setSelected() (0xRRGGBB).

Связанные элементы API

flash.text.TextSnapshot.setSelected()

setSelected

()

метод

public function setSelected(beginIndex:int, endIndex:int, select:Boolean):void

Язык версии:

ActionScript 3.0

Версии среды выполнения:

AIR 1.0, Flash Player 9., Flash Lite 4

Задает диапазон символов в объекте TextSnapshot для выбора или отмены выбора. Выделенные символы помечаются цветным фоном по размеру их ограничительного блока. Цвет ограничительного блока определяется методом setSelectColor().

Чтобы метод выделил все символы или отменил выделение всех символом, передайте значение 0 для beginIndex и charCount (или любое очень большое число) для endIndex. Чтобы задать один символ, передайте значение beginIndex + 1 для параметра endIndex.

Так как символы помечаются или выделяются по отдельности, этот метод можно вызывать несколько раз для выделения нескольких символов. Другими словами, этот метод не отменяет выделение с других, уже обработанных им символов.

Цветной прямоугольник, обозначающий выделение, отображается только для шрифтов, содержащих информацию о метриках символов. По умолчанию Flash не включает эту информацию для статических текстовых полей. В некоторых случаях такое поведение приводит к тому, что выбранный текст не имеет признаков выделения на экране.Чтобы весь выбранный текст был соответствующим образом выделен, необходимо заставить инструмент разработки Flash включать для шрифта информацию о метриках символов. Для этого нужно добавить динамическое текстовое поле, использующее данный шрифт, выбрать параметры символа для этого поля и затем указать, что контуры шрифта, должны быть встроены хотя бы для одного символа. Не имеет значения, какие заданы символы и используются ли они в статическом текстовом поле.

Параметры

	`beginIndex:int` — Указывает позицию первого символа для выделения. Действительные значения параметра `beginIndex` лежат в диапазоне от `0` до `charCount - 1`. Если в качестве `beginIndex` выбрано отрицательное значение, используется `0` .

	`endIndex:int` — Целое число, которое на одну единицу больше индекса последнего рассматриваемого символа. Действительные значения параметра `end` лежат в диапазоне от `0` до `charCount`. Символ, индексированный параметром `end`, не включен в извлеченную строку. Если этот параметр пропущен, используется `TextSnapshot.charCount`. Если значение `endIndex` меньше или равно значению `beginIndex`, используется `beginIndex + 1`.

	`select:Boolean` — Логическое значение, указывающее, должен текст выделяться (`true`) или нет (`false`).

Связанные элементы API

flash.text.TextSnapshot.charCount
flash.text.TextSnapshot.setSelectColor()

Юридическая информация | Политика конфиденциальности онлайн

TextSnapshot - AS3

Пакетыx

Элементы языка

Приложения

Пакет flash.text

charCount

findText

getSelected

getSelectedText

getText

getTextRunInfo

hitTestTextNearPos

setSelectColor

setSelected