TextArea  - AS3 Flex

Указывает, требуется ли удалить лишние разделители (пробелы, разрывы строки и т. д.) в элементе управления TextArea с HTML-текстом.

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

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

Значением по умолчанию является false.

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

Позволяет выполнить передачу значения в компонент при его использовании в средстве визуализации элементов или редакторе элементов. Привязка данных, как правило, используется для привязки поля свойства data к свойству данного компонента.

При использовании элемента управления в качестве средства визуализации или редактора вставных элементов Flex автоматически записывает текущее значение элемента в свойство text данного элемента управления.

Это свойство не устанавливается в MXML.

Значением по умолчанию является null.

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

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

Указывает, используется ли этот элемент управления для ввода паролей. Если значение равно true, поле не отображает введенный текст. При этом вместо каждого введенного в элемент управления текстового символа отображается звездочка «*».

Значением по умолчанию является false.

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

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

Значением по умолчанию является true;.

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

Флаг, указывающий на необходимость активации IME при получении компонентом фокуса.

Управляет видимостью горизонтальной полосы прокрутки: всегда включена (ScrollPolicy.ON), всегда выключена (ScrollPolicy.OFF) или включается при необходимости (ScrollPolicy.AUTO).

Значением по умолчанию является ScrollPolicy.AUTO.

Расположение в области содержимого крайнего левого пикселя, отображаемого в настоящий момент. (Область содержимого включает все содержимое элемента управления, а не только отображаемый в данный момент фрагмент.) Для этого свойства всегда устанавливается значение 0. Любые изменения игнорируются, если для wordWrap установлено значение true.

Значением по умолчанию является 0.

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

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

При активации данного свойства после применения стилей CSS для экземпляра TextArea применяется разметка HTML. При получении этого свойства разметка HTML включает стили CSS.

Например, при определении строки, такой как «Это пример полужирной разметки», текст «Это пример <b>полужирной</b> разметки» отображается в TextArea со всеми применяемыми стилями CSS. Кроме того, слово «полужирный» отображается жирным шрифтом вследствие разметки <b>.

В разметке HTML используются символы, такие как < и >, которые имеют специальное значение в XML (и, следовательно, в MXML). Например, следующий код не компилируется:

      <mx:TextArea htmlText="This is an example of <b>bold</b> markup"/>
      

Существует три способа решения этой проблемы.

• Установите значение для свойства htmlText в методе ActionScript, вызываемом в качестве обработчика initialize,

        <mx:TextArea id="myTextArea" initialize="myTextArea_initialize()"/>
        

  где метод myTextArea_initialize находится в разделе сценария CDATA:

        <fx:Script>
        <![CDATA[
        private function myTextArea_initialize():void {
            myTextArea.htmlText = "This is an example of <b>bold</b> markup";
        }
        ]]>
        </fx:Script>
        
        

  Это наиболее простой подход, поскольку разметка HTML остается читаемой. Учтите, что TextArea необходимо присвоить id для получения возможности обращения к нему в обработчике initialize.

• Укажите значение свойства htmlText с помощью нижестоящего тега в разделе CDATA. Раздел CDATA в XML содержит символьные данные, где символы < и > не несут специального значения.

        <mx:TextArea>
            <mx:htmlText><![CDATA[This is an example of <b>bold</b> markup]]></mx:htmlText>
        <mx:TextArea/>
        

  Свойство htmlText необходимо записать в качестве нижестоящего тега, а не атрибута в теге <mx:TextArea>, поскольку в XML невозможно использовать CDATA в качестве значения атрибута. Учтите, что разметка остается читаемой, но особенности использования раздела CDATA затрудняют применение этого подхода.

• Атрибут hmtlText используется в том случае, если вхождения символов < и > разметки HTML в значении атрибута записаны вместо объектов XML < и >:

        <mx:TextArea htmlText="This is an example of <b>bold</b> markup"/>
        

  Adobe не рекомендует использовать этот подход, поскольку при этом разметка HTML становится практически нечитаемой.

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

При считывании свойства htmlText сразу же после установки его значения будет получена та же установленная строка. Однако после запуска LayoutManager значение изменяется и включает дополнительную разметку со стилями CSS.

Установка свойства htmlText оказывает на text различное воздействие. При считывании свойства text сразу же после установки свойства htmlText будет получено значение null. Это означает, что значение свойства text, соответствующее новому значению htmlText, еще не определено. Однако после запуска LayoutManager значение свойства text изменяется на строку htmlText без HTML-разметки; т. е. значение включает символы, реально отображаемые TextArea.

Наоборот, при установке свойства text любое предыдущее значение htmlText становится нерелевантным. При считывании свойства htmlText сразу же после установки свойства text будет получено значение null. Это означает, что значение htmlText, соответствующее новому значению text, еще не определено. Однако после запуска LayoutManager значение свойства htmlText изменяется на новый текст с разметкой HTML для стилей CSS.

Для немедленного запуска LayoutManager можно вызвать метод validateNow() в TextArea. Например, можно установить htmlText, вызвать метод validateNow() и немедленно получить соответствующее значение text без разметки HTML.

При установке свойств text и htmlText в ActionScript будет использовано только последнее значение. Не устанавливайте оба эти свойства в MXML, поскольку в MXML невозможно обеспечить указанный порядок установки свойств экземпляра.

Настройка свойства text или htmlText в цикле выполняется быстро, поскольку соответствующий TextField, который обеспечивает визуализацию текста, не обновляется до запуска LayoutManager.

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

Значением по умолчанию является "".

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

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

Указывает режим IME (редактор методов ввода). IME позволяет пользователям вводить текст на китайском, японском и корейском языках. Режим IME устанавливается при перемещении фокуса на элемент управления и возвращается к предыдущему значению при потере фокуса этим элементом управления.

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

Значением по умолчанию является null.

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

Количество символов текста, отображаемых в TextArea.

Значением по умолчанию является 0.

Если компонент используется в качестве средства визуализации или редактора вставных элементов, то Flex инициализирует свойство компонента listData соответствующими данными из элемента управления списка. Затем компонент может использовать свойство listData для инициализации свойства data средства визуализации или редактора вставных объектов.

Это свойство не устанавливается в MXML или ActionScript; Flex устанавливает его, когда компонент используется как средство визуализации или редактор вставных элементов.

Значением по умолчанию является null.

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

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

Максимальное количество символов, которые может ввести пользователь в текстовом поле. Это свойство не ограничивает длину текста, заданного значениями свойств элемента управления text или htmlText.

Значением по умолчанию является 0. При этом значении ограничения отсутствуют.

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

Определяет набор символов, которые пользователь может ввести в элементе управления. Если свойству restrict присвоено значение null, можно ввести любой символ. Если в качестве значения свойства restrict установлена пустая строка, ввод символов невозможен. Это свойство ограничивает только действия пользователя; сценарий может помещать в текстовое поле любые символы. Если значением свойства restrict является строка символов, в текстовое поле можно ввести только символы из этой строки.

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

Поскольку некоторые символы при использовании в свойстве restrict приобретают специальное значение, для указания буквенных символов – ^ и \ необходимо указывать символ обратной косой черты. При использовании свойства restrict в качестве атрибута в теге MXML укажите одинарный символ обратной косой черты, например: \^\-\\. При установке свойства restrict и выражения ActionScript используются двойные символы обратной косой черты, как в следующем примере: \\^\\-\\\.

Значением по умолчанию является null.

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

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

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

Значением по умолчанию является true.

Отсчитываемое от нуля значение индекса для первого символа в текущем выделенном фрагменте. Например, первый символ имеет индекс 0, второй — индекс 1 и т. д. При фокусировке на элементе управления выбор становится видимым в том случае, если установлены значения для свойств selectionBeginIndex и selectionEndIndex.

Значением по умолчанию является 0.

Отсчитываемый от нуля индекс позиции послепоследнего символа в текущем диапазоне (эквивалентен индексу последнего символа, отсчитываемому от единицы). Если последний символ в диапазоне, например, является пятым символом, это свойство имеет значение 5. При фокусировке на элементе управления выбор становится видимым в том случае, если установлены значения для свойств selectionBeginIndex и selectionEndIndex.

Значением по умолчанию является 0.

Объект flash.text.StyleSheet может выполнять визуализацию текста элемента управления TextArea. Используется для точного контроля стилей HTML для текста. Для получения дополнительной информации см. документацию по классу flash.text.StyleSheet.

Значением по умолчанию является null.

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

Простой текст, отображаемый в элементе управления. Его внешний вид определяется стилями CSS данного элемента управления Label.

Любые HTML-теги в текстовой строке игнорируются и отображаются при вводе в строку. Для отображения отформатированного текста с помощью HTML-тегов используется свойство htmlText. При активации свойства htmlText HTML заменяет любой заданный с помощью этого свойства текст, а свойство text возвращает неформатированный текст HTML без тегов HTML. Для получения дополнительной информации см. описание свойства htmlText.

Для включения в текст специальных символов левой угловой скобки (<), правой угловой скобки (>) или амперсанда (&) необходимо заключить текстовую строку в тег CDATA. Либо можно использовать объекты HTML для специальных символов, например <.

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

Значением по умолчанию является "".

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