spark.globalizationSortingCollator La classe SortingCollator fournit des capacités de comparaison de chaînes en fonction des paramètres régionaux avec des paramètres initiaux adaptés aux fonctions de tri linguistique, telles que le tri d’une liste de chaînes de caractères présentées à un utilisateur final.spark.globalization.supportClasses:CollatorBase La classe SortingCollator fournit des capacités de comparaison de chaînes en fonction des paramètres régionaux avec des paramètres initiaux adaptés aux fonctions de tri linguistique, telles que le tri d’une liste de chaînes de caractères présentées à un utilisateur final.

Cette classe est une classe d’enveloppe autour de la classe flash.globalization.Collator. Par conséquent, la comparaison de chaînes spécifiques aux paramètres régionaux est fournie par la classe flash.globalization.Collator. Toutefois, cette classe SortingCollator peut être utilisée dans les déclarations MXML, utilise le style de paramètres régionaux pour le nom d’ID de paramètres régionaux demandé, et possède des méthodes et des propriétés qui sont liables. En outre, la propriété LastOperationStatus est définie, si la classe flash.globalization génère une erreur ou un avertissement.

La classe flash.globalization.Collator utilise le système d’exploitation sous-jacent pour la fonctionnalité de formatage et pour fournir les données spécifiques aux paramètres régionaux. Sur certains systèmes d’exploitation, les classes flash.globalization ne sont pas prises en charge ; cette classe d’enveloppe fournit des fonctionnalités de secours.

flash.globalization.CollatorSortingCollator Construit un nouvel objet SortingCollator en vue d’effectuer des comparaisons de chaînes en fonction des conventions des paramètres régionaux spécifiés. Construit un nouvel objet SortingCollator en vue d’effectuer des comparaisons de chaînes en fonction des conventions des paramètres régionaux spécifiés.

Cette classe définit les valeurs initiales des diverses options de classement à des fins de tri linguistique général, comme par exemple le tri d’une liste de chaînes de caractères présentées à un utilisateur final. Dans ce mode, les différences entre majuscules et minuscules, caractères accentués et autres différences spécifiques aux paramètres régionaux sont prises en compte lors de la comparaison de chaînes.

La comparaison fournie par une occurrence de cette classe est équivalente à la construction d’une occurrence de la classe flash.globalization.Collator avec le paramètre initialMode défini sur CollatorMode.SORTING. Pour plus de détails et des exemples d’utilisation de ce mode, veuillez consulter la documentation relative à la classe flash.globalization.Collator.

Les paramètres régionaux pour cette classe sont fournis par le style de paramètres régionaux. Le style de paramètres régionaux peut être défini de plusieurs manières :

  • En héritant le style à partir d’un composant UIComponent en appelant la méthode addStyleClient du composant UIComponent.
  • En utilisant la classe dans une déclaration MXML et en héritant les paramètres régionaux à partir du document qui contient la déclaration.
          Example:
          <fx:Declarations>
                 <s:SortingCollator id="sc" />
          </fx:Declarations>
          
  • En utilisant une déclaration MXML et en spécifiant la valeur des paramètres régionaux dans la liste des affectations.
          Example:
          <fx:Declarations>
              <s:SortingCollator id="sc_France" locale="fr-FR" />
          </fx:Declarations>
          
  • En appelant la méthode setStyle, par ex. sc.setStyle("locale", "fr-FR").

Si le style locale n’est défini par aucune des techniques ci-dessus, l’occurrence de cette classe sera ajoutée comme StyleClient à topLevelApplication. Elle hérite par conséquent du style locale de l’objet topLevelApplication lors de l’appel de l’accesseur de lecture de la propriété dépendante de locale ou de la méthode dépendante de locale.

flash.globalization.Collator
StringTools La classe StringTools fournit des méthodes de conversion de casse en fonction des paramètres régionaux.spark.globalization.supportClasses:GlobalizationBase La classe StringTools fournit des méthodes de conversion de casse en fonction des paramètres régionaux.

