ActionScript® 3.0 Referenzhandbuch für die Adobe® Flash®-Plattform
Home  |  Liste der Pakete und Klassen ausblenden |  Pakete  |  Klassen  |  Neue Funktionen  |  Stichwortverzeichnis  |  Anhänge  |  Warum auf Englisch?
Filter: Daten werden vom Server abgerufen...
Daten werden vom Server abgerufen...
spark.globalization 

SortingCollator  - AS3 Flex

Paketspark.globalization
Klassepublic class SortingCollator
VererbungSortingCollator Inheritance CollatorBase Inheritance GlobalizationBase Inheritance AdvancedStyleClient Inheritance EventDispatcher Inheritance Object

Sprachversion: ActionScript 3.0
Produktversion: Flex 4.5
Laufzeitversionen: Flash Player 10.1, AIR 2.5

Die SortingCollator-Klasse stellt gebietsschemabeachtende Fähigkeiten für Stringvergleiche mit Anfangseinstellungen bereit, die sich für linguistische Sortierungszwecke eignen, z. B Sortieren einer Liste von Textstrings, die einem Endbenutzer angezeigt werden.

Diese Klasse ist eine Wrapper-Klasse um den flash.globalization.Collator. Deshalb wird die gebietsschemaspezifische Stringsuche durch den flash.globalization.Collator bereitgestellt. Diese SortingCollator-Klasse die in MXML-Deklarationen verwendet werden kann, verwendet jedoch den Stil des Gebietsschemas für die angeforderte Gebietsschema-ID und hat Methoden und Eigenschaften, die bindend sind. Zusätzlich wird LastOperationStatus gesetzt, wenn ein Fehler oder eine Warnung auftritt, die von der flash.globalization-Klasse generiert wurden.

Die flash.globalization.Collator-Klasse verwendet das zugrundeliegende Betriebssystem für die Formatierungsfunktion und für das Bereitstellen der gebietsschemaspezifischen Daten. Auf einigen Betriebssystemen werden die flash.globalization-Klassen nicht unterstützt. Auf diesen Systemen stellt diese Wrapper-Klasse Ersatzfunktionen bereit.

Beispiele anzeigen

Verwandte API-Elemente



Öffentliche Eigenschaften
 EigenschaftDefiniert von
 InheritedactualLocaleIDName : String
[override] [schreibgeschützt] Der Name der Gebietsschema-ID, die von diesem Klassenobjekt verwendet wird.
CollatorBase
 InheritedclassName : String
[schreibgeschützt] Der Name der Komponentenklasse.
AdvancedStyleClient
 Inheritedconstructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.
Object
 Inheritedid : String
Die Identität der Komponente.
AdvancedStyleClient
 InheritedignoreCase : 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
 InheritedignoreCharacterWidth : 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
 InheritedignoreDiacritics : Boolean
Wenn diese Eigenschaft auf „true“ gesetzt ist, werden Strings mit denselben Grundzeichen aber unterschiedlichen Akzenten oder anderen diakritischen Zeichen als gleich bewertet.
CollatorBase
 InheritedignoreKanaType : 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
 InheritedignoreSymbols : 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
 InheritedinheritingStyles : Object
Ein Objekt, das die vererbbaren Stile für diese nichtvisuelle Stilclientinstanz enthält.
AdvancedStyleClient
 InheritedlastOperationStatus : String
[override] [schreibgeschützt] Der Status der letzten Operation, die dieses Klassenobjekt ausgeführt hat.
CollatorBase
 InheritedmoduleFactory : IFlexModuleFactory
Eine Module-Factory wird als Kontext zum Suchen des Stilmanagers verwendet, der die Stile für diese nichtvisuelle Stilclientinstanz steuert.
AdvancedStyleClient
 InheritednonInheritingStyles : Object
Beginn der Kette von Komponentenstilen, die keine Vererbungsstile sind.
AdvancedStyleClient
 InheritednumericComparison : Boolean
Regelt, wie numerische Werte, die in Strings eingebettet sind, bei Stringvergleichen behandelt werden.
CollatorBase
 InheritedstyleDeclaration : CSSStyleDeclaration
