| Пакет | spark.globalization.supportClasses |
| Класс | public class CollatorBase |
| Наследование | CollatorBase  GlobalizationBase AdvancedStyleClient EventDispatcher Object |
| Подклассы | MatchingCollator, SortingCollator |
| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10.1, AIR 2.5 |
CollatorBase является базовым классом для классов SortingCollator и MatchingCollator.
Это класс-оболочка, включающий класс flash.globalization.Collator. Поэтому сравнение строк на основе локали обеспечивает класс flash.globalization.Collator. При использовании этого класса как базового классы SortingCollator и MatchingCollator войдут в объявления MXML. В этих классах стиль locale используется для запрашиваемого имени идентификатора локали и содержит привязываемые методы и свойства.
Класс flash.globalization.Collator использует базовую операционную систему для форматирования функциональности и предоставления данных, относящихся к конкретной локали. Некоторые операционные системы не поддерживают классы flash.globalization. В этих системах класс оболочки обеспечивает резервные функциональные возможности для сравнения строк.
Связанные элементы API
Скрыть унаследованные общедоступные свойства
Показать унаследованные общедоступные свойства| Свойство | Определено | ||
|---|---|---|---|
| actualLocaleIDName : String [переопределить] [только для чтения]
Имя фактического идентификатора локали, используемое этим объектом класса. | CollatorBase | ||
 | className : String [только для чтения]
