Langue

AlphabeticIndex Classe

Définition

AlphabeticIndex prend en charge la création d’un index d’interface utilisateur approprié pour une langue donnée.

[Android.Runtime.Register("android/icu/text/AlphabeticIndex", ApiSince=24, DoNotGenerateAcw=true)]
[Java.Interop.JavaTypeParameters(new System.String[] { "V" })]
public sealed class AlphabeticIndex : Java.Lang.Object, IDisposable, Java.Lang.IIterable
[<Android.Runtime.Register("android/icu/text/AlphabeticIndex", ApiSince=24, DoNotGenerateAcw=true)>]
[<Java.Interop.JavaTypeParameters(new System.String[] { "V" })>]
type AlphabeticIndex = class
    inherit Object
    interface IIterable
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable
Héritage
AlphabeticIndex
Attributs
Implémente

Remarques

AlphabeticIndex prend en charge la création d’un index d’interface utilisateur approprié pour une langue donnée. Il peut prendre en charge l’utilisation directe ou l’utiliser avec un client qui ne prend pas en charge le classement localisé. Voici un exemple de ce qu’un index peut ressembler dans une interface utilisateur :

<b>... A B C D E F G H I J K L M N O P Q R S T U V W X Y Z  ...</b>

<b>A</b>
                Addison
                Albertson
                Azensky
<b>B</b>
                Baecker
             ...

La classe peut générer une liste d’étiquettes à utiliser comme « index » de l’interface utilisateur, c’est-à-dire une liste de caractères cliquables (ou séquences de caractères) qui permettent à l’utilisateur d’afficher un segment (compartiment) d’une liste « cible » plus grande. Autrement dit, chaque étiquette correspond à un compartiment dans la liste cible, où tout ce qui se trouve dans le compartiment est supérieur ou égal au caractère (selon le classement des paramètres régionaux). Les chaînes peuvent être ajoutées à l’index ; ils seront triés dans le bon compartiment.

La classe prend également en charge la présence de compartiments pour les chaînes avant le premier (sous-flux), après le dernier (dépassement de capacité) et entre les scripts (flux). Par exemple, si l’index est construit avec des étiquettes pour le russe et l’anglais, les caractères grecs se trouvent dans un compartiment de flux entre les deux autres scripts.

<em>Remarque :</em> Si vous prévoyez d’avoir beaucoup de caractères ASCII ou latins ainsi que des caractères de la langue de l’utilisateur, il est judicieux d’appeler addLabels(ULocale.English).

<h2>Utilisation< directe/h2>

L’exemple suivant montre comment créer un index directement. Le « show... » les méthodes ci-dessous illustrent simplement l’utilisation.

