AlphabeticIndex Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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
- 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<Integer> index = new AlphabeticIndex<Integer>(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<Integer> bucket : index) {
if (showAll || bucket.size() != 0) {
showLabelAtTop(UI, bucket.getLabel());
}
}
...
// Show the buckets with their contents, skipping empty buckets
for (AlphabeticIndex.Bucket<Integer> bucket : index) {
if (bucket.size() != 0) {
showLabelInList(UI, bucket.getLabel());
for (AlphabeticIndex.Record<Integer> 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 |
| 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 |
| IJavaPeerable.Finalized() |
Marque cet homologue comme supprimé et appelle |
| 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 |
| JavaAs<TResult>(IJavaPeerable) |
Essayez de forcer |
| 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 |
| ToEnumerable<T>(IIterable) |
Retourne un IEnumerable<T> itération sur un JavaIIterable, marshalant chaque élément sur |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
Essayez de forcer |