Label  - AS3 Flex

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Внутренний UITextField, выполняющий визуализацию текста данного Label.

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

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

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

Ширина текста.

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

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

Если это свойство true, и размер элемента управления Label меньше, чем его текст, текст элемента управления Label отсекается с помощью локализуемой строки, например "...". Если это свойство является false, то текст, который не помещается, отсекается.

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

Конструктор.

Возвращает объект TextLineMetrics с информацией о размещении текста и измерениями для строки текста в элементе управления. Для получения корректного значения требуется проверка компонента. При установке значения для свойства text и немедленном вызове getLineMetrics() возможно получение некорректного значения. Следует дождаться завершения проверки компонента или вызвать метод validateNow(). Это поведение отличается от поведения класса flash.text.TextField, который выполняет обновление значения незамедлительно.

Параметры

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

Передается при изменении свойстваdata.

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

Свойства объекта события имеют следующие значения:

Передается, когда пользователь щелкает в текстовом поле с поддержкой HTML гиперссылку, в которой URL-адрес начинается с event:. Остальная часть URL после event: помещается в свойство text объекта события link.

При обработке события link гиперссылка не выполняется автоматически; ее необходимо выполнить из обработчика события. Для выполнения гиперссылки, как правило, используется метод navigateToURL(). Он позволяет изменить гиперссылку или даже запретить ее отображение в приложении.

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

Это событие имеет следующие свойства: