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...
mx.formatters 

Formatter  - AS3 Flex

Paketmx.formatters
Klassepublic class Formatter
VererbungFormatter Inheritance Object
Implementiert IFormatter
Unterklassen CurrencyFormatter, DateFormatter, NumberFormatter, PhoneFormatter, ZipCodeFormatter

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Die Formatter-Klasse ist die Basisklasse für alle Datenformatierungen. Alle Unterklassen der Formatter-Klasse müssen die format()-Methode überschreiben.

MXML-SyntaxexpandedMXML-Syntax ausblenden

The Formatter class defines the following tag attributes, which all of its subclasses inherit:

  <mx:tagname
    Properties
    error=""
  />
  

Beispiele anzeigen



Öffentliche Eigenschaften
 EigenschaftDefiniert von
 Inheritedconstructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.
Object
  defaultInvalidFormatError : String
[statisch] Fehlermeldung für einen ungültigen Formatstring, der in der Formatierung angegeben ist.
Formatter
  defaultInvalidValueError : String
[statisch] Fehlermeldungen für einen ungültigen Wert, der in der Formatierung angegeben ist.
Formatter
  error : String
Beschreibung, die von der Formatierung gespeichert wird, wenn ein Fehler auftritt.
Formatter
Geschützte Eigenschaften
 EigenschaftDefiniert von
  resourceManager : IResourceManager
[schreibgeschützt] Ein Verweis auf ein Objekt, welches alle lokalisierten Ressourcen der Anwendung verwaltet.
Formatter
Öffentliche Methoden
 MethodeDefiniert von
  
Konstruktor.
Formatter
  
Formatiert einen Wert und gibt einen String zurück, der den neuen, formatierten Wert enthält.
Formatter
 Inherited
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.
Object
 Inherited
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.
Object
 Inherited
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.
Object
 Inherited
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.
Object
 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
Geschützte Methoden
 MethodeDefiniert von
  
Diese Methode wird aufgerufen, wenn eine Formatierung erstellt wird, und wird erneut aufgerufen, wenn ResourceManager ein „change“-Ereignis auslöst, um anzugeben, dass sich die lokalisierten Ressourcen geändert haben.
Formatter
Eigenschaftendetails

defaultInvalidFormatError

Eigenschaft
defaultInvalidFormatError:String

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Fehlermeldung für einen ungültigen Formatstring, der in der Formatierung angegeben ist.

Der Standardwert ist "Invalid format".



Implementierung
    public static function get defaultInvalidFormatError():String
    public static function set defaultInvalidFormatError(value:String):void

defaultInvalidValueError

Eigenschaft 
defaultInvalidValueError:String

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Fehlermeldungen für einen ungültigen Wert, der in der Formatierung angegeben ist.

Der Standardwert ist "Invalid value".



Implementierung
    public static function get defaultInvalidValueError():String
    public static function set defaultInvalidValueError(value:String):void

error

Eigenschaft 
public var error:String

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Beschreibung, die von der Formatierung gespeichert wird, wenn ein Fehler auftritt. Weitere Informationen zu den möglichen Werten dieser Eigenschaft finden Sie in der Beschreibung zu der jeweiligen Formatierung.

Unterklassen müssen diesen Wert in der Methode format() festlegen.

resourceManager

Eigenschaft 
resourceManager:IResourceManager  [schreibgeschützt]

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Ein Verweis auf ein Objekt, welches alle lokalisierten Ressourcen der Anwendung verwaltet. Dabei handelt es sich um eine Singleton-Instanz, die die IResourceManager-Schnittstelle implementiert.

Diese Eigenschaft kann als Quelle für die Datenbindung verwendet werden. Beim Ändern dieser Eigenschaft wird das unused -Ereignis ausgelöst.



Implementierung
    protected function get resourceManager():IResourceManager
Konstruktordetails

Formatter

()Konstruktor
public function Formatter()

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Konstruktor.

Methodendetails

format

()Methode
public function format(value:Object):String

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Formatiert einen Wert und gibt einen String zurück, der den neuen, formatierten Wert enthält. Alle Unterklassen müssen diese Methode überschreiben, um die Formatierung zu implementieren.

Parameter

value:Object — Zu formatierender Wert.

Rückgabewerte
String — Der formatierte String.

resourcesChanged

()Methode 
protected function resourcesChanged():void

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Diese Methode wird aufgerufen, wenn eine Formatierung erstellt wird, und wird erneut aufgerufen, wenn ResourceManager ein "change"-Ereignis auslöst, um anzugeben, dass sich die lokalisierten Ressourcen geändert haben.

Dieses Ereignis wird ausgelöst, wenn Sie die localeChain-Eigenschaft des ResourceManager setzen, wenn ein Ressourcenmodul den Ladevorgang abgeschlossen hat und wenn Sie die update()-Methode des ResourceManager aufrufen.

Unterklassen sollten diese Methode überschreiben und nach dem Aufruf von super.resourcesChanged() einen als Antwort auf die neuen Ressourcenwerte angemessenen Vorgang ausführen.

SimpleFormatterExample.mxml
<?xml version="1.0" encoding="utf-8"?>
<!-- Simple example to demonstrate the Formatter class. -->
<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:Script>
        <![CDATA[
            // Event handler to format the input.
            private function Format():void {
                // The format() method returns the formatted String,
                // or an empty String if there is an error.
                var formattedVal:String = numberFormatter.format(inputVal.text);

                if (formattedVal.length == 0) {
                    // If there is an error, the Format.error property 
                    // contains the reason.
                    formattedNumber.text = numberFormatter.error;
                } else {
                    formattedNumber.text = formattedVal;
                }
            }
        ]]>
    </fx:Script>

    <fx:Declarations>
        <mx:NumberFormatter id="numberFormatter" />
    </fx:Declarations>

    <s:Panel title="NumberFormatter Example"
            width="75%" height="75%"
            horizontalCenter="0" verticalCenter="0">
        <mx:Form left="10" right="10" top="10" bottom="10">
            <mx:FormItem label="Enter number - a letter is invalid:">
                <s:TextInput id="inputVal" text="" width="75%"/>
            </mx:FormItem>
            <mx:FormItem label="Formatted number: ">
                <s:TextInput id="formattedNumber" editable="false" width="75%"/>
            </mx:FormItem>
            <mx:FormItem>
                <s:Button label="Validate and Format" click="Format();"/>
            </mx:FormItem>
        </mx:Form>
    </s:Panel>

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