Naslaggids voor Adobe ActionScript® 3.0 voor het Adobe® Flash®-platform
Startpagina  |  Lijst met pakketten en klassen verbergen |  Pakketten  |  Klassen  |  Nieuw  |  Index  |  Bijlagen  |  Waarom in het Engels?
Filters: Gegevens ophalen van server...
Gegevens ophalen van server...
flash.globalization 

CurrencyFormatter  - AS3

Pakketflash.globalization
Klassepublic final class CurrencyFormatter
OverervingCurrencyFormatter Inheritance Object

Taalversie: ActionScript 3.0
Runtimeversies: Flash Player 10.1, AIR 2

De CurrencyFormatter-klasse bevat landspecifieke opmaak en parseringsmethoden voor numerieke waarden.

De CurrencyFormatter-klasse gebruikt de gegevens en functionaliteit die zijn voorzien door het besturingssysteem en die is ontworpen voor de opmaak van valutawaarden volgens de conventies van een specifieke landinstelling en valutasoort. De positie van het valutasymbool, het negatieve symbool, het decimale scheidingsteken, het scheidingsteken voor cijfergroepering, het decimale scheidingsteken van het groeperingspatroon en andere elementen kunnen variëren afhankelijk van de landinstelling.

Als het besturingssysteem ondersteuning biedt voor de aangevraagde landinstelling, worden de eigenschappen en het valutatype ingesteld volgens de conventies en standaardwaarden van de aangevraagde landinstelling. Als de aangevraagde landinstelling niet beschikbaar is, worden de eigenschappen ingesteld volgens een fallback- of standaardlandinstelling van het systeem, die kan worden opgehaald met de eigenschap actualLocaleIDName.

Door de toepassing van gebruikersinstellingen, van besturingssysteemspecifieke opmaakpatronen en van een fallback-landinstelling die wordt toegepast wanneer een gevraagde landinstelling niet wordt ondersteund, komt het voor dat gebruikers soms een andere opmaak zien, ook al wordt dezelfde landinstellings-id gebruikt.

Bekijk de voorbeelden



Openbare eigenschappen
 EigenschapGedefinieerd door
  actualLocaleIDName : String
[alleen-lezen] De naam van de werkelijke landinstellings-id die door dit CurrencyFormatter-object wordt gebruikt.
CurrencyFormatter
 Inheritedconstructor : Object
Verwijzing naar het klasseobject of de constructorfunctie van een bepaalde objectinstantie.
Object
  currencyISOCode : String
[alleen-lezen] De driecijferige ISO 4217-valutacode voor de werkelijk gebruikte landinstelling.
CurrencyFormatter
  currencySymbol : String
[alleen-lezen] Het valutasymbool of -tekenreeks voor de werkelijk gebruikte landinstelling.
CurrencyFormatter
  decimalSeparator : String
Het decimale scheidingsteken dat wordt gebruikt bij de opmaak of het parseren van valutabedragen met een decimaal gedeelte.
CurrencyFormatter
  digitsType : uint
Geeft aan welke cijferset wordt gebruikt voor de opmaak van valutabedragen.
CurrencyFormatter
  fractionalDigits : int
Het maximale aantal cijfers dat wordt weergegeven achter het decimale scheidingsteken.
CurrencyFormatter
  groupingPattern : String
Beschrijft de plaatsing van scheidingstekens voor cijfergroepering binnen de opgemaakte tekenreeks voor het valutabedrag.
CurrencyFormatter
  groupingSeparator : String
Het teken of de tekenreeks die wordt gebruikt voor het scheidingsteken voor cijfergroepering.
CurrencyFormatter
  lastOperationStatus : String
[alleen-lezen] De status van de meest recente bewerking die door dit object CurrencyFormatter is uitgevoerd.
CurrencyFormatter
  leadingZero : Boolean
Geeft aan of een voorloopnul wordt opgenomen in een opgemaakt valutabedrag wanneer er geen gehele getallen links van het decimale scheidingsteken staan.
CurrencyFormatter
  negativeCurrencyFormat : uint
Een numerieke waarde waarmee een notatie voor negatieve valutabedragen wordt aangegeven.
CurrencyFormatter
  negativeSymbol : String
Het symbool voor negatieve getallen dat wordt gebruikt bij de opmaak van negatieve valutabedragen.
CurrencyFormatter
  positiveCurrencyFormat : uint
Een numerieke waarde waarmee een notatie voor positieve valutabedragen wordt aangegeven.
CurrencyFormatter
  requestedLocaleIDName : String
[alleen-lezen] De naam van de aangevraagde landinstellings-id die is doorgegeven aan de constructor van dit CurrencyFormatter-object.
CurrencyFormatter
  trailingZeros : Boolean
Geeft aan of volgnullen worden opgenomen in het opgemaakte valutabedrag.
CurrencyFormatter
  useGrouping : Boolean
Geeft aan dat het scheidingsteken voor cijfergroepering kan worden toegepast bij het opmaken van valutabedragen.
CurrencyFormatter
Openbare methoden
 MethodeGedefinieerd door
  
CurrencyFormatter(requestedLocaleIDName:String)
Maakt een nieuw CurrencyFormatter-object waarmee getallen die valutabedragen voorstellen worden opgemaakt volgens de conventies van een bepaalde landinstelling.
CurrencyFormatter
  
format(value:Number, withCurrencySymbol:Boolean = false):String
Maakt een tekenreeks die een valutabedrag vertegenwoordigt dat is opgemaakt volgens de valuta-eigenschappen van dit object CurrencyFormatter, inclusief de landinstelling, valutasymbool en ISO-code van de valuta.
CurrencyFormatter
  
Bepaalt of het huidige opgegeven valutasymbool kan worden gebruikt bij het opmaken van valutabedragen.
CurrencyFormatter
  
[statisch] Biedt een overzicht van alle namen van landinstellings-id's die door deze klasse worden ondersteund.
CurrencyFormatter
 Inherited
Geeft aan of voor een object een opgegeven eigenschap is gedefinieerd.
Object
 Inherited
Geeft aan of een instantie van de klasse Object zich in de prototypeketen van het object bevindt dat als parameter is opgegeven.
Object
  
Parseert een tekenreeks naar een valutabedrag en een valutasymbool.
CurrencyFormatter
 Inherited
