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 

StringTools  - AS3 Flex

Paketspark.globalization
Klassepublic class StringTools
VererbungStringTools 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 StringTools-Klasse stellt gebietsschemabeachtende Methoden für die Umwandlung von Groß- und Kleinbuchstaben bereit.

Diese Klasse ist eine Wrapper-Klasse um den flash.globalization.StringTools. Deshalb werden die Funktionen für die Umwandlung von Groß- und Kleinbuchstaben von derflash.globalization.StringTools-Klasse bereitgestellt. Diese StringTools-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 werden Ereignisse generiert, wenn ein Fehler oder eine Warnung auftritt, die von der flash.globalization-Klasse generiert wurden.

Die flash.globalization.StringTools-Klasse verwendet das zugrundeliegende Betriebssystem für die Funktionen der Umwandlung von Groß- und Kleinbuchstaben, und da einige Betriebssysteme die flash.globalization-Klassen nicht unterstützen, stellt diese Wrapperklasse eine Ausweichlösung bereit, die die Umwandlung von Groß- und Kleinbuchstaben verwendet, die die String-Klasse bereitstellt.

Beispiele anzeigen

Verwandte API-Elemente



Öffentliche Eigenschaften
 EigenschaftDefiniert von
  actualLocaleIDName : String
[override] [schreibgeschützt] Der Name der Gebietsschema-ID, die von diesem Klassenobjekt verwendet wird.
StringTools
 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
 InheritedinheritingStyles : 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.
StringTools
 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
 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 StringTools-Objekt, das Groß-/Kleinschreibungskonvertierung und andere Dienstprogramme gemäß den Konventionen eines gegebenen Gebietsschemas bietet.
StringTools
 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
Sendet ein Ereignis in den Ereignisablauf.
EventDispatcher
  
[statisch] Listet alle Gebietsschema-ID-Namen auf, die von dieser Klasse unterstützt werden.
StringTools
 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
  
Konvertiert einen String in Großbuchstaben gemäß den Sprachkonventionen.
StringTools
 Inherited
Gibt das angegebene Objekt als String zurück.
Object
  
Konvertiert einen String in Kleinbuchstaben gemäß den Sprachkonventionen.
StringTools
 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
Eigenschaftendetails

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():String

Verwandte API-Elemente

flash.globalization.StringTools.actualLocaleIDName
StringTools()

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():String
Konstruktordetails

StringTools

()Konstruktor
public function StringTools()

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

Konstruiert ein neues StringTools-Objekt, das Groß-/Kleinschreibungskonvertierung und andere Dienstprogramme gemäß den Konventionen eines gegebenen Gebietsschemas bietet. 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. Beispiel:
          <fx:Declarations>
                 <s:StringTools id="st" />
          </fx:Declarations>
          
  • Durch Verwenden einer MXML-Deklaration und Festlegen des Gebietsschemawerts in der Liste mit Zuweisungen. Beispiel:
          <fx:Declarations>
              <s:StringTools id="st_turkish" locale="tr-TR" />
          </fx:Declarations>
          
  • setStyle-Methode, z. B. st.setStyle("locale", "tr-TR") 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

Methodendetails

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ückgabewerte
Vector.<String> — Ein Vektor von Strings, der alle von dieser Klasse und diesem Betriebssystem unterstützten Gebietsschema-ID-Namen enthält.

toLowerCase

()Methode 
public function toLowerCase(s:String):String

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

Konvertiert einen String in Großbuchstaben gemäß den Sprachkonventionen. Je nach Gebietsschema kann die Länge des Ausgabestrings von der Länge des Eingabestrings abweichen.

Parameter

s:StringEin String, der in Kleinbuchstaben konvertiert werden soll.

Rückgabewerte
String — Der konvertierte String in Kleinbuchstaben.

Verwandte API-Elemente

toUpperCase

()Methode 
public function toUpperCase(s:String):String

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

Konvertiert einen String in Kleinbuchstaben gemäß den Sprachkonventionen. Je nach Gebietsschema kann die Länge des Ausgabestrings von der Länge des Eingabestrings abweichen.

Parameter

s:StringEin String, der in Großbuchstaben konvertiert werden soll.

Rückgabewerte
String — Der konvertierte String in Großbuchstaben.

Verwandte API-Elemente

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 ]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.