AlphabeticIndex Classe

Definizione

[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

Ereditarietà

Object

JavaObject

Object

AlphabeticIndex

Attributi

RegisterAttribute JavaTypeParametersAttribute

Implementazioni

IJavaObject IJavaPeerable IIterable IDisposable

Commenti

AlphabeticIndex supporta la creazione di un indice dell'interfaccia utente appropriato per una determinata lingua. Può supportare l'uso diretto o l'uso con un client che non supporta le regole di confronto localizzate. Di seguito è riportato un esempio dell'aspetto di un indice in un'interfaccia utente:

<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 può generare un elenco di etichette da usare come "indice" dell'interfaccia utente, ovvero un elenco di caratteri selezionabili (o sequenze di caratteri) che consentono all'utente di visualizzare un segmento (bucket) di un elenco di "destinazione" più grande. Ovvero, ogni etichetta corrisponde a un bucket nell'elenco di destinazione, in cui tutti gli elementi nel bucket sono maggiori o uguali al carattere (in base alle regole di confronto delle impostazioni locali). È possibile aggiungere stringhe all'indice; saranno ordinati nel bucket destro.

La classe supporta anche la presenza di bucket per le stringhe prima del primo (underflow), dopo l'ultimo (overflow) e tra gli script (inflow). Ad esempio, se l'indice viene costruito con etichette per russo e inglese, i caratteri greci rientrano in un bucket di flusso tra gli altri due script.

<em>Nota:</em> Se si prevede di avere un sacco di caratteri ASCII o latini e caratteri della lingua dell'utente, è consigliabile chiamare addLabels(ULocale.English).

<h2>Direct Use</h2>

Di seguito viene illustrato un esempio di compilazione diretta di un indice. Il "show..." i metodi seguenti sono solo per illustrare l'utilizzo.

// 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());
                    }

Il chiamante può compilare interfacce utente diverse usando questa classe. Ad esempio, un carattere di indice può essere omesso o disattivato se il relativo bucket è vuoto. I bucket di piccole dimensioni possono anche essere combinati in base alle dimensioni, ad esempio:

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

<h2>Supporto< client/h2>

I chiamanti possono anche usare , AlphabeticIndex.ImmutableIndexo AlfabeticoIndex stesso, per supportare l'ordinamento in un client che non supporta la funzionalità AlphabeticIndex.

ImmutableIndex è sia non modificabile che thread-safe. I metodi AlphabeticIndex corrispondenti non sono thread-safe perché creano "lazily" i bucket di indice. <ul><li>ImmutableIndex.getBucket(index) fornisce accesso casuale a tutti i bucket e alle relative etichette e tipi di etichetta. <li>AlphabeticIndex.getBucketLabels() o l'iteratore bucket in una delle due classi può essere usato per ottenere un elenco delle etichette, ad esempio "...", "A", "B",..., e inviare tale elenco al client. <li>Quando il client ha un nuovo nome, invia tale nome al server. Il server deve chiamare i metodi seguenti e comunicare di nuovo bucketIndex e collationKey al client.

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

<li>Il client inserisce il nome (e le informazioni associate) nel relativo bucket per bucketIndex. La proprietà collationKey è una sequenza di byte che può essere confrontata con un confronto binario e produce il risultato localizzato corretto.</li></ul>

per android.icu.text.AlphabeticIndex.

Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dalla e usati in base ai termini descritti in Creative License 2.5 Attribution License.