Пакет | mx.core |
Интерфейс | public interface IUITextField extends IIMESupport , IFlexModule , IInvalidating , ISimpleStyleClient , IToolTipManagerClient , IUIComponent , IFlexDisplayObject , IFlexDisplayObject , IBitmapDrawable , IEventDispatcher |
Средство реализации | UIFTETextField, UITextField |
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Свойство | Определено | ||
---|---|---|---|
accessibilityProperties : AccessibilityProperties
Текущие параметры специальных возможностей для данного экранного объекта. | IFlexDisplayObject | ||
alpha : Number
Указывает значение альфа-прозрачности заданного объекта. | IFlexDisplayObject | ||
alwaysShowSelection : Boolean
При значении true и отсутствии фокуса на текстовом поле проигрыватель Flash Player выделяет фрагмент в текстовом поле серым цветом. | IUITextField | ||
antiAliasType : String
Тип сглаживания, применяемый для данного текстового поля. | IUITextField | ||
autoSize : String
Управляет автоматической настройкой размеров и выравниванием текстовых полей. | IUITextField | ||
background : Boolean
Указывает, используется ли в текстовом поле фоновая заливка. | IUITextField | ||
backgroundColor : uint
Цвет фона текстового поля. | IUITextField | ||
baselinePosition : Number [только для чтения]
Координата Y базовой линии первой строки текста компонента. | IUIComponent | ||
blendMode : String
Значение класса BlendMode, задающее режим наложения. | IFlexDisplayObject | ||
border : Boolean
Указывает, есть ли у текстового поля рамка. | IUITextField | ||
borderColor : uint
Цвет рамки текстового поля. | IUITextField | ||
bottomScrollV : int [только для чтения]
Целое число (индекс, отсчитываемый от 1), соответствующее самой нижней строке, которую видно в заданном текстовом поле. | IUITextField | ||
cacheAsBitmap : Boolean
При значении true среда выполнения Flash кэширует внутреннее растровое представление экранного объекта. | IFlexDisplayObject | ||
caretIndex : int [только для чтения]
Индекс точки вставки (каре). | IUITextField | ||
condenseWhite : Boolean
Логическое значение, определяющее, следует ли удалять лишние разделители (пробелы, разрывы строк и т.д.) в текстовом поле с текстом HTML. | IUITextField | ||
defaultTextFormat : flash.text:TextFormat
Определяет формат, применяемый к новому вставленному тексту, такому как тексту, введенному пользователем, или тексту, вставленному с использованием метода replaceSelectedText(). | IUITextField | ||
displayAsPassword : Boolean
Показывает, является ли текстовое поле полем пароля. | IUITextField | ||
document : Object
Ссылка на объект документа, связанный с этим компонентом. | IUIComponent | ||
doubleClickEnabled : Boolean
Определяет, получает ли объект события doubleClick. | IUITextField | ||
embedFonts : Boolean
Определяет, должна ли выполняться визуализация с использованием структур встроенных шрифтов. | IUITextField | ||
enabled : Boolean
Возможность использования компонента пользователем. | IUIComponent | ||
enableIME : Boolean [только для чтения]
Указывает, нужно ли активировать IME, если этот компонент имеет фокус. | IIMESupport | ||
explicitHeight : Number
Явно указанная высота для компонента в пикселях в виде координат компонента. | IUIComponent | ||
explicitMaxHeight : Number [только для чтения]
Число, указывающее максимальную высоту компонента в пикселях в виде координат компонента. | IUIComponent | ||
explicitMaxWidth : Number [только для чтения]
Число, указывающее максимальную ширину компонента в пикселях в виде координат компонента. | IUIComponent | ||
explicitMinHeight : Number [только для чтения]
Число, указывающее минимальную высоту компонента в пикселях в виде координат компонента. | IUIComponent | ||
explicitMinWidth : Number [только для чтения]
Число, указывающее минимальную ширину компонента в пикселях в виде координат компонента. | IUIComponent | ||
explicitWidth : Number
Явно указанная ширина для компонента в пикселях в виде координат компонента. | IUIComponent | ||
filters : Array
Индексированный массив, который содержит все объекты filter, связанные в настоящий момент с экранным объектом. | IFlexDisplayObject | ||
focusPane : Sprite
Один объект Sprite, распределенный между компонентами и используемый в качестве перекрытия для отображения индикатора фокуса. | IUIComponent | ||
focusRect : Object
Задает отображение прямоугольной рамки индикатора фокуса для данного объекта. | IUITextField | ||
gridFitType : String
Тип подгонки к сетке, применяемый для этого текстового поля. | IUITextField | ||
height : Number
Указывает высоту экранного объекта в пикселях. | IFlexDisplayObject | ||
htmlText : String
Содержит HTML-представление содержимого текстового поля. | IUITextField | ||
ignorePadding : Boolean
Если значение равно true, стили paddingLeft и paddingRight не будут оставлять промежуток вокруг текста компонента. | IUITextField | ||
imeMode : String
Режим IME для компонента. | IIMESupport | ||
includeInLayout : Boolean
Указывает, включается ли этот компонент в макет вышестоящего контейнера. | IUIComponent | ||
inheritingStyles : Object
Начало цепочки UITextField с ненаследуемыми стилями. | IUITextField | ||
isPopUp : Boolean
Установите значение true в PopUpManager для указания того, что компонент имеет всплывающую подсказку. | IUIComponent | ||
length : int [только для чтения]
Число символов в текстовом поле. | IUITextField | ||
loaderInfo : LoaderInfo [только для чтения]
Возвращает объект LoaderInfo, содержащий сведения о загрузке файла, к которому принадлежит этот экранный объект. | IFlexDisplayObject | ||
mask : DisplayObject
Вызывающий экранный объект маскируется заданным объектом mask. | IFlexDisplayObject | ||
maxChars : int
Введенное пользователем максимальное число символов, которое может содержать текстовое поле. | IUITextField | ||
maxHeight : Number [только для чтения]
Число, указывающее максимальную высоту компонента в пикселях в виде координат компонента. | IUIComponent | ||
maxScrollH : int [только для чтения]
Максимальное значение scrollH. | IUITextField | ||
maxScrollV : int [только для чтения]
Максимальное значение scrollV. | IUITextField | ||
maxWidth : Number [только для чтения]
Число, указывающее максимальную ширину компонента в пикселях в виде координат компонента. | IUIComponent | ||
measuredHeight : Number [только для чтения]
Рассчитанная высота этого объекта. | IFlexDisplayObject | ||
measuredMinHeight : Number
Минимальная высота компонента по умолчанию в пикселях. | IUIComponent | ||
measuredMinWidth : Number
Минимальная ширина компонента по умолчанию в пикселях. | IUIComponent | ||
measuredWidth : Number [только для чтения]
Измеренная ширина этого объекта. | IFlexDisplayObject | ||
minHeight : Number [только для чтения]
Число, указывающее минимальную высоту компонента в пикселях в виде координат компонента. | IUIComponent | ||
minWidth : Number [только для чтения]
Число, указывающее минимальную ширину компонента в пикселях в виде координат компонента. | IUIComponent | ||
mouseEnabled : Boolean
Определяет, получает ли этот объект события мыши или другого пользовательского ввода. | IUITextField | ||
mouseWheelEnabled : Boolean
Логическое значение, определяющее, выполняет ли проигрыватель Flash Player автоматическую прокрутку многострочных текстовых полей, когда пользователь щелкает текстовое поле и вращает колесико мыши. | IUITextField | ||
mouseX : Number [только для чтения]
Указывает координату x мыши или курсора пользовательского ввода (в пикселях). | IFlexDisplayObject | ||
mouseY : Number [только для чтения]
Указывает координату y мыши или курсора пользовательского ввода (в пикселях). | IFlexDisplayObject | ||
multiline : Boolean
Показывает, является ли текстовое поле многострочным. | IUITextField | ||
name : String
Указывает имя экземпляра DisplayObject. | IFlexDisplayObject | ||
nestLevel : int
Глубина этого объекта в иерархии включения. | IUITextField | ||
nonInheritingStyles : Object
Начало цепочки UITextField с ненаследуемыми стилями. | IUITextField | ||
nonZeroTextHeight : Number [только для чтения]
В отличие от textHeight, этот элемент возвращает ненулевое значение даже при пустом тексте. | IUITextField | ||
numLines : int [только для чтения]
Определяет число строк текста в многострочном текстовом поле. | IUITextField | ||
opaqueBackground : Object
Определяет, является ли экранный объект непрозрачным с определенным цветом фона. | IFlexDisplayObject | ||
owner : DisplayObjectContainer
Владелец этого объекта IVisualElement. | IUIComponent | ||
parent : DisplayObjectContainer [только для чтения]
Указывает объект DisplayObjectContainer, содержащий данный экранный объект. | IFlexDisplayObject | ||
percentHeight : Number
Число, указывающее высоту компонента в виде процента от размера вышестоящего элемента. | IUIComponent | ||
percentWidth : Number
Число, указывающее ширину компонента в процентах от размера его вышестоящего элемента. | IUIComponent | ||
restrict : String
Определяет набор символов, которые могут быть введены пользователем в текстовом поле. | IUITextField | ||
root : DisplayObject [только для чтения]
В случае с экранным объектом в загруженном SWF-файле свойством root является самый верхний экранный объект в части структуры дерева списка отображения, представленной этим SWF-файлом. | IFlexDisplayObject | ||
rotation : Number
Указывает поворот экземпляра DisplayObject относительно его исходной ориентации (в градусах). | IFlexDisplayObject | ||
scale9Grid : Rectangle
Текущая активная сетка масштабирования. | IFlexDisplayObject | ||
scaleX : Number
Указывает горизонтальное масштабирование объекта от точки регистрации (в процентах). | IFlexDisplayObject | ||
scaleY : Number
Указывает вертикальное масштабирование объекта от точки регистрации (в процентах). | IFlexDisplayObject | ||
scrollH : int
Текущее положение горизонтальной прокрутки. | IUITextField | ||
scrollRect : Rectangle
Прямоугольная область прокрутки экранного объекта. | IFlexDisplayObject | ||
scrollV : int
Вертикальное положение текста в текстовом поле. | IUITextField | ||
selectable : Boolean
Логическое значение, определяющее, можно ли выбрать текстовое поле. | IUITextField | ||
selectionBeginIndex : int [только для чтения]
Отсчитываемое от нуля значение индекса для первого символа в текущем выделенном фрагменте. | IUITextField | ||
selectionEndIndex : int [только для чтения]
Отсчитываемое от нуля значение индекса для последнего символа в текущем выделенном фрагменте. | IUITextField | ||
sharpness : Number
Четкость контуров символов в этом текстовом поле. | IUITextField | ||
stage : Stage [только для чтения]
Класс Stage экранного объекта. | IFlexDisplayObject | ||
styleName : Object
Источник значений стиля данного объекта. | ISimpleStyleClient | ||
styleSheet : StyleSheet
Присоединяет таблицу стилей к текстовому полю. | IUITextField | ||
systemManager : ISystemManager
Ссылка на объект SystemManager для этого компонента. | IUIComponent | ||
tabEnabled : Boolean
Определяет, включен ли переход к этому объекту с помощью клавиши Tab. | IUITextField | ||
tabIndex : int
Задает последовательность перехода между объектами в SWF-файле. | IUITextField | ||
text : String
Строка, представляющая текущий текст в текстовом поле. | IUITextField | ||
textColor : uint
Цвет текста в текстовом поле (в шестнадцатеричном формате). | IUITextField | ||
textHeight : Number [только для чтения]
Высота текста в пикселях. | IUITextField | ||
textWidth : Number [только для чтения]
Ширина текста в пикселях. | IUITextField | ||
thickness : Number
Толщина контуров символов в данном текстовом поле. | IUITextField | ||
toolTip : String
Текст всплывающей подсказки данного компонента. | IToolTipManagerClient | ||
transform : flash.geom:Transform
Объект со свойствами, относящимися к матрице, преобразованию цвета и пиксельным границам экранного объекта. | IFlexDisplayObject | ||
tweeningProperties : Array
Используется EffectManager. | IUIComponent | ||
type : String
Тип текстового поля. | IUITextField | ||
useRichTextClipboard : Boolean
Определяет, будет ли форматирование текста копироваться и вставляться вместе с самим текстом. | IUITextField | ||
visible : Boolean
Определяет видимость экранного объекта. | IFlexDisplayObject | ||
width : Number
Указывает ширину экранного объекта в пикселях. | IFlexDisplayObject | ||
wordWrap : Boolean
Логическое значение, определяющее применение переноса по словам к текстовому полю. | IUITextField | ||
x : Number
Указывает координату x экземпляра DisplayObject, связанную с локальными координатами родительского DisplayObjectContainer. | IFlexDisplayObject | ||
y : Number
Указывает координату y экземпляра DisplayObject, связанную с локальными координатами родительского DisplayObjectContainer. | IFlexDisplayObject |
Метод | Определено | ||
---|---|---|---|
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Регистрирует объект прослушивателя события на объекте EventDispatcher для получения прослушивателем уведомления о событии. | IEventDispatcher | ||
Добавляет строку, указанную параметром newText, в конец текста в текстовом поле. | IUITextField | ||
Посылает событие в поток событий. | IEventDispatcher | ||
Возвращает прямоугольник, определяющий область объекта отображения, которая относится к системе координат объекта targetCoordinateSpace. | IFlexDisplayObject | ||
Возвращает прямоугольник, который является ограничительным блоком символа. | IUITextField | ||
Возвращает значение индекса, отсчитываемое от нуля, для символа в точке, определенной параметрами x и y. | IUITextField | ||
Стандартный метод, позволяющий определить, использовать ли явную или измеренную высоту
| IUIComponent | ||
Стандартный метод, позволяющий определить, использовать ли явную или измеренную ширину
| IUIComponent | ||
Получив индекс символа, возвращает индекс первого символа в том же абзаце. | IUITextField | ||
Возвращает ссылку DisplayObject для данного идентификатора, изображения или SWF-файла, добавленного в текстовое поле с форматированием HTML с помощью тега <img>. | IUITextField | ||
Возвращает значение индекса, отсчитываемое от нуля, для строки в точке с координатами x и y. | IUITextField | ||
Отсчитываемое от нуля значение индекса для строки, которая содержит символ, заданный параметром charIndex. | IUITextField | ||
Возвращает число символов в заданной строке текста. | IUITextField | ||
Возвращает данные метрик для заданной строки текста. | IUITextField | ||
Возвращает индекс первого символа в строке, заданной параметром lineIndex. | IUITextField | ||
Возвращает текст строки, заданной параметром lineIndex. | IUITextField | ||
Используя полученный индекс символа, возвращает длину абзаца, содержащего этот символ. | IUITextField | ||
Возвращает прямоугольник, определяющий границу объекта отображения по системе координат, определенной параметром targetCoordinateSpace за исключением линий фигур. | IFlexDisplayObject | ||
Получает свойство style, которое было установлено в любом месте в пределах цепочки поиска стиля этого компонента. | IUITextField | ||
Возвращает объект TextFormat, содержащий данные о форматировании для фрагмента текста, заданного параметрами beginIndex и endIndex. | IUITextField | ||
Возвращает объект UITextFormat, содержащий сведения о форматировании этого компонента. | IUITextField | ||
Преобразует объект Point из координат рабочей области (глобальных) в координаты отображаемого объекта (локальные). | IFlexDisplayObject | ||
Проверяет, имеет ли объект EventDispatcher прослушиватели, зарегистрированные для определенного типа события. | IEventDispatcher | ||
Вычисляет ограничительную рамку экранного объекта, чтобы определить, не перекрывает и не пересекает ли она ограничительную рамку экранного объекта obj. | IFlexDisplayObject | ||
Вычисляет экранный объект, чтобы определить, перекрывает ли он точку, заданную координатами x и y, или пересекает ее. | IFlexDisplayObject | ||
Инициализация объекта. | IUIComponent | ||
Вызов метода приводит к вызову метода validateDisplayList() компонента до визуализации списка отображения. | IInvalidating | ||
Выполнение вызова этого метода приводит к вызову метода validateProperties() компонента до визуализации списка отображения. | IInvalidating | ||
Вызов этого метода приводит к вызову метода validateSize() компонента до визуализации списка отображения. | IInvalidating | ||
Преобразует объект Point из координат экранного объекта (локальных) в координаты рабочей области (глобальные). | IFlexDisplayObject | ||
Перемещает этот объект по указанным координатам осей x и y. | IFlexDisplayObject | ||
Возвращает значение true, если цепочка свойств owner направлена от child к этому UIComponent. | IUIComponent | ||
Вызывается Flex при добавлении или удалении объекта UIComponent из вышестоящего элемента. | IUIComponent | ||
Удаляет прослушиватель из объекта EventDispatcher. | IEventDispatcher | ||
Заменяет текущий выделенный фрагмент содержимым параметра value. | IUITextField | ||
Заменяет диапазон символов, заданный параметрами beginIndex и endIndex, содержанием параметра newText. | IUITextField | ||
Устанавливает фактический размер для этого объекта. | IFlexDisplayObject | ||
Задает цвет шрифта для текста. | IUITextField | ||
Задает фокус на этот компонент. | IUITextField | ||
Задает способ разметки текста с помощью индексов первого и последнего символов, которые указываются параметрами beginIndex и endIndex | IUITextField | ||
Применяет форматирование текста, заданное параметром format, к указанному содержимому текстового поля. | IUITextField | ||
Вызывается при изменении свойства visible. | IUIComponent | ||
Вызывается при изменении значения свойства стиля. | ISimpleStyleClient | ||
Усекает текст для его полного горизонтального размещения в области, определенной для элемента управления, и присоединяет к тексту многоточие (...). | IUITextField | ||
Проверяет и обновляет свойства и макет этого объекта посредством немедленного вызова методов validateProperties(), validateSize() и validateDisplayList(), если необходимо. | IInvalidating | ||
Проверяет, зарегистрирован ли прослушиватель события для указанного типа события с данным объектом EventDispatcher или любым его предшественником. | IEventDispatcher |
alwaysShowSelection | свойство |
alwaysShowSelection:Boolean
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
При значении true
и отсутствии фокуса на текстовом поле проигрыватель Flash Player выделяет фрагмент в текстовом поле серым цветом. При значении false
и отсутствии фокуса на текстовом поле проигрыватель Flash Player не выделяет фрагмент в текстовом поле.
Реализация
public function get alwaysShowSelection():Boolean
public function set alwaysShowSelection(value:Boolean):void
antiAliasType | свойство |
antiAliasType:String
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Тип сглаживания, применяемый для данного текстового поля. Используйте константы flash.text.AntiAliasType
для этого свойства. Этим параметром можно управлять, только если используется встроенный шрифт (свойство embedFonts
имеет значение true
). Параметр по умолчанию — flash.text.AntiAliasType.NORMAL
.
В качестве значений этого свойства используйте следующие строковые значения:
Строковое значение | Описание |
---|---|
flash.text.AntiAliasType.NORMAL | Применяет обычное сглаживание текста. Значение соответствует типу сглаживания, который использовался в проигрывателе Flash Player 7 и более ранних версиях. |
flash.text.AntiAliasType.ADVANCED | Применяет расширенное сглаживание, которое делает текст более четким. (Эта функция стала доступной в проигрывателе Flash Player 8.) Расширенное сглаживание обеспечивает высококачественную визуализацию шрифтов мелкого размера. Оно оптимально для приложений с большим объемом мелкого текста. Расширенное сглаживание не рекомендуется для шрифтов больше 48 размера. |
Реализация
public function get antiAliasType():String
public function set antiAliasType(value:String):void
autoSize | свойство |
autoSize:String
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Управляет автоматической настройкой размеров и выравниванием текстовых полей. Допустимые значения констант TextFieldAutoSize
: TextFieldAutoSize.NONE
(по умолчанию), TextFieldAutoSize.LEFT
, TextFieldAutoSize.RIGHT
и TextFieldAutoSize.CENTER
.
Если autoSize
имеет значение TextFieldAutoSize.NONE
(по умолчанию) размер не изменяется.
Если autoSize
имеет значение TextFieldAutoSize.LEFT
, тексту задается выравнивание по левому краю, то есть левое поле текста остается неподвижным и изменение размера одной строки текстового поля осуществляется по правому полю. Если в тексте встречается разрыв строки (например, \n
или \r
), размер нижнего края также изменяется, чтобы вместить следующую строку текста. Если свойство wordWrap
также имеет значение true
, размер текстового поля изменяется только по нижнему краю, а правый край остается фиксированным.
Если autoSize
имеет значение TextFieldAutoSize.RIGHT
, тексту задается выравнивание по правому краю, то есть правое поле текста остается неподвижным и изменение размера одной строки текстового поля осуществляется по левому полю. Если в тексте встречается разрыв строки (например, \n или \r
), размер нижнего края также изменяется, чтобы вместить следующую строку текста. Если свойство wordWrap
также имеет значение true
, размер текстового поля изменяется только по нижнему краю, а левый край остается фиксированным.
Если autoSize
имеет значение TextFieldAutoSize.CENTER
, текст обрабатывается с учетом выравнивания по центру, то есть изменение размера одной строки текстового поля равномерно распределяется по правому и левому полям. Если в тексте встречается разрыв строки (например, \n
или \r
), размер нижнего края также изменяется, чтобы вместить следующую строку текста. Если свойство wordWrap
также имеет значение true
, размер текстового поля изменяется только по нижнему краю, а левый и правый края остаются фиксированными.
Реализация
public function get autoSize():String
public function set autoSize(value:String):void
background | свойство |
background:Boolean
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Указывает, используется ли в текстовом поле фоновая заливка. При значении true
фоновая заливка текстового поля используется. При значении false
фоновая заливка текстового поля не используется. Цвет фона для текстового поля задается с помощью свойства backgroundColor
.
Реализация
public function get background():Boolean
public function set background(value:Boolean):void
backgroundColor | свойство |
backgroundColor:uint
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Цвет фона текстового поля. Значение по умолчанию — 0xFFFFFF
(белый). Это свойство можно получить или задать, даже если в настоящее время фона нет, однако цвет будет видимым, только если свойству background
текстового поля задано значение true
.
Реализация
public function get backgroundColor():uint
public function set backgroundColor(value:uint):void
border | свойство |
border:Boolean
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Указывает, есть ли у текстового поля рамка. При значении true
текстовое поле имеет рамку. При значении false
текстовое поле не имеет рамки. Цвет рамки задается с помощью свойства borderColor
.
Реализация
public function get border():Boolean
public function set border(value:Boolean):void
borderColor | свойство |
borderColor:uint
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Цвет рамки текстового поля. Значение по умолчанию — 0x000000
(черный). Это свойство можно получить или задать, даже если в настоящее время рамки нет, однако цвет будет видимым, только если свойству border
текстового поля задано значение true
.
Реализация
public function get borderColor():uint
public function set borderColor(value:uint):void
bottomScrollV | свойство |
bottomScrollV:int
[только для чтения] Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Целое число (индекс, отсчитываемый от 1), соответствующее самой нижней строке, которую видно в заданном текстовом поле. Представьте, что текстовое поле — это окно на блоке текста. Свойство scrollV
представляет собой отсчитываемый от единицы индекс самой верхней видимой строки в окне.
Весь текст между линиями, заданными параметрами scrollV
и bottomScrollV
в данный момент отображается в текстовом поле.
Реализация
public function get bottomScrollV():int
caretIndex | свойство |
caretIndex:int
[только для чтения] Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Индекс точки вставки (каре). Если точка вставки не отображается, значением является положение, которое она бы занимала, если бы поле было в фокусе (обычно это последнее место вставки или 0, если поле не было в фокусе).
Индексы выделенного фрагмента отсчитываются от нуля (например, первая позиция — 0, вторая — 1 и т. д.).
Реализация
public function get caretIndex():int
condenseWhite | свойство |
condenseWhite:Boolean
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Логическое значение, определяющее, следует ли удалять лишние разделители (пробелы, разрывы строк и т.д.) в текстовом поле с текстом HTML. Значение по умолчанию false
. Свойство condenseWhite
влияет только на текст, определенный с помощью свойства htmlText
, а не с помощью свойства text
. Если текст определен посредством свойства text
, condenseWhite
игнорируется.
Если свойству condenseWhite
присваивается значение true
, необходимо использовать стандартные команды HTML (например, <BR>
и <P>
), чтобы поместить в текстовое поле разрывы строк.
Свойство condenseWhite
задается перед свойством htmlText
.
Реализация
public function get condenseWhite():Boolean
public function set condenseWhite(value:Boolean):void
defaultTextFormat | свойство |
defaultTextFormat:flash.text:TextFormat
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Определяет формат, применяемый к новому вставленному тексту, такому как тексту, введенному пользователем, или тексту, вставленному с использованием метода replaceSelectedText()
.
Примечание. При выборе символов, которые будут заменены с помощью методов setSelection()
и replaceSelectedText()
, свойство defaultTextFormat
будет применено, только если текст был выделен полностью, включая последний символ. Далее приводится пример:
var my_txt:TextField new TextField(); my_txt.text = "Flash Macintosh version"; var my_fmt:TextFormat = new TextFormat(); my_fmt.color = 0xFF0000; my_txt.defaultTextFormat = my_fmt; my_txt.setSelection(6,15); // partial text selected - defaultTextFormat not applied my_txt.setSelection(6,23); // text selected to end - defaultTextFormat applied my_txt.replaceSelectedText("Windows version");
При обращении к свойству defaultTextFormat
возвращается объект TextFormat, все свойства которого определены. Ни одно из свойств не имеет значения null
.
Примечание. Это свойство невозможно задать, если к текстовому полю применена таблица стилей.
Реализация
public function get defaultTextFormat():flash.text:TextFormat
public function set defaultTextFormat(value:flash.text:TextFormat):void
displayAsPassword | свойство |
displayAsPassword:Boolean
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Показывает, является ли текстовое поле полем пароля. Если это свойство имеет значение true
, текстовое поле обрабатывается как поле ввода пароля и скрывает вводимые символы, показывая звездочки вместо действительных символов. При значении false
текстовое поле не обрабатывается как поле пароля. В режиме пароля команды «Вырезать» и «Копировать», а также соответствующие им комбинации клавиш не работают. Этот механизм защиты не позволяет недобросовестным пользователям использовать комбинации клавиш с целью получения пароля на компьютере, оставленном без присмотра.
Реализация
public function get displayAsPassword():Boolean
public function set displayAsPassword(value:Boolean):void
doubleClickEnabled | свойство |
doubleClickEnabled:Boolean
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Определяет, получает ли объект события doubleClick
. Значение по умолчанию — false
: по умолчанию экземпляр InteractiveObject не получает событий doubleClick
. Если свойству doubleClickEnabled
задано значение true
, экземпляр получает события doubleClick
в своих границах. Свойство mouseEnabled
экземпляра InteractiveObject должно иметь значение true
, чтобы объект мог получать события doubleClick
.
При настройке данного свойства события не отправляются. Чтобы добавить прослушиватель события doubleClick
, необходимо использовать метод addEventListener()
.
Реализация
public function get doubleClickEnabled():Boolean
public function set doubleClickEnabled(value:Boolean):void
embedFonts | свойство |
embedFonts:Boolean
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Определяет, должна ли выполняться визуализация с использованием структур встроенных шрифтов. При значении false
проигрыватель Flash Player визуализирует текстовое поле с использованием шрифтов устройства.
Если свойству embedFonts
текстового поля задано значение true
, необходимо указать для текста шрифт с помощью свойства font
объекта TextFormat, примененного к текстовому полю. Если указанный шрифт не встроен в SWF-файл, текст не отображается.
Реализация
public function get embedFonts():Boolean
public function set embedFonts(value:Boolean):void
focusRect | свойство |
focusRect:Object
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Задает отображение прямоугольной рамки индикатора фокуса для данного объекта. Может принимать одно из трех значений true
, false
или null
. Значения true
и false
дают ожидаемые результаты, определяя, будет ли появляться прямоугольник в фокусе. Значение null
указывает, что данный объект подчиняется свойству stageFocusRect
рабочей области.
Реализация
public function get focusRect():Object
public function set focusRect(value:Object):void
gridFitType | свойство |
gridFitType:String
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Тип подгонки к сетке, применяемый для этого текстового поля. Это свойство применяется, только если свойство flash.text.AntiAliasType
текстового поля имеет значение flash.text.AntiAliasType.ADVANCED
.
Используемый тип подгонки к сетке определяет, подгоняет ли проигрыватель Flash Player жирные горизонтальные или вертикальные линии к пиксельной или субпиксельной сетке, или совсем не выполняет подгонку.
Для свойства flash.text.GridFitType
можно использовать следующие строковые значения.
Строковое значение | Описание |
---|---|
flash.text.GridFitType.NONE | Задает отсутствие подгонки к сетке. Горизонтальные и вертикальные линии в глифах не подгоняются к пиксельной сетке. Этот параметр рекомендуется для анимации или для шрифтов большого размера. |
flash.text.GridFitType.PIXEL | Задает подгонку жирных горизонтальных и вертикальных линий к пиксельной сетке. Этот параметр применяется только к текстовым полям с выравниванием по левому краю. Для использования этого параметра свойство flash.display.AntiAliasType текстового поля должно иметь значение flash.text.AntiAliasType.ADVANCED . Этот параметр, как правило, дает максимальную четкость для текста с выравниванием по левому краю. |
flash.text.GridFitType.SUBPIXEL | Задает подгонку горизонтальных и вертикальных линий к субпиксельной сетке на ЖК-мониторе. Для использования этого параметра свойство flash.text.AntiAliasType текстового поля должно иметь значение flash.text.AntiAliasType.ADVANCED . Параметр flash.text.GridFitType.SUBPIXEL обычно целесообразен для динамического текста с выравниванием по правому краю или по центру и в некоторых случаях позволяет найти оптимальный баланс качеством анимации и текста. |
Реализация
public function get gridFitType():String
public function set gridFitType(value:String):void
htmlText | свойство |
htmlText:String
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Содержит HTML-представление содержимого текстового поля.
Проигрыватель Flash Player поддерживает следующие теги HTML.
Тег | Описание |
---|---|
Тег привязки |
Тег <a> создает гипертекстовую ссылку и поддерживает следующие атрибуты.
|
Тег полужирного начертания |
Тег <b> изменяет начертание текста на полужирное. Для используемого шрифта должно быть доступно полужирное написание.
|
Тег разрыва |
Тег <br> создает разрыв строки в текстовом поле. Чтобы использовать этот тег, определите текстовое поле как многострочное.
|
Тег шрифта |
Тег <font> задает шрифт или список шрифтов для отображения текста. Тег шрифта поддерживает следующие атрибуты.
|
Тег изображения |
Тег <img> позволяет встраивать в текстовые поля внешние файлы изображений (JPEG, GIF, PNG), SWF-файлы и фрагменты роликов. Текст автоматически обтекает изображения, встроенные в текстовые поля. Необходимо определить текстовое поле как многострочное, чтобы текст обтекал изображение.
Тег
В текстовом поле проигрыватель Flash Player отображает встроенное мультимедийное содержимое в полном размере. Чтобы задать размеры встраиваемого мультимедийного содержимого, используйте атрибуты Как правило, изображение, встроенное в текстовое поле отображается на следующей строке после тега В отношении содержимого AIR в изолированной программной среде безопасности приложения AIR игнорирует теги |
Тег курсива |
Тег <i> отображает заключенный в него текст курсивом. Для используемого шрифта должно быть доступно курсивное начертание.
|
Тег элемента списка |
Тег <li> помещает маркер перед заключенным в него текстом. Примечание. Так как приложение Flash Player и AIR не распознают теги упорядоченного и неупорядоченного списка (<ol> и <ul> ), они не модифицируют визуализацию списка. Все списки являются неупорядоченными, и для всех элементов списка используются маркеры.
|
Тег абзаца |
Тег <p> создает новый абзац. Чтобы использовать этот тег, необходимо определить текстовое поле как многострочное. Тег <p> поддерживает следующие атрибуты.
|
Тег диапазона |
Тег <span> доступен только при использовании вместе со стилями текста CSS. Он поддерживает следующий атрибут.
|
Тег формата текста |
Тег Тег
|
Тег подчеркивания |
Тег <u> подчеркивает заключенный в него текст.
|
Flash Player и AIR поддерживают следующие HTML-сущности:
Сущность | Описание |
---|---|
< | < (знак меньше) |
> | > (знак больше) |
& | & (ampersand) |
" | " (двойные кавычки) |
' | ' (апостроф, одинарная кавычка) |
Flash Player и AIR поддерживают явные коды символов, например, & (амперсанд ASCII) и € (символ € в Юникод).
Реализация
public function get htmlText():String
public function set htmlText(value:String):void
ignorePadding | свойство |
ignorePadding:Boolean
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Если значение равно true
, стили paddingLeft
и paddingRight
не будут оставлять промежуток вокруг текста компонента.
Реализация
public function get ignorePadding():Boolean
public function set ignorePadding(value:Boolean):void
inheritingStyles | свойство |
inheritingStyles:Object
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Начало цепочки UITextField с ненаследуемыми стилями. Метод getStyle()
имеет доступ к nonInheritingStyles[styleName]
для поиска всей связанной с прототипом цепочки. Этот объект настраивается методом initProtoChain()
. Как правило, это свойство не вызывается напрямую.
Реализация
public function get inheritingStyles():Object
public function set inheritingStyles(value:Object):void
length | свойство |
maxChars | свойство |
maxChars:int
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Введенное пользователем максимальное число символов, которое может содержать текстовое поле. Сценарий может вставить больше текста, чем допускает maxChars
. Свойство maxChars
указывает только количество символов, которые может ввести пользователь. Если это свойство имеет значение 0
, пользователь может ввести любое количество символов.
Реализация
public function get maxChars():int
public function set maxChars(value:int):void
maxScrollH | свойство |
maxScrollV | свойство |
mouseEnabled | свойство |
mouseEnabled:Boolean
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Определяет, получает ли этот объект события мыши или другого пользовательского ввода. Значение по умолчанию — true
, которое указывает, что по умолчанию любой экземпляр InteractiveObject в списке отображения получает события мыши или других устройств пользовательского ввода. Если свойство mouseEnabled
имеет значение false
, экземпляр не получает событий мыши (или события другого пользовательского ввода, например клавиатуры). Эта настройка не затрагивает дочерние элементы данного экземпляра в списке отображения. Чтобы изменить поведение mouseEnabled
для всех дочерних элементов объекта в списке отображения, используйте flash.display.DisplayObjectContainer.mouseChildren
.
При настройке данного свойства события не отправляются. Чтобы создать интерактивные функции, необходимо использовать метод addEventListener()
.
Реализация
public function get mouseEnabled():Boolean
public function set mouseEnabled(value:Boolean):void
mouseWheelEnabled | свойство |
mouseWheelEnabled:Boolean
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Логическое значение, определяющее, выполняет ли проигрыватель Flash Player автоматическую прокрутку многострочных текстовых полей, когда пользователь щелкает текстовое поле и вращает колесико мыши. Значение по умолчанию — true
. Это свойство целесообразно, если требуется предотвратить прокрутку текстового поля с помощью колесика мыши или внедрить собственную функцию прокрутки текста.
Реализация
public function get mouseWheelEnabled():Boolean
public function set mouseWheelEnabled(value:Boolean):void
multiline | свойство |
multiline:Boolean
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Показывает, является ли текстовое поле многострочным. Если значение — true
, текстовое поле многострочное, а если значение — false
, то однострочное. В поле типа TextFieldType.INPUT
значение multiline
определяет, создает ли клавиша Enter
новую строку (при значении false
нажатие клавиши Enter
игнорируется). Если вставить текст в поле TextField
со свойством multiline
в значении false
, новые строки опускаются.
Реализация
public function get multiline():Boolean
public function set multiline(value:Boolean):void
nestLevel | свойство |
nestLevel:int
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Глубина этого объекта в иерархии включения. Это число используется кодом макета и измерения. Значение – 0, если этот компонент не находится в DisplayList.
Реализация
public function get nestLevel():int
public function set nestLevel(value:int):void
nonInheritingStyles | свойство |
nonInheritingStyles:Object
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Начало цепочки UITextField с ненаследуемыми стилями. Метод getStyle()
имеет доступ к nonInheritingStyles[styleName]
для поиска всей связанной с прототипом цепочки. Этот объект настраивается методом initProtoChain()
. Как правило, это свойство не вызывается напрямую.
Реализация
public function get nonInheritingStyles():Object
public function set nonInheritingStyles(value:Object):void
nonZeroTextHeight | свойство |
nonZeroTextHeight:Number
[только для чтения] Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
В отличие от textHeight, этот элемент возвращает ненулевое значение даже при пустом тексте. В этом случае возвращается предполагаемое значение textHeight при непустом тексте.
Реализация
public function get nonZeroTextHeight():Number
numLines | свойство |
numLines:int
[только для чтения] Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Определяет число строк текста в многострочном текстовом поле. Если свойство wordWrap
имеет значение true
, то при переносе текста количество строк увеличивается.
Реализация
public function get numLines():int
restrict | свойство |
restrict:String
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Определяет набор символов, которые могут быть введены пользователем в текстовом поле. Если свойству restrict
присвоено значение null
, можно ввести любой символ. Если в качестве значения свойства restrict
установлена пустая строка, ввод символов невозможен. Если значение restrict
— это строка, состоящая из символов, в текстовое поле можно вводить только символы из этой строки. Строка сканируется слева направо. Диапазон определяется с помощью символа (-). Ограничивается только взаимодействие пользователей; с помощью сценариев в текстовом поле можно ввести любой текст. Это свойство не синхронизируется с параметрами встраивания шрифтов в инспекторе свойств.
Если строка начинается с символа вставки (^), все символы изначально поддерживаются, а последующие символы в строке исключаются из набора поддерживаемых символов. Если строка не начинается с символа вставки (^), символы изначально не поддерживаются, а последующие символы в строке включаются в набор поддерживаемых символов.
В следующем примере в текстовое поле можно вводить только заглавные буквы, пробелы и цифры.
my_txt.restrict = "A-Z 0-9";
В следующем примере включены все символы, но исключены строчные буквы.
my_txt.restrict = "^a-z";
Можно использовать обратную косую черту для ввода символа ^ или -. Допускаются следующие последовательности с обратной косой чертой: \-, \^ или \\. Обратная косая черта должна быть фактическим символом в строке, потому, когда она задана в коде ActionScript, необходимо использовать двойную обратную косую черту. Например, следующий код включает только дефис (-) и символ вставки (^).
my_txt.restrict = "\\-\\^";
Символ ^ может использоваться в любом месте строки для переключения между включенными и исключенными символами. Следующий код включает только заглавные буквы, но исключает заглавную букву Q.
my_txt.restrict = "A-Z^Q";
Для создания строк restrict
можно использовать управляющую последовательность \u
. Следующий код включает только символы с ASCII 32 (пробел) до ASCII 126 (тильда).
my_txt.restrict = "\u0020-\u007E";
Реализация
public function get restrict():String
public function set restrict(value:String):void
scrollH | свойство |
scrollH:int
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Текущее положение горизонтальной прокрутки. Если свойство scrollH
имеет значение 0, текст не прокручивается по горизонтали. Значением этого свойства является целое число, представляющее положение по горизонтали в пикселях.
Единицей измерения горизонтальной прокрутки являются пиксели, а вертикальной — строки. Горизонтальная прокрутка измеряется в пикселях, так как большинство распространенных шрифтов расставляются пропорционально, то есть символы могут иметь разную ширину. Проигрыватель Flash Player выполняет вертикальную прокрутку по строкам, так как пользователи обычно хотят видеть строку текста целиком, а не частично. Даже если в строке используются разные шрифты, ее высота регулируется в соответствии с самым большим используемым шрифтом.
Примечание. Значение свойства scrollH
отсчитывается от нуля, а значение свойства scrollV
(для вертикальной прокрутки) — от единицы.
Реализация
public function get scrollH():int
public function set scrollH(value:int):void
scrollV | свойство |
scrollV:int
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Вертикальное положение текста в текстовом поле. Свойство scrollV
целесообразно для направления пользователей к определенному абзацу в длинном тексте или для создания прокручиваемых текстовых полей.
Единицей измерения вертикальной прокрутки являются строки, а горизонтальной — пиксели. Если первая отображаемая строка является первой строкой в текстовом поле, то свойство scrollV имеет значение 1 (не 0). Горизонтальная прокрутка измеряется в пикселях, так как большинство шрифтов расставляются пропорционально, то есть символы могут иметь разную ширину. Flash выполняет вертикальную прокрутку по строкам, так как пользователи обычно хотят видеть строку текста целиком, а не частично. Даже если строка содержит разные шрифты, ее высота регулируется в соответствии с самым большим используемым шрифтом.
Реализация
public function get scrollV():int
public function set scrollV(value:int):void
selectable | свойство |
selectable:Boolean
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Логическое значение, определяющее, можно ли выбрать текстовое поле. Значение true
указывает на то, что текст можно выделить. Свойство selectable
управляет возможностью выделения содержимого текстового поля, а не возможностью его редактирования. Динамическое текстовое поле может поддерживать выделение даже при отсутствии возможности редактирования. Если динамическое текстовое поле не поддерживает выделения, пользователь не может выделять его содержимое.
Если свойство selectable
имеет значение false
, содержимое текстового поля не реагирует на команды выделения мыши и клавиатуры, и его нельзя копировать с использованием команды «Копировать». Если свойство selectable
имеет значение true
, содержимое текстового поля можно выделить с помощью мыши и клавиатуры, и его можно копировать с использованием команды «Копировать». Таким образом можно выделить текст, даже если текстовое поле является динамическим, а не полем ввода.
Реализация
public function get selectable():Boolean
public function set selectable(value:Boolean):void
selectionBeginIndex | свойство |
selectionBeginIndex:int
[только для чтения] Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Отсчитываемое от нуля значение индекса для первого символа в текущем выделенном фрагменте. Например, первый символ имеет индекс 0, второй — индекс 1 и т. д. Если текст не выделен, это свойство является значением caretIndex
.
Реализация
public function get selectionBeginIndex():int
selectionEndIndex | свойство |
selectionEndIndex:int
[только для чтения] Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Отсчитываемое от нуля значение индекса для последнего символа в текущем выделенном фрагменте. Например, первый символ имеет индекс 0, второй — индекс 1 и т. д. Если текст не выделен, это свойство является значением caretIndex
.
Реализация
public function get selectionEndIndex():int
sharpness | свойство |
sharpness:Number
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Четкость контуров символов в этом текстовом поле. Это свойство применяется, только если свойство flash.text.AntiAliasType
текстового поля имеет значение flash.text.AntiAliasType.ADVANCED
. Допустимый диапазон значений свойства sharpness
: числа от -400 до 400. При попытке задать свойству sharpness
значение, находящееся за пределами этого диапазона, проигрыватель Flash Player назначает ему ближайшее значение в диапазоне (-400 или 400).
Реализация
public function get sharpness():Number
public function set sharpness(value:Number):void
styleSheet | свойство |
styleSheet:StyleSheet
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Присоединяет таблицу стилей к текстовому полю. Сведения о создании таблиц стилей см. в описании класса StyleSheet и Руководстве разработчика по ActionScript 3.0.
Таблицу стилей, связанную с текстовым полем, можно изменить в любое время. При изменении текущей таблицы стилей текстовое поле перерисовывается с использованием новой таблицы стилей. Чтобы удалить таблицу стилей, нужно задать значение null
или undefined
. Если текущая таблица стилей удаляется, текстовое поле перерисовывается без нее.
Примечание. Если таблица стилей удаляется, содержимоеTextField.text
и TextField.htmlText
изменяется для внедрения форматирования, которое раньше применялось с помощью таблицы стилей. Чтобы сохранить исходное содержимое TextField.htmlText
без форматирования, нужно сохранить значение в переменной, прежде чем удалять таблицу стилей.
Реализация
public function get styleSheet():StyleSheet
public function set styleSheet(value:StyleSheet):void
tabEnabled | свойство |
tabEnabled:Boolean
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Определяет, включен ли переход к этому объекту с помощью клавиши Tab. Если объект включен в последовательность перехода с помощью клавиши Tab, значение — true
; в противном случае — false
. По умолчанию используется значение false
, за исключением следующих случаев.
- Для объекта SimpleButton используется значение
true
. - Для объекта TextField с
type = "input"
используется значениеtrue
. - Для объекта Sprite или MovieClip с
buttonMode = true
используется значениеtrue
.
Реализация
public function get tabEnabled():Boolean
public function set tabEnabled(value:Boolean):void
tabIndex | свойство |
tabIndex:int
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Задает последовательность перехода между объектами в SWF-файле. Свойство tabIndex
по умолчанию имеет значение -1, то есть для объекта не задан индекс при переходе с помощью клавиши Tab.
Если какой-либо отображаемый в данный момент объект в SWF-файле имеет свойство tabIndex
, автоматическая последовательность перехода с помощью клавиши Tab отключается, и последовательность перехода вычисляется по свойствам tabIndex
объектов SWF-файла. Пользовательская последовательность перехода с помощью клавиши Tab включает только объекты, имеющие свойство tabIndex
.
Свойство tabIndex
может быть выражено неотрицательным числом. Последовательность перехода определяется в соответствии со свойствами tabIndex
объектов в восходящем порядке. Объект со значением 1 свойства tabIndex
предшествует объекту со значением 2 свойства tabIndex
. Нельзя использовать одинаковое значение tabIndex
для нескольких объектов.
Пользовательская последовательность перехода с помощью клавиши Tab, определяемая свойством tabIndex
, является линейной. Это значит, что иерархические отношения объектов в SWF-файле не учитываются. Все объекты в SWF-файле со свойствами tabIndex
помещаются в последовательность перехода с помощью клавиши Tab, которая определяется последовательностью значений tabIndex
.
Примечание. Чтобы установить порядок табуляции для экземпляров TLFTextField, передайте дочерний объект экранного объекта TLFTextField как InteractiveObject, затем задайте свойство tabIndex
. Например:
InteractiveObject(tlfInstance.getChildAt(1)).tabIndex = 3;Чтобы изменить порядок табуляции по умолчанию на обратный для трех экземпляров объекта TLFTextField (
tlfInstance1
, tlfInstance2
и tlfInstance3
), используйте:
InteractiveObject(tlfInstance1.getChildAt(1)).tabIndex = 3; InteractiveObject(tlfInstance2.getChildAt(1)).tabIndex = 2; InteractiveObject(tlfInstance3.getChildAt(1)).tabIndex = 1;
Реализация
public function get tabIndex():int
public function set tabIndex(value:int):void
text | свойство |
text:String
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Строка, представляющая текущий текст в текстовом поле. Строки разделяются символом возврата каретки (\r
, ASCII 13). Это свойство содержит неформатированный текст в текстовом поле без тегов HTML.
Чтобы получить текст в виде HTML, используйте свойство htmlText
.
Примечание. Если таблица стилей применена к текстовому полю, содержимое свойства text
будет интерпретироваться как код HTML.
Реализация
public function get text():String
public function set text(value:String):void
textColor | свойство |
textColor:uint
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Цвет текста в текстовом поле (в шестнадцатеричном формате). Шестнадцатеричная система цвета использует шесть знаков для представления цветовых значений. Каждый знак имеет 16 возможных значений или символов. Символы находятся в диапазоне 0 — 9 и затем A — F. Например, черный цвет — это 0x000000
, а белый — 0xFFFFFF
.
Реализация
public function get textColor():uint
public function set textColor(value:uint):void
textHeight | свойство |
textWidth | свойство |
thickness | свойство |
thickness:Number
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Толщина контуров символов в данном текстовом поле. Это свойство применяется, только когда параметр flash.text.AntiAliasType
имеет значение flash.text.AntiAliasType.ADVANCED
.
Допустимый диапазон значений свойства thickness
: числа от -200 до 200. При попытке задать свойству thickness
значение, находящееся за пределами этого диапазона, проигрыватель Flash Player назначает ему ближайшее значение в диапазоне (-200 или 200).
Реализация
public function get thickness():Number
public function set thickness(value:Number):void
type | свойство |
type:String
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Тип текстового поля. Одна из следующих констант класса TextFieldType: TextFieldType.DYNAMIC
, задающая динамическое текстовое поле, которое не может редактироваться пользователем, или TextFieldType.INPUT
, задающая текстовое поле ввода, которое может редактироваться пользователем.
Реализация
public function get type():String
public function set type(value:String):void
useRichTextClipboard | свойство |
useRichTextClipboard:Boolean
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Определяет, будет ли форматирование текста копироваться и вставляться вместе с самим текстом. Если задано значение true
, при копировании и вставке текста из одного текстового поля в другое проигрыватель Flash Player также копирует и вставляет форматирование (например, выравнивание, полужирное и курсивное начертание). Для обоих текстовых полей, участвующих в операции копирования и вставки свойство useRichTextClipboard
должно иметь значение true
. Значение по умолчанию false
.
Реализация
public function get useRichTextClipboard():Boolean
public function set useRichTextClipboard(value:Boolean):void
wordWrap | свойство |
wordWrap:Boolean
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Логическое значение, определяющее применение переноса по словам к текстовому полю. Если свойство wordWrap
имеет значение true
, текстовое поле поддерживает перенос слов, а если оно имеет значение false
, то перенос слов запрещен. Значение по умолчанию false
.
Реализация
public function get wordWrap():Boolean
public function set wordWrap(value:Boolean):void
appendText | () | метод |
public function appendText(newText:String):void
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Добавляет строку, указанную параметром newText
, в конец текста в текстовом поле. Этот метод более эффективен, чем присвоение сложения (+=
) в свойстве text
(например, someTextField.text += moreText
), особенно для текстовых полей с большим объемом содержимого.
Параметры
newText:String — Строка, добавляемая к существующему тексту.
|
getCharBoundaries | () | метод |
public function getCharBoundaries(charIndex:int):Rectangle
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Возвращает прямоугольник, который является ограничительным блоком символа.
Параметры
charIndex:int — Отсчитываемое от нуля значение индекса для символа (например, первая позиция — 0, вторая позиция — 1 и т.д.)
|
Rectangle — Прямоугольник с минимальными и максимальными значениями по осям x и y , определяющий ограничительный блок символа.
|
getCharIndexAtPoint | () | метод |
public function getCharIndexAtPoint(x:Number, y:Number):int
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Возвращает значение индекса, отсчитываемое от нуля, для символа в точке, определенной параметрами x
и y
.
Параметры
x:Number — Координата x символа.
| |
y:Number — Координата y символа.
|
int — Отсчитываемое от нуля значение индекса для символа (например, первая позиция — 0, вторая позиция — 1 и т.д.). Возвращает -1, если точка не находится в области символа.
|
getFirstCharInParagraph | () | метод |
public function getFirstCharInParagraph(charIndex:int):int
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Получив индекс символа, возвращает индекс первого символа в том же абзаце.
Параметры
charIndex:int — Отсчитываемое от нуля значение индекса для символа (например, первый символ — 0, второй символ — 1 и т.д.).
|
int — Отсчитываемое от нуля значение индекса для первого символа в строке в том же абзаце.
|
getImageReference | () | метод |
public function getImageReference(id:String):DisplayObject
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Возвращает ссылку DisplayObject по данному идентификатору id
для изображения или SWF-файла, добавленного в текстовое поле с форматированием HTML с помощью тега <img>
. Тег <img>
имеет следующий формат:
<img src = 'filename.jpg' id = 'instanceName' >
Параметры
id:String — Идентификатор id для сопоставления (в атрибуте id тега <img> ).
|
DisplayObject — Экранный объект, соответствующий изображению или SWF-файлу с соответствующим атрибутом id в теге <img> текстового поля. Для мультимедийного содержимого, загруженного из внешнего источника, этот объект является объектом Loader, и после загрузки мультимедийный объект становится дочерним по отношению к нему. Для мультимедийного содержимого, встроенного в SWF-файл, это загруженный объект Если не существует тега <img> с идентичным атрибутом id , метод возвращает значение null .
|
getLineIndexAtPoint | () | метод |
public function getLineIndexAtPoint(x:Number, y:Number):int
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Возвращает значение индекса, отсчитываемое от нуля, для строки в точке с координатами x
и y
.
Параметры
x:Number — Координата x строки.
| |
y:Number — Координата x строки.
|
int — Отсчитываемое от нуля значение индекса для строки (например, первая строка — 0, вторая строка — 1 и т.д.). Возвращает -1, если точка не находится в области строки.
|
getLineIndexOfChar | () | метод |
public function getLineIndexOfChar(charIndex:int):int
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Отсчитываемое от нуля значение индекса для строки, которая содержит символ, заданный параметром charIndex
.
Параметры
charIndex:int — Отсчитываемое от нуля значение индекса для символа (например, первый символ — 0, второй символ — 1 и т.д.).
|
int — Отсчитываемое от нуля значение индекса для строки.
|
getLineLength | () | метод |
public function getLineLength(lineIndex:int):int
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Возвращает число символов в заданной строке текста.
Параметры
lineIndex:int — Номер строки, длину которой требуется определить.
|
int — Количество символов в строке.
|
getLineMetrics | () | метод |
public function getLineMetrics(lineIndex:int):flash.text:TextLineMetrics
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Возвращает данные метрик для заданной строки текста.
Параметры
lineIndex:int — Номер строки, для которой требуется получить данные метрик.
|
flash.text:TextLineMetrics — Объект TextLineMetrics.
|
getLineOffset | () | метод |
public function getLineOffset(lineIndex:int):int
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Возвращает индекс первого символа в строке, заданной параметром lineIndex
.
Параметры
lineIndex:int — Отсчитываемое от нуля значение индекса для строки (например, первая строка — 0, вторая строка — 1 и т.д.).
|
int — Отсчитываемое от нуля значение индекса для первого символа в строке.
|
getLineText | () | метод |
public function getLineText(lineIndex:int):String
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Возвращает текст строки, заданной параметром lineIndex
.
Параметры
lineIndex:int — Отсчитываемое от нуля значение индекса для строки (например, первая строка — 0, вторая строка — 1 и т.д.).
|
String — Текстовая строка, содержащаяся в заданной строке.
|
getParagraphLength | () | метод |
public function getParagraphLength(charIndex:int):int
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Используя полученный индекс символа, возвращает длину абзаца, содержащего этот символ. Длина отсчитывается от первого символа в абзаце (возвращенного методом getFirstCharInParagraph()
), а не от переданного индекса символа.
Параметры
charIndex:int — Отсчитываемое от нуля значение индекса для символа (например, первый символ — 0, второй символ — 1 и т. д.).
|
int — Возвращает количество символов в абзаце.
|
getStyle | () | метод |
public function getStyle(styleProp:String):*
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Получает свойство style, которое было установлено в любом месте в пределах цепочки поиска стиля этого компонента.
Один и тот же метод используется для получения свойства style любого типа, таким образом, возвращаемое значение может являться Boolean, String, Number, int, uint (для цвета RGB), Class (для темы оформления) или объектом любого типа. Поэтому вид возврата указывается как *.
При получении определенного свойства style появляется информация о его типе, и часто требуется сохранить результат в переменной этого типа. Приведение от * до этого типа не требуется.
var backgroundColor:uint = getStyle("backgroundColor");
Если свойство style не было установлено в любом месте цепочки поиска стиля, значением, возвращаемым getStyle()
, является undefined
. Учтите, что undefined
является особым значением, не идентичным значениям false
, ""
, NaN
, 0
или null
. Значение действительного стиля не может быть undefined
. Для проверки того, было ли задано значение, можно использовать метод IStyleManager2.isValidStyleValue()
.
Параметры
styleProp:String — Имя свойства стиля.
|
* — Значение стиля.
|
getTextFormat | () | метод |
public function getTextFormat(beginIndex:int = -1, endIndex:int = -1):flash.text:TextFormat
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Возвращает объект TextFormat, содержащий данные о форматировании для фрагмента текста, заданного параметрами beginIndex
и endIndex
. В полученном объекте TextFormat задаются только свойства, используемые для всего заданного текста. Смешанные свойства (те, которые имеют разные значения для разных участков текста) имеют значение null
.
Если не задать значения для этих параметров, то метод применяется ко всему содержимому текстового поля.
В следующей таблице описываются три способа применения.
Применение | Описание |
---|---|
my_textField.getTextFormat() | Возвращает объект TextFormat, содержащий информацию о форматировании для всего содержимого текстового поля. В полученном объекте TextFormat задаются только свойства, используемые для всего текста в текстовом поле. Смешанные свойства (те, которые имеют разные значения для разных участков текста) имеют значение null . |
my_textField.getTextFormat(beginIndex:Number) | Возвращает объект TextFormat, содержащий копию формата текста для символа в положении beginIndex . |
my_textField.getTextFormat(beginIndex:Number,endIndex:Number) | Возвращает объект TextFormat, содержащий информацию о форматировании для фрагмента текста от beginIndex до endIndex-1 . В полученном объекте TextFormat задаются только свойства, используемые для всего заданного текста. Смешанные свойства (те, которые имеют разные значения для разных участков выбранного текста) имеют значение null . |
Параметры
beginIndex:int (default = -1 ) — Необязательно; целое число, указывающее начальное положение фрагмента текста в текстовом поле.
| |
endIndex:int (default = -1 ) — Необязательно: целое число, указывающее положение первого символа после нужного фрагмента текста. В соответствии с дизайном, если задать значения beginIndex и endIndex , считывается текст с beginIndex по endIndex-1 .
|
flash.text:TextFormat — Объект TextFormat, представляющий свойства форматирования для указанного текста.
|
getUITextFormat | () | метод |
public function getUITextFormat():mx.core:UITextFormat
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Возвращает объект UITextFormat, содержащий сведения о форматировании этого компонента. Этот метод схож с методом getTextFormat()
класса flash.text.TextField, но возвращает объект UITextFormat вместо объекта TextFormat.
Класс UITextFormat расширяет класс TextFormat для добавления методов измерения текста measureText()
и measureHTMLText()
.
mx.core:UITextFormat — Объект, содержащий информацию форматирования для этого компонента.
|
replaceSelectedText | () | метод |
public function replaceSelectedText(value:String):void
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Заменяет текущий выделенный фрагмент содержимым параметра value
. Текст вставляется в положении текущего выделенного фрагмента с использованием текущих форматов символов и абзаца по умолчанию. Текст обрабатывается не как HTML.
Можно использовать метод replaceSelectedText()
для вставки и удаления текста без нарушения форматирования символов и абзацев остальной части текста.
Примечание. Этот метод не работает, если к текстовому полю применена таблица стилей.
Параметры
value:String — Строка для замены текущего выделенного текста.
|
replaceText | () | метод |
public function replaceText(beginIndex:int, endIndex:int, newText:String):void
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Заменяет диапазон символов, заданный параметрами beginIndex
и endIndex
, содержанием параметра newText
. Согласно плану, заменяется текст от beginIndex
до endIndex-1
.
Примечание. Этот метод не работает, если к текстовому полю применена таблица стилей.
Параметры
beginIndex:int — Отсчитываемое от нуля значение индекса для начального положения диапазона замены.
| |
endIndex:int — Отсчитываемая от нуля позиция индекса первого символа после требуемого фрагмента текста.
| |
newText:String — Текст для замены заданного диапазона символов.
|
setColor | () | метод |
setFocus | () | метод |
public function setFocus():void
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Задает фокус на этот компонент. Компонент может в свою очередь поместить в фокус субкомпонент.
Примечание. Только элементы управления TextInput и TextArea отображают выделение при установке фокуса с помощью этого метода. Все элементы управления отображают выделение при переходе пользователя к элементу управления.
setSelection | () | метод |
public function setSelection(beginIndex:int, endIndex:int):void
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Задает способ разметки текста с помощью индексов первого и последнего символов, которые указываются параметрами beginIndex
и endIndex
Если два параметра имеют одинаковые значения, этот метод задает точку вставки, как при использовании свойства caretIndex
.
Параметры
beginIndex:int — Отсчитываемое от нуля значение индекса для выделенного символа (например, первый символ — 0, второй символ — 1 и т.д.).
| |
endIndex:int — Отсчитываемое от нуля значение индекса для последнего символа в выделенном фрагменте.
|
setTextFormat | () | метод |
public function setTextFormat(format:flash.text:TextFormat, beginIndex:int = -1, endIndex:int = -1):void
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Применяет форматирование текста, заданное параметром format
, к указанному содержимому текстового поля. Значением параметра format
должен быть объект TextFormat, определяющий необходимые изменения формата текста. К текстовому полю применяются только ненулевые свойства format
. Свойства параметра format
, имеющие значение null
, не применяются. По умолчанию все свойства вновь созданного объекта TextFormat имеют значение null
.
Примечание. Этот метод не работает, если к текстовому полю применена таблица стилей.
Метод setTextFormat()
изменяет форматирование текста, применяемое к диапазону символов или ко всему содержимому текстового поля. Чтобы применить свойства формата ко всему тексту в текстовом поле, не нужно задавать значения для beginIndex
и endIndex
. Чтобы применить свойства формата к фрагменту текста, задайте значения для параметров beginIndex
и endIndex
. Для определения значений индекса можно использовать свойство length
.
Объект TextFormat содержит два типа информации о форматировании: форматирование символов и форматирование абзацев. Каждый символ в текстовом поле может иметь собственные параметры формата символов, такие как имя и размер шрифта, полужирное или курсивное начертание.
Для абзацев параметры форматирования всего абзаца определяются по его первому символу. В качестве примера можно назвать такие параметры форматирования, как левое, правое поле и отступ.
Любой текст, вставленный пользователем вручную или замененный методом replaceSelectedText()
, получает форматирование текстового поля по умолчанию для нового текста, а не то, которое задано для точки вставки текста. Форматирование по умолчанию для нового текста задается с помощью свойства defaultTextFormat
.
Параметры
format:flash.text:TextFormat — Объект TextFormat, содержащий информацию о форматировании символов и абзацев.
| |||||||||
beginIndex:int (default = -1 ) — Необязательно; целое число, указывающее отсчитываемую от нуля позицию индекса, определяющую первый символ требуемого фрагмента текста.
| |||||||||
endIndex:int (default = -1 ) — Необязательно; целое число, указывающее первый символ после требуемого фрагмента текста. В соответствии с планом, если задать значения beginIndex и endIndex , обновляется текст с beginIndex по endIndex-1 .
Обратите внимание, что текст, вставленный пользователем вручную или замененный методом |
truncateToFit | () | метод |
public function truncateToFit(truncationIndicator:String = null):Boolean
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Усекает текст для его полного горизонтального размещения в области, определенной для элемента управления, и присоединяет к тексту многоточие (...).
Параметры
truncationIndicator:String (default = null ) — Текст, добавляемый после усечения. При передаче значения null будет использоваться локализуемая строка, например ... .
|
Boolean — true , если текст требовал усечения.
|
Tue Jun 12 2018, 11:34 AM Z