Geeft aan of de opgegeven eigenschap bestaat en kan worden opgesomd.
Object
  
setCurrency(currencyISOCode:String, currencySymbol:String):void
Stelt de currencyISOCode en currencySymbol-eigenschappen van het CurrencyFormatter-object in.
CurrencyFormatter
 Inherited
Stelt de beschikbaarheid van een dynamische eigenschap voor lusbewerkingen in.
Object
 Inherited
Geeft de tekenreeksweergave van dit object weer, geformatteerd volgens de locatiespecifieke conventies.
Object
 Inherited
Retourneert een tekenreeksrepresentatie van het opgegeven object.
Object
 Inherited
Retourneert de primitieve waarde van het opgegeven object.
Object
Eigenschapdetails

actualLocaleIDName

eigenschap
actualLocaleIDName:String  [alleen-lezen]

Taalversie: ActionScript 3.0
Runtimeversies: Flash Player 10.1, AIR 2

De naam van de werkelijke landinstellings-id die door dit CurrencyFormatter-object wordt gebruikt.

Er zijn drie mogelijke waarden voor de naam, afhankelijk van het besturingssysteem en de waarde van de requestedLocaleIDName-parameter die wordt doorgegeven aan de CurrencyFormatter()-constructor.

  1. Als de aangevraagde landinstelling niet gelijk is aan LocaleID.DEFAULT en het besturingssysteem ondersteuning voor de aangevraagde landinstelling biedt, is de geretourneerde naam gelijk aan de eigenschap requestedLocaleIDName.
  2. Als LocaleID.DEFAULT is gebruikt als waarde voor de parameter requestedLocaleIDName aan de constructor, wordt de naam van de huidige landinstelling zoals opgegeven door het besturingssysteem van de gebruiker gebruikt. Met de waarde LocaleID.DEFAULT blijft de aangepaste gebruikersinstelling in het besturingssysteem behouden. Als u een expliciete waarde doorgeeft als parameter requestedLocaleIDName, krijgt u niet noodzakelijkerwijs hetzelfde resultaat als wanneer u LocaleID.DEFAULT gebruikt, ook al zijn beide namen voor de landinstellings-id's gelijk. Misschien heeft de gebruiker de landinstellingen op zijn computer aangepast. Doordat u een expliciete naam van een landinstellings-id aanvraagt (en niet LocaleID.DEFAULT gebruikt), worden deze aangepaste instellingen niet door uw toepassing opgehaald.
  3. Als het systeem geen ondersteuning biedt voor derequestedLocaleIDName die in de constructor is opgegeven, wordt een fallback-landinstellings-id gebruikt.



Implementatie
    public function get actualLocaleIDName():String

Verwante API-elementen

currencyISOCode

eigenschap 
currencyISOCode:String  [alleen-lezen]

Taalversie: ActionScript 3.0
Runtimeversies: Flash Player 10.1, AIR 2

De driecijferige ISO 4217-valutacode voor de werkelijk gebruikte landinstelling.

Deze code wordt gebruikt om het valutasymbool of de tekenreeks te bepalen tijdens de opmaak van de valutabedragen met behulp van de methode format() waarbij de parameter withCurrencySymbol is ingesteld op false.

Deze eigenschap wordt geïnitialiseerd door de constructor op basis van de werkelijk gebruikte landinstelling. Wanneer een fallback-landinstelling wordt gebruikt, geeft deze eigenschap de standaardvalutacode voor de fallback-landinstelling weer.

De standaardwaarde is dependent on the actual locale and operating system.



Implementatie
    public function get currencyISOCode():String

Verwante API-elementen

currencySymbol

eigenschap 
currencySymbol:String  [alleen-lezen]

Taalversie: ActionScript 3.0
Runtimeversies: Flash Player 10.1, AIR 2

Het valutasymbool of -tekenreeks voor de werkelijk gebruikte landinstelling.

Deze eigenschap wordt gebruikt als valutasymbool tijdens het opmaken van valutabedragen met behulp van de methode format() waarbij de parameter withCurrencySymbol is ingesteld op true.

Deze eigenschap wordt geïnitialiseerd door de constructor op basis van de werkelijk gebruikte landinstelling. Wanneer een fallback-landinstelling wordt gebruikt, geeft deze eigenschap het standaardvalutasymbool voor de fallback-landinstelling weer.

De standaardwaarde is dependent on the actual locale and operating system.



Implementatie
    public function get currencySymbol():String

Verwante API-elementen

decimalSeparator

eigenschap 
decimalSeparator:String

Taalversie: ActionScript 3.0
Runtimeversies: Flash Player 10.1, AIR 2

Het decimale scheidingsteken dat wordt gebruikt bij de opmaak of het parseren van valutabedragen met een decimaal gedeelte.

Deze eigenschap wordt oorspronkelijk ingesteld op basis van de landinstelling die is geselecteerd bij het maken van het Formatter-object.

Wanneer u een waarde toekent aan deze eigenschap en er treden geen fouten of waarschuwingsberichten op, wordt de eigenschap lastOperationStatus ingesteld op:

  • LastOperationStatus.NO_ERROR

Als dat niet het geval is, wordt de eigenschap lastOperationStatus ingesteld op een van de constanten die zijn gedefinieerd in de LastOperationStatus-klasse.

De standaardwaarde is dependent on the actual locale and operating system.



Implementatie
    public function get decimalSeparator():String
    public function set decimalSeparator(value:String):void

Gegenereerde uitzondering
TypeError — als aan deze eigenschap de waarde null is toegewezen.

Verwante API-elementen

digitsType

eigenschap 
digitsType:uint

Taalversie: ActionScript 3.0
Runtimeversies: Flash Player 10.1, AIR 2

Geeft aan welke cijferset wordt gebruikt voor de opmaak van valutabedragen.

In verschillende talen en regio's worden verschillende tekensets gebruikt om de cijfers van 0 tot en met 9 aan te geven. Met deze eigenschap wordt aangegeven welke cijferset wordt toegepast.

De waarde van deze eigenschap staat voor de Unicode-waarde van het getal nul van een decimale-cijferset. De geldige waarden voor deze eigenschap zijn gedefinieerd in de NationalDigitsType-klasse.

Wanneer u een waarde toekent aan deze eigenschap en er treden geen fouten of waarschuwingsberichten op, wordt de eigenschap lastOperationStatus ingesteld op:

  • LastOperationStatus.NO_ERROR

Als dat niet het geval is, wordt de eigenschap lastOperationStatus ingesteld op een van de constanten die zijn gedefinieerd in de LastOperationStatus-klasse.

De standaardwaarde is dependent on the actual locale and operating system.



Implementatie
    public function get digitsType():uint
    public function set digitsType(value:uint):void

Gegenereerde uitzondering
TypeError — als aan deze eigenschap de waarde null is toegewezen.

Verwante API-elementen

fractionalDigits

eigenschap 
fractionalDigits:int

Taalversie: ActionScript 3.0
Runtimeversies: Flash Player 10.1, AIR 2

Het maximale aantal cijfers dat wordt weergegeven achter het decimale scheidingsteken.

Getallen worden afgerond op het aantal cijfers dat door deze eigenschap wordt aangegeven. Het afrondingsschema varieert afhankelijk van het besturingssysteem van de gebruiker.

Wanneer de eigenschap trailingZeros is ingesteld op true, wordt het breukgedeelte van het getal (het gedeelte achter de decimale komma) opgevuld met volgnullen, totdat de lengte overeenkomt met de waarde van deze eigenschap fractionalDigits.

Wanneer u een waarde toekent aan deze eigenschap en er treden geen fouten of waarschuwingsberichten op, wordt de eigenschap lastOperationStatus ingesteld op:

  • LastOperationStatus.NO_ERROR

Als dat niet het geval is, wordt de eigenschap lastOperationStatus ingesteld op een van de constanten die zijn gedefinieerd in de LastOperationStatus-klasse.

De standaardwaarde is 0.



Implementatie
    public function get fractionalDigits():int
    public function set fractionalDigits(value:int):void

Verwante API-elementen

groupingPattern

eigenschap 
groupingPattern:String

Taalversie: ActionScript 3.0
Runtimeversies: Flash Player 10.1, AIR 2

Beschrijft de plaatsing van scheidingstekens voor cijfergroepering binnen de opgemaakte tekenreeks voor het valutabedrag.

Wanneer de eigenschap useGrouping is ingesteld op true, worden de plaatsing en het patroon voor het scheidingsteken voor cijfergroepering ingesteld door de eigenschap groupingPattern.

Het groeperingspatroon wordt gedefinieerd als een tekenreeks met cijfers die door puntkomma's worden gescheiden. Het patroon eindigt optioneel met een asterisk. Bijvoorbeeld: "3;2;*". Elk cijfer in de tekenreeks staat voor het aantal cijfers in een groep. Het scheidingsteken voor cijfergroepering wordt voor elke cijfergroep geplaatst. Met de asterisk aan het einde van de tekenreeks geeft u aan dat groepen met het desbetreffende aantal cijfers moeten worden herhaald voor het resterende gedeelte van de opgemaakte tekenreeks. Zonder asterisk zijn er geen extra groepen of scheidingstekens voor het resterende gedeelte van de opgemaakte tekenreeks.

Het eerste getal in de tekenreeks komt overeen met de eerste cijfergroep links van het decimale scheidingsteken. Met de volgende nummers wordt het aantal cijfers in de volgende groepen links van het decimale scheidingsteken bepaald. Zo geeft de tekenreeks "3;2;*" aan dat er een scheidingsteken voor cijfergroepering wordt geplaatst na de eerste cijfergroep van 3 cijfers. Links van deze groep staat dan een groep van 2 cijfers. Bijvoorbeeld: 98,76,54,321

In de volgende tabel worden de voorbeelden weergegeven voor de opmaak van het valutabedrag 123456789.12 met verschillende groeperingspatronen. Het scheidingsteken voor cijfergroepering is een komma, het decimale scheidingsteken een punt en een dollarteken ($) is het valutasymbool.

GroeperingspatroonVoorbeeldopmaak
3;* $123,456,789.12
3;2;*$12,34,56,789.12
3$123456,789.12

U kunt slechts een beperkt aantal groeperingstypen definiëren. Bij sommige besturingssystemen kunnen groeperingspatronen alleen bestaan uit twee cijfers plus een asterisk. Bij andere besturingssystemen is er ondersteuning voor maximaal vier cijfers en een asterisk. Voor patronen zonder asterisk geldt dat sommige besturingssystemen alleen ééncijferige groepen ondersteunen, terwijl bij andere besturingssystemen groepen van maximaal drie cijfers worden ondersteund. Als het maximale aantal elementen in het groeperingspatroon wordt overschreden, worden de extra elementen genegeerd en wordt de eigenschap lastOperationStatus ingesteld als hieronder beschreven.

Wanneer u een waarde toekent aan deze eigenschap en er treden geen fouten of waarschuwingsberichten op, wordt de eigenschap lastOperationStatus ingesteld op:

  • LastOperationStatus.NO_ERROR

Als dat niet het geval is, wordt de eigenschap lastOperationStatus ingesteld op een van de constanten die zijn gedefinieerd in de LastOperationStatus-klasse.



Implementatie
    public function get groupingPattern():String
    public function set groupingPattern(value:String):void

Gegenereerde uitzondering
TypeError — als aan deze eigenschap de waarde null is toegewezen.

Verwante API-elementen

groupingSeparator

eigenschap 
groupingSeparator:String

Taalversie: ActionScript 3.0
Runtimeversies: Flash Player 10.1, AIR 2

Het teken of de tekenreeks die wordt gebruikt voor het scheidingsteken voor cijfergroepering.

De waarde van deze eigenschap wordt gebruikt als het scheidingsteken voor cijfergroepering tijdens de opmaak van valutabedragen wanneer de useGrouping-eigenschap op true is ingesteld. Deze eigenschap wordt oorspronkelijk ingesteld op basis van de landinstelling die is geselecteerd bij het maken van het Formatter-object.

Wanneer u een waarde toekent aan deze eigenschap en er treden geen fouten of waarschuwingsberichten op, wordt de eigenschap lastOperationStatus ingesteld op:

  • LastOperationStatus.NO_ERROR

Als dat niet het geval is, wordt de eigenschap lastOperationStatus ingesteld op een van de constanten die zijn gedefinieerd in de LastOperationStatus-klasse.

De standaardwaarde is dependent on the actual locale and operating system.



Implementatie
    public function get groupingSeparator():String
    public function set groupingSeparator(value:String):void

Gegenereerde uitzondering
TypeError — als aan deze eigenschap de waarde null is toegewezen.

Verwante API-elementen

lastOperationStatus

eigenschap 
lastOperationStatus:String  [alleen-lezen]

Taalversie: ActionScript 3.0
Runtimeversies: Flash Player 10.1, AIR 2

De status van de meest recente bewerking die door dit object CurrencyFormatter is uitgevoerd. De eigenschap lastOperationStatus wordt ingesteld wanneer de constructor of een methode van deze klasse wordt aangeroepen of wanneer een andere eigenschap wordt ingesteld. Zie de beschrijving van de verschillende methoden voor de mogelijke waarden.



Implementatie
    public function get lastOperationStatus():String

Verwante API-elementen

leadingZero

eigenschap 
leadingZero:Boolean

Taalversie: ActionScript 3.0
Runtimeversies: Flash Player 10.1, AIR 2

Geeft aan of een voorloopnul wordt opgenomen in een opgemaakt valutabedrag wanneer er geen gehele getallen links van het decimale scheidingsteken staan.

Wanneer deze eigenschap is ingesteld op true, wordt een voorloopnul toegevoegd aan de linkerzijde van het decimale scheidingsteken bij het opmaken van numerieke waarden tussen -1,0 en 1,0. Wanneer deze eigenschap is ingesteld op false, wordt er geen voorloopnul opgenomen.

Als het valutabedrag bijvoorbeeld 0,321 is en deze eigenschap is ingesteld op true, wordt de voorloopnul in de opgemaakte tekenreeks ingevoegd. Wanneer de eigenschap is ingesteld op false, wordt er geen voorloopnul opgenomen. In dat geval bevat de tekenreeks alleen het decimale scheidingsteken, gevolgd door de decimale cijfers, zoals $.321.

In de volgende tabel staan voorbeelden van de opmaak van valutabedragen op basis van de waarden van deze eigenschap en de bijbehorende eigenschappen fractionalDigits en trailingZeros.

trailingZerosleadingZerofractionalDigits0.120
truetrue3$0.120$0.000
falsetrue3$0.12$0
truefalse3$.120$.000
falsefalse3$.12$0

Wanneer u een waarde toekent aan deze eigenschap en er treden geen fouten of waarschuwingsberichten op, wordt de eigenschap lastOperationStatus ingesteld op:

  • LastOperationStatus.NO_ERROR

Als dat niet het geval is, wordt de eigenschap lastOperationStatus ingesteld op een van de constanten die zijn gedefinieerd in de LastOperationStatus-klasse.

De standaardwaarde is dependent on the actual locale and operating system.



Implementatie
    public function get leadingZero():Boolean
    public function set leadingZero(value:Boolean):void

Gegenereerde uitzondering
TypeError — als aan deze eigenschap de waarde null is toegewezen.

Verwante API-elementen

negativeCurrencyFormat

eigenschap 
negativeCurrencyFormat:uint

Taalversie: ActionScript 3.0
Runtimeversies: Flash Player 10.1, AIR 2

Een numerieke waarde waarmee een notatie voor negatieve valutabedragen wordt aangegeven. Dit patroon bepaalt de locatie van het valutasymbool en het negatieve symbool of haakjes in verband met het numerieke deel van het valutabedrag.

De waarde van deze eigenschap moet een van de contanten in de onderstaande tabel zijn.

In de onderstaande tabel staan de mogelijke opmaakpatronen voor negatieve valutabedragen opgesomd. Wanneer een valutabedrag is opgemaakt met de format()-methode:

  • Het symbool '¤' wordt vervangen door de waarde van de eigenschap currencyISOCode of currencySymbol, afhankelijk van de waarde van de parameter withCurrencySymbol die wordt doorgegeven aan de methode format();
  • Het '-'-teken wordt vervangen door de waarde van de negativeNumberSymbol-eigenschap;
  • Het teken 'n' wordt vervangen door de waarde van het valutabedrag die wordt doorgegeven aan de methode format().
Negatief opmaaktype voor valutaNotatiepatroon
0(¤znw)
1-¤znw
2¤-znw
3¤znw-
4(znw¤)
5-znw¤
6znw-¤
7znw¤-
8-znw¤
9-¤znw
10znw¤-
11¤znw-
12¤-znw
13znw-¤
14(¤znw)
15(znw¤)

Wanneer u een waarde toekent aan deze eigenschap en er treden geen fouten of waarschuwingsberichten op, wordt de eigenschap lastOperationStatus ingesteld op:

  • LastOperationStatus.NO_ERROR

Als dat niet het geval is, wordt de eigenschap lastOperationStatus ingesteld op een van de constanten die zijn gedefinieerd in de LastOperationStatus-klasse.

De standaardwaarde is dependent on the actual locale and operating system.



Implementatie
    public function get negativeCurrencyFormat():uint
    public function set negativeCurrencyFormat(value:uint):void

Gegenereerde uitzondering
ArgumentError — als de toegewezen waarde niet tussen 0 en 15 ligt.

Verwante API-elementen

negativeSymbol

eigenschap 
negativeSymbol:String

Taalversie: ActionScript 3.0
Runtimeversies: Flash Player 10.1, AIR 2

Het symbool voor negatieve getallen dat wordt gebruikt bij de opmaak van negatieve valutabedragen.

Dit symbool wordt met de negatieve valutanotatie gebruikt bij het opmaken van een valutabedrag dat lager dan nul is. Dit wordt niet gebruikt in een negatieve valutaopmaak die geen negatief teken bevat (bijvoorbeeld wanneer negatieve valutabedragen tussen haakjes staan).

Wanneer u een waarde toekent aan deze eigenschap en er treden geen fouten of waarschuwingsberichten op, wordt de eigenschap lastOperationStatus ingesteld op:

  • LastOperationStatus.NO_ERROR

Als dat niet het geval is, wordt de eigenschap lastOperationStatus ingesteld op een van de constanten die zijn gedefinieerd in de LastOperationStatus-klasse.

De standaardwaarde is dependent on the actual locale and operating system.



Implementatie
    public function get negativeSymbol():String
    public function set negativeSymbol(value:String):void

Gegenereerde uitzondering
TypeError — als aan deze eigenschap de waarde null is toegewezen.

Verwante API-elementen

positiveCurrencyFormat

eigenschap 
positiveCurrencyFormat:uint

Taalversie: ActionScript 3.0
Runtimeversies: Flash Player 10.1, AIR 2

Een numerieke waarde waarmee een notatie voor positieve valutabedragen wordt aangegeven. Deze opmaak bepaalt de locatie van het valutasymbool ten opzichte van het numerieke onderdeel van het valutabedrag.

De waarde van deze eigenschap moet een van de contanten in de onderstaande tabel zijn.

In de onderstaande tabel staan de mogelijke opmaakpatronen voor positieve valutabedragen opgesomd. Wanneer een valutabedrag is opgemaakt met de format()-methode:

  • Het symbool '¤' wordt vervangen door de waarde van de eigenschap currencyISOCode of currencySymbol, afhankelijk van de waarde van de parameter withCurrencySymbol die wordt doorgegeven aan de methode format();
  • Het teken 'n' wordt vervangen door de waarde van het valutabedrag die wordt doorgegeven aan de methode format().
Positief opmaaktype voor valutaNotatiepatroon
0¤znw
1znw ¤
2¤znw
3znw ¤

Wanneer u een waarde toekent aan deze eigenschap en er treden geen fouten of waarschuwingsberichten op, wordt de eigenschap lastOperationStatus ingesteld op:

  • LastOperationStatus.NO_ERROR

Als dat niet het geval is, wordt de eigenschap lastOperationStatus ingesteld op een van de constanten die zijn gedefinieerd in de LastOperationStatus-klasse.

De standaardwaarde is dependent on the actual locale and operating system.



Implementatie
    public function get positiveCurrencyFormat():uint
    public function set positiveCurrencyFormat(value:uint):void

Gegenereerde uitzondering
ArgumentError — als de toegewezen waarde niet tussen 0 en 3 ligt.

Verwante API-elementen

requestedLocaleIDName

eigenschap 
requestedLocaleIDName:String  [alleen-lezen]

Taalversie: ActionScript 3.0
Runtimeversies: Flash Player 10.1, AIR 2

De naam van de aangevraagde landinstellings-id die is doorgegeven aan de constructor van dit CurrencyFormatter-object.

Als u de waarde LocaleID.DEFAULT hebt gebruikt, is de geretourneerde naam 'i-default'. Als een fallback-landinstelling wordt toegepast, kan de werkelijk gebruikte landinstelling afwijken van de aangevraagde landinstelling. De naam van de werkelijke landinstelling kan worden opgehaald met de eigenschap actualLocaleIDName.



Implementatie
    public function get requestedLocaleIDName():String

Verwante API-elementen

trailingZeros

eigenschap 
trailingZeros:Boolean

Taalversie: ActionScript 3.0
Runtimeversies: Flash Player 10.1, AIR 2

Geeft aan of volgnullen worden opgenomen in het opgemaakte valutabedrag.

Wanneer deze eigenschap is ingesteld op true, worden volgnullen opgenomen in het breukgedeelte van het opgemaakte getal. Het aantal nullen komt overeen met de maximale waarde die is opgegeven door de eigenschap fractionalDigits. Wanneer deze eigenschap is ingesteld op false, worden er geen volgnullen weergegeven.

Als het valutabedrag bijvoorbeeld 123,4 is, deze eigenschap is ingesteld op true en de eigenschap fractionalDigits is ingesteld op 3, zou de opgemaakte tekenreeks volgnullen weergeven, bijvoorbeeld $123,400. Als deze eigenschap false is, worden volgnullen niet ingevoegd en wordt in de tekenreeks alleen het decimale scheidingsteken weergegeven, gevolgd door de decimale cijfers die niet nul zijn, bijvoorbeeld $123,4.

In de volgende tabel staan voorbeelden van de opmaak van valutabedragen op basis van de waarden van deze eigenschap en de bijbehorende eigenschappen fractionalDigits en leadingZero.

trailingZerosleadingZerofractionalDigits0.120
truetrue3$0.120$0.000
falsetrue3$0.12$0
truefalse3$.120$.000
falsefalse3$.12$0

Wanneer u een waarde toekent aan deze eigenschap en er treden geen fouten of waarschuwingsberichten op, wordt de eigenschap lastOperationStatus ingesteld op:

  • LastOperationStatus.NO_ERROR

Als dat niet het geval is, wordt de eigenschap lastOperationStatus ingesteld op een van de constanten die zijn gedefinieerd in de LastOperationStatus-klasse.

De standaardwaarde is dependent on the actual locale and operating system.



Implementatie
    public function get trailingZeros():Boolean
    public function set trailingZeros(value:Boolean):void

Gegenereerde uitzondering
TypeError — als aan deze eigenschap de waarde null is toegewezen.

Verwante API-elementen

useGrouping

eigenschap 
useGrouping:Boolean

Taalversie: ActionScript 3.0
Runtimeversies: Flash Player 10.1, AIR 2

Geeft aan dat het scheidingsteken voor cijfergroepering kan worden toegepast bij het opmaken van valutabedragen.

Wanneer de eigenschap useGrouping is ingesteld op true, worden cijfers gegroepeerd en gescheiden door het scheidingsteken voor cijfergroepering. Bijvoorbeeld:$123.456.789

Wanneer de eigenschap useGrouping is ingesteld op false, worden er geen cijfers gegroepeerd of gescheiden. Bijvoorbeeld:$123456789

De eigenschap groupingSeparator definieert het symbool dat als scheidingsteken wordt gebruikt. De eigenschap groupingPattern definieert het aantal cijfers tussen scheidingstekens.

Wanneer u een waarde toekent aan deze eigenschap en er treden geen fouten of waarschuwingsberichten op, wordt de eigenschap lastOperationStatus ingesteld op:

  • LastOperationStatus.NO_ERROR

Als dat niet het geval is, wordt de eigenschap lastOperationStatus ingesteld op een van de constanten die zijn gedefinieerd in de LastOperationStatus-klasse.



Implementatie
    public function get useGrouping():Boolean
    public function set useGrouping(value:Boolean):void

Verwante API-elementen

Constructordetails

CurrencyFormatter

()Constructor
public function CurrencyFormatter(requestedLocaleIDName:String)

Taalversie: ActionScript 3.0
Runtimeversies: Flash Player 10.1, AIR 2

Maakt een nieuw CurrencyFormatter-object waarmee getallen die valutabedragen voorstellen worden opgemaakt volgens de conventies van een bepaalde landinstelling.

Deze constructor bepaalt of het huidige besturingssysteem ondersteuning biedt voor de aangevraagde naam van de landinstellings-id. Als er geen ondersteuning is, wordt een fallback-landinstelling gebruikt. Als een fallback-landinstelling wordt gebruikt, geeft de eigenschap lastOperationStatus het type fallback aan en bevat de eigenschap actualLocaleIDName de naam van de fallback-landinstellings-id.

Bepaalde eigenschappen zoals currencySymbol en currencyISOCode worden automatisch gebaseerd op de landinstelling.

OPMERKING: wanneer een fallback-landinstelling wordt gebruikt,worden de valuta-eigenschappen op de standaardwaarde ingesteld en daardoor de eigenschap currencySymbol of currencyISOCode een onverwachte waarde worden gegeven. Het is een goed idee om de eigenschapswaarden van currencySymbol en currencyISOCode te bekijken, voordat u een valutabedrag opmaakt.

Als u een opmaak wilt toepassen die is gebaseerd op de huidige voorkeuren van het besturingssysteem, geeft u de waarde LocaleID.DEFAULT in de parameter requestedLocaleIDName door aan de constructor.

Wanneer de constructor wordt aangeroepen en succesvol wordt afgerond, is de eigenschap lastOperationStatus ingesteld op:

  • LastOperationStatus.NO_ERROR

Wanneer de aangevraagde naam voor de landinstellings-id niet beschikbaar is, wordt lastOperationStatus ingesteld op een van de volgende waarden:

  • LastOperationStatus.USING_FALLBACK_WARNING
  • LastOperationStatus.USING_DEFAULT_WARNING

In het andere geval wordt de eigenschap lastOperationStatus ingesteld op een van de constanten die in de LastOperationStatus-klasse worden gedefinieerd.

Meer informatie over de bovenstaande waarschuwingen en andere mogelijke waarden voor de eigenschap lastOperationStatus vindt u in de beschrijvingen in de klasse LastOperationStatus.

Parameters
requestedLocaleIDName:String — De voorkeursnaam voor de landinstellings-id bij het bepalen van de datum- en tijdnotatie.

Gegenereerde uitzondering
TypeError — als de requestedLocaleIDName-parameter null is.

Verwante API-elementen

Methodedetails

format

()methode
public function format(value:Number, withCurrencySymbol:Boolean = false):String

Taalversie: ActionScript 3.0
Runtimeversies: Flash Player 10.1, AIR 2

Maakt een tekenreeks die een valutabedrag vertegenwoordigt dat is opgemaakt volgens de valuta-eigenschappen van dit object CurrencyFormatter, inclusief de landinstelling, valutasymbool en ISO-code van de valuta.

Deze methode gebruikt standaard de currencyISOCode-eigenschap om het valutasymbool en andere instellingen te bepalen die tijdens de opmaak worden gebruikt.

Veel landen en regio's gebruiken dezelfde valutasymbolen voor verschillende valuta. De Verenigde Staten, Australië, Nieuw-Zeeland, Canada en Mexico gebruiken bijvoorbeeld allemaal hetzelfde dollarsymbool ($) voor lokale valutawaarden. Wanneer de opmaakvaluta afwijkt van de lokale valuta van de gebruiker, kan het beste de ISO-code als valutatekenreeks worden gebruikt. U kunt de formattingWithCurrencySymbolIsSafe()-methode gebruiken om te testen of de ISO-code van de op te maken valuta overeenkomt met de currencyISOCode-eigenschap van de formatter.

Deze methode kan getallen opmaken voor erg grote en erg kleine hoeveelheden. Het aantal belangrijke cijfers wordt echter beperkt tot de precisie die wordt voorzien door het getalgegevenstype.

Parameters

value:Number — De numerieke waarde die in een valutabedrag moet worden ingedeeld.
 
withCurrencySymbol:Boolean (default = false) — Wanneer de eigenschap currencyISOCode is ingesteld op false, bepaalt deze welke valutatekenreeks of welk symbool er in de uitvoertekenreeks wordt gebruikt. Wanneer deze is ingesteld op true, wordt de huidige waarde van de eigenschap currencySymbol in de uitvoertekenreeks gebruikt.

Geretourneerde waarde
String — Een tekenreeks die de opgemaakte valutawaarde bevat.

Verwante API-elementen


Voorbeeld  ( Hoe dit voorbeeld te gebruiken )
In dit voorbeeld is de aangevraagde landinstelling fr-CA Frans (Canada). Het voorbeeld neemt aan dat deze landinstelling wordt ondersteund in het besturingssysteem van de gebruiker en dat er daardoor geen fallback-landinstelling wordt gebruikt. De standaardvaluta voor fr-CA is de Canadese dollar met de ISO-code CAD. Wanneer een valuta met de standaardwaarden wordt opgemaakt, wordt CAD als het valutasymbool gebruikt. Wanneer de withCurrencySymbol-parameter op true ingesteld is, wordt de currencySymbol -eigenschap gebruikt om het huidige bedrag op te maken.
 
         var cf:CurrencyFormatter = new CurrencyFormatter("fr-CA");  
         
         trace(cf.actualLocaleIDName);               // "fr-CA"  
         trace(cf.currencyISOCode);                // "CAD"
         trace(cf.currencySymbol);                // "$"
         
         trace(cf.format(1254.56));                // "1 254,56 CAD"
         trace(cf.format(1254.56, true));            // "1 254,56 $"
         

