Главная / Action Script 3
Пакетfl.controls
Классpublic class TextArea
НаследованиеTextArea Inheritance UIComponent Inheritance Sprite Inheritance DisplayObjectContainer Inheritance InteractiveObject Inheritance DisplayObject Inheritance EventDispatcher Inheritance Object
Реализует IFocusManagerComponent

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9.0.28.0

Компонент TextArea представляет собой многострочное текстовое поле с границей и возможностью отображения полос прокрутки. Компонент TextArea поддерживает возможности визуализации HTML программы Adobe Flash Player.

Посмотреть примеры

См. также

TextInput


Общедоступные свойства
 СвойствоОпределено
 InheritedaccessibilityProperties : AccessibilityProperties
Текущие параметры специальных возможностей для данного экранного объекта.
DisplayObject
 Inheritedalpha : Number
Указывает значение альфа-прозрачности заданного объекта.
DisplayObject
  alwaysShowSelection : Boolean
Определяет или задает логическое значение, указывающее, выделяет ли Flash Player выбранный текст, когда текстовое поле не имеет фокуса.
TextArea
 InheritedblendMode : String
Значение класса BlendMode, задающее режим наложения.
DisplayObject
 InheritedblendShader : Shader
[только для записи] Задает затенение, используемое при наложении переднего плана на фон.
DisplayObject
 InheritedbuttonMode : Boolean
Задает режим кнопки данного спрайта.
Sprite
 InheritedcacheAsBitmap : Boolean
При значении true проигрыватель Flash Player кэширует внутреннее растровое представление экранного объекта.
DisplayObject
  condenseWhite : Boolean
Определяет или задает логическое значение, управляющее удалением лишних разделителей из компонента TextArea, который содержит текст HTML.
TextArea
 Inheritedconstructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта.
Object
 InheritedcontextMenu : ContextMenu
Определяет контекстное меню, связанное с данным объектом.
InteractiveObject
  displayAsPassword : Boolean
Определяет или задает логическое значение, указывающее тип компонента TextArea (текстовое поле или поле для ввода пароля).
TextArea
 InheriteddoubleClickEnabled : Boolean
Определяет, получает ли объект события doubleClick.
InteractiveObject
 InheriteddropTarget : DisplayObject
[только для чтения] Определяет экранный объект, над которым перетаскивается спрайт, либо на котором спрайт был отпущен.
Sprite
  editable : Boolean
Определяет или задает логическое значение, указывающее, может ли пользователь редактировать текст компонента.
TextArea
  enabled : Boolean
Определяет или задает значение, указывающее, поддерживает ли компонент взаимодействие с пользователем.
TextArea
 Inheritedfilters : Array
Индексированный массив, который содержит все объекты filter, связанные в настоящий момент с экранным объектом.
DisplayObject
 InheritedfocusEnabled : Boolean
Определяет или задает логическое значение, указывающее, может ли компонент принимать фокус при щелчке пользователя.
UIComponent
 InheritedfocusManager : IFocusManager
Определяет или задает объект FocusManager, управляющий фокусом для этого компонента и компонентов, находящихся на том же уровне иерархии.
UIComponent
 InheritedfocusRect : Object
Задает отображение прямоугольной рамки индикатора фокуса для данного объекта.
InteractiveObject
 Inheritedgraphics : Graphics
[только для чтения] Задает объект Graphics, принадлежащий данному спрайту, в котором могут выполняться команды векторного рисования.
Sprite
 Inheritedheight : Number
Определяет или задает высоту компонента (в пикселах).
UIComponent
 InheritedhitArea : Sprite
Определяет другой спрайт в качестве области щелчка для спрайта.
Sprite
  horizontalScrollBar : UIScrollBar
[только для чтения] Определяет ссылку на горизонтальную полосу прокрутки.
TextArea
  horizontalScrollPolicy : String
Определяет или задает правило прокрутки горизонтальной полосы прокрутки.
TextArea
  horizontalScrollPosition : Number
Определяет или задает величину, на которую изменяется положение бегунка полосы прокрутки при горизонтальной прокрутке текстового поля (в пикселах).
TextArea
  htmlText : String
Определяет или задает представление строки, содержащейся в текстовом поле, в формате HTML.
TextArea
  imeMode : String
Определяет или задает режим редактора методов ввода (IME).
TextArea
  length : Number
[только для чтения] Определяет число символов в компоненте TextArea.
TextArea
 InheritedloaderInfo : LoaderInfo
[только для чтения] Возвращает объект LoaderInfo, содержащий сведения о загрузке файла, к которому принадлежит этот экранный объект.
DisplayObject
 Inheritedmask : DisplayObject
Вызывающий экранный объект маскируется заданным объектом mask.
DisplayObject
  maxChars : int
Определяет или задает максимальное число символов, которые могут быть введены пользователем в текстовом поле.
TextArea
  maxHorizontalScrollPosition : int
[только для чтения] Определяет максимальное значение свойства horizontalScrollPosition.
TextArea
  maxVerticalScrollPosition : int
[только для чтения] Определяет максимальное значение свойства verticalScrollPosition.
TextArea
 InheritedmouseChildren : Boolean
Определяет, включен ли переход между потомками объекта с помощью мыши.
DisplayObjectContainer
 InheritedmouseEnabled : Boolean
Определяет, получает ли этот объект сообщения мыши.
InteractiveObject
 InheritedmouseFocusEnabled : Boolean
Определяет или задает значение, указывающее, может ли компонент принимать фокус при щелчке пользователя.
UIComponent
 InheritedmouseX : Number
[только для чтения] Указывает координату x положения курсора мыши (в пикселах).
DisplayObject
 InheritedmouseY : Number
[только для чтения] Указывает координату y положения курсора мыши (в пикселах).
DisplayObject
 Inheritedname : String
Указывает имя экземпляра DisplayObject.
DisplayObject
 InheritednumChildren : int
[только для чтения] Возвращает число потомков данного объекта.
DisplayObjectContainer
 InheritedopaqueBackground : Object
Определяет, является ли экранный объект непрозрачным с определенным цветом фона.
DisplayObject
 Inheritedparent : DisplayObjectContainer
[только для чтения] Указывает объект DisplayObjectContainer, содержащий данный экранный объект.
DisplayObject
 Inheritedprototype : Object
[статические] Ссылка на модель объекта класса или функции.
Object
  restrict : String
Определяет или задает строку символов, которые могут быть введены пользователем в текстовом поле.
TextArea
 Inheritedroot : DisplayObject
[только для чтения] В случае с экранным объектом в загруженном SWF-файле свойством root является самый верхний экранный объект в части структуры дерева списка отображения, представленной этим SWF-файлом.
DisplayObject
 Inheritedrotation : Number
Указывает поворот экземпляра DisplayObject относительно его исходной ориентации (в градусах).
DisplayObject
 InheritedrotationX : Number
Обозначает поворот в градусах по оси x экземпляра DisplayObject относительно исходной ориентации по трехмерному родительскому контейнеру.
DisplayObject
 InheritedrotationY : Number
Обозначает поворот в градусах по оси у экземпляра DisplayObject относительно исходной ориентации по трехмерному родительскому контейнеру.
DisplayObject
 InheritedrotationZ : Number
