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

SortingCollator  - AS3 Flex

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

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

Класс SortingCollator предоставляет возможности сравнения строк на основе локали с исходными параметрами, подходящими для лингвистической сортировки (например, сортировки списка текстовых строк, которые отображаются для конечного пользователя).

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

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

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

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



Общедоступные свойства
 СвойствоОпределено
 InheritedactualLocaleIDName : String
[переопределить] [только для чтения] Имя фактического идентификатора локали, используемое этим объектом класса.
CollatorBase
 InheritedclassName : String
[только для чтения] Имя класса компонента.
AdvancedStyleClient
 Inheritedconstructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта.
Object
 Inheritedid : String
Идентификатор компонента.
AdvancedStyleClient
 InheritedignoreCase : Boolean
Когда это свойство имеет значение true, идентичные строки и строки, отличающиеся только регистром букв, рассматриваются как равные.
CollatorBase
 InheritedignoreCharacterWidth : Boolean
Когда это свойство имеет значение true, полноширинные и полуширинные формы некоторых китайских и японских символов рассматриваются как одинаковые.
CollatorBase
 InheritedignoreDiacritics : Boolean
Когда это свойство имеет значение true, строки, в которых используются одинаковые базовые символы, но разные акценты или диакритические знаки, рассматриваются как одинаковые.
CollatorBase
 InheritedignoreKanaType : Boolean
Когда это свойство имеет значение true, строки, которые отличаются только типом используемого символа кана, рассматриваются как одинаковые.
CollatorBase
 InheritedignoreSymbols : Boolean
Когда это свойство имеет значение true, при сортировке или сравнении игнорируются символьные знаки, включая пробелы, символы валют, математическим символы и др.
CollatorBase
 InheritedinheritingStyles : Object
Объект, содержащий стили наследования для экземпляра клиента с невизуальным стилем.
AdvancedStyleClient
 InheritedlastOperationStatus : String
[переопределить] [только для чтения] Состояние самой последней операции, выполненной этим объектом класса.
CollatorBase
 InheritedmoduleFactory : IFlexModuleFactory
Фабрика модуля, используемая в качестве контекста для поиска менеджера стилей, управляющего стилями в этом экземпляре клиента с невизуальным стилем.
AdvancedStyleClient
 InheritednonInheritingStyles : Object
Начало цепочки этого компонента с ненаследуемыми стилями.
AdvancedStyleClient
 InheritednumericComparison : Boolean
Управляет обработкой числовых значений, включенных в строки, в ходе сравнения строк.
CollatorBase
 InheritedstyleDeclaration : CSSStyleDeclaration
Объявление стиля, которое содержит действующие стили, объявленные этим объектом.
AdvancedStyleClient
 InheritedstyleManager : IStyleManager2
[только для чтения] Возвращает экземпляр StyleManager, используемый этим компонентом.
AdvancedStyleClient
 InheritedstyleName : Object
Источник значений стиля данного объекта.
AdvancedStyleClient
 InheritedstyleParent : IAdvancedStyleClient
Вышестоящий узел компонента используется для анализа нижестоящих селекторов.
AdvancedStyleClient
Общедоступные методы
 МетодОпределено
  
Создает новый объект SortingCollator для сравнения строк в соответствии с правилами заданной локали.
SortingCollator
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Регистрирует объект прослушивателя события на объекте EventDispatcher для получения прослушивателем уведомления о событии.
EventDispatcher
 Inherited
Удаляет свойство style для экземпляра компонента.
AdvancedStyleClient
 Inherited
compare(string1:String, string2:String):int
Сравнивает две строки и возвращает целое число, указывающее на то, меньше, равна или больше первая строка второй.
CollatorBase
 Inherited
Посылает событие в поток событий.
EventDispatcher
 Inherited
equals(string1:String, string2:String):Boolean
Сравнивает две строки и возвращает логическое значение, указывающее на то, равны ли эти строки.
CollatorBase
 Inherited
[статические] Перечисляет все имена идентификаторов локалей, поддерживаемые этим классом.
CollatorBase
 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
 Inherited
Возвращает строковое представление заданного объекта.
Object
 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
Сведения о конструкторе

SortingCollator

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

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

Создает новый объект SortingCollator для сравнения строк в соответствии с правилами заданной локали.

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

Обеспечиваемое экземпляром этого класса сравнение эквивалентно созданию экземпляра flash.globalization.Collator, для параметра initialMode которого установлено значение CollatorMode.SORTING. Более подробные сведения и примеры использования этого режима см. в документации для класса flash.globalization.Collator.

Стиль локали определяет локаль для этого класса. Стиль локали можно установить следующими способами:

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

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

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

SortingCollatorExample.mxml
<?xml version="1.0" encoding="utf-8"?>
<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"
               width="100%" height="100%">

    <fx:Declarations>
        <s:SortingCollator id="sortingCollator"/>
    </fx:Declarations>

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

            [Bindable]
            private var localeList:ArrayCollection
                = new ArrayCollection([
                    { label:"English (en)", data:"en" },
                    { label:"French (fr)", data:"fr" },
                    { label:"German (de)", data:"de" },
                    { label:"Latvian (lt)", data:"lt" },
                    { label:"Sweedish (sv)", data:"sv" },
                    { label:"Chinese (zh)", data:"zh" }]);

            private static const wordList:ArrayCollection
                = new ArrayCollection([
                    "B", "b", "a", "A" ,
                    "y (lt)", "i (lt)", "k (lt)",
                    "n (sv)", "ö (sv)", "o (sv)", "z (sv)",
                    "vu (sv)", "wo (sv)",
                    "däd (de)", "daed (de)",
                    "öf (de)", "of (de)",
                    "côte (fr)", "coté (fr)",
                    "手 (zh)", "中 (zh)", "土 (zh)", "岀 (zh)" ]);

            protected function localeSelector_changeHandler(
                                                        event:ListEvent):void
            {
                setStyle("locale", ComboBox(event.target).selectedItem.data);
                wordList.refresh();
            }
        ]]>
    </fx:Script>

    <mx:VBox>
        <mx:HBox>
            <s:Label text="Select Language"/>
            <mx:ComboBox id="localeSelector"
                change="localeSelector_changeHandler(event)"
                dataProvider="{localeList}"/>
        </mx:HBox>
        <mx:DataGrid id="dataGrid" width="100%"
            dataProvider="{wordList}" rowCount="{wordList.length}">
            <mx:columns>
                <mx:DataGridColumn headerText="Click here to sort"
                    sortCompareFunction="{sortingCollator.compare}"/>
            </mx:columns>
        </mx:DataGrid>
     </mx:VBox>
</s:Application>




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

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