Имя класса компонента. | AdvancedStyleClient | |
| constructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта. | Object | |
| id : String
Идентификатор компонента. | AdvancedStyleClient | |
| ignoreCase : Boolean
Когда это свойство имеет значение true, идентичные строки и строки, отличающиеся только регистром букв, рассматриваются как равные. | CollatorBase | ||
| ignoreCharacterWidth : Boolean
Когда это свойство имеет значение true, полноширинные и полуширинные формы некоторых китайских и японских символов рассматриваются как одинаковые. | CollatorBase | ||
| ignoreDiacritics : Boolean
Когда это свойство имеет значение true, строки, в которых используются одинаковые базовые символы, но разные акценты или диакритические знаки, рассматриваются как одинаковые. | CollatorBase | ||
| ignoreKanaType : Boolean
Когда это свойство имеет значение true, строки, которые отличаются только типом используемого символа кана, рассматриваются как одинаковые. | CollatorBase | ||
| ignoreSymbols : Boolean
Когда это свойство имеет значение true, при сортировке или сравнении игнорируются символьные знаки, включая пробелы, символы валют, математическим символы и др. | CollatorBase | ||
| inheritingStyles : Object
Объект, содержащий стили наследования для экземпляра клиента с невизуальным стилем. | AdvancedStyleClient | |
| lastOperationStatus : String [переопределить] [только для чтения]
Состояние самой последней операции, выполненной этим объектом класса. | CollatorBase | ||
| moduleFactory : IFlexModuleFactory
Фабрика модуля, используемая в качестве контекста для поиска менеджера стилей, управляющего стилями в этом экземпляре клиента с невизуальным стилем. | AdvancedStyleClient | |
| nonInheritingStyles : Object
Начало цепочки этого компонента с ненаследуемыми стилями. | AdvancedStyleClient | |
| numericComparison : Boolean
Управляет обработкой числовых значений, включенных в строки, в ходе сравнения строк. | CollatorBase | ||
| styleDeclaration : CSSStyleDeclaration
Объявление стиля, которое содержит действующие стили, объявленные этим объектом. | AdvancedStyleClient | |
| styleManager : IStyleManager2 [только для чтения]
Возвращает экземпляр StyleManager, используемый этим компонентом. | AdvancedStyleClient | |
| styleName : Object
Источник значений стиля данного объекта. | AdvancedStyleClient | |
| styleParent : IAdvancedStyleClient
Вышестоящий узел компонента используется для анализа нижестоящих селекторов. | AdvancedStyleClient | |
| Метод | Определено | ||
|---|---|---|---|
CollatorBase(initialMode:String)
Создает новый объект CollatorBase для сравнения строк в соответствии с правилами заданной локали. | CollatorBase | ||
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Регистрирует объект прослушивателя события на объекте EventDispatcher для получения прослушивателем уведомления о событии. | EventDispatcher | |
|
Удаляет свойство style для экземпляра компонента. | AdvancedStyleClient | |
Сравнивает две строки и возвращает целое число, указывающее на то, меньше, равна или больше первая строка второй. | CollatorBase | ||
|
Посылает событие в поток событий. | EventDispatcher | |
Сравнивает две строки и возвращает логическое значение, указывающее на то, равны ли эти строки. | CollatorBase | ||
[статические]
Перечисляет все имена идентификаторов локалей, поддерживаемые этим классом. | CollatorBase | ||
|
Возвращает массив объектов CSSStyleDeclaration для селектора типа, применяемого к этому компоненту, или null, если массив не существует. | AdvancedStyleClient | |
| [переопределить]
Получает свойство style, которое было установлено в любом месте в пределах цепочки поиска стиля этого компонента. | GlobalizationBase | |
|
Возвращает true, если для currentCSSState не указано значение null. | AdvancedStyleClient | |
|
Проверяет, имеет ли объект EventDispatcher прослушиватели, зарегистрированные для определенного типа события. | EventDispatcher | |
|
Показывает, определено ли заданное свойство для объекта. | Object | |
|
Инициализированный метод вызывается, когда этот класс или класс, расширяющий этот класс, используются в объявлении MXML. | AdvancedStyleClient | |
|
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра. | Object | |
|
Возвращает значение true, если cssState совпадает с currentCSSState. | AdvancedStyleClient | |
|
Определяет, совпадает ли этот экземпляр с данным типом (или является его подклассом). | AdvancedStyleClient | |
|
Применяет изменения стиля к нижестоящим элементам этого экземпляра клиента стиля. | AdvancedStyleClient | |
|
Показывает наличие заданного свойства и его перечисляемость. | Object | |
|
Обеспечивает настройку внутренних значений кэша стиля для функционирования метода getStyle(). | AdvancedStyleClient | |
|
Обеспечивает регистрацию EffectManager в качестве одного из прослушивателей события для каждого события эффекта. | AdvancedStyleClient | |
|
Удаляет прослушиватель из объекта EventDispatcher. | EventDispatcher | |
|
Задает доступность динамического свойства для операций цикла. | Object | |
|
Задает свойство style для экземпляра компонента. | AdvancedStyleClient | |
|
Обеспечивает обнаружение изменений в свойствах стиля. | AdvancedStyleClient | |
|
Метод stylesInitialized() вызывается программой Flex при первой инициализации стиля компонента. | AdvancedStyleClient | |
|
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали. | Object | |
|
Возвращает строковое представление заданного объекта. | Object | |
|
Возвращает элементарное значение заданного объекта. | Object | |
|
Проверяет, зарегистрирован ли прослушиватель события для указанного типа события с данным объектом EventDispatcher или любым его предшественником. | EventDispatcher | |
Стили являются либо общими, либо связанными с определенной темой. Если стиль общий, он может использоваться с любой темой. Если стиль связан с определенной темой, он может использоваться, только если ваше приложение использует ее.
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
CollatorBase()
ignoreCase | свойство |
ignoreCase:Boolean| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10.1, AIR 2.5 |
Когда это свойство имеет значение true, идентичные строки и строки, отличающиеся только регистром букв, рассматриваются как равные.
Значение по умолчанию - true, если для CollatorBase() параметра initialMode конструктора установлено значение Collator.MATCHING. false, если для CollatorBase() параметра initialMode конструктора установлено значение Collator.SORTING.
Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие change .
Реализация
public function get ignoreCase():Boolean public function set ignoreCase(value:Boolean):voidСвязанные элементы API
ignoreCharacterWidth | свойство |
ignoreCharacterWidth:Boolean| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10.1, AIR 2.5 |
Когда это свойство имеет значение true, полноширинные и полуширинные формы некоторых китайских и японских символов рассматриваются как одинаковые.
Для обеспечения совместимости с существующими стандартами для китайских и японских наборов символов Юникод обеспечивает коды символов для полноширинных и полуширинных форм некоторых символов. Например, когда свойство ignoreCharacterWidth имеет значение true, метод compare("Ａｱ", "Aア") возвращает значение true.
Если свойство ignoreCharacterWidth имеет значение false, то полноширинные и полуширинные формы рассматриваются как разные.
Значение по умолчанию - true, если для CollatorBase() параметра initialMode конструктора установлено значение Collator.MATCHING. false, если для CollatorBase() параметра initialMode конструктора установлено значение Collator.SORTING.
Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие change .
Реализация
public function get ignoreCharacterWidth():Boolean public function set ignoreCharacterWidth(value:Boolean):voidСвязанные элементы API
ignoreDiacritics | свойство |
ignoreDiacritics:Boolean| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10.1, AIR 2.5 |
Когда это свойство имеет значение true, строки, в которых используются одинаковые базовые символы, но разные акценты или диакритические знаки, рассматриваются как одинаковые. Например, метод compare("coté", "côte") возвращает значение true, когда свойство ignoreDiacritics имеет значение true.
Когда свойство ignoreDiacritics имеет значение false, базовые символы с диакритическими знаками или акцентами будут рассматриваться как разные.
Значение по умолчанию - true, если для CollatorBase() параметра initialMode конструктора установлено значение Collator.MATCHING. false, если для CollatorBase() параметра initialMode конструктора установлено значение Collator.SORTING.
Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие change .
Реализация
public function get ignoreDiacritics():Boolean public function set ignoreDiacritics(value:Boolean):voidСвязанные элементы API
ignoreKanaType | свойство |
ignoreKanaType:Boolean| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10.1, AIR 2.5 |
Когда это свойство имеет значение true, строки, которые отличаются только типом используемого символа кана, рассматриваются как одинаковые. Например, compare("カナ", "��") возвращает значение true, когда свойство ignoreKanaType имеет значение true.
Если ignoreKanaType имеет значение false, символы хираганы и катаканы, обозначающие одинаковый слог, рассматриваются как разные.
Значение по умолчанию - true, если для CollatorBase() параметра initialMode конструктора установлено значение Collator.MATCHING. false, если для CollatorBase() параметра initialMode конструктора установлено значение Collator.SORTING.
Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие change .
Реализация
public function get ignoreKanaType():Boolean public function set ignoreKanaType(value:Boolean):voidСвязанные элементы API
ignoreSymbols | свойство |
ignoreSymbols:Boolean| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10.1, AIR 2.5 |
Когда это свойство имеет значение true, при сортировке или сравнении игнорируются символьные знаки, включая пробелы, символы валют, математическим символы и др. Например, строки «OBrian», «O'Brian» и «O Brian» рассматриваются как одинаковые, когда свойство ignoreSymbols имеет значение true.
Значение по умолчанию - true, если для CollatorBase() параметра initialMode конструктора установлено значение Collator.MATCHING. false, если для CollatorBase() параметра initialMode конструктора установлено значение Collator.SORTING.
Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие change .
Реализация
public function get ignoreSymbols():Boolean public function set ignoreSymbols(value:Boolean):voidСвязанные элементы API
lastOperationStatus | свойство |
lastOperationStatus:String [только для чтения] [переопределить] | Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10.1, AIR 2.5 |
Состояние самой последней операции, выполненной этим объектом класса. Свойство lastOperationStatus задается каждый раз при вызове конструктора или метода этого класса или при задании значения для другого свойства. Другие возможные значения см. в описании соответствующего метода.
Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие change .
Реализация
override public function get lastOperationStatus():StringСвязанные элементы API
numericComparison | свойство |
numericComparison:Boolean| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10.1, AIR 2.5 |
Управляет обработкой числовых значений, включенных в строки, в ходе сравнения строк.
Когда свойство numericComparison имеет значение true, метод compare преобразует числа, включенные в строки, в числовые значения для сравнения.
Когда это свойство имеет значение false, в ходе сравнения эти числа рассматриваются как коды символов и сортируются в соответствии с правилами сортировки символов для указанной локали.
Например, когда это свойство имеет значение true для идентификатора локали en-US, строки «version1», «version10» и «version2» сортируются в следующем порядке: version1 < version2 < version10.
Когда это свойство имеет значение false для локали en-US, эти же строки сортируются по-другому: version1 < version10 < version2.
Значением по умолчанию является false.
Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие change .
Реализация
public function get numericComparison():Boolean public function set numericComparison(value:Boolean):voidСвязанные элементы API
CollatorBase | () | Конструктор |
public function CollatorBase(initialMode:String)| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10.1, AIR 2.5 |
Создает новый объект CollatorBase для сравнения строк в соответствии с правилами заданной локали.
Параметр initialMode устанавливает исходные параметры сравнения для двух случаев использования: сортировки и поиска совпадений. Он может иметь одно из следующих двух значений:
CollatorMode.SORTINGзадает параметры сравнения для обычной лингвистической сортировки, такой как сортировка списка текстовых строк, которые отображаются для конечного пользователя. В этом режиме при сравнении строк проводится различие между строчными и прописными буквами, символами с акцентом и без, а также учитываются другие отличия.CollatorMode.MATCHINGзадает параметры сравнения для общего применения, такого как определение эквивалентности двух строк. В этом режиме сравнение выполняется без учета строчных и прописных букв, символов с акцентами и других отличий.
Более подробные сведения и примеры использования этих двух режимов см. в документации для класса flash.globalization.Collator.
Стиль locale определяет локаль для этого класса. Стиль locale можно установить следующими способами.
- Наследование стиля из
UIComponentс помощью вызова методаaddStyleClientUIComponent с экземпляром этого объекта в качестве параметра. - Использование класса в объявлении MXML и наследование стиля
localeиз документа, содержащего объявление.<fx:Declarations> <s:SortingCollator id="collator" /> </fx:Declarations> - Использование объявления MXML и указание значения
localeв списке назначений.<fx:Declarations> <s:SortingCollator id="collator_german" locale="de-DE" /> </fx:Declarations> - Вызов метода setStyle, например
collator.setStyle("locale", "de-DE")
Если стиль locale не установлен одним из вышеперечисленных способов, методы этого класса, которые зависят от locale, установят для свойства lastOperationStatus значение spark.globalization.LastOperationStatus.LOCALE_UNDEFINED_ERROR.
initialMode:String — Устанавливает исходные параметры сравнения для двух случаев использования: сортировки и поиска совпадений.
|
Связанные элементы API
compare | () | метод |
public function compare(string1:String, string2:String):int| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10.1, AIR 2.5 |
Сравнивает две строки и возвращает целое число, указывающее на то, меньше, равна или больше первая строка второй. При сравнении используются правила сортировки для стиля locale, который действует на момент вызова метода сравнения.
Параметры
string1:String — Первая строка сравнения.
| |
string2:String — Вторая строка сравнения.
|
int — Целое число, указывающее на то, меньше, равна или больше первая строка по сравнению со второй.
|
Связанные элементы API
equals | () | метод |
public function equals(string1:String, string2:String):Boolean| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10.1, AIR 2.5 |
Сравнивает две строки и возвращает логическое значение, указывающее на то, равны ли эти строки. При сравнении используются правила сортировки для идентификатора локали, указанного в конструкторе CollatorBase().
Параметры
string1:String — Первая строка сравнения.
| |
string2:String — Вторая строка сравнения.
|
Boolean — Логическое значение, указывающее на то равны строки (true) или нет (false).
|
Связанные элементы API
getAvailableLocaleIDNames | () | метод |
public static function getAvailableLocaleIDNames():Vector.<String>| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10.1, AIR 2.5 |
Перечисляет все имена идентификаторов локалей, поддерживаемые этим классом.
ВозвращаетVector.<String> — Вектор строк, содержащий все имена идентификаторов локалей, поддерживаемые этим классом и операционной системой.
|
Tue Jun 12 2018, 11:34 AM Z