Обозначает поворот в градусах по оси z экземпляра DisplayObject относительно исходной ориентации по трехмерному родительскому контейнеру.
DisplayObject
 Inheritedscale9Grid : Rectangle
Текущая активная сетка масштабирования.
DisplayObject
 InheritedscaleX : Number
Умножает текущую ширину компонента на коэффициент масштабирования.
UIComponent
 InheritedscaleY : Number
Умножает текущую высоту компонента на коэффициент масштабирования.
UIComponent
 InheritedscaleZ : Number
Указывает масштабирование глубины объекта (в процентах) относительно точки регистрации этого объекта.
DisplayObject
 InheritedscrollRect : Rectangle
Прямоугольная область прокрутки экранного объекта.
DisplayObject
  selectionBeginIndex : int
[только для чтения] Определяет положение индекса первого выделенного символа в выделенном диапазоне из одного или нескольких символов.
TextArea
  selectionEndIndex : int
[только для чтения] Определяет индекс последнего выделенного символа в выделенном диапазоне из одного или нескольких символов.
TextArea
 InheritedsoundTransform : SoundTransform
Управляет звуком в данном спрайте.
Sprite
 Inheritedstage : Stage
[только для чтения] Класс Stage экранного объекта.
DisplayObject
 InheritedtabChildren : Boolean
Определяет, включен ли переход между потомками объекта с помощью клавиши Tab.
DisplayObjectContainer
 InheritedtabEnabled : Boolean
Определяет, включен ли этот объект в последовательность перехода с помощью клавиши Tab.
InteractiveObject
 InheritedtabIndex : int
Задает последовательность перехода между объектами в SWF-файле.
InteractiveObject
  text : String
Определяет или задает строку, которая содержит текст, отображаемый в настоящее время компонентом TextInput.
TextArea
  textField : TextField
Ссылка на внутреннее текстовое поле компонента TextArea.
TextArea
  textHeight : Number
[только для чтения] Определяет высоту текста (в пикселах).
TextArea
 InheritedtextSnapshot : TextSnapshot
[только для чтения] Возвращает объект TextSnapshot для данного экземпляра DisplayObjectContainer.
DisplayObjectContainer
  textWidth : Number
[только для чтения] Определяет ширину текста (в пикселах).
TextArea
 Inheritedtransform : Transform
Объект со свойствами, относящимися к матрице, преобразованию цвета и пиксельным границам экранного объекта.
DisplayObject
 InheriteduseHandCursor : Boolean
Логическое значение, определяющее, должен ли отображаться указатель "рука" при наведении указателя мыши на спрайт, в котором свойство buttonMode имеет значение true.
Sprite
 Inheritedversion : String = "3.0.0.16"
Номер версии компонентов.
UIComponent
  verticalScrollBar : UIScrollBar
[только для чтения] Определяет ссылку на вертикальную полосу прокрутки.
TextArea
  verticalScrollPolicy : String
Определяет или задает правило прокрутки вертикальной полосы прокрутки.
TextArea
  verticalScrollPosition : Number
Определяет или задает величину, на которую изменяется положение бегунка полосы прокрутки при вертикальной прокрутке текстового поля (в пикселах).
TextArea
 Inheritedvisible : Boolean
Определяет или задает значение, указывающее, видим ли текущий экземпляр компонента.
UIComponent
 Inheritedwidth : Number
Определяет или задает ширину компонента (в пикселах).
UIComponent
  wordWrap : Boolean
Определяет или задает логическое значение, указывающее, переносится ли текст по словам в конце строки.
TextArea
 Inheritedx : Number
Определяет или задает координату, представляющую положение компонента по оси X в пределах родительского контейнера.
UIComponent
 Inheritedy : Number
Определяет или задает координату, представляющую положение компонента по оси Y в пределах родительского контейнера.
UIComponent
 Inheritedz : Number
Указывает положение по оси z экземпляра DisplayObject относительно трехмерного родительского контейнера.
DisplayObject
Общедоступные методы
 МетодОпределено
  
Создает новый экземпляр компонента TextArea.
TextArea
 Inherited
Добавляет дочерний экземпляр DisplayObject к данному экземпляру DisplayObjectContainer.
DisplayObjectContainer
 Inherited
Добавляет дочерний экземпляр DisplayObject к данному экземпляру DisplayObjectContainer.
DisplayObjectContainer
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Регистрирует объект прослушивателя события в объекте EventDispatcher, в результате чего прослушиватель будет получать уведомления о событиях.
EventDispatcher
  
Добавляет заданную строку после последнего символа в компоненте TextArea.
TextArea
 Inherited
Показывает, могут ли ограничения безопасности привести к пропуску каких-либо экранных объектов в списке, возвращаемом в результате вызова метода DisplayObjectContainer.getObjectsUnderPoint() с заданной точкой.
DisplayObjectContainer
 Inherited
Удаляет свойство style для экземпляра компонента.
UIComponent
 Inherited
Определяет, является ли заданный экранный объект дочерним объектом экземпляра DisplayObjectContainer или самим экземпляром.
DisplayObjectContainer
 Inherited
Передает событие в поток событий.
EventDispatcher
  
Отображает или скрывает индикатор фокуса этого компонента.
TextArea
 Inherited
Инициирует немедленную операцию отрисовки без аннулирования всех элементов (в отличие от метода invalidateNow).
UIComponent
 Inherited
getBounds(targetCoordinateSpace:DisplayObject):Rectangle
Возвращает прямоугольник, определяющий область экранного объекта, которая относится к системе координат объекта targetCoordinateSpace.
DisplayObject
 Inherited
Возвращает экземпляр дочернего экранного объекта, существующий в заданной позиции индекса.
DisplayObjectContainer
 Inherited
Возвращает экземпляр дочернего экранного объекта с заданным именем.
DisplayObjectContainer
 Inherited
Возвращает позицию индекса для дочернего экземпляра DisplayObject.
DisplayObjectContainer
 Inherited
Возвращает объект, который в настоящее время имеет фокус.
UIComponent
  
Возвращает сведения об указанной строке текста.
TextArea
 Inherited
Возвращает массив объектов, расположенных ниже заданной позиции и являющихся дочерними объектами любого уровня для данного экземпляра DisplayObjectContainer.
DisplayObjectContainer
 Inherited
getRect(targetCoordinateSpace:DisplayObject):Rectangle
Возвращает прямоугольник, определяющий границу экранного объекта по системе координат, заданной параметром targetCoordinateSpace, за исключением линий фигур.
DisplayObject
 Inherited
Возвращает свойство style, установленное в последовательности для поиска стилей компонента.
UIComponent
  
[статические] Возвращает карту стилей по умолчанию для текущего компонента.
TextArea
 Inherited
Преобразует объект Point из координат рабочей области (глобальных) в координаты экранного объекта (локальные).
DisplayObject
 Inherited
Преобразует двумерный объект Point из координат рабочей области (глобальных) в координаты экранного трехмерного объекта (локальные).
DisplayObject
 Inherited
Проверяет наличие у объекта EventDispatcher прослушивателей событий, которые зарегистрированы для получения уведомлений о событиях определенного типа.
EventDispatcher
 Inherited