Cette classe est une classe d’enveloppe autour de la classe flash.globalization.StringTools. Par conséquent, la fonctionnalité de conversion de casse est fournie par la classe flash.globalization.StringTools. Toutefois, cette classe StringTools peut être utilisée dans les déclarations MXML, utilise le style de paramètres régionaux pour le nom d’ID de paramètres régionaux demandé, et possède des méthodes et des propriétés qui sont liables. En outre, des événements sont générés, si la classe flash.globalization génère une erreur ou un avertissement.

La classe flash.globalization.StringTools utilise le système d’exploitation sous-jacent pour la fonctionnalité de conversion de casse et, sur certains systèmes d’exploitation où les classes flash.globalization ne sont pas prises en charge, cette classe d’enveloppe fournit une solution de secours qui utilise la conversion de casse fournie par la classe String.

flash.globalization.StringToolsStringTools Construit un nouvel objet StringTools qui fournit une conversion de casse et d’autres utilitaires selon les conventions d’un jeu de paramètres régionaux donné. Construit un nouvel objet StringTools qui fournit une conversion de casse et d’autres utilitaires selon les conventions d’un jeu de paramètres régionaux donné. Les paramètres régionaux pour cette classe sont fournis par le style de paramètres régionaux. Le style de paramètres régionaux peut être défini de plusieurs manières :
  • En héritant le style à partir d’un composant UIComponent en appelant la méthode addStyleClient du composant UIComponent.
  • En utilisant la classe dans une déclaration MXML et en héritant les paramètres régionaux à partir du document qui contient la déclaration. Exemple :
          <fx:Declarations>
                 <s:StringTools id="st" />
          </fx:Declarations>
          
  • En utilisant une déclaration MXML et en spécifiant la valeur des paramètres régionaux dans la liste des affectations. Exemple :
          <fx:Declarations>
              <s:StringTools id="st_turkish" locale="tr-TR" />
          </fx:Declarations>
          
  • En appelant la méthode setStyle, par ex. st.setStyle("locale", "tr-TR").

Si le style locale n’est défini par aucune des techniques ci-dessus, l’occurrence de cette classe sera ajoutée comme StyleClient à topLevelApplication. Elle hérite par conséquent du style locale de l’objet topLevelApplication lors de l’appel de l’accesseur de lecture de la propriété dépendante de locale ou de la méthode dépendante de locale.

flash.globalization.StringTools
getAvailableLocaleIDNames Vecteur de chaînes contenant tous les noms des identificateurs de paramètres régionaux pris en charge par cette classe et ce système d'exploitation. toLowerCase Convertit une chaîne en majuscules selon les conventions de langue.La chaîne convertie en minuscules. sObjet String à convertir en minuscules. Convertit une chaîne en majuscules selon les conventions de langue. Selon le jeu de paramètres régionaux, il est possible que la longueur de la chaîne de sortie soit différente de celle de la chaîne d’entrée. flash.globalization.StringToolstoUpperCase Convertit une chaîne en majuscules selon les conventions de langue.La chaîne convertie en majuscules. sObjet String à convertir en majuscules. Convertit une chaîne en majuscules selon les conventions de langue. Selon le jeu de paramètres régionaux, il est possible que la longueur de la chaîne de sortie soit différente de celle de la chaîne d’entrée. flash.globalization.StringToolsactualLocaleIDName Nom de l’identificateur de paramètres régionaux utilisé par cet objet de classe. Nom de l’identificateur de paramètres régionaux utilisé par cet objet de classe. Il s’agit des paramètres régionaux qui sont utilisés pour accéder à la fonctionnalité et aux données de formatage à partir du système d’exploitation.

Si les paramètres régionaux définis par le style des paramètres régionaux ne sont pas disponibles, la valeur de la propriété actualLocaleIDName est différente de la valeur du style des paramètres régionaux. Elle indique les paramètres régionaux de secours qui sont utilisés. Si le style de paramètres régionaux a été défini sur LocaleID.DEFAULT, le nom des paramètres régionaux spécifié par le système d’exploitation de l’utilisateur est utilisé.

flash.globalization.StringTools.actualLocaleIDNameStringTools()
lastOperationStatus Etat de la dernière opération que cet objet de classe a effectuée. Etat de la dernière opération que cet objet de classe a effectuée. La propriété lastOperationStatus est définie chaque fois que le constructeur ou une méthode de cette classe est appelé, ou qu’une autre propriété est définie. Pour les valeurs disponibles, voir la description de chaque méthode.
MatchingCollator La classe MatchingCollator fournit des capacités de comparaison de chaînes en fonction des paramètres régionaux avec des paramètres initiaux adaptés à la mise en correspondance générale de chaînes, comme par exemple la recherche d’un mot donné dans un bloc de texte.spark.globalization.supportClasses:CollatorBase La classe MatchingCollator fournit des capacités de comparaison de chaînes en fonction des paramètres régionaux avec des paramètres initiaux adaptés à la mise en correspondance générale de chaînes, comme par exemple la recherche d’un mot donné dans un bloc de texte.

Cette classe est une classe d’enveloppe autour de la classe flash.globalization.Collator. Par conséquent, la comparaison de chaînes spécifiques aux paramètres régionaux est fournie par la classe flash.globalization.Collator. Toutefois, cette classe MatchingCollator peut être utilisée dans les déclarations MXML, utilise le style de paramètres régionaux pour le nom d’ID de paramètres régionaux demandé, et possède des méthodes et des propriétés qui sont liables. En outre, la propriété LastOperationStatus est définie, si la classe flash.globalization génère une erreur ou un avertissement.

La classe flash.globalization.Collator utilise le système d’exploitation sous-jacent pour la fonctionnalité de formatage et pour fournir les données spécifiques aux paramètres régionaux. Sur certains systèmes d’exploitation, les classes flash.globalization ne sont pas prises en charge ; cette classe d’enveloppe fournit des fonctionnalités de secours.

flash.globalization.CollatorMatchingCollator Construit un nouvel objet MatchingCollator en vue d’effectuer des comparaisons de chaînes en fonction des conventions des paramètres régionaux spécifiés. Construit un nouvel objet MatchingCollator en vue d’effectuer des comparaisons de chaînes en fonction des conventions des paramètres régionaux spécifiés.

Cette classe définit les valeurs initiales des divers cas de classement pour la mise en correspondance générale de chaînes, notamment pour déterminer si deux chaînes sont équivalentes ou pour rechercher un mot donné dans un bloc de texte. Dans ce mode, les différences entre majuscules et minuscules, caractères accentués, etc., sont ignorées lors de la comparaison de chaînes.

La comparaison fournie par une occurrence de cette classe est équivalente à la construction d’une occurrence de la classe flash.globalization.Collator avec le paramètre initialMode défini sur CollatorMode.MATCHING. Pour plus de détails et des exemples d’utilisation de ce mode, veuillez consulter la documentation relative à la classe flash.globalization.Collator.

Les paramètres régionaux pour cette classe sont fournis par le style de paramètres régionaux. Le style de paramètres régionaux peut être défini de plusieurs manières :

  • En héritant le style à partir d’un composant UIComponent en appelant la méthode addStyleClient du composant UIComponent.
  • En utilisant la classe dans une déclaration MXML et en héritant les paramètres régionaux à partir du document qui contient la déclaration.
          Example:
          <fx:Declarations>
                 <s:MatchingCollator id="mc" />
          </fx:Declarations>
          
  • En utilisant une déclaration MXML et en spécifiant la valeur des paramètres régionaux dans la liste des affectations.
          Example:
          <fx:Declarations>
              <s:MatchingCollator id="mc_France" locale="fr-FR" />
          </fx:Declarations>
          
  • En appelant la méthode setStyle, par ex. mc.setStyle("locale", "fr-FR").

Si le style locale n’est défini par aucune des techniques ci-dessus, l’occurrence de cette classe sera ajoutée comme StyleClient à topLevelApplication. Elle hérite par conséquent du style locale de l’objet topLevelApplication lors de l’appel de l’accesseur de lecture de la propriété dépendante de locale ou de la méthode dépendante de locale.

