Справочник по ActionScript® 3.0 для платформы Adobe® Flash®
Домашняя страница  |  Скрыть список пакетов и классов |  Пакеты  |  Классы  |  Что нового  |  Указатель  |  Приложения  |  Почему по-английски?
Фильтры: Получение данных с сервера...
Получение данных с сервера...
spark.globalization 

StringTools  - AS3 Flex

Пакетspark.globalization
Классpublic class StringTools
НаследованиеStringTools Inheritance GlobalizationBase Inheritance AdvancedStyleClient Inheritance EventDispatcher Inheritance Object

Язык версии: ActionScript 3.0
Версия продукта: Flex 4.5
Версии среды выполнения: Flash Player 10.1, AIR 2.5

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

Это класс-оболочка, включающий flash.globalization.StringTools. Поэтому функциональность преобразования регистра обеспечивает класс flash.globalization.StringTools. Класс StringTools, который может применяться в объявлениях MXML, использует стиль локали для запрашиваемого имени идентификатора локали и содержит привязываемые методы и свойства. Также события генерируются, если в классе flash.globalization создается ошибка или предупреждение.

Класс flash.globalization.StringTools использует базовую операционную систему для обеспечения функциональных возможностей преобразования регистра. В операционных системах, не поддерживающих классы flash.globalization, класс оболочки обеспечивает резервные функциональные возможности, использующие преобразование регистра, выполняемое классом String.

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

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



Общедоступные свойства
 СвойствоОпределено
  actualLocaleIDName : String
[переопределить] [только для чтения] Имя фактического идентификатора локали, используемое этим объектом класса.
StringTools
 InheritedclassName : String
[только для чтения] Имя класса компонента.
AdvancedStyleClient
 Inheritedconstructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта.
Object
 Inheritedid : String
Идентификатор компонента.
AdvancedStyleClient
 InheritedinheritingStyles : Object
Объект, содержащий стили наследования для экземпляра клиента с невизуальным стилем.
AdvancedStyleClient
  lastOperationStatus : String
[переопределить] [только для чтения] Состояние самой последней операции, выполненной этим объектом класса.
StringTools
 InheritedmoduleFactory : IFlexModuleFactory
Фабрика модуля, используемая в качестве контекста для поиска менеджера стилей, управляющего стилями в этом экземпляре клиента с невизуальным стилем.
AdvancedStyleClient
 InheritednonInheritingStyles : Object
Начало цепочки этого компонента с ненаследуемыми стилями.
AdvancedStyleClient
 InheritedstyleDeclaration : CSSStyleDeclaration
Объявление стиля, которое содержит действующие стили, объявленные этим объектом.
AdvancedStyleClient
 InheritedstyleManager : IStyleManager2
[только для чтения] Возвращает экземпляр StyleManager, используемый этим компонентом.
AdvancedStyleClient
 InheritedstyleName : Object
Источник значений стиля данного объекта.
AdvancedStyleClient
 InheritedstyleParent : IAdvancedStyleClient
Вышестоящий узел компонента используется для анализа нижестоящих селекторов.
AdvancedStyleClient
Общедоступные методы
 МетодОпределено
  
Создает новый объект StringTools, который обеспечивает преобразование регистра и другие служебные функции в соответствии с правилами данной локали.
StringTools
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Регистрирует объект прослушивателя события на объекте EventDispatcher для получения прослушивателем уведомления о событии.
EventDispatcher
 Inherited
Удаляет свойство style для экземпляра компонента.
AdvancedStyleClient
 Inherited
Посылает событие в поток событий.
EventDispatcher
  
[статические] Перечисляет все имена идентификаторов локалей, поддерживаемые этим классом.
StringTools
 Inherited
Возвращает массив объектов CSSStyleDeclaration для селектора типа, применяемого к этому компоненту, или null, если массив не существует.
AdvancedStyleClient
 Inherited
getStyle(styleProp:String):*
[переопределить] Получает свойство style, которое было установлено в любом месте в пределах цепочки поиска стиля этого компонента.
GlobalizationBase
 Inherited
Возвращает true, если для currentCSSState не указано значение null.
AdvancedStyleClient
 Inherited
Проверяет, имеет ли объект EventDispatcher прослушиватели, зарегистрированные для определенного типа события.
EventDispatcher
 Inherited
