TextInput  - AS3 Flex

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Фабрика модулей, обеспечивающая контекст шрифта для этого компонента.

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

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

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

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

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

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

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

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

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

        <mx:TextInput id="myTextInput" initialize="myTextInput_initialize()"/>
        

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

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

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

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

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

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

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

        <mx:TextInput 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-разметка удаляется; таким образом, значение включает символы, которые реально отображаются с помощью TextInput.

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

Для немедленного запуска LayoutManager вызовите метод validateNow() в TextInput. Например, можно установить 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 .

Если true, вызовы метода drawFocus() элемента управления передаются в метод drawFocus() вышестоящего элемента. Это применяется, если TextInput является частью составного элемента управления, например NumericStepper или ComboBox;

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

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

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

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

Флаг, указывающий, можно ли выбрать текст в TextInput.

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

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

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

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

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

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

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

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

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

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

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

Внутренний объект UITextField, который обеспечивает визуализацию текста данного TextInput.

Высота текста.

Значение свойства textHeight становится корректным только после проверки компонента. При установке значения свойства text и немедленном запросе textHeight возможно получение некорректного значения. Перед получением значения необходимо дождаться завершения проверки компонента или вызвать метод validateNow(). Это поведение отличается от поведения элемента управления flash.text.TextField, который выполняет обновление значения незамедлительно.

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