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

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

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

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

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

Для получения доступа к экземпляру редактора элементов и новому значению элемента во время редактирования воспользуйтесь свойством itemEditorInstance. Свойство itemEditorInstance учитывается только после выполнения прослушивателя событий для события itemEditBegin. Поэтому обычно доступ к свойству itemEditorInstance осуществляется только из прослушивателя событий для события itemEditEnd.

Свойство itemEditor определяет класс редактора элементов, и, следовательно, тип данных экземпляра редактора элементов.

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

Этот объект состоит из двух полей, columnIndex и rowIndex, столбца, отсчитываемого от нуля, и индексов элементов для элемента. Для элемента управления List свойство columnIndex всегда имеет значение 0, например: {columnIndex:0, rowIndex:3}.

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

Из прослушивателя событий для событий itemEditBegin и itemEditEnd можно вызвать текущее значение редактируемого элемента с помощью свойства editedItemRenderer.data.

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

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

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

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

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

При активации данного свойства после применения стилей 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 &lt; и &gt;:

        <mx:TextArea htmlText="This is an example of &lt;b&gt;bold&lt;/b&gt; markup"/&gt;
        

  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 еще не определено.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

В ActionScript для установки значения этого свойства используются следующие константы: ProgressBarDirection.RIGHT и ProgressBarDirection.LEFT.

В ActionScript для установки значения этого свойства используются следующие константы: ProgressBarLabelPlacement.RIGHT, ProgressBarLabelPlacement.LEFT, ProgressBarLabelPlacement.BOTTOM, ProgressBarLabelPlacement.CENTER и ProgressBarLabelPlacement.TOP.

• %1 = текущее количество загруженных байтов;
• %2 = общее количество байтов;
• %3 = процент загрузки;
• %% = символ «%».

Если значение поля неизвестно, оно заменяется на «??». Если установлено значение undefined, метка не отображается.

В ручном режиме значения этих специальных символов устанавливаются с помощью метода setProgress().

• event Элемент управления, определяемый свойством source, должен передавать события выполнения и завершенные события. Элемент управления ProgressBar использует эти события для обновления своего состояния. Элемент управления ProgressBar обновляется только в том случае, если значение свойства source расширяет класс EventDispatcher.
• polled Свойство source должно указывать объект, который предоставляет свойства bytesLoaded и bytesTotal. Элемент управления ProgressBar вызывает эти методы для обновления своего статуса.
• manual Статус ProgressBar обновляется вручную. В этом режиме указываются значения свойств maximum и minimum, и используется метод свойства setProgress() для указания статуса. Этот режим часто используется, если для свойства indeterminate установлено значение true.

В ActionScript для установки значения этого свойства используются следующие константы: ProgressBarMode.EVENT, ProgressBarMode.POLLED и ProgressBarMode.MANUAL.

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

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

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

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

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

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

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

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

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

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

        <mx:Label id="myLabel" initialize="myLabel_initialize()"/>
        

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

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

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

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

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

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

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

        <mx:Label htmlText="This is an example of &lt;b&gt;bold&lt;/b&gt; markup"/&gt;
        

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

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

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

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

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

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

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

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

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

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

Если событие link указано в элементе управления Label, необходимо установить свойство selectable как true для выполнения события link.

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

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

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

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

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

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

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

Подклассы Button, например классы SliderThumb и ScrollThumb или стрелки вверх и вниз для ScrollBar, устанавливают для этого свойства значение true.

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

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

В ActionScript для установки значения этого свойства используются следующие константы: ButtonLabelPlacement.RIGHT, ButtonLabelPlacement.LEFT, ButtonLabelPlacement.BOTTOM и ButtonLabelPlacement.TOP.

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

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

Для элемента управления CheckBox указывает, отображается ли в поле флажок. Для элемента управления RadioButton указывает, выбран ли данный элемент управления.

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

Если в предыдущих версиях для свойства toggle было установлено значение true, то при изменении этого свойства также передавалось событие change. С версии 3.0 при настройке этого свойства программным способом передается только событие valueCommit.

Если объекты dataProvider не содержат поле цвета, настройте свойство colorField для использования корректного имени поля. Это свойство доступно, но не является значимым, если dataProvider представляет собой массив шестнадцатеричных значений цветов.

Если объекты dataProvider не содержат поле метки, установите свойство labelField для использования корректного имени поля. Это свойство доступно, но не является значимым, если dataProvider представляет собой массив шестнадцатеричных значений цветов.

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

Это свойство принимает массив объектов в качестве параметра. Каждый объект в этом массиве является объектом Date, который указывает один день, подлежащий деактивации; или объектом, содержащим одно или оба свойства rangeStart и rangeEnd, каждое из значений которых представляет собой объект Date. Значение этих свойств указывает границы диапазона дат. Если любое из значений опущено, диапазон рассматривается как неограниченный в соответствующем направлении. Если определено только свойство rangeStart, деактивируются все даты после указанной даты, включая дату rangeStart. Если определено только свойство rangeEnd, деактивируются все даты, предшествующие указанной дате, включая дату rangeEnd. Для деактивации одного дня используется отдельный объект Date в массиве, который указывает определенную дату. Значения времени при наличии заполняются нулями из объекта Date.

Например, требуется деактивировать следующие даты: 11 января 2006 г. в диапазоне от 23 января до 10 февраля 2006 г., а также 1 марта 2006 г. и все последующие даты.

disabledRanges="{[new Date(2006,0,11), {rangeStart:
      new Date(2006,0,23), rangeEnd: new Date(2006,1,10)},
      {rangeStart: new Date(2006,2,1)}]}"