Показывает, определено ли заданное свойство для объекта.
Object
 Inherited
Инициализированный метод вызывается, когда этот класс или класс, расширяющий этот класс, используются в объявлении MXML.
AdvancedStyleClient
 Inherited
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра.
Object
 Inherited
Возвращает значение true, если cssState совпадает с currentCSSState.
AdvancedStyleClient
 Inherited
Определяет, совпадает ли этот экземпляр с данным типом (или является его подклассом).
AdvancedStyleClient
 Inherited
Применяет изменения стиля к нижестоящим элементам этого экземпляра клиента стиля.
AdvancedStyleClient
 Inherited
Показывает наличие заданного свойства и его перечисляемость.
Object
 Inherited
Обеспечивает настройку внутренних значений кэша стиля для функционирования метода getStyle().
AdvancedStyleClient
 Inherited
Обеспечивает регистрацию EffectManager в качестве одного из прослушивателей события для каждого события эффекта.
AdvancedStyleClient
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Удаляет прослушиватель из объекта EventDispatcher.
EventDispatcher
 Inherited
Задает доступность динамического свойства для операций цикла.
Object
 Inherited
setStyle(styleProp:String, newValue:*):void
Задает свойство style для экземпляра компонента.
AdvancedStyleClient
 Inherited
Обеспечивает обнаружение изменений в свойствах стиля.
AdvancedStyleClient
 Inherited
Метод stylesInitialized() вызывается программой Flex при первой инициализации стиля компонента.
AdvancedStyleClient
 Inherited
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали.
Object
  
Преобразует строку в нижний регистр в соответствии с правилами языка.
StringTools
 Inherited
Возвращает строковое представление заданного объекта.
Object
  
Преобразует строку в верхний регистр в соответствии с правилами языка.
StringTools
 Inherited
Возвращает элементарное значение заданного объекта.
Object
 Inherited