Het tweede voorbeeld geeft een methode weer voor het opmaken van een valutabedrag in Canadese dollars met de landinstelling van de standaardgebruiker. De formattingWithCurrencySymbolIsSafe()-methode wordt gebruikt om te testen of de standaardvaluta van de gebruiker de Canadese dollar is en of voor de opmaakmethode die hiervoor wordt gebruikt, de withCurrencySymbol-parameter op true is ingesteld. Anders wordt de valuta op Canadese dollar ingesteld met een meer omschrijvend valutasymbool. Het voorbeeld geeft weer hoe de valuta zou worden opgemaakt als de standaardlandinstelling Frans (Canada) of Engels (VS) zou zijn.

 
         var cf:CurrencyFormatter = new CurrencyFormatter(LocaleID.DEFAULT);  
         
         if (cf.formattingWithCurrencySymbolIsSafe("CAD")) {
           trace(cf.actualLocaleIDName);     // "fr-CA French (Canada)"
           trace(cf.format(1254.56, false)); // "1 254,56 $"
         }
         else {
           trace(cf.actualLocaleIDName);     // "en-US English (USA)"
           cf.setCurrency("CAD", "C$")
           trace(cf.format(1254.56, true));  // "C$ 1,254.56"
         }
         

formattingWithCurrencySymbolIsSafe

()methode 
public function formattingWithCurrencySymbolIsSafe(requestedISOCode:String):Boolean

Taalversie: ActionScript 3.0
Runtimeversies: Flash Player 10.1, AIR 2

Bepaalt of het huidige opgegeven valutasymbool kan worden gebruikt bij het opmaken van valutabedragen.

Veel landen en regio's gebruiken dezelfde valutasymbolen. Deze methode kan gebruikt worden om te beschermen tegen het gebruik van een dubbelzinnig valutasymbool of een andere valutasymbool of ISO-code dan verwacht door het gebruik van een fallback-landinstelling.

Een algemene toepassing voor deze methode is om te bepalen of er een lokaal valutasymbool (als het bedrag in de standaardvaluta van de gebruiker wordt opgemaakt) of een specifiekere ISO-codetekenreeks (als het bedrag in een andere valuta dan de standaardvaluta van de gebruiker wordt opgemaakt) wordt weergegeven.

Deze methode vergelijkt de parameter requestedISOCode met de huidige eigenschap currencyISOCode en retourneert true als de tekenreeksen hetzelfde zijn en false als dit niet het geval is. Wanneer de tekenreeks hetzelfde zijn, levert het gebruik van de methode format() met de parameter withCurrencySymbol ingesteld op true een opgemaakte valutawaardetekenreeks op met een uniek valutasymbool voor de landinstelling. Als deze methode false retourneert en u de methode format() met de parameter withCurrencySymbol ingesteld op true gebruikt, kan dit leiden tot het gebruik van een dubbelzinnig of onjuist valutasymbool.

Wanneer deze methode wordt aangeroepen en met succes wordt voltooid, wordt de eigenschap lastOperationStatus ingesteld op:

  • LastOperationStatus.NO_ERROR

Als dat niet het geval is, wordt de eigenschap lastOperationStatus ingesteld op een van de constanten die zijn gedefinieerd in de LastOperationStatus-klasse.

Parameters

