| Paket | spark.globalization.supportClasses |
| Klasse | public class CollatorBase |
| Vererbung | CollatorBase  GlobalizationBase AdvancedStyleClient EventDispatcher Object |
| Unterklassen | MatchingCollator, SortingCollator |
| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 4.5 |
| Laufzeitversionen: | Flash Player 10.1, AIR 2.5 |
CollatorBase ist eine Basisklasse für die SortingCollator-Klasse und die MatchingCollator-Klasse.
Diese Klasse ist eine Wrapper-Klasse um die flash.globalization.Collator-Klasse. Deshalb wird der gebietsschemaspezifische Stringvergleich durch die flash.globalization.Collator-Klasse bereitgestellt. Durch Verwenden dieser Klasse als Basisklasse können die SortingCollator- und die MatchingCollator-Klasse in MXML-Deklarationen verwendet werden. In diesen Klassen wird der locale-Stil verwendet für die angeforderte Locale ID und hat Methoden und Eigenschaften, die bindbar sind.
Die flash.globalization.Collator-Klasse verwendet das zugrundeliegende Betriebssystem für die Formatierungsfunktion und für das Bereitstellen der gebietsschemaspezifischen Daten. In einigen Betriebssystemen werden die flash.globalization-Klassen nicht unterstützt. In diesen Systemen stellt die Wrapper-Klasse Ersatzfunktionen für Stringvergleich bereit.
Verwandte API-Elemente
Vererbte öffentliche Eigenschaften ausblenden
Vererbte öffentliche Eigenschaften anzeigen| Eigenschaft | Definiert von | ||
|---|---|---|---|
| actualLocaleIDName : String [override] [schreibgeschützt]
Der Name der Gebietsschema-ID, die von diesem Klassenobjekt verwendet wird. | CollatorBase | ||
 | className : String [schreibgeschützt]