Показывает, определено ли заданное свойство для объекта.
Object
 Inherited
Оценивает экранный объект, чтобы определить, перекрывает ли он экранный объект obj или пересекается с ним.
DisplayObject
 Inherited
hitTestPoint(x:Number, y:Number, shapeFlag:Boolean = false):Boolean
Вычисляет экранный объект, чтобы определить, перекрывает ли он точку, заданную координатами x и y, или пересекает ее.
DisplayObject
 Inherited
invalidate(property:String, callLater:Boolean = true):void
Помечает свойство как недопустимое и обновляет компонент в следующем кадре, если не указано иное.
UIComponent
 Inherited
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра.
Object
 Inherited
Преобразует трехмерный объект point из координат трехмерного экранного объекта (локальных) в двухмерный объект point с координатами рабочей области (глобальными).
DisplayObject
 Inherited
Преобразует объект point из координат экранного объекта (локальных) в координаты рабочей области (глобальные).
DisplayObject
 Inherited
[статические] Объединяет стили из нескольких классов в одном объекте.
UIComponent
 Inherited
Перемещает компонент в указанное положение в пределах его родительского компонента.
UIComponent
 Inherited
Показывает наличие заданного свойства и его перечисляемость.
Object
 Inherited
Удаляет заданный дочерний объект DisplayObject из списка потомков экземпляра DisplayObjectContainer.
DisplayObjectContainer
 Inherited
Удаляет дочерний DisplayObject из заданной позиции индекса в списке потомков DisplayObjectContainer.
DisplayObjectContainer
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Удаляет прослушиватель из объекта EventDispatcher.
EventDispatcher
 Inherited
Изменяет положение существующего потомка в DisplayObjectContainer.
DisplayObjectContainer
 Inherited
Задает фокус на этот компонент.
UIComponent
 Inherited
Задает доступность динамического свойства для операций цикла.
Object
  
setSelection(setSelection:int, endIndex:int):void
Задает диапазон выделения в текстовой области, имеющей фокус.
TextArea
 Inherited
setSize(width:Number, height:Number):void
Задает указанную высоту и ширину компонента.
UIComponent
 Inherited
setStyle(style:String, value:Object):void
Задает свойство style для экземпляра компонента.
UIComponent
 Inherited
startDrag(lockCenter:Boolean = false, bounds:Rectangle = null):void
Позволяет пользователю перетаскивать заданный спрайт (растровый графический объект, легко перемещаемый по экрану).
Sprite
 Inherited
Завершает метод startDrag().
Sprite
 Inherited
Меняет местами (в порядке "от начала к концу") два заданных дочерних объекта.
DisplayObjectContainer
 Inherited
swapChildrenAt(index1:int, index2:int):void
Меняет местами (в порядке "от начала к концу") дочерние объекты, расположенные в двух заданных позициях индекса в списке потомков.
DisplayObjectContainer
 Inherited
Возвращает строковое представление заданного объекта.
Object
 Inherited
Проверяет и обновляет свойства и макет этого объекта, а также перерисовывает его при необходимости.
UIComponent
 Inherited
Возвращает элементарное значение заданного объекта.
Object
 Inherited
Проверяет, зарегистрирован ли прослушиватель событий в объекте EventDispatcher или в любом из его предков для получения уведомлений о событиях определенного типа.
EventDispatcher
Защищенные методы
 МетодОпределено
 Inherited
Возвращает указанный стиль для компонента, учитывая все стили, заданные на глобальном уровне, уровне компонентов и уровне экземпляров.
UIComponent
События
 Событие Сводка Определено
 Inherited[многоадресное событие] Отправляется, когда проигрыватель Flash Player перемещается в фокус операционной системы и становится активным.EventDispatcher
 InheritedОтправляется, когда экранный объект добавляется в список отображения.DisplayObject
 InheritedОтправляется, когда экранный объект добавляется к списку отображения в рабочей области, либо непосредственно, либо путем добавления поддерева, содержащего экранный объект.DisplayObject
  Отправляется при изменении текста в элементе управления TextArea.TextArea
 InheritedОтправляется, когда пользователь выбирает команду "Удалить" в контекстном меню текста.InteractiveObject
 InheritedОтправляется, когда пользователь нажимает и отпускает главную кнопку на указывающем устройстве над одним и тем же объектом InteractiveObject.InteractiveObject
 InheritedОтправляется, когда пользователь активирует комбинацию клавиш ускорения, используемую на данной платформе для операции "Копировать", или выбирает команду "Копировать" из контекстного меню.InteractiveObject
 InheritedОтправляется, когда пользователь активирует комбинацию клавиш ускорения, используемую на данной платформе для операции "Вырезать", или выбирает команду "Вырезать" из контекстного меню.InteractiveObject
 Inherited[многоадресное событие] Отправляется, когда проигрыватель Flash Player покидает фокус операционной системы и становится неактивным.EventDispatcher
 InheritedОтправляется, когда пользователь дважды нажимает и отпускает главную кнопку на указывающем устройстве над одним и тем же объектом InteractiveObject, а флаг doubleClickEnabled для этого объекта имеет значение true.InteractiveObject
  Отправляется при нажатии клавиши Enter, когда курсор находится в компоненте.TextArea
 Inherited[многоадресное событие] Отправляется, когда точка воспроизведения переходит в новый кадр.DisplayObject
 Inherited[многоадресное событие] Отправляется, когда точка воспроизведения покидает текущий кадр.DisplayObject
 InheritedОтправляется, когда экранный объект перемещается в фокус.InteractiveObject
 InheritedОтправляется, когда экранный объект покидает фокус.InteractiveObject
 Inherited[многоадресное событие] Отправляется после завершения работы конструкторов экранных объектов кадра до выполнения сценариев кадра.DisplayObject
 InheritedОтправляется, когда видимый компонент становится невидимым.UIComponent
 InheritedОтправляется, когда пользователь нажимает клавишу.InteractiveObject
 InheritedОтправляется, когда пользователь пытается изменить фокус с помощью клавиатуры.InteractiveObject
 InheritedОтправляется, когда пользователь отпускает клавишу.InteractiveObject
 InheritedОтправляется, когда пользователь нажимает кнопку на указывающем устройстве над экземпляром InteractiveObject в окне проигрывателя Flash Player.InteractiveObject
 InheritedОтправляется, когда пользователь пытается изменить фокус с помощью указывающего устройства.InteractiveObject
 InheritedОтправляется, когда пользователь перемещает указывающее устройство в момент, когда курсор находится над объектом InteractiveObject.InteractiveObject
 InheritedОтправляется, когда пользователь перемещает указывающее устройство от экземпляра InteractiveObject.InteractiveObject
 InheritedОтправляется, когда пользователь наводит указывающее устройству на экземпляр InteractiveObject в окне проигрывателя Flash Player.InteractiveObject
 InheritedОтправляется, когда пользователь отпускает кнопку на указывающем устройстве над экземпляром InteractiveObject в окне проигрывателя Flash Player.InteractiveObject
 InheritedОтправляется, когда пользователь вращает колесико мыши над экземпляром InteractiveObject в окне проигрывателя Flash Player.InteractiveObject
 InheritedОтправляется при перемещении компонента.UIComponent
 InheritedОтправляется, когда пользователь активирует комбинацию клавиш ускорения, используемую на данной платформе для операции "Вставить", или выбирает команду "Вставить" из контекстного меню.InteractiveObject
 InheritedОтправляется перед удалением экранного объекта из списка отображения.DisplayObject
 InheritedОтправляется перед удалением экранного объекта из списка отображения, либо непосредственно, либо путем удаления поддерева, содержащего экранный объект.DisplayObject
 Inherited[многоадресное событие] Отправляется перед обновлением и визуализацией списка отображения.DisplayObject
 InheritedОтправляется при изменении размеров компонента.UIComponent
 InheritedОтправляется, когда пользователь перемещает указывающее устройство от экземпляра InteractiveObject.InteractiveObject
 InheritedОтправляется, когда пользователь наводит указывающее устройство на экземпляр InteractiveObject.InteractiveObject
  Отправляется во время прокрутки содержимого.TextArea
 InheritedОтправляется, когда пользователь активирует комбинацию клавиш ускорения, используемую на данной платформе для операции "Выделить все", или выбирает команду "Выделить все" из контекстного меню.InteractiveObject
 InheritedОтправляется, когда невидимый компонент становится видимым.UIComponent
 InheritedОтправляется, когда изменяется значение свойства tabChildren объекта.InteractiveObject
 InheritedОтправляется при изменении флага tabEnabled объекта.InteractiveObject
 InheritedОтправляется, когда изменяется значение свойства tabIndex объекта.InteractiveObject
  Отправляется при вводе, удалении или вставке текста в компонент.TextArea