flash.globalization.Collator
LastOperationStatus La classe LastOperationStatus énumère les valeurs constantes qui représentent l’état de l’opération de service de globalisation la plus récente.Object La classe LastOperationStatus énumère les valeurs constantes qui représentent l’état de l’opération de service de globalisation la plus récente. Ces valeurs peuvent être récupérées via la propriété en lecture seule lastOperationStatus disponible dans la plupart des classes de globalisation. flash.globalization.LastOperationStatusBUFFER_OVERFLOW_ERROR Indique que la mémoire tampon fournie ne dispose pas de suffisamment d’espace pour contenir les résultats.bufferOverflowError Indique que la mémoire tampon fournie ne dispose pas de suffisamment d’espace pour contenir les résultats. flash.globalization.LastOperationStatus.BUFFER_OVERFLOW_ERRORERROR_CODE_UNKNOWN Indique que le code d’erreur renvoyé est inconnu.errorCodeUnknown Indique que le code d’erreur renvoyé est inconnu. Toute méthode non statique ou propriété accessible en lecture/écriture peut renvoyer cette erreur lorsque l’opération a échoué et que le code d’erreur renvoyé est inconnu. flash.globalization.LastOperationStatus.ERROR_CODE_UNKNOWNILLEGAL_ARGUMENT_ERROR Indique qu’un argument transmis à une méthode était incorrect.illegalArgumentError Indique qu’un argument transmis à une méthode était incorrect.

Par exemple, le code suivant indique qu’un état d’erreur d’argument non valide est défini lorsque la propriété CurrencyFormatter.grouping est définie sur la valeur non valide "3;".

      var cf:CurrencyFormatter = new CurrencyFormatter();
      cf.setStyle("locale","en_US");
      cf.groupingPattern = "3;";
      trace(cf.lastOperationStatus); // "illegalArgumentError"
      
flash.globalization.LastOperationStatus.ILLEGAL_ARGUMENT_ERROR
INDEX_OUT_OF_BOUNDS_ERROR Indique qu’un itérateur a dépassé les limites ou qu’un paramètre non valide a été spécifié pour le mois, le jour ou l’heure.indexOutOfBoundsError Indique qu’un itérateur a dépassé les limites ou qu’un paramètre non valide a été spécifié pour le mois, le jour ou l’heure. flash.globalization.LastOperationStatus.INDEX_OUT_OF_BOUNDS_ERRORINVALID_ATTR_VALUE Indique que la valeur d’un attribut donné est en dehors de la plage attendue.invalidAttrValue Indique que la valeur d’un attribut donné est en dehors de la plage attendue.

L’exemple suivant indique que définir la propriété NumberFormatter.negativeNumberFormat sur une valeur qui se trouve en dehors de la plage attendue entraîne un état de valeur d’attribut non valide.

      var nf:NumberFormatter = new NumberFormatter();
      nf.setStyle("locale","en_US");
      nf.negativeNumberFormat = 9;
      nf.lastOperationStatus; // "invalidAttrValue"
      
flash.globalization.LastOperationStatus.INVALID_ATTR_VALUE
INVALID_CHAR_FOUND Indique qu’une valeur Unicode non valide a été détectée.invalidCharFound Indique qu’une valeur Unicode non valide a été détectée. flash.globalization.LastOperationStatus.INVALID_CHAR_FOUNDLOCALE_UNDEFINED_ERROR Indique que le style Locale n’est pas défini.localeUndefinedError Indique que le style Locale n’est pas défini. MEMORY_ALLOCATION_ERROR Indique que l’allocation de mémoire a échoué.memoryAllocationError Indique que l’allocation de mémoire a échoué. flash.globalization.LastOperationStatus.MEMORY_ALLOCATION_ERRORNO_ERROR Indique que la dernière opération s’est déroulée sans aucune erreur.noError Indique que la dernière opération s’est déroulée sans aucune erreur. Cet état peut être renvoyé par tous les constructeurs, méthodes non statiques, méthodes statiques et propriétés accessibles en lecture/écriture. flash.globalization.LastOperationStatus.NO_ERRORNUMBER_OVERFLOW_ERROR Indique qu’une opération a produit une valeur qui dépasse le type numérique spécifié.numberOverflowError Indique qu’une opération a produit une valeur qui dépasse le type numérique spécifié. flash.globalization.LastOperationStatus.NUMBER_OVERFLOW_ERRORPARSE_ERROR Indique que l’analyse d’un numéro a échoué.parseError Indique que l’analyse d’un numéro a échoué. Il est possible de renvoyer cet état en analysant les méthodes des classes de formatage, telles que CurrencyFormatter.parse() et NumberFormatter.parseNumber(). Par exemple, si la valeur "12abc34" est transmise en tant que paramètre à la méthode CurrencyFormatter.parse(), la méthode renvoie "NaN" et définit la valeur lastOperationStatus sur LastOperationStatus.PARSE_ERROR. flash.globalization.LastOperationStatus.PARSE_ERRORPATTERN_SYNTAX_ERROR Indique que le modèle de formatage d’un numéro, d’une date ou d’une heure n’est pas valide.patternSyntaxError Indique que le modèle de formatage d’un numéro, d’une date ou d’une heure n’est pas valide. Cet état est défini lorsque le système d’exploitation de l’utilisateur ne prend pas en charge le modèle donné.