Die Stildeklaration, die die von diesem Objekt deklarierten Inline-Stile enthält.
AdvancedStyleClient
 InheritedstyleManager : IStyleManager2
[schreibgeschützt] Gibt die von dieser Komponente verwendete StyleManager-Instanz zurück.
AdvancedStyleClient
 InheritedstyleName : Object
Die Quelle der Stilwerte dieses Objekts.
AdvancedStyleClient
 InheritedstyleParent : IAdvancedStyleClient
Das übergeordnete Element einer Komponente wird zur Überprüfung der untergeordneten Selektoren verwendet.
AdvancedStyleClient
Öffentliche Methoden
 MethodeDefiniert von
  
Konstruiert ein neues SortingCollator-Objekt, um Stringvergleiche entsprechend den Konventionen eines angegebenen Gebietsschemas bereitzustellen.
SortingCollator
 Inherited
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
 Inherited
Löscht eine Stileigenschaft aus dieser Komponenteninstanz.
AdvancedStyleClient
 Inherited
compare(string1:String, string2:String):int
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
 Inherited
Sendet ein Ereignis in den Ereignisablauf.
EventDispatcher
 Inherited
equals(string1:String, string2:String):Boolean
Vergleicht zwei Strings und gibt einen booleschen Wert zurück, der angibt, ob die Strings gleich sind.
CollatorBase
 Inherited
[statisch] Listet alle Gebietsschema-ID-Namen auf, die von dieser Klasse unterstützt werden.
CollatorBase
 Inherited
Gibt einen Array von CSSStyleDeclaration-Objekten für den Typselektor zurück, der auf diese Komponente anzuwenden ist, oder „null“, wenn keiner existiert.
AdvancedStyleClient
 Inherited
getStyle(styleProp:String):*
[override] Ruft eine Stileigenschaft ab, die an einer beliebigen Stelle in der Stilkette der Komponente festgelegt ist.
GlobalizationBase
 Inherited
Gibt true zurück, wenn currentCSSState ungleich null ist.
AdvancedStyleClient
 Inherited
Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat.
EventDispatcher
 Inherited
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.
Object
 Inherited
Die initialized-Methode wird aufgerufen, wenn diese Klasse oder eine Klasse, die diese Klasse erweitert, in einer MXML-Deklaration verwendet wird.
AdvancedStyleClient
 Inherited
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.
Object
 Inherited
Gibt „true“ zurück, wenn cssState mit currentCSSState übereinstimmt.
AdvancedStyleClient
 Inherited
Bestimmt, ob diese Instanz dem angegebenen Typ entspricht oder eine Unterklasse davon ist.
AdvancedStyleClient
 Inherited
Gibt Stiländerungen an die untergeordneten Elemente dieser Stilclientinstanz weiter.
AdvancedStyleClient
 Inherited
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.
Object
 Inherited
Legt die internen Stilcachewerte fest, sodass die getStyle()-Methode funktioniert.
AdvancedStyleClient
 Inherited
Registriert den EffectManager als einen der Ereignis-Listener für jedes Effekt-Ereignis.
AdvancedStyleClient
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Entfernt einen Listener aus dem EventDispatcher-Objekt.
EventDispatcher
 Inherited
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.
Object
 Inherited
setStyle(styleProp:String, newValue:*):void
Legt eine Stileigenschaft für diese Komponenteninstanz fest.
AdvancedStyleClient
 Inherited
Erkennt Änderungen an Stileigenschaften.
AdvancedStyleClient
 Inherited
Flex ruft die stylesInitialized()-Methode auf, wenn die Stile für eine Komponente zum ersten Mal initialisiert werden.
AdvancedStyleClient
 Inherited
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.
Object
 Inherited
Gibt das angegebene Objekt als String zurück.
Object
 Inherited
Gibt den Grundwert des angegebenen Objekts zurück.
Object
 Inherited