Стили
 Стиль Описание Определено
  
disabledSkin
Тип: Class
Класс, обеспечивающий фон компонента TextArea, когда свойству enabled присвоено значение false. Значение по умолчанию TextArea_disabledSkin.
TextArea
 InheritedТип: flash.text.TextFormat
Объект TextFormat, который используется для визуализации метки компонента, когда кнопка отключена.
UIComponent
  
embedFonts
Тип: Boolean
Указывает, необходимо ли использовать для визуализации текстового поля контуры встроенных шрифтов. Если выбрано значение true, Flash Player визуализирует текстовое поле с помощью контуров встроенных шрифтов. Если выбрано значение false, Flash Player визуализирует текстовое поле с использованием шрифтов устройства.

Если свойству embedFonts текстового поля присвоено значение true, необходимо указать для текста шрифт с помощью свойства font объекта TextFormat, примененного к текстовому полю. Если указанный шрифт не встроен в SWF-файл, текст не отображается.

Значение по умолчанию false.
TextArea
 InheritedТип: Number Формат: Length
Заполнитель, отделяющий внешние границы компонента от внешних краев индикатора фокуса, в пикселах.
UIComponent
 InheritedТип: Class
Обложка, используемая для показа индикаторов фокуса.
UIComponent
 InheritedТип: flash.text.TextFormat
Объект TextFormat, используемый для визуализации метки компонента.
UIComponent
  
textPadding
Тип: Number Формат: Length
Ширина заполнителя, отделяющего границу компонента от текста, в пикселах. Значение по умолчанию 3.
TextArea
  
upSkin
Тип: Class
Класс, обеспечивающий фон компонента TextArea. Значение по умолчанию TextArea_upSkin.
TextArea
Сведения о свойстве
alwaysShowSelectionсвойство
alwaysShowSelection:Boolean  [чтение и запись]

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9.0.28.0

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

Значение по умолчанию false



Реализация
    public function get alwaysShowSelection():Boolean
    public function set alwaysShowSelection(value:Boolean):void

См. также

condenseWhiteсвойство 
condenseWhite:Boolean  [чтение и запись]

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9.0.28.0

Определяет или задает логическое значение, управляющее удалением лишних разделителей из компонента TextArea, который содержит текст HTML. Примеры дополнительного свободного места в компоненте включают пробелы и разрывы строк. Значение true указывает на удаление дополнительного свободного места; значение false указывает на то, что дополнительное свободное место не удаляется.

Это свойство влияет только на текст, который задается с помощью свойства htmlText; оно не влияет на текст, который задается с помощью свойства text. Если свойство text используется для настройки текста, свойство condenseWhite игнорируется.

Если свойству condenseWhite присваивается значение true, необходимо использовать стандартные команды HTML (например, <br> и <p>), чтобы поместить в текстовое поле разрывы строк.

Значение по умолчанию false



Реализация
    public function get condenseWhite():Boolean
    public function set condenseWhite(value:Boolean):void

См. также


Пример
В следующем примере компонент CheckBox используется для переключения свойства condenseWhite компонента TextArea:

import fl.controls.CheckBox;
import fl.controls.ScrollPolicy;
import fl.controls.TextArea;

var str:String;

var plainTextArea:TextArea = new TextArea();
plainTextArea.verticalScrollPolicy = ScrollPolicy.ON;
plainTextArea.setSize(260, 360);
plainTextArea.move(10, 10);
addChild(plainTextArea);

var htmlTextArea:TextArea = new TextArea();
htmlTextArea.verticalScrollPolicy = ScrollPolicy.ON;
htmlTextArea.condenseWhite = true;
htmlTextArea.setSize(260, 360);
htmlTextArea.move(280, 10);
addChild(htmlTextArea);

var condenseCheckBox:CheckBox = new CheckBox();
condenseCheckBox.textField.autoSize = TextFieldAutoSize.LEFT;
condenseCheckBox.label = "condenseWhite:";
condenseCheckBox.selected = htmlTextArea.condenseWhite;
condenseCheckBox.move(htmlTextArea.x, htmlTextArea.y + htmlTextArea.height);
condenseCheckBox.addEventListener(MouseEvent.CLICK, clickHandler);
addChild(condenseCheckBox);

var urlLdr:URLLoader = new URLLoader();
urlLdr.addEventListener(Event.COMPLETE, completeHandler);
urlLdr.dataFormat = URLLoaderDataFormat.TEXT;
urlLdr.load(new URLRequest("http://www.helpexamples.com/flash/lorem.html"));

function completeHandler(event:Event):void {
    str = event.target.data as String;
    plainTextArea.text = str;
    htmlTextArea.htmlText = str;
}

function clickHandler(event:MouseEvent):void {
    var sel:Boolean = event.currentTarget.selected;
    htmlTextArea.condenseWhite = sel;
    htmlTextArea.htmlText = str;
}
displayAsPasswordсвойство 
displayAsPassword:Boolean  [чтение и запись]

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9.0.28.0

Определяет или задает логическое значение, указывающее тип компонента TextArea (текстовое поле или поле для ввода пароля). Значение true указывает, что текущий экземпляр создан для ввода пароля; значение false говорит о том, что он не предназначен для этого.

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

Значение по умолчанию false



Реализация
    public function get displayAsPassword():Boolean
    public function set displayAsPassword(value:Boolean):void
editableсвойство 
editable:Boolean  [чтение и запись]

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9.0.28.0

Определяет или задает логическое значение, указывающее, может ли пользователь редактировать текст компонента. Значение true указывает на то, что пользователь может изменить текст, который содержится в компоненте; значение false говорит о том, что он не может этого.