Проверяет, зарегистрирован ли прослушиватель события для указанного типа события с данным объектом EventDispatcher или любым его предшественником.
EventDispatcher
События
 Событие Сводка Определено
 Inherited[многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR перемещается в фокус операционной системы и становится активным.EventDispatcher
 InheritedСобытие изменения создается при изменении стиля локали или установке другого свойства, которое изменит формат числа или обновит другие значения, доступные с помощью этого класса.GlobalizationBase
 Inherited[многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR теряет фокус системы и становится неактивным.EventDispatcher
Стили

Стили являются либо общими, либо связанными с определенной темой. Если стиль общий, он может использоваться с любой темой. Если стиль связан с определенной темой, он может использоваться, только если ваше приложение использует ее.

Общие стили
 Стиль Описание Определено
 InheritedТип: String Наследование CSS: Да
Язык версии: ActionScript 3.0  Версия продукта: Flex 4.5  Версии среды выполнения: Flash10.1, AIR 2.5

Идентификатор локали, который определяет язык, область, сценарий и, дополнительно, другие связанные теги и ключи.
GlobalizationBase
Сведения о свойстве

actualLocaleIDName

свойство
actualLocaleIDName:String  [только для чтения] [переопределить]

Язык версии: ActionScript 3.0
Версия продукта: Flex 4.5
Версии среды выполнения: Flash Player 10.1, AIR 2.5

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

Если локаль, установленная стилем locale, недоступна, то значение actualLocaleIDName будет отличаться от значения стиля locale. Значение будет указывать резервную используемую локаль. Если стиль локали установлен как LocaleID.DEFAULT, будет использоваться имя локали, определенное операционной системой пользователя.

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



Реализация
    override public function get actualLocaleIDName():String

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

flash.globalization.StringTools.actualLocaleIDName
StringTools()

lastOperationStatus

свойство 
lastOperationStatus:String  [только для чтения] [переопределить]

Язык версии: ActionScript 3.0
Версия продукта: Flex 4.5
Версии среды выполнения: Flash Player 10.1, AIR 2.5

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

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



Реализация
    override public function get lastOperationStatus():String
Сведения о конструкторе

StringTools

()Конструктор
public function StringTools()

Язык версии: ActionScript 3.0
Версия продукта: Flex 4.5
Версии среды выполнения: Flash Player 10.1, AIR 2.5

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

  • Наследование стиля из UIComponent путем вызова метода addStyleClient UIComponent.
  • С использованием класса в объявлении MXML и наследованием локали из документа, содержащего объявление. Пример:
          <fx:Declarations>
                 <s:StringTools id="st" />
          </fx:Declarations>
          
  • С использованием объявления MXML и указанием значения локали в списке назначений. Пример:
          <fx:Declarations>
              <s:StringTools id="st_turkish" locale="tr-TR" />
          </fx:Declarations>
          
  • Вызов метода setStyle, например st.setStyle("locale", "tr-TR")

Если стиль locale не установлен одним из вышеперечисленных способов, экземпляр этого класса добавляется как StyleClient в topLevelApplication и наследует стиль locale из объекта topLevelApplication при вызове получателя свойств, зависящего от locale, или метода, зависящего от locale.

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

Сведения о методе

getAvailableLocaleIDNames

()метод
public static function getAvailableLocaleIDNames():Vector.<String>

Язык версии: ActionScript 3.0
Версия продукта: Flex 4.5
Версии среды выполнения: Flash Player 10.1, AIR 2.5

Перечисляет все имена идентификаторов локалей, поддерживаемые этим классом.

Возвращает
Vector.<String> — Вектор строк, содержащий все имена идентификаторов локалей, поддерживаемые этим классом и операционной системой.

toLowerCase

()метод 
public function toLowerCase(s:String):String

Язык версии: ActionScript 3.0
Версия продукта: Flex 4.5
Версии среды выполнения: Flash Player 10.1, AIR 2.5

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

Параметры

s:StringString для преобразования в нижний регистр.

Возвращает
String — Преобразованная строка в нижнем регистре.

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

toUpperCase

()метод 
public function toUpperCase(s:String):String

Язык версии: ActionScript 3.0
Версия продукта: Flex 4.5
Версии среды выполнения: Flash Player 10.1, AIR 2.5

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

Параметры

s:StringString для преобразования в верхний регистр.

Возвращает
String — Преобразованная строка в верхнем регистре.

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

StringToolsExample.mxml
<?xml version="1.0" encoding="utf-8"?>
<!-- Sample program for spark.globalization.StringTools -->
<s:Application
    xmlns:fx="http://ns.adobe.com/mxml/2009"
    xmlns:s="library://ns.adobe.com/flex/spark"
    xmlns:mx="library://ns.adobe.com/flex/mx">

    <fx:Declarations>
        <s:StringTools id="stringTools" />
    </fx:Declarations>

    <fx:Script>
        <![CDATA[
            import mx.collections.ArrayCollection;

            private static const localeList:ArrayCollection
                = new ArrayCollection([
                    { label:"Turkish (tr)", data:"tr" },
                    { label:"Greek (el)", data:"el" },
                    { label:"German (de)", data:"de" },
                    { label:"English (en)", data:"en" } ]);

            private static const inputString:String =
                "aá�æ� Iıİi (Turkish), σςΣΣ (Greek), SSß (German), bβв (Latin/Greek/Cyrillic)";
        ]]>
    </fx:Script>

    <mx:Form width="100%">
        <mx:FormItem label="Select Language">
            <mx:ComboBox id="localeSelector"
                change="setStyle('locale', localeSelector.selectedItem.data);"
                dataProvider="{localeList}"/>
        </mx:FormItem>
        <mx:FormItem label="Actual Locale ID Name">
            <mx:Text text="{stringTools.actualLocaleIDName}"/>
        </mx:FormItem>
        <mx:FormItem width="100%" label="Upper Case Result">
            <mx:Text width="100%"
                text="{stringTools.toUpperCase(inputString)}"/>
        </mx:FormItem>
        <mx:FormItem width="100%" label="Lower Case Result">
            <mx:Text width="100%"
                text="{stringTools.toLowerCase(inputString)}"/>
        </mx:FormItem>
    </mx:Form>
</s:Application>




[ X ]Почему по-английски?
Содержимое Справочника ActionScript 3.0 отображается на английском языке

Не все части Справочника ActionScript 3.0 переводятся на все языки. Если какой-то текстовый элемент не переведен, он отображается на английском языке. Например, компонент ga.controls.HelpBox не переведен ни на один из языков. Это значит, что в русской версии справки компонент ga.controls.HelpBox будет отображаться на английском языке.