CollatorBase  - AS3 Flex

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

Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement change .

Eléments de l’API associés

Lorsque cette propriété est définie sur true, les chaînes identiques, ainsi que les chaînes dont l’unique différence réside dans la casse typographique, sont considérées comme égales.

La valeur par défaut est true lorsque le paramètre initialMode du constructeur CollatorBase() est défini sur Collator.MATCHING. La valeur est false lorsque le paramètre initialMode du constructeur CollatorBase() est défini sur Collator.SORTING.

Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement change .

Eléments de l’API associés

Lorsque cette propriété est définie sur true, les formes à pleine chasse et à demi-chasse de certains caractères chinois et japonais sont considérées comme égales.

Pour assurer la compatibilité avec les normes existantes relatives aux jeux de caractères chinois et japonais, Unicode fournit des codes de caractères pour certains caractères à pleine chasse et à demi-chasse. Par exemple, lorsque la propriété ignoreCharacterWidth est définie sur true, compare("Ａｱ", "Aア") renvoie true.

Si la propriété ignoreCharacterWidth est définie sur false, les caractères à pleine chasse et à demi-chasse ne sont pas égaux.

La valeur par défaut est true lorsque le paramètre initialMode du constructeur CollatorBase() est défini sur Collator.MATCHING. La valeur est false lorsque le paramètre initialMode du constructeur CollatorBase() est défini sur Collator.SORTING.

Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement change .

Eléments de l’API associés

Lorsque cette propriété est définie sur true, les chaînes qui utilisent les mêmes caractères de base, mais des accents différents ou d’autres signes diacritiques, sont considérées comme égales. Par exemple, compare("coté", "côte") renvoie true lorsque la propriété ignoreDiacritics est définie sur true.

Lorsque la propriété ignoreDiacritics est définie sur false, les caractères de base possédant des signes diacritiques ou des accents ne sont pas considérés comme égaux.

La valeur par défaut est true lorsque le paramètre initialMode du constructeur CollatorBase() est défini sur Collator.MATCHING. La valeur est false lorsque le paramètre initialMode du constructeur CollatorBase() est défini sur Collator.SORTING.

Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement change .

Eléments de l’API associés

Lorsque cette propriété est définie sur true, les chaînes dont l’unique différence réside dans le type de caractères kana utilisés sont considérées comme égales. Par exemple, compare("カナ", "かな") renvoie true lorsque la propriété ignoreKanaType est définie sur true.

Si la propriété ignoreKanaType est définie sur false, les caractères hiragana et katakana qui font référence à la même syllabe ne sont pas égaux.

La valeur par défaut est true lorsque le paramètre initialMode du constructeur CollatorBase() est défini sur Collator.MATCHING. La valeur est false lorsque le paramètre initialMode du constructeur CollatorBase() est défini sur Collator.SORTING.

Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement change .

Eléments de l’API associés

Lorsque cette propriété est définie sur true, les caractères de symbole, tels qu’espaces, symboles de devises, symboles mathématiques et autres types de symboles, ne sont pas pris en compte lors du tri ou de la correspondance. Par exemple, les chaînes "OBrian", "O’Brian" et "o Brian" sont toutes considérées comme égales lorsque la propriété ignoreSymbols est définie sur true.

La valeur par défaut est true lorsque le paramètre initialMode du constructeur CollatorBase() est défini sur Collator.MATCHING. La valeur est false lorsque le paramètre initialMode du constructeur CollatorBase() est défini sur Collator.SORTING.

Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement change .

Eléments de l’API associés

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.

Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement change .

Eléments de l’API associés

Contrôle la manière dont les valeurs numériques intégrées aux chaînes sont gérées lors de la comparaison des chaînes.

Lorsque la propriété numericComparison est définie sur true, la méthode de comparaison convertit les nombres figurant dans les chaînes en valeurs numériques en vue de le comparaison.

Lorsque cette propriété est définie sur false, la comparaison considère les nombres en tant que codes de caractères et les classe conformément aux règles de tri des caractères des paramètres régionaux spécifiés.

Par exemple, lorsque cette propriété est définie sur true pour l’identificateur de paramètres régionaux "en-US", les chaînes "version1", "version10" et "version2" sont classées dans l’ordre suivant : version1 < version2 < version10.

Lorsque cette propriété est définie sur false pour "en-US", ces mêmes chaînes sont classées dans l’ordre suivant : version1 < version10 < version2.

La valeur par défaut est false.

Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement change .

Eléments de l’API associés

Construit un nouvel objet CollatorBase en vue d’effectuer des comparaisons de chaînes conformément aux conventions des paramètres régionaux spécifiés.

Le paramètre initialMode définit les options de classement initial pour deux cas d’utilisation : le tri et la mise en correspondance. Il peut lui être affectée l’une des deux valeurs suivantes :

• CollatorMode.SORTING : définit les 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.
• CollatorMode.MATCHING : définit les options de classement à des fins telles que le fait de déterminer si deux chaînes sont équivalentes. 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.

Pour plus de détails et des exemples d’utilisation de ces deux modes, veuillez consulter la documentation relative à la classe flash.globalization.Collator.

Les paramètres régionaux pour cette classe sont fournis par le style locale. Le style locale 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 avec une instance de cet objet comme paramètre.
• En utilisant la classe dans une déclaration MXML et en héritant le style locale à partir du document qui contient la déclaration.

            <fx:Declarations>
                   <s:SortingCollator id="collator" />
            </fx:Declarations>
            

• En utilisant une déclaration MXML et en spécifiant la valeur locale dans la liste des affectations.

            <fx:Declarations>
                <s:SortingCollator id="collator_german" locale="de-DE" />
            </fx:Declarations>
            

• En appelant la méthode setStyle, par ex. collator.setStyle("locale", "de-DE").

Si le style locale n’est pas défini selon l’une des techniques ci-dessus, les méthodes de cette classe qui dépendent du style locale définissent la propriété lastOperationStatus sur spark.globalization.LastOperationStatus.LOCALE_UNDEFINED_ERROR.

Eléments de l’API associés

Compare deux chaînes et renvoie un nombre entier indiquant si la première chaîne est inférieure, égale ou supérieure à la deuxième chaîne. La comparaison utilise les règles de tri du style locale qui est en vigueur lorsque la méthode compare est appelée.

Paramètres

Eléments de l’API associés

Compare deux chaînes et renvoie une valeur booléenne indiquant si les chaînes sont égales. La comparaison utilise les règles de tri de l’identificateur de paramètres régionaux spécifié dans le constructeur CollatorBase().

Paramètres

Eléments de l’API associés

Répertorie tous les noms des ID de paramètres régionaux pris en charge par cette classe.