Значение по умолчанию true



Реализация
    public function get editable():Boolean
    public function set editable(value:Boolean):void
enabledсвойство 
enabled:Boolean  [чтение и запись]

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9.0.28.0

Определяет или задает значение, указывающее, поддерживает ли компонент взаимодействие с пользователем. Значение true указывает, что компонент поддерживает взаимодействие с пользователем; значение false указывает на то, что оно не поддерживает его.

Если присвоить свойству enabled значение false, цвет контейнера становится тусклым, а данные, вводимые пользователем, блокируются (за исключением компонентов Label и ProgressBar).



Реализация
    public function get enabled():Boolean
    public function set enabled(value:Boolean):void
horizontalScrollBarсвойство 
horizontalScrollBar:UIScrollBar  [только для чтения]

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9.0.28.0

Определяет ссылку на горизонтальную полосу прокрутки.



Реализация
    public function get horizontalScrollBar():UIScrollBar

См. также

horizontalScrollPolicyсвойство 
horizontalScrollPolicy:String  [чтение и запись]

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9.0.28.0

Определяет или задает правило прокрутки горизонтальной полосы прокрутки. Это может быть одно из указанных ниже значений.

Значение по умолчанию ScrollPolicy.AUTO



Реализация
    public function get horizontalScrollPolicy():String
    public function set horizontalScrollPolicy(value:String):void

См. также


Пример
В следующем примере создается экземпляр компонента TextArea, а его свойству horizontalScrollPolicy присваивается значение ScrollPolicy.ON. Таким образом, горизонтальная полоса прокрутки всегда будет видна независимо от объема содержимого, которое находится в текстовой области в данный момент.

import fl.controls.TextArea;
import fl.controls.ScrollPolicy;

var myTextArea:TextArea = new TextArea();
myTextArea.wordWrap = false;
myTextArea.horizontalScrollPolicy = ScrollPolicy.ON;
myTextArea.text = "The quick brown fox jumped over the lazy dog.";
myTextArea.setSize(320, 120);
myTextArea.move(10, 10);
addChild(myTextArea);
horizontalScrollPositionсвойство 
horizontalScrollPosition:Number  [чтение и запись]

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9.0.28.0

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

Значение по умолчанию 0



Реализация
    public function get horizontalScrollPosition():Number
    public function set horizontalScrollPosition(value:Number):void

См. также

htmlTextсвойство 
htmlText:String  [чтение и запись]

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9.0.28.0

Определяет или задает представление строки, содержащейся в текстовом поле, в формате HTML.

Значение по умолчанию ""



Реализация
    public function get htmlText():String
    public function set htmlText(value:String):void

См. также


Пример
В следующем примере создается экземпляр компонента TextArea, а для создания стиля текста применяются различные теги HTML:

import fl.controls.TextArea;

var myText:String = "";
myText += "<p>You can use the <b> tag to create <b>bold</b> text.</p>";
myText += "<p>You can use the <i> tag to create <i>italic</i> text.</p>";
myText += "<p>You can use the <u> tag to create <u>underlined</a> text.</p>";
myText += "<p>You can use the <a> tag to create <a href='http://www.adobe.com'>links to other sites</a>.</p>";
myText += "<p>You can use the <br> tag to create<br>new lines of text<br>whenever you want.</p>";
myText += "<p>You can use the <font> tag to specificy different font <font color='#FF0000'>colors</font>, <font size='16'>sizes</font>, or <font face='Times New Roman'>faces</font>.</p>";
myText += "<p>You can use the <img> tag to load images or SWF files:<br><img src='http://www.helpexamples.com/flash/images/logo.png'>.</p>";

var myTextArea:TextArea = new TextArea();
myTextArea.htmlText = myText;
myTextArea.setSize(320, 240);
myTextArea.move(10, 10);
addChild(myTextArea);
В следующем примере создается экземпляр компонента TextArea, а ссылки формируются с помощью тега привязки:

import fl.controls.TextArea;

var str:String = "<p>Check out the following links:</p>";
str += "<li><a href=\"event:flash\"><u>Flash</u></a></li>";
str += "<li><a href=\"event:flex\"><u>Flex</u></a></li>";
str += "<li><a href=\"event:devnet\"><u>Developer Center</u></a></li>";

var myTextArea:TextArea = new TextArea();
myTextArea.htmlText += str;
myTextArea.setSize(320, 120);
myTextArea.move(10, 10);
myTextArea.addEventListener(TextEvent.LINK, linkHandler);
addChild(myTextArea);

function linkHandler(event:TextEvent):void {
    var url:String = "http://www.adobe.com/go/" + event.text;
    var urlReq:URLRequest = new URLRequest(url);
    navigateToURL(urlReq);
}
imeModeсвойство 
imeMode:String  [чтение и запись]

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9.0.28.0

Определяет или задает режим редактора методов ввода (IME). IME дает пользователям возможность воспользоваться клавиатурой QWERTY для ввода символов из наборов для китайского, японского и корейского языков.

Программа Flash переводит IME в указанный режим, когда компонент оказывается в фокусе, и восстанавливает исходное значение после того, как он выходит из фокуса.

Класс flash.system.IMEConversionMode определяет константы для действительных значений этого свойства. Присвойте этому свойству значение null, чтобы предотвратить применение IME по отношению к этому компоненту.



Реализация
    public function get imeMode():String
    public function set imeMode(value:String):void

См. также

lengthсвойство 
length:Number  [только для чтения]

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9.0.28.0

Определяет число символов в компоненте TextArea.

Значение по умолчанию 0



Реализация
    public function get length():Number

См. также

maxCharsсвойство 
maxChars:int  [чтение и запись]

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9.0.28.0

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

Значение по умолчанию 0



Реализация
    public function get maxChars():int
    public function set maxChars(value:int):void

См. также


Пример
В следующем примере создается экземпляр компонента TextArea, а свойство maxChars используется для ограничения объема текста, который может быть введен в текстовую область:

import fl.controls.Label;
import fl.controls.TextArea;

var myTextArea:TextArea = new TextArea();
myTextArea.maxChars = 500;
myTextArea.setSize(320, 240);
myTextArea.move(10, 10);
myTextArea.addEventListener(TextEvent.TEXT_INPUT, textInputHandler);
addChild(myTextArea);

var charCountLabel:Label = new Label();
charCountLabel.autoSize = TextFieldAutoSize.LEFT;
charCountLabel.move(myTextArea.x, myTextArea.y + myTextArea.height);
addChild(charCountLabel);

charCountLabel.text = myTextArea.length + " of " + myTextArea.maxChars;

function textInputHandler(event:TextEvent):void {
    updateCount();
}

function updateCount():void {
    charCountLabel.text = myTextArea.length + " of " + myTextArea.maxChars;
}
maxHorizontalScrollPositionсвойство 
maxHorizontalScrollPosition:int  [только для чтения]

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9.0.28.0

Определяет максимальное значение свойства horizontalScrollPosition.

Значение по умолчанию 0



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

См. также

maxVerticalScrollPositionсвойство 
maxVerticalScrollPosition:int  [только для чтения]

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9.0.28.0

Определяет максимальное значение свойства verticalScrollPosition.

Значение по умолчанию 1



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

См. также

restrictсвойство 
restrict:String  [чтение и запись]

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9.0.28.0

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

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

Символы в строке читаются слева направо. Можно задать диапазон символов с помощью дефиса (-).

Если значение этого свойства — null, текстовое поле поддерживает все символы. Если для этого свойства задана пустая строка (""), текстовое поле не поддерживает ввод символов.

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

Значение по умолчанию null



Реализация
    public function get restrict():String
    public function set restrict(value:String):void

См. также

selectionBeginIndexсвойство 
selectionBeginIndex:int  [только для чтения]

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9.0.28.0

Определяет положение индекса первого выделенного символа в выделенном диапазоне из одного или нескольких символов.

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

Значение по умолчанию 0



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

См. также

selectionEndIndexсвойство 
selectionEndIndex:int  [только для чтения]

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9.0.28.0

Определяет индекс последнего выделенного символа в выделенном диапазоне из одного или нескольких символов.

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

Значение по умолчанию 0



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

См. также

textсвойство 
text:String  [чтение и запись]

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9.0.28.0

Определяет или задает строку, которая содержит текст, отображаемый в настоящее время компонентом TextInput. Это свойство содержит неформатированный текст, который лишен тегов HTML. Чтобы извлечь этот текст в формате HTML, воспользуйтесь свойством htmlText.

Значение по умолчанию ""



Реализация
    public function get text():String
    public function set text(value:String):void

См. также

textFieldсвойство 
public var textField:TextField

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9.0.28.0

Ссылка на внутреннее текстовое поле компонента TextArea.

textHeightсвойство 
textHeight:Number  [только для чтения]

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9.0.28.0

Определяет высоту текста (в пикселах).

Значение по умолчанию 0



Реализация
    public function get textHeight():Number

См. также


Пример
В следующем примере создается экземпляр компонента TextArea и отображаются свойства textWidth и textHeight каждый раз при отправке события change:

import fl.controls.Label;
import fl.controls.TextArea;

var myTextArea:TextArea = new TextArea()
myTextArea.setSize(320, 240);
myTextArea.move(10, 10);
myTextArea.addEventListener(Event.CHANGE, changeHandler);
addChild(myTextArea);

var widthLabel:Label = new Label();
widthLabel.autoSize = TextFieldAutoSize.LEFT;
widthLabel.text = "textWidth: " + myTextArea.textWidth;
widthLabel.move(340, 10);
addChild(widthLabel);

var heightLabel:Label = new Label();
heightLabel.autoSize = TextFieldAutoSize.LEFT;
heightLabel.text = "textHeight: " + myTextArea.textHeight;
heightLabel.move(340, 30);
addChild(heightLabel);

function changeHandler(event:Event):void {
    widthLabel.text = "textWidth: " + myTextArea.textWidth;
    heightLabel.text = "textHeight: " + myTextArea.textHeight;
}
textWidthсвойство 
textWidth:Number  [только для чтения]

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9.0.28.0

Определяет ширину текста (в пикселах).

Значение по умолчанию 0



Реализация
    public function get textWidth():Number

См. также


Пример
В следующем примере создается экземпляр компонента TextArea и отображаются свойства textWidth и textHeight каждый раз при отправке события change:

import fl.controls.Label;
import fl.controls.TextArea;

var myTextArea:TextArea = new TextArea()
myTextArea.setSize(320, 240);
myTextArea.move(10, 10);
myTextArea.addEventListener(Event.CHANGE, changeHandler);
addChild(myTextArea);

var widthLabel:Label = new Label();
widthLabel.autoSize = TextFieldAutoSize.LEFT;
widthLabel.text = "textWidth: " + myTextArea.textWidth;
widthLabel.move(340, 10);
addChild(widthLabel);

var heightLabel:Label = new Label();
heightLabel.autoSize = TextFieldAutoSize.LEFT;
heightLabel.text = "textHeight: " + myTextArea.textHeight;
heightLabel.move(340, 30);
addChild(heightLabel);

function changeHandler(event:Event):void {
    widthLabel.text = "textWidth: " + myTextArea.textWidth;
    heightLabel.text = "textHeight: " + myTextArea.textHeight;
}
verticalScrollBarсвойство 
verticalScrollBar:UIScrollBar  [только для чтения]

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9.0.28.0

Определяет ссылку на вертикальную полосу прокрутки.



Реализация
    public function get verticalScrollBar():UIScrollBar

См. также


Пример
В следующем примере создается компонент TextArea и устанавливается свойство pageSize для вертикальной полосы прокрутки компонента:

import fl.controls.TextArea;
import fl.events.ScrollEvent;

var myTextArea:TextArea = new TextArea();
myTextArea.setSize(160, 120);
myTextArea.move(10, 10);
myTextArea.verticalScrollBar.pageSize = 1;
myTextArea.addEventListener(ScrollEvent.SCROLL, scrollHandler);
addChild(myTextArea);

var myURLLoader:URLLoader = new URLLoader();
myURLLoader.addEventListener(Event.COMPLETE, completeHandler);
myURLLoader.load(new URLRequest("http://www.helpexamples.com/flash/lorem.txt"));

function scrollHandler(event:ScrollEvent):void {
    trace("scroll: " + myTextArea.verticalScrollPosition + " of " + myTextArea.maxVerticalScrollPosition);
}

function completeHandler(event:Event):void {
    var txt:String = URLLoader(event.currentTarget).data as String;
    myTextArea.text = txt;
}
verticalScrollPolicyсвойство 
verticalScrollPolicy:String  [чтение и запись]

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9.0.28.0

Определяет или задает правило прокрутки вертикальной полосы прокрутки. Это может быть одно из указанных ниже значений.

Значение по умолчанию ScrollPolicy.AUTO



Реализация
    public function get verticalScrollPolicy():String
    public function set verticalScrollPolicy(value:String):void

См. также


Пример
В следующем примере создается экземпляр компонента TextArea, а его свойству verticalScrollPolicy присваивается значение ScrollPolicy.ON. Таким образом, вертикальная полоса прокрутки всегда будет видна независимо от объема содержимого, которое находится в текстовой области в данный момент.

import fl.controls.TextArea;
import fl.controls.ScrollPolicy;

var myTextArea:TextArea = new TextArea();
myTextArea.verticalScrollPolicy = ScrollPolicy.ON;
myTextArea.text = "The quick brown fox jumped over the lazy dog.";
myTextArea.setSize(160, 120);
myTextArea.move(10, 10);
addChild(myTextArea);
verticalScrollPositionсвойство 
verticalScrollPosition:Number  [чтение и запись]

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9.0.28.0

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

Значение по умолчанию 1



Реализация
    public function get verticalScrollPosition():Number
    public function set verticalScrollPosition(value:Number):void

См. также


Пример
В следующем примере компонент Slider применяется для прокрутки содержимого компонента TextArea:

import fl.controls.ScrollPolicy;
import fl.controls.Slider;
import fl.controls.SliderDirection
import fl.controls.TextArea;
import fl.events.ScrollEvent;
import fl.events.SliderEvent;