Überprüft, ob bei diesem EventDispatcher-Objekt oder bei einem seiner Vorgänger ein Ereignis-Listener für einen bestimmten Ereignistyp registriert ist.
EventDispatcher
Ereignisse
 Ereignis Übersicht Definiert von
 Inherited[broadcast event] Wird ausgelöst, wenn Flash Player oder eine AIR-Anwendung den Betriebssystemfokus erhält und aktiv wird.EventDispatcher
 InheritedDas Änderungsereignis wird immer dann generiert, wenn der Gebietsschemastil geändert oder eine andere Eigenschaft festgelegt wird, die zur Änderung des Zahlenformats oder zu Updates der anderen durch diese Klasse bereitgestellten Werte führen würde.GlobalizationBase
 Inherited[broadcast event] Wird ausgelöst, wenn Flash Player- oder die AIR-Anwendung den Fokus verliert und inaktiv wird.EventDispatcher
Stile

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.

Allgemeine Stile
 Stil Beschreibung Definiert von
 InheritedTyp: String CSS-Vererbung: Ja
Sprachversion: ActionScript 3.0  Produktversion: Flex 4.5  Laufzeitversionen: Flash10.1, AIR 2.5

Die Gebietsschema-ID, die die Tags und Schlüssel für Sprache, Region und Skript sowie optional weitere entsprechende Tags und Schlüssel angibt.
GlobalizationBase
Konstruktordetails

SortingCollator

()Konstruktor
public function SortingCollator()

Sprachversion: ActionScript 3.0
Produktversion: Flex 4.5
Laufzeitversionen: Flash Player 10.1, AIR 2.5

Konstruiert ein neues SortingCollator-Objekt, um Stringvergleiche entsprechend den Konventionen eines angegebenen Gebietsschemas bereitzustellen.

Diese Klasse legt die Startwerte der verschiedenen Überprüfungsoptionen für allgemeine linguistische Sortierzwecke, z. B Sortieren einer Liste von Textstrings, die einem Endbenutzer angezeigt werden, fest. In diesem Modus werden Unterschiede in der Groß- und Kleinschreibung, Zeichen mit Akzent und andere gebietsschemaspezifische Unterschiede bei Stringvergleichen berücksichtigt.

Der Vergleich, der von einer Instanz dieser Klasse bereitgestellt wurde, entspricht dem Erstellen einer Instanz des flash.globalization.Collator, bei dem der initialMode-Paramater auf CollatorMode.SORTING festgelegt wurde. Weitere Informationen und Beispiele für diesen Modus finden Sie in der Dokumentation für die flash.globalization.Collator-Klasse.

Das Gebietsschema für diese Klasse wird vom Gebietsschemastil bereitgestellt. Der Gebietsschemastil kann auf verschiedene Weisen festgelegt werden:

  • Übernehmen des Stils aus einer UIComponent, indem die addStyleClient-Methode der UIComponent aufgerufen wird.
  • Durch Verwenden der Klasse in einer MXML-Deklaration und Übernehmen des Gebietsschemas aus dem Dokument, das die Deklaration enthält.
          Example:
          <fx:Declarations>
                 <s:SortingCollator id="sc" />
          </fx:Declarations>
          
  • Durch Verwenden einer MXML-Deklaration und Festlegen des Gebietsschemawerts in der Liste mit Zuweisungen.
          Example:
          <fx:Declarations>
              <s:SortingCollator id="sc_France" locale="fr-FR" />
          </fx:Declarations>
          
  • setStyle-Methode, z. B. nv.setStyle("locale", "fr-FR") aufrufen

Wenn der locale-Stil nicht durch eine der oben beschriebenen Methoden festgelegt wird, wird die Instanz dieser Klasse als StyleClient der topLevelApplication hinzugefügt und übernimmt daher den locale-Stil aus dem topLevelApplication-Objekt, wenn die locale-abhängige Get-Funktion oder locale-abhängige Methode aufgerufen wird.

Verwandte API-Elemente

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 ]Warum auf Englisch?
Inhalt des ActionScript 3.0-Referenzhandbuchs wird in englischer Sprache angezeigt

Nicht alle Teile des ActionScript 3.0-Referenzhandbuchs wurden in alle Sprachen übersetzt. Wenn der Text zu einem Sprachelement nicht übersetzt wurde, wird er auf Englisch angezeigt. Zum Beispiel wurden die Informationen zur ga.controls.HelpBox-Klasse nicht in andere Sprachen übersetzt. In der deutschen Version des Referenzhandbuchs erscheint der Abschnitt zur ga.controls.HelpBox-Klasse deshalb auf Englisch.