Der Name der Komponentenklasse. | AdvancedStyleClient | |
| constructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz. | Object | |
| id : String
Die Identität der Komponente. | AdvancedStyleClient | |
| ignoreCase : Boolean
Wenn diese Eigenschaft auf „true“ gesetzt ist, werden identische Strings und Strings, die sich nur in der Groß- und Kleinschreibung der Buchstaben unterscheiden, als gleich bewertet. | CollatorBase | ||
| ignoreCharacterWidth : Boolean
Wenn diese Eigenschaft auf „true“ gesetzt ist, werden Formen voller Breite und halber Breite bei bestimmten chinesischen und japanischen Zeichen als gleich bewertet. | CollatorBase | ||
| ignoreDiacritics : Boolean
Wenn diese Eigenschaft auf „true“ gesetzt ist, werden Strings mit denselben Grundzeichen aber unterschiedlichen Akzenten oder anderen diakritischen Zeichen als gleich bewertet. | CollatorBase | ||
| ignoreKanaType : Boolean
Wenn diese Eigenschaft auf „true“ gesetzt ist, werden Strings, die sich nur durch die Art der verwendeten kana-Zeichen unterscheiden, als gleich bewertet. | CollatorBase | ||
| ignoreSymbols : Boolean
Wenn diese Eigenschaft auf „true“ gesetzt ist, werden Symbolzeichen wie Leerzeichen, Währungssymbole, mathematische Symbole und andere Arten von Symbolen beim Sortieren oder Überprüfen ignoriert. | CollatorBase | ||
| inheritingStyles : Object
Ein Objekt, das die vererbbaren Stile für diese nichtvisuelle Stilclientinstanz enthält. | AdvancedStyleClient | |
| lastOperationStatus : String [override] [schreibgeschützt]
Der Status der letzten Operation, die dieses Klassenobjekt ausgeführt hat. | CollatorBase | ||
| moduleFactory : IFlexModuleFactory
Eine Module-Factory wird als Kontext zum Suchen des Stilmanagers verwendet, der die Stile für diese nichtvisuelle Stilclientinstanz steuert. | AdvancedStyleClient | |
| nonInheritingStyles : Object
Beginn der Kette von Komponentenstilen, die keine Vererbungsstile sind. | AdvancedStyleClient | |
| numericComparison : Boolean
Regelt, wie numerische Werte, die in Strings eingebettet sind, bei Stringvergleichen behandelt werden. | CollatorBase | ||
| styleDeclaration : CSSStyleDeclaration
Die Stildeklaration, die die von diesem Objekt deklarierten Inline-Stile enthält. | AdvancedStyleClient | |
| styleManager : IStyleManager2 [schreibgeschützt]
Gibt die von dieser Komponente verwendete StyleManager-Instanz zurück. | AdvancedStyleClient | |
| styleName : Object
Die Quelle der Stilwerte dieses Objekts. | AdvancedStyleClient | |
| styleParent : IAdvancedStyleClient
Das übergeordnete Element einer Komponente wird zur Überprüfung der untergeordneten Selektoren verwendet. | AdvancedStyleClient | |
| Methode | Definiert von | ||
|---|---|---|---|
CollatorBase(initialMode:String)
Konstruiert ein neues CollatorBase-Objekt, um Stringvergleiche entsprechend den Konventionen eines angegebenen Gebietsschemas bereitzustellen. | CollatorBase | ||
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registriert ein Ereignis-Listener-Objekt bei einem EventDispatcher-Objekt, sodass der Listener über ein Ereignis benachrichtigt wird. | EventDispatcher | |
|
Löscht eine Stileigenschaft aus dieser Komponenteninstanz. | AdvancedStyleClient | |
Vergleicht zwei Strings und gibt einen Ganzzahlwert zurück, der angibt, ob der erste String kleiner, gleich oder größer als der zweite String ist. | CollatorBase | ||
|
Sendet ein Ereignis in den Ereignisablauf. | EventDispatcher | |
Vergleicht zwei Strings und gibt einen booleschen Wert zurück, der angibt, ob die Strings gleich sind. | CollatorBase | ||
[statisch]
Listet alle Gebietsschema-ID-Namen auf, die von dieser Klasse unterstützt werden. | CollatorBase | ||
|
Gibt einen Array von CSSStyleDeclaration-Objekten für den Typselektor zurück, der auf diese Komponente anzuwenden ist, oder „null“, wenn keiner existiert. | AdvancedStyleClient | |
| [override]
Ruft eine Stileigenschaft ab, die an einer beliebigen Stelle in der Stilkette der Komponente festgelegt ist. | GlobalizationBase | |
|
Gibt true zurück, wenn currentCSSState ungleich null ist. | AdvancedStyleClient | |
|
Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat. | EventDispatcher | |
|
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde. | Object | |
|
Die initialized-Methode wird aufgerufen, wenn diese Klasse oder eine Klasse, die diese Klasse erweitert, in einer MXML-Deklaration verwendet wird. | AdvancedStyleClient | |
|
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde. | Object | |
|
Gibt „true“ zurück, wenn cssState mit currentCSSState übereinstimmt. | AdvancedStyleClient | |
|
Bestimmt, ob diese Instanz dem angegebenen Typ entspricht oder eine Unterklasse davon ist. | AdvancedStyleClient | |
|
Gibt Stiländerungen an die untergeordneten Elemente dieser Stilclientinstanz weiter. | AdvancedStyleClient | |
|
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann. | Object | |
|
Legt die internen Stilcachewerte fest, sodass die getStyle()-Methode funktioniert. | AdvancedStyleClient | |
|
Registriert den EffectManager als einen der Ereignis-Listener für jedes Effekt-Ereignis. | AdvancedStyleClient | |
|
Entfernt einen Listener aus dem EventDispatcher-Objekt. | EventDispatcher | |
|
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest. | Object | |
|
Legt eine Stileigenschaft für diese Komponenteninstanz fest. | AdvancedStyleClient | |
|
Erkennt Änderungen an Stileigenschaften. | AdvancedStyleClient | |
|
Flex ruft die stylesInitialized()-Methode auf, wenn die Stile für eine Komponente zum ersten Mal initialisiert werden. | AdvancedStyleClient | |
|
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas. | Object | |
|
Gibt das angegebene Objekt als String zurück. | Object | |
|
Gibt den Grundwert des angegebenen Objekts zurück. | Object | |
|
Überprüft, ob bei diesem EventDispatcher-Objekt oder bei einem seiner Vorgänger ein Ereignis-Listener für einen bestimmten Ereignistyp registriert ist. | EventDispatcher | |
Stile sind entweder allgemein oder mit einem bestimmten Thema verknüpft. Allgemeine Stile können mit jedem Thema verwendet werden. Stile, die mit einem bestimmten Thema verknüpft sind, können nur verwendet werden, wenn Ihre Anwendung dieses Thema verwendet.
actualLocaleIDName | Eigenschaft |
actualLocaleIDName:String [schreibgeschützt] [override] | Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 4.5 |
| Laufzeitversionen: | Flash Player 10.1, AIR 2.5 |
Der Name der Gebietsschema-ID, die von diesem Klassenobjekt verwendet wird. Dies ist das Gebietsschema, das verwendet wird, um auf Formatierungsdaten und Funktionen vom Betriebssystem aus zuzugreifen.
Wenn das vom locale-Stil festgelegte Gebietsschema nicht verfügbar ist, sind der Wert des actualLocaleIDName und der Wert des locale-Stils unterschiedlich. Er gibt das Ersatzgebietsschema an, das verwendet wird. Wenn für den locale-Stil LocaleID.DEFAULT festgelegt wurde, wird der Name des vom Betriebssystem des Benutzers festgelegten Gebietsschemas verwendet.
Diese Eigenschaft kann als Quelle für die Datenbindung verwendet werden. Beim Ändern dieser Eigenschaft wird das change -Ereignis ausgelöst.
Implementierung
override public function get actualLocaleIDName():StringVerwandte API-Elemente
CollatorBase()
ignoreCase | Eigenschaft |
ignoreCase:Boolean| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 4.5 |
| Laufzeitversionen: | Flash Player 10.1, AIR 2.5 |
Wenn diese Eigenschaft auf „true“ gesetzt ist, werden identische Strings und Strings, die sich nur in der Groß- und Kleinschreibung der Buchstaben unterscheiden, als gleich bewertet.
Der Standardwert ist "true", wenn für den zum CollatorBase()-Konstruktor gehörenden initialMode-Parameter Collator.MATCHING festgelegt ist. "false", wenn für den zum CollatorBase()-Konstruktor gehörenden initialMode-Parameter Collator.SORTING festgelegt ist.
Diese Eigenschaft kann als Quelle für die Datenbindung verwendet werden. Beim Ändern dieser Eigenschaft wird das change -Ereignis ausgelöst.
Implementierung
public function get ignoreCase():Boolean public function set ignoreCase(value:Boolean):voidVerwandte API-Elemente
ignoreCharacterWidth | Eigenschaft |
ignoreCharacterWidth:Boolean| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 4.5 |
| Laufzeitversionen: | Flash Player 10.1, AIR 2.5 |
Wenn diese Eigenschaft auf „true“ gesetzt ist, werden Formen voller Breite und halber Breite bei bestimmten chinesischen und japanischen Zeichen als gleich bewertet.
Für die Kompatibilität mit vorhandenen Standards für chinesische und japanische Zeichensätze stellt Unicode Zeichencodes sowohl für Zeichen voller Breite als auch halber Breite bereit. Wenn zum Beispiel die ignoreCharacterWidth-Eigenschaft auf true gesetzt ist, gibt compare("Ａｱ", "Aア") den Wert true zurück.
Wenn die ignoreCharacterWidth-Eigenschaft auf false gesetzt ist, werden Zeichen voller Breite und halber Breite nicht als gleich angesehen.
Der Standardwert ist true, wenn für den zum CollatorBase()-Konstruktor gehörenden initialMode-Parameter Collator.MATCHING festgelegt ist. "false", wenn für den zum CollatorBase()-Konstruktor gehörenden initialMode-Parameter Collator.SORTING festgelegt ist.
Diese Eigenschaft kann als Quelle für die Datenbindung verwendet werden. Beim Ändern dieser Eigenschaft wird das change -Ereignis ausgelöst.
Implementierung
public function get ignoreCharacterWidth():Boolean public function set ignoreCharacterWidth(value:Boolean):voidVerwandte API-Elemente
ignoreDiacritics | Eigenschaft |
ignoreDiacritics:Boolean| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 4.5 |
| Laufzeitversionen: | Flash Player 10.1, AIR 2.5 |
Wenn diese Eigenschaft auf „true“ gesetzt ist, werden Strings mit denselben Grundzeichen aber unterschiedlichen Akzenten oder anderen diakritischen Zeichen als gleich bewertet. Zum Beispiel gibt compare("coté", "côte") den Wert true zurück, wenn die ignoreDiacritics-Eigenschaft den Wert true hat.
Wenn die ignoreDiacritics-Eigenschaft den Wert false hat, werden Basiszeichen mit diakritischen Zeichen oder Akzenten nicht als gleich angesehen.
Der Standardwert ist true, wenn für den zum CollatorBase()-Konstruktor gehörenden initialMode-Parameter Collator.MATCHING festgelegt ist. "false", wenn für den zum CollatorBase()-Konstruktor gehörenden initialMode-Parameter Collator.SORTING festgelegt ist.
Diese Eigenschaft kann als Quelle für die Datenbindung verwendet werden. Beim Ändern dieser Eigenschaft wird das change -Ereignis ausgelöst.
Implementierung
public function get ignoreDiacritics():Boolean public function set ignoreDiacritics(value:Boolean):voidVerwandte API-Elemente
ignoreKanaType | Eigenschaft |
ignoreKanaType:Boolean| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 4.5 |
| Laufzeitversionen: | Flash Player 10.1, AIR 2.5 |
Wenn diese Eigenschaft auf „true“ gesetzt ist, werden Strings, die sich nur durch die Art der verwendeten kana-Zeichen unterscheiden, als gleich bewertet. Zum Beispiel gibt compare("カナ", "かな") den Wert true zurück, wenn die ignoreKanaType-Eigenschaft den Wert true hat.
Wenn die ignoreKanaType-Eigenschaft auf false gesetzt ist, werden Hiragana- und Katakana-Zeichen, die sich auf dieselbe Silbe beziehen, nicht als gleich angesehen.
Der Standardwert ist true, wenn für den zum CollatorBase()-Konstruktor gehörenden initialMode-Parameter Collator.MATCHING festgelegt ist. "false", wenn für den zum CollatorBase()-Konstruktor gehörenden initialMode-Parameter Collator.SORTING festgelegt ist.
Diese Eigenschaft kann als Quelle für die Datenbindung verwendet werden. Beim Ändern dieser Eigenschaft wird das change -Ereignis ausgelöst.
Implementierung
public function get ignoreKanaType():Boolean public function set ignoreKanaType(value:Boolean):voidVerwandte API-Elemente
ignoreSymbols | Eigenschaft |
ignoreSymbols:Boolean| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 4.5 |
| Laufzeitversionen: | Flash Player 10.1, AIR 2.5 |
Wenn diese Eigenschaft auf „true“ gesetzt ist, werden Symbolzeichen wie Leerzeichen, Währungssymbole, mathematische Symbole und andere Arten von Symbolen beim Sortieren oder Überprüfen ignoriert. Zum Beispiel werden die Strings "OBrian", "O'Brian" und "O Brian" als gleich angesehen, wenn die ignoreSymbols-Eigenschaft den Wert true hat.
Der Standardwert ist true, wenn für den zum CollatorBase()-Konstruktor gehörenden initialMode-Parameter Collator.MATCHING festgelegt ist. "false", wenn für den zum CollatorBase()-Konstruktor gehörenden initialMode-Parameter Collator.SORTING festgelegt ist.
Diese Eigenschaft kann als Quelle für die Datenbindung verwendet werden. Beim Ändern dieser Eigenschaft wird das change -Ereignis ausgelöst.
Implementierung
public function get ignoreSymbols():Boolean public function set ignoreSymbols(value:Boolean):voidVerwandte API-Elemente
lastOperationStatus | Eigenschaft |
lastOperationStatus:String [schreibgeschützt] [override] | Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 4.5 |
| Laufzeitversionen: | Flash Player 10.1, AIR 2.5 |
Der Status der letzten Operation, die dieses Klassenobjekt ausgeführt hat. Die lastOperationStatus-Eigenschaft wird immer festgelegt, wenn der Konstruktor oder eine Methode dieser Klasse aufgerufen oder eine Eigenschaft festgelegt wird. Die möglichen Werte sind in der Beschreibung der einzelnen Methoden aufgeführt.
Diese Eigenschaft kann als Quelle für die Datenbindung verwendet werden. Beim Ändern dieser Eigenschaft wird das change -Ereignis ausgelöst.
Implementierung
override public function get lastOperationStatus():StringVerwandte API-Elemente
numericComparison | Eigenschaft |
numericComparison:Boolean| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 4.5 |
| Laufzeitversionen: | Flash Player 10.1, AIR 2.5 |
Regelt, wie numerische Werte, die in Strings eingebettet sind, bei Stringvergleichen behandelt werden.
Wenn die numericComparison-Eigenschaft den Wert true hat, konvertiert die Vergleichsmethode Zahlen, die im String vorkommen, zum Vergleich in numerische Werte.
Wenn diese Eigenschaft den Wert false hat, behandelt der Vergleich Zahlen als Zeichencodes und sortiert sie entsprechend der Regeln zum Sortieren von Zeichen im angegebenen Gebietsschema.
Wenn diese Eigenschaft zum Beispiel für das Gebietsschema "en-US" den Wert „true“ hat, werden die Strings "version1", "version10" und "version2" in dieser Reihenfolge sortiert: version1 < version2 < version10.
Wenn diese Eigenschaft für das Gebietsschema "en-US" den Wert „false“ hat, werden dieselben Strings in dieser Reihenfolge sortiert: version1 < version10 < version2.
Der Standardwert ist false.
Diese Eigenschaft kann als Quelle für die Datenbindung verwendet werden. Beim Ändern dieser Eigenschaft wird das change -Ereignis ausgelöst.
Implementierung
public function get numericComparison():Boolean public function set numericComparison(value:Boolean):voidVerwandte API-Elemente
CollatorBase | () | Konstruktor |
public function CollatorBase(initialMode:String)| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 4.5 |
| Laufzeitversionen: | Flash Player 10.1, AIR 2.5 |
Konstruiert ein neues CollatorBase-Objekt, um Stringvergleiche entsprechend den Konventionen eines angegebenen Gebietsschemas bereitzustellen.
Der initialMode-Parameter legt die anfänglichen Suchoptionen für zwei Verwendungsbeispiele fest: Sortieren und Übereinstimmen. Er kann auf einen der beiden folgenden Werte festgelegt werden:
CollatorMode.SORTING: legt Sortieroptionen für allgemeine linguistische Sortiervorgänge fest, zum Beispiel für das Sortieren einer Liste mit Textstrings, die einem Endbenutzer angezeigt werden. In diesem Modus werden Unterschiede in der Groß- und Kleinschreibung, Zeichen mit Akzent und andere gebietsschemaspezifische Unterschiede bei Stringvergleichen berücksichtigt.CollatorMode.MATCHING: legt Sortieroptionen für allgemeine Zwecke fest, zum Beispiel, um festzustellen, ob zwei Strings gleich sind. In diesem Modus werden Unterschiede in der Groß- und Kleinschreibung, Zeichen mit Akzent usw. bei Stringvergleichen nicht berücksichtigt.
Weitere Informationen und Beispiele für die Verwendung dieser beiden Modi finden Sie in der Dokumentation für die flash.globalization.Collator-Klasse.
Das Gebietsschema für diese Klasse wird vom Gebietsschema-Stil bereitgestellt. Der Gebietsschema-Stil kann auf verschiedene Arten festgelegt werden:
- Übernehmen des Stils von einer
UIComponentdurch Aufrufen deraddStyleClient-Methode mit einer Instanz dieses Objekts als Parameter. - Durch Verwenden der Klasse in einer MXML-Deklaration und Übernehmen des
Gebietsschemasaus dem Dokument, das die Deklaration enthält.<fx:Declarations> <s:SortingCollator id="collator" /> </fx:Declarations> - Durch Verwenden einer MXML-Deklaration und Festlegen des
locale-Werts in der Liste mit Zuweisungen.<fx:Declarations> <s:SortingCollator id="collator_german" locale="de-DE" /> </fx:Declarations> - setStyle-Methode, z. B.
collator.setStyle("locale", "de-DE")aufrufen
Wenn der locale-Stil nicht durch eine der obigen Techniken festgelegt wurde, legen die Methoden dieser Klasse, die vom locale abhängig sind, die lastOperationStatus-Eigenschaft auf spark.globalization.LastOperationStatus.LOCALE_UNDEFINED_ERROR fest.
initialMode:String — Legt die anfänglichen Suchoptionen für zwei Verwendungsbeispiele fest: Sortieren und Übereinstimmen.
|
Verwandte API-Elemente
compare | () | Methode |
public function compare(string1:String, string2:String):int| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 4.5 |
| Laufzeitversionen: | Flash Player 10.1, AIR 2.5 |
Vergleicht zwei Strings und gibt einen Ganzzahlwert zurück, der angibt, ob der erste String kleiner, gleich oder größer als der zweite String ist. Der Vergleich verwendet die Sortierregeln für den locale-Stil, der gültig ist, wenn die Vergleichsmethode aufgerufen wird.
Parameter
string1:String — Erster Vergleichsstring.
| |
string2:String — Zweiter Vergleichsstring.
|
int — Ein Ganzzahlwert, der angibt, ob der erste String kleiner, gleich oder größer als der zweite String ist.
|
Verwandte API-Elemente
equals | () | Methode |
public function equals(string1:String, string2:String):Boolean| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 4.5 |
| Laufzeitversionen: | Flash Player 10.1, AIR 2.5 |
Vergleicht zwei Strings und gibt einen booleschen Wert zurück, der angibt, ob die Strings gleich sind. Der Vergleich verwendet die Sortierregeln für die Gebietsschema-ID, die imCollatorBase()-Konstruktor angegeben wurde.
Parameter
string1:String — Erster Vergleichsstring.
| |
string2:String — Zweiter Vergleichsstring.
|
Boolean — Ein boolescher Wert, der angibt, ob die Strings gleich sind (true) oder ungleich sind (false).
|
Verwandte API-Elemente
getAvailableLocaleIDNames | () | Methode |
public static function getAvailableLocaleIDNames():Vector.<String>| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 4.5 |
| Laufzeitversionen: | Flash Player 10.1, AIR 2.5 |
Listet alle Gebietsschema-ID-Namen auf, die von dieser Klasse unterstützt werden.
RückgabewerteVector.<String> — Ein Vektor von Strings, der alle von dieser Klasse und diesem Betriebssystem unterstützten Gebietsschema-ID-Namen enthält.
|
Tue Jun 12 2018, 10:04 AM Z