var myTextArea:TextArea = new TextArea();
myTextArea.horizontalScrollPolicy = ScrollPolicy.OFF;
myTextArea.verticalScrollPolicy = ScrollPolicy.OFF;
myTextArea.setSize(320, 240);
myTextArea.move(10, 10);
myTextArea.addEventListener(ScrollEvent.SCROLL, scrollHandler);
addChild(myTextArea)

var mySlider:Slider = new Slider();
mySlider.liveDragging = true;
mySlider.snapInterval = 1;
mySlider.tickInterval = 1;
mySlider.width = myTextArea.width;
mySlider.move(myTextArea.x, myTextArea.y + myTextArea.height + 10);

var urlLdr:URLLoader = new URLLoader();
urlLdr.addEventListener(Event.COMPLETE, completeHandler);
urlLdr.dataFormat = URLLoaderDataFormat.TEXT;
urlLdr.load(new URLRequest("http://www.helpexamples.com/flash/text/lorem.txt"));

function completeHandler(event:Event):void {
    var txt:String = event.target.data as String;
    myTextArea.text = txt;
    myTextArea.drawNow();

    mySlider.minimum = myTextArea.verticalScrollPosition;
    mySlider.maximum = myTextArea.maxVerticalScrollPosition;
    mySlider.addEventListener(SliderEvent.CHANGE, changeHandler);
    addChild(mySlider);
}

function scrollHandler(event:ScrollEvent):void {
    trace("scrolled:");
    mySlider.value = event.position;
}

function changeHandler(event:SliderEvent):void {
    trace("changed:");
    myTextArea.verticalScrollPosition = event.value;
}
wordWrapсвойство 
wordWrap:Boolean  [чтение и запись]

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9.0.28.0

Определяет или задает логическое значение, указывающее, переносится ли текст по словам в конце строки. Значение true указывает на перенос текста; значение false говорит о том, что текст не переносится.

Значение по умолчанию true



Реализация
    public function get wordWrap():Boolean
    public function set wordWrap(value:Boolean):void

См. также

Сведения о конструкторе
TextArea()Конструктор
public function TextArea()

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9.0.28.0

Создает новый экземпляр компонента TextArea.

Сведения о методе
appendText()метод
public function appendText(text:String):void

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9.0.28.0

Добавляет заданную строку после последнего символа в компоненте TextArea. Этот метод более эффективен, чем сцепление двух строк при помощи сложения и присваивания по отношению к свойству текста (например, myTextArea.text += moreText). Этот метод особенно полезен, когда компонент TextArea имеет значительный объем содержимого.

Параметры

text:String — Строка, добавляемая в конец существующего текста.

drawFocus()метод 
override public function drawFocus(focused:Boolean):void

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9.0.28.0

Отображает или скрывает индикатор фокуса этого компонента.

Класс UIComponent реализует этот метод путем создания и размещения экземпляра класса, указанного стилем focusSkin.

Параметры

focused:Boolean — Указывает, следует ли показать или скрыть индикатор фокуса. Если выбрано значение true, виден индикатор фокуса; если указано значение false, индикатор фокуса скрыт.

getLineMetrics()метод 
public function getLineMetrics(lineIndex:int):TextLineMetrics

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9.0.28.0

Возвращает сведения об указанной строке текста.

Параметры

lineIndex:int — Номер строки, для которой следует извлечь информацию.

Возвращает
TextLineMetrics
getStyleDefinition()метод 
public static function getStyleDefinition():Object

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9.0.28.0

Возвращает карту стилей по умолчанию для текущего компонента. Карта стилей содержит тип, который подходит для компонента в зависимости от стиля, используемого компонентом. Например, стиль disabledTextFormat содержит значение null или объект TextFormat. Вы можете воспользоваться этими стилями и вызвать метод setStyle() по отношению к текущему компоненту. Следующий код переопределяет стиль disabledTextFormat, выбранный по умолчанию для указанного компонента:

componentInstance.setStyle("disabledTextFormat", new TextFormat());

Возвращает
Object — Объект стилей по умолчанию.

См. также


Пример

В следующем примере создается обозреватель стилей для нескольких классов компонентов:
import fl.controls.*;
import fl.containers.*;
import fl.controls.listClasses.*;
import fl.controls.dataGridClasses.*;
import fl.controls.progressBarClasses.*;
import fl.core.UIComponent;
import fl.data.DataProvider;

var dp:DataProvider = new DataProvider();
dp.addItem( { label: "BaseScrollPane",    data:BaseScrollPane } );
dp.addItem( { label: "Button",             data:Button } );
dp.addItem( { label: "CellRenderer",    data:CellRenderer } );
dp.addItem( { label: "CheckBox",         data:CheckBox } );
dp.addItem( { label: "ColorPicker",     data:ColorPicker } );
dp.addItem( { label: "ComboBox",         data:ComboBox } );
dp.addItem( { label: "DataGrid",         data:DataGrid } );
dp.addItem( { label: "HeaderRenderer",    data:HeaderRenderer } );
dp.addItem( { label: "ImageCell",        data:ImageCell } );
dp.addItem( { label: "IndeterminateBar",data:IndeterminateBar } );
dp.addItem( { label: "Label",             data:Label } );
dp.addItem( { label: "List",             data:List } );
dp.addItem( { label: "NumericStepper",     data:NumericStepper } );
dp.addItem( { label: "ProgressBar",     data:ProgressBar } );
dp.addItem( { label: "RadioButton",     data:RadioButton } );
dp.addItem( { label: "ScrollPane",         data:ScrollPane } );
dp.addItem( { label: "Slider",             data:Slider } );
dp.addItem( { label: "TextArea",         data:TextArea } );
dp.addItem( { label: "TextInput",         data:TextInput } );
dp.addItem( { label: "TileList",         data:TileList } );
dp.addItem( { label: "UILoader",         data:UILoader } );
dp.addItem( { label: "UIComponent",     data:UIComponent } );

var cb:ComboBox = new ComboBox();
cb.move(10,10);
cb.setSize(300,25);
cb.prompt = "Select a component to view its styles";
cb.rowCount = 12;
cb.dataProvider = dp;
cb.addEventListener(Event.CHANGE, showStyleDefinition);
addChild(cb);

var dg:DataGrid = new DataGrid();
dg.setSize(425,300);
dg.move(10,50);
dg.columns = [ new DataGridColumn("StyleName"), new DataGridColumn("DefaultValue") ];
addChild(dg);

function showStyleDefinition(e:Event):void {
    var componentClass:Class = e.target.selectedItem.data as Class;
    var styles:Object = componentClass["getStyleDefinition"].call(this);
    trace(styles.toString());
    var styleData:DataProvider = new DataProvider();
    for(var i:* in styles) {
        trace(i + " : " + styles[i]);
        styleData.addItem( { StyleName:i, DefaultValue:styles[i] } );
    }
    styleData.sortOn("StyleName");
    dg.dataProvider = styleData;
}
setSelection()метод 
public function setSelection(setSelection:int, endIndex:int):void

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9.0.28.0

Задает диапазон выделения в текстовой области, имеющей фокус. Выделенный диапазон начинается с индекса, который указывается начальным параметром, и заканчивается индексом, указанным конечным параметром. Выделенный текст воспринимается как строка символов, начинающаяся с нуля, в которой первый выбранный символ расположен в положении с индексом 0, второй символ — в положении с индексом 1 и т.д.