requestedISOCode:String — Een drieletterige ISO 4217-valutacode (bijvoorbeeld USD voor Amerikaanse dollars en EUR voor euro's). Moet drie hoofdletters bevatten (van A tot Z).

Geretourneerde waarde
Booleantrue als de currencyISOCode-eigenschap komt overeen met de requestedISOCode-parameter; anders false.

Gegenereerde uitzondering
TypeError — als de requestedISOCode-parameter null is.

Verwante API-elementen

getAvailableLocaleIDNames

()methode 
public static function getAvailableLocaleIDNames():Vector.<String>

Taalversie: ActionScript 3.0
Runtimeversies: Flash Player 10.1, AIR 2

Biedt een overzicht van alle namen van landinstellings-id's die door deze klasse worden ondersteund.

Als deze klasse niet word ondersteund op het huidige besturingssysteem, retourneert deze methode de waarde null.

Wanneer deze methode wordt aangeroepen en met succes wordt voltooid, wordt de eigenschap lastOperationStatus ingesteld op:

  • LastOperationStatus.NO_ERROR

Als dat niet het geval is, wordt de eigenschap lastOperationStatus ingesteld op een van de constanten die zijn gedefinieerd in de LastOperationStatus-klasse.

Geretourneerde waarde
Vector.<String> — Een tekenreeksvector met alle namen van landinstellings-id's die door deze klasse worden ondersteund.

parse

()methode 
public function parse(inputString:String):CurrencyParseResult

Taalversie: ActionScript 3.0
Runtimeversies: Flash Player 10.1, AIR 2

Parseert een tekenreeks naar een valutabedrag en een valutasymbool.

Het parseringslogaritme gebruikt de waarde van de decimalSeparator-eigenschap om het integrale en fractionele deel van het getal te bepalen. Het gebruikt de waarden van de eigenschappen negativeCurrencyFormat en positiveCurrencyFormat om de locatie van het valutasymbool of de tekenreeks in verhouding tot het valutabedrag te bepalen. Voor negatieve bedragen bepaalt de waarde van de eigenschap negativeCurrencyFormat de locatie van het negatieve symbool en of er haakjes worden gebruikt.

Als de volgorde van het valutasymbool, minteken en getal in de invoertekenreeks niet overeenkomt met het patroon van de eigenschappen negativeCurrencyFormat en positiveCurrencyFormat, dan:

  1. De eigenschap value van het geretourneerde object CurrencyParseResult wordt ingesteld op NaN.
  2. De eigenschap currencyString van het geretourneerde object CurrencyParseResult wordt ingesteld op null.
  3. De eigenschap lastOperationStatus wordt ingesteld om aan te geven dan de parsering is mislukt.

De invoertekenreeks kan spatietekens bevatten, die tijdens het parseren worden genegeerd.

Parseren kan zelfs lukken als er geen valutasymbool is. Er wordt geen validatie uitgevoerd op het gedeelte van de tekenreeks die overeenkomt met het valutasymbool. Als er geen valutasymbool of tekenreeks is, wordt de eigenschap currencyString in het geretourneerde object CurrencyParseResult op een lege tekenreeks ingesteld.

Wanneer deze methode wordt aangeroepen en met succes wordt voltooid, wordt de eigenschap lastOperationStatus ingesteld op:

  • LastOperationStatus.NO_ERROR

Als dat niet het geval is, wordt de eigenschap lastOperationStatus ingesteld op een van de constanten die zijn gedefinieerd in de LastOperationStatus-klasse.

Parameters

inputString:String — De invoertekenreeks om te parseren.

Geretourneerde waarde
CurrencyParseResult — Een CurrencyParseResult-object dat de numerieke waarde en het valutasymbool of valutatekenreeks bevat.

Gegenereerde uitzondering
TypeError — als de inputString-parameter null is.

Verwante API-elementen

setCurrency

()methode 
public function setCurrency(currencyISOCode:String, currencySymbol:String):void

Taalversie: ActionScript 3.0
Runtimeversies: Flash Player 10.1, AIR 2

Stelt de currencyISOCode- en currencySymbol-eigenschappen van het CurrencyFormatter-object in.

Wanneer deze methode wordt aangeroepen en met succes wordt voltooid, wordt de eigenschap lastOperationStatus ingesteld op:

  • LastOperationStatus.NO_ERROR

Anders worden de eigenschappen currencyISOCode en currencySymbol niet aangepast en de lastOperationStatus-eigenschap wordt ingesteld als een van de constanten die gedefinieerd zijn in de LastOperationStatus-klasse.

Parameters

currencyISOCode:String — De drieletterige ISO 4217-valutacode (bijvoorbeeld USD voor Amerikaanse dollars en EUR voor euro's). Moet drie hoofdletters bevatten (van A tot Z).
 
currencySymbol:String — Het valutasymbool of valutatekenreeks voor gebruik bij het opmaken van valutawaarden. Dit kan een lege tekenreeks zijn.


Gegenereerde uitzondering
TypeError — als de currencyISOCode of currencySymbol-parameter null is.

Verwante API-elementen

CurrencyFormatterExample.as

Hieronder wordt weergegeven hoe een valutabedrag verschillend wordt ingedeeld bij andere landinstellingen en valuta's. De resultaten in het volgende voorbeeld kunnen afwijken, afhankelijk van het besturingssysteem en de gebruikersinstellingen.

Dit voorbeeld gebruikt de volgende landinstellingen:

  • De standaard landinstelling van het besturingssysteem voor de indeling van valuta (LocaleID.DEFAULT)
  • Japans (Japan)
  • Engels (VS)
  • Frans (Frankrijk)

In het voorbeeld wordt voor elke landinstelling in de lijst het volgende uitgevoerd:

  1. Maakt een CurrencyFormatter-object.
  2. Gebruikt de formattingWithCurrencySymbolIsSafe()-methode om te controleren of de standaardvaluta voor de landinstelling de Euro ('EUR') is en of de tekenreeks met het valutasymbool wordt opgemaakt. Anders wordt de tekenreeks met de ISO-code opgemaakt.
  
package {
    import flash.display.Sprite;
    import flash.globalization.CurrencyFormatter;
    import flash.globalization.LocaleID;
    
    public class CurrencyFormatterExample1 extends Sprite
    {
        public function CurrencyFormatterExample1():void
        {
            var cf:CurrencyFormatter;
            var amountWithSymbol:String;
            var amountWithISOCode:String
            
            var localeNames:Array = [LocaleID.DEFAULT, "ja-JP", "en-US", "fr-FR"];
            
            for each (var localeName:String in localeNames) 
            {
                cf = new CurrencyFormatter(localeName);
                
                trace('\n' + "LocaleID requested=" + cf.requestedLocaleIDName 
                    + "; actual=" + cf.actualLocaleIDName);
                
                trace("Last Operation Status: " + cf.lastOperationStatus );
                
                trace("Currency ISO Code: " + cf.currencyISOCode);
                
                if (cf.formattingWithCurrencySymbolIsSafe("EUR")) 
                {
                    amountWithSymbol = cf.format(123456789.19, true);
                    trace("Format using Symbol: "+ amountWithSymbol);
                }
                else 
                {
                    amountWithISOCode = cf.format(123456789.19); 
                    trace("Format using ISO Code: " + amountWithISOCode);
                }
            }
        }
    }
}
CurrencyFormatterParseExample.as

In het volgende voorbeeld wordt een valutabedrag geparseerd met de regels voor een bepaalde landinstelling. De resultaten in het volgende voorbeeld kunnen afwijken, afhankelijk van het besturingssysteem en de gebruikersinstellingen.

In dit voorbeeld worden de volgende stappen uitgevoerd:

  1. Maakt een CurrencyFormatter-object voor de landinstelling Engels (VS).
  2. Gebruikt de parse()-methode om de invoertekenreeks te parseren.
  3. Geeft de tekenreekswaarden voor het bedrag en de valuta weer van het resulterende CurrencyParseResult-object.
 
package {
      import flash.display.Sprite;
      import flash.globalization.CurrencyFormatter;
      import flash.globalization.CurrencyParseResult;
      import flash.globalization.LastOperationStatus;
      import flash.globalization.LocaleID;

      public class CurrencyFormatterParseExample extends Sprite
      {
            public function CurrencyFormatterParseExample()
            {
                var cf:CurrencyFormatter = new CurrencyFormatter( "en_US" );
                
                trace("LocaleID requested=" + cf.requestedLocaleIDName 
                    + "; actual=" + cf.actualLocaleIDName);
                trace("Last Operation Status: " + cf.lastOperationStatus );

                var inputString:String = "Dollar 123,567,89,0.254";
                
                var result:CurrencyParseResult = cf.parse(inputString);
                
                if (cf.lastOperationStatus == LastOperationStatus.NO_ERROR ) {
                    trace("Amount value: " + result.value); 
                    trace("Currency string: " + result.currencyString); 
                }
            }
      }
}




[ X ]Waarom in het Engels?
Sommige inhoud van de Naslaggids voor ActionScript 3.0 staat in het Engels

Niet alle onderdelen van de Naslaggids voor ActionScript 3.0 zijn in alle talen vertaald. Wanneer een taalelement niet is vertaald, wordt het in het Engels weergegeven. Zo is de klasse ga.controls.HelpBox niet in elke taal vertaald. In de Nederlandse versie van de naslaggids wordt de klasse ga.controls.HelpBox bijvoorbeeld in het Engels weergegeven.