// Create a simple index where the values for the strings are Integers, and add the strings

            AlphabeticIndex&lt;Integer&gt; index = new AlphabeticIndex&lt;Integer&gt;(desiredLocale).addLabels(additionalLocale);
            int counter = 0;
            for (String item : test) {
                index.addRecord(item, counter++);
            }
            ...
            // Show index at top. We could skip or gray out empty buckets

            for (AlphabeticIndex.Bucket&lt;Integer&gt; bucket : index) {
                if (showAll || bucket.size() != 0) {
                    showLabelAtTop(UI, bucket.getLabel());
                }
            }
             ...
            // Show the buckets with their contents, skipping empty buckets

            for (AlphabeticIndex.Bucket&lt;Integer&gt; bucket : index) {
                if (bucket.size() != 0) {
                    showLabelInList(UI, bucket.getLabel());
                    for (AlphabeticIndex.Record&lt;Integer&gt; item : bucket) {
                        showIndexedItem(UI, item.getName(), item.getData());
                    }

L’appelant peut générer différentes interfaces utilisateur à l’aide de cette classe. Par exemple, un caractère d’index peut être omis ou grisé si son compartiment est vide. Les petits compartiments peuvent également être combinés en fonction de la taille, par exemple :

<b>... A-F G-N O-Z ...</b>

<Support< client h2>/h2>

Les appelants peuvent également utiliser l’alphabeticIndex AlphabeticIndex.ImmutableIndexlui-même pour prendre en charge le tri sur un client qui ne prend pas en charge la fonctionnalité AlphabeticIndex.

ImmutableIndex est immuable et thread-safe. Les méthodes AlphabeticIndex correspondantes ne sont pas thread-safe, car elles « lazily » créent les compartiments d’index. <ul><li>ImmutableIndex.getBucket(index) fournit un accès aléatoire à tous les compartiments et à leurs étiquettes et types d’étiquettes. <li>AlphabeticIndex.getBucketLabels() ou itérateur de compartiment sur l’une ou l’autre classe peut être utilisé pour obtenir une liste des étiquettes, telles que « ... », « A », « B » ,..., et envoyer cette liste au client. <li>Lorsque le client a un nouveau nom, il envoie ce nom au serveur. Le serveur doit appeler les méthodes suivantes et communiquer le bucketIndex et collationKey au client.

int bucketIndex = index.getBucketIndex(name);
            String label = immutableIndex.getBucket(bucketIndex).getLabel();  // optional
            RawCollationKey collationKey = collator.getRawCollationKey(name, null);

<li>Le client place le nom (et les informations associées) dans son compartiment pour bucketIndex. La clé de classement est une séquence d’octets qui peut être comparée à une comparaison binaire et produit le résultat localisé approprié.</li></ul>

Java documentation pour android.icu.text.AlphabeticIndex.

Les parties de cette page sont des modifications basées sur le travail créé et partagé par Android Open Source et utilisées en fonction des termes décrits dans la Creative Commons 2.5 Attribution License.

Constructeurs

Nom Description
AlphabeticIndex(Locale)

Créez l’objet d’index.

AlphabeticIndex(RuleBasedCollator)

Créez un alphabeticIndex qui utilise un collator spécifique.

AlphabeticIndex(ULocale)

Créez l’objet d’index.

Propriétés

Nom Description
BucketCount

Retourne le nombre de compartiments dans l’index.

BucketLabels

Obtenez les étiquettes.

Class

Retourne la classe runtime de ce Object.

(Hérité de Object)
Collator

Obtenez un clone du collateur utilisé en interne.

Handle

Handle de l’instance Android sous-jacente.

(Hérité de Object)
InflowLabel

Obtenez l’étiquette par défaut utilisée pour les compartiments abrégés entre d’autres étiquettes.

JniIdentityHashCode

Obtient le code de hachage d’identité affecté à cet homologue Java par le runtime d’interopérabilité.

(Hérité de Object)
JniManagedPeerState

Obtient les indicateurs d’état affectés en dernier par le runtime.

(Hérité de JavaObject)
JniPeerMembers

Obtient les métadonnées JNI utilisées pour accéder aux membres de cette liaison Java.

MaxLabelCount

Obtenez la limite du nombre d’étiquettes dans l’index.

OverflowLabel

Obtenez l’étiquette par défaut utilisée dans les paramètres régionaux d’IndexCharacters pour le dépassement de capacité, par exemple le premier élément dans : .

PeerReference

Obtient la référence d’objet JNI pour cet homologue Java.

(Hérité de Object)
RecordCount

Retourne le nombre d’enregistrements dans l’index : autrement dit, le nombre total de < distincts ; name,data> paires ajoutées avec addRecord(.

ThresholdClass

Cette API prend en charge l’infrastructure Mono pour Android et n’est pas destinée à être utilisée directement à partir de votre code.

(Hérité de Object)
ThresholdType

Cette API prend en charge l’infrastructure Mono pour Android et n’est pas destinée à être utilisée directement à partir de votre code.

(Hérité de Object)
UnderflowLabel

Obtenez l’étiquette par défaut utilisée dans les paramètres régionaux d’IndexCharacters pour le sous-flux, par exemple le dernier élément dans : X Y Z .

Méthodes

Nom Description
AddLabels(Locale[])

Ajouter d’autres caractères d’index (à part ce qui se trouve dans les paramètres régionaux)

AddLabels(ULocale[])

Ajouter d’autres caractères d’index (à part ce qui se trouve dans les paramètres régionaux)

AddLabels(UnicodeSet)

Ajouter d’autres caractères d’index (à part ce qui se trouve dans les paramètres régionaux)

AddRecord(ICharSequence, Object)

Ajoutez un enregistrement (nom et données) à l’index.

AddRecord(String, Object)

Ajoutez un enregistrement (nom et données) à l’index.

BuildImmutableIndex()

Génère une version immuable et thread-safe de cette instance, sans enregistrements de données.

ClearRecords()

Effacez l’index.

Clone()

Crée et retourne une copie de cet objet.

(Hérité de Object)
Construct(JniObjectReference, JniObjectReferenceOptions)

Délègue la construction de cet homologue au gestionnaire de valeurs du runtime.

(Hérité de JavaObject)
Dispose()

Libère les ressources détenues par cet homologue Java.

(Hérité de Object)
Dispose(Boolean)

Libère les ressources détenues par cet homologue Java.

(Hérité de Object)
DisposeUnlessReferenced()

Demande au gestionnaire de valeurs de supprimer cet homologue, sauf si son mappage conserve cette même instance managée.

(Hérité de JavaObject)
Equals(Object)

Teste si un autre homologue managé fait référence au même objet Java.

(Hérité de JavaObject)
Equals(Object)

Indique si un autre objet est « égal à » celui-ci.

(Hérité de Object)
GetBucketIndex(ICharSequence)

Obtenez le numéro de compartiment pour le nom donné.

GetBucketIndex(String)

Obtenez le numéro de compartiment pour le nom donné.

GetHashCode()

Retourne une valeur de code de hachage pour l’objet.

(Hérité de Object)
Iterator()

Retourne un itérateur sur les compartiments.

JavaFinalize()
Obsolète.

Appelé par le garbage collector sur un objet lorsque le garbage collection détermine qu’il n’y a plus de références à l’objet.

(Hérité de Object)
Notify()

Réveille un thread unique qui attend le moniteur de cet objet.

(Hérité de Object)
NotifyAll()

Réveille tous les threads qui attendent le moniteur de cet objet.

(Hérité de Object)
SetHandle(IntPtr, JniHandleOwnership)

Définit la propriété Handle.

(Hérité de Object)
SetInflowLabel(String)

Définir l’étiquette inflowLabel

SetMaxLabelCount(Int32)

Définissez une limite sur le nombre d’étiquettes dans l’index.

SetOverflowLabel(String)

Définir l’étiquette de dépassement de capacité

SetPeerReference(JniObjectReference, JniObjectReferenceOptions)

Stocke une valeur de référence dans le bloc de contrôle sans créer de copie de référence JNI.

(Hérité de JavaObject)
SetUnderflowLabel(String)

Définir l’étiquette underflowLabel

ToArray<T>()

Crée un tableau managé à partir de ce wrapper de tableau Java.

(Hérité de Object)
ToString()

Retourne une représentation sous forme de chaîne de l’objet.

(Hérité de Object)
UnregisterFromRuntime()

Annule l’inscription de cet homologue Java à partir du runtime d’interopérabilité.

(Hérité de Object)
Wait()

Provoque l’attente du thread actuel jusqu’à ce qu’il soit réveillé, généralement en étant <averti par em ou><em>interrompu</em>.<>

(Hérité de Object)
Wait(Int64, Int32)

Provoque l’attente du thread actuel jusqu’à ce qu’il soit réveillé, généralement en étant <averti> par< em>ou <em>interrompu/em<,> ou jusqu’à ce qu’une certaine quantité de temps réel s’est écoulée.

(Hérité de Object)
Wait(Int64)

Provoque l’attente du thread actuel jusqu’à ce qu’il soit réveillé, généralement en étant <averti> par< em>ou <em>interrompu/em<,> ou jusqu’à ce qu’une certaine quantité de temps réel s’est écoulée.

(Hérité de Object)

Implémentations d’interfaces explicites

Nom Description
IJavaPeerable.Disposed()

Marque cet homologue comme supprimé et appelle Dispose avec disposing la valeur définie truesur .

(Hérité de JavaObject)
IJavaPeerable.Finalized()

Marque cet homologue comme supprimé et appelle Dispose avec disposing la valeur définie falsesur .

(Hérité de JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock

Obtient le pointeur de bloc de contrôle natif utilisé par cet homologue.

(Hérité de JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)

Stocke le code de hachage d’identité fourni par le runtime.

(Hérité de JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)

Remplace les indicateurs d’état d’homologue géré stockés.

(Hérité de JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)

Met à jour la référence d’homologue et libère le bloc de contrôle d’un homologue supprimé lorsque la référence n’est pas valide.

(Hérité de JavaObject)
IJavaPeerable.UnregisterFromRuntime()

Supprime cette instance de la recherche d'objets Java du runtime.

Méthodes d’extension

Nom Description
GetJniTypeName(IJavaPeerable)

Obtient le nom JNI du type de l’instance self.

JavaAs<TResult>(IJavaPeerable)

Essayez de forcer self le typeTResult, en vérifiant que le forçage est valide côté Java.

JavaCast<TResult>(IJavaObject)

Effectue une conversion de type vérifiée par le runtime Android.

JavaCast<TResult>(IJavaObject)

Réutilise un homologue managé compatible ou obtient un wrapper du type demandé.

ToEnumerable(IIterable)

Retourne un IEnumerable itération sur un JavaIIterable, ce qui permet foreach et LINQ d’être utilisé avec Java types de collection. Chaque élément est marshalé de son instance Java vers le type managé correspondant.

ToEnumerable<T>(IIterable)

Retourne un IEnumerable<T> itération sur un JavaIIterable, marshalant chaque élément sur T. Cela permet foreach et LINQ d’être utilisé avec des types de collection Java.

TryJavaCast<TResult>(IJavaPeerable, TResult)

Essayez de forcer self le typeTResult, en vérifiant que le forçage est valide côté Java.

S’applique à