Этот метод не работает, если текстовое поле находится не в фокусе.

Параметры

setSelection:int — Положение индекса для первого символа в выделенном фрагменте.
 
endIndex:int — Положение индекса для последнего символа в выделенном фрагменте.

Сведения о событии
change Событие
Тип объекта события: flash.events.Event
свойство Event.type = flash.events.Event.CHANGE

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9.0.28.0

Отправляется при изменении текста в элементе управления TextArea.

Константа Event.CHANGE определяет значение свойства type объекта события change.

Данное событие имеет следующие свойства.

СвойствоЗначение
bubblestrue
cancelablefalse; нет поведения по умолчанию для отмены.
currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.
targetОбъект, значение которого было изменено. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget, чтобы обратиться к объекту в списке отображения, обрабатывающему событие в данный момент.
enter Событие  
Тип объекта события: fl.events.ComponentEvent
свойство ComponentEvent.type = fl.events.ComponentEvent.ENTER

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9.0.28.0

Отправляется при нажатии клавиши Enter, когда курсор находится в компоненте.

Задает значение свойства type для объекта события enter.

Данное событие имеет следующие свойства.

СвойствоЗначение
bubblesfalse
cancelablefalse; нет поведения по умолчанию для отмены.
currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.
targetОбъект, отправивший событие. Адресат не всегда является объектом, выполняющим прослушивание события. Воспользуйтесь свойством currentTarget для доступа к объекту, прослушивающему событие.
scroll Событие  
Тип объекта события: fl.events.ScrollEvent
свойство ScrollEvent.type = fl.events.ScrollEvent.SCROLL

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9.0.28.0

Отправляется во время прокрутки содержимого.

Задает значение свойства type для объекта события scroll.

Данное событие имеет следующие свойства.

СвойствоЗначение
bubblesfalse
cancelablefalse; нет поведения по умолчанию для отмены.
currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.
delta1; значение, указывающее величину прокрутки.
directionvertical; направление объекта ScrollBar.
position0; положение бегунка Scrollbar после того, как он был перемещен.
targetОбъект, отправивший событие. Адресат не всегда является объектом, выполняющим прослушивание события. Воспользуйтесь свойством currentTarget для доступа к объекту, прослушивающему событие.

Пример

В следующем примере выполняется загрузка текста в компонент TextArea и отслеживание направления прокрутки, положения прокрутки и максимального положения прокрутки, когда пользователь прокручивает TextArea:

import fl.controls.ScrollBarDirection;
import fl.controls.TextArea;
import fl.events.ScrollEvent;

var myTextArea:TextArea = new TextArea();
myTextArea.setSize(320, 240);
myTextArea.move(10, 10);
myTextArea.addEventListener(ScrollEvent.SCROLL, scrollHandler);
addChild(myTextArea);

var urlLdr:URLLoader = new URLLoader();
urlLdr.addEventListener(Event.COMPLETE, completeHandler);
urlLdr.dataFormat = URLLoaderDataFormat.TEXT;
urlLdr.load(new URLRequest("http://www.helpexamples.com/flash/text/lorem.txt"));

function completeHandler(event:Event):void {
    var txt:String = event.target.data as String;
    myTextArea.text = txt;
}

function scrollHandler(event:ScrollEvent):void {
    var myTA:TextArea = event.currentTarget as TextArea;
    var pos:Number = event.position;
    var maxPos:Number;
    
    if (event.direction == ScrollBarDirection.VERTICAL) {
        maxPos = myTA.maxVerticalScrollPosition;
    } else {
        maxPos = myTA.maxHorizontalScrollPosition;
    }
    trace("scroll: " + event.direction + " (" + pos.toFixed(2) + " of " + maxPos + ")");
}
textInput Событие  
Тип объекта события: flash.events.TextEvent
свойство TextEvent.type = flash.events.TextEvent.TEXT_INPUT

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9.0.28.0

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

Задает значение свойства type для объекта события textInput.

Данное событие имеет следующие свойства.

СвойствоЗначение
bubblestrue
cancelabletrue; вызовите метод preventDefault() для отмены поведения по умолчанию.
currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.
targetТекстовое поле, в которое вводятся символы. Цель не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget, чтобы обратиться к объекту в списке отображения, обрабатывающему событие в данный момент.
textСимвол или последовательность символов, введенных пользователем.
Примеры Как пользоваться примерами
TextAreaExample.as

В этом примере показано, как прослушивать события экземпляра класса TextArea
  1. Перетащите компонент TextArea в рабочую область и присвойте ему имя ta1.
  2. Перетащите компонент TextArea в рабочую область и присвойте ему имя ta2.
  3. Сохраните этот код под именем TextAreaExample.as в том же каталоге, где и FLA-файл.
  4. Присвойте параметру DocumentClass в FLA-файле значение TextAreaExample.
package
{
    import flash.display.Sprite;
    import flash.events.Event;
    import flash.events.TextEvent;
    import flash.text.TextField;
    import fl.events.ComponentEvent;
    import fl.controls.TextArea;
    
    public class TextAreaExample extends Sprite
    {
        private var testString:String         = 'Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Vivamus quis nisl vel tortor nonummy vulputate. Quisque sit amet eros sed purus euismod tempor. Morbi tempor. Class aptent taciti sociosqu ad litora torquent per conubia nostra, per inceptos hymenaeos. Curabitur diam. Suspendisse at purus in ipsum volutpat viverra. Nulla pellentesque libero id libero. Proin pretium suscipit lectus. Donec in sapien vel nulla egestas semper. Mauris massa. In aliquet sem ac libero. In eget orci. Sed feugiat. Vestibulum vel felis in lectus imperdiet scelerisque. Vestibulum vestibulum neque at est. Etiam purus quam, laoreet quis, accumsan sed, porttitor ut, erat. Proin volutpat. In facilisis dolor gravida felis. Curabitur nisi lacus, euismod non, pharetra et, mollis a, tellus. Donec lectus orci, viverra at, luctus ac, sodales id, quam. Phasellus faucibus lacus ut est. Curabitur id diam eu massa bibendum lobortis. Vivamus quis elit. Donec mi justo, dictum vitae, cursus sit amet, lacinia consectetuer, d ut, vulputate sed, molestie et, arcu. Nullam mi.';
        private var testStringHTML:String     = 'This is <font color="#FF0000">HTML text</font> in a <b>TextArea control</b>. Use the <u>htmlText property</u> of the <font color="#008800">TextArea control</font> to include basic HTML markup in your text.';
        
        public function TextAreaExample() {
            ta1.text = testString;
            ta2.htmlText = testStringHTML;
            configureListeners(ta1);
            configureListeners(ta2);
        }
        private function configureListeners(ta:TextArea):void {
            ta.addEventListener(TextEvent.TEXT_INPUT,announceEvent);
            ta.addEventListener(Event.CHANGE,announceEvent);
            ta.addEventListener(ComponentEvent.ENTER,announceEvent);
            ta.addEventListener(Event.SCROLL,announceEvent);            
        }
        private function announceEvent(e:Event):void {
            trace(e.toString());    
        }
    }
}