Par exemple, le code suivant affiche la valeur de la propriété lastOperationStatus après l’utilisation d’un modèle de formatage "xx" non valide :

      var df:DateTimeFormatter = new DateTimeFormatter();
      df.setStyle("locale","en_US");
      df.setDateTimePattern("xx");
      trace(df.lastOperationStatus); // "patternSyntaxError"
      
flash.globalization.LastOperationStatus.PATTERN_SYNTAX_ERROR
PLATFORM_API_FAILED Indique que l’API d’une plate-forme sous-jacente a échoué pour une opération.platformAPIFailed Indique que l’API d’une plate-forme sous-jacente a échoué pour une opération. flash.globalization.LastOperationStatus.PLATFORM_API_FAILEDTRUNCATED_CHAR_FOUND Indique qu’un caractère Unicode tronqué a été détecté.truncatedCharFound Indique qu’un caractère Unicode tronqué a été détecté. flash.globalization.LastOperationStatus.TRUNCATED_CHAR_FOUNDUNEXPECTED_TOKEN Indique qu’un jeton inattendu a été détecté dans la chaîne d’un identificateur de paramètres régionaux.unexpectedToken Indique qu’un jeton inattendu a été détecté dans la chaîne d’un identificateur de paramètres régionaux.

Par exemple, le code suivant affiche la valeur de la propriété lastOperationStatus après l’utilisation d’une chaîne incomplète lors de la demande d’un identificateur de paramètres régionaux. Par conséquent, la propriété lastOperationStatus est définie sur la valeur UNEXPECTED_TOKEN après un appel à la méthode LocaleID.getKeysAndValues().

      var locale:flash.globalization.LocaleID = new flash.globalization.LocaleID("en-US@Collation");
      var kav:Object = locale.getKeysAndValues();
      trace(locale.lastOperationStatus); // "unexpectedToken"
      
flash.globalization.LastOperationStatus.UNEXPECTED_TOKEN
UNSUPPORTED_ERROR Indique que l’opération ou l’option requise n’est pas prise en charge.unsupportedError Indique que l’opération demandée ou option n’est pas pris en charge. Cet état peut être renvoyé par des méthodes telles que DateTimeFormatter.setDateTimePattern() et lors de la récupération de propriétés telles que Collator.ignoreCase. flash.globalization.LastOperationStatus.UNSUPPORTED_ERRORUSING_DEFAULT_WARNING Indique qu’une valeur par défaut du système d’exploitation a été utilisée au cours de la dernière opération.usingDefaultWarning Indique qu’une valeur par défaut du système d’exploitation a été utilisée au cours de la dernière opération. Les constructeurs de classe peuvent renvoyer cet état. flash.globalization.LastOperationStatus.USING_DEFAULT_WARNINGUSING_FALLBACK_WARNING Indique qu’une valeur par défaut a été définie au cours de la dernière opération.usingFallbackWarning Indique qu’une valeur par défaut a été définie au cours de la dernière opération. Cet état peut être renvoyé par des constructeurs et des méthodes tels que DateTimeFormatter.setDateTimeStyles(), et lors de la récupération de propriétés telles que CurrencyFormatter.groupingPattern. flash.globalization.LastOperationStatus.USING_FALLBACK_WARNING