При установке значения для этого свойства внешний вид элемента управления DateChooser незамедлительно изменяется, если деактивированные даты включены в свойства displayedMonth и displayedYear.

Значением по умолчанию является текущий месяц.

Значением по умолчанию является текущий год.

Функция принимает в качестве аргумента объект Date и возвращает строку в указанном формате, как показано ниже:

      public function formatDate(currentDate:Date):String {
          ...
          return dateString;
      }

Если пользователь может вводить дату в текстовое поле элемента управления DateField, а функция форматирования определена с помощью свойства labelFunction, необходимо указать функцию в свойстве parseFunction, которая преобразует входную текстовую строку в объект Date для использования элементом управления DateField, либо установить для свойства parseFunction значение null.

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

Функция принимает два аргумента и возвращает объект Date в элемент управления DateField, например:

      public function parseDate(valueString:String, inputFormat:String):Date {
          ...
          return newDate
      }

Здесь аргумент valueString содержит текстовую строку, введенную пользователем в текстовое поле, а аргумент inputFormat содержит формат строки. Так, если пользователь ограничен при вводе текстовой строки двумя символами для месяца, дня и года, то в аргумент inputFormat передается MM/DD/YY.

Это свойство принимает объект в качестве параметра. Объект содержит два свойства типа Date: rangeStart и rangeEnd. Если указано только значение для rangeStart, будут активированы все даты после указанной даты. Если указано только значение для rangeEnd, будут активированы все даты до указанной даты. Для активации только одной даты в элементе управления DateChooser можно передать объект Date напрямую. Значения времени при наличии заполняются нулями из объекта Date.

В следующем примере активирован только диапазон с 1 января 2006 года по 30 июня 2006 года. Месяцы до января и после июня не отображаются в DateChooser.

selectableRange="{{rangeStart : new Date(2006,0,1),
      rangeEnd : new Date(2006,5,30)}}"

Нажатие клавиши Ctrl при выборе выделенной в данной момент даты приводит к снятию выделения, устанавливает свойство selectedDate в значение null, а затем отправляет событие change.

В ActionScript для установки значения этого свойства можно использовать следующие константы: ButtonLabelPlacement.RIGHT, ButtonLabelPlacement.LEFT, ButtonLabelPlacement.BOTTOM и ButtonLabelPlacement.TOP.

При использовании контейнера ViewStack для заполнения элементов навигации применяются свойства label и icon нижестоящих элементов контейнера ViewStack, например:

      <mx:LinkBar dataProvider="{vs}"/>
      <mx:ViewStack id="vs">
        <mx:VBox label="Accounts" icon="account_icon"/>
        <mx:VBox label="Leads" icon="leads_icon"/>
      </mx:ViewStack> 

Элемент управления LinkBar содержит две ссылки: «Учетные записи» и «Руководители», каждая из которых имеет собственный значок, определенный в тегах VBox. При переходе по ссылке контейнер ViewStack перемещается в соответствующее представление.

При использовании массива свойство labelField определяет имя поля dataProvider для использования в качестве метки для каждого элемента навигации; свойство iconField определяет имя поля dataProvider для использования в качестве значка для каждого элемента навигации. При использовании массива строк свойство labelField игнорируется.

Можно предоставить функцию labelFunction, которая выполняет поиск соответствующих полей и возвращает отображаемую строку. labelFunction можно также использовать для обработки форматирования и локализации.

Для большинства компонентов функция метки принимает отдельный аргумент, который является элементом в поставщике данных и возвращает строку.

      myLabelFunction(item:Object):String

Значением по умолчанию является 0. Значение -1 приводит к отмене выделения всех кнопок строки.

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

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

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

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

При установке значения этого свойства разметка 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 &lt; и &gt;:

        <mx:TextInput htmlText="This is an example of &lt;b&gt;bold&lt;/b&gt; markup"/&gt;
        

  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 еще не определено.

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

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

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

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

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

При указании этого свойства в качестве атрибута в MXML необходимо использовать ссылку на дескриптор данных, а не на имя строки дескриптора. Используйте следующий формат для свойства:

<mx:PopUpMenuButton id="menubar" dataDescriptor="{new MyCustomDataDescriptor()}"/>

В качестве альтернативы, в MXML свойство может быть указано в качестве вложенного подтега, как представлено в примере:

<mx:PopUpMenuButton>
      <mx:dataDescriptor>
         <myCustomDataDescriptor>
      </mx:dataDescriptor>
      ...

Значением по умолчанию является внутренний экземпляр класса DefaultDataDescriptor.

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

Если поставщиком данных является объект E4X XML, необходимо установить это свойство явным способом, например использовать @icon для определения атрибута icon.

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

Функция iconFunction принимает отдельный аргумент, являющийся элементом в поставщике данных, и возвращает класс:

iconFunction(item:Object):Class

При задании этого свойства функция метки должна обнаружить соответствующее поле или поля и вернуть отображаемую строку. Свойство labelFunction можно также использовать для обработки форматирования и локализации.

В качестве аргумента функция метки принимает элемент в объекте dataProvider и возвращает элемент String, как показано в следующем примере:

labelFunction(item:Object):String

Это свойство предназначено только для чтения. Установка этого свойства не приведет к выполнению каких-либо действий. Вместо этого следует задать свойство dataProvider. (Индикатор «Только для записи» отображается в сводке синтаксиса, так как свойство в суперклассе предназначено для чтения и записи, а этот класс переопределяет установщик пустой реализацией.)

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

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

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