AlphabeticIndex Classe

Definição

[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

Herança

Object

JavaObject

Object

AlphabeticIndex

Atributos

RegisterAttribute JavaTypeParametersAttribute

Implementações

IJavaObject IJavaPeerable IIterable IDisposable

Comentários

AlphabeticIndex dá suporte à criação de um índice de interface do usuário apropriado para um determinado idioma. Ele pode dar suporte ao uso direto ou usar com um cliente que não dá suporte à ordenação localizada. Veja a seguir um exemplo de como um índice pode ser em uma interface do usuário:

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

A classe pode gerar uma lista de rótulos para uso como um "índice" da interface do usuário, ou seja, uma lista de caracteres clicáveis (ou sequências de caracteres) que permitem que o usuário veja um segmento (bucket) de uma lista maior de "destino". Ou seja, cada rótulo corresponde a um bucket na lista de destino, em que tudo no bucket é maior ou igual ao caractere (de acordo com a ordenação da localidade). Cadeias de caracteres podem ser adicionadas ao índice; eles estarão em ordem classificada no bucket direito.

A classe também dá suporte a ter buckets para cadeias de caracteres antes do primeiro (subfluxo), após o último (estouro) e entre scripts (fluxo). Por exemplo, se o índice for construído com rótulos para russo e inglês, os caracteres gregos cairão em um bucket de entrada entre os outros dois scripts.

<em>Observação:</em> Se você espera ter muitos caracteres ASCII ou latinos, bem como caracteres do idioma do usuário, é uma boa ideia chamar addLabels(ULocale.English).

<h2>Uso< Direto/h2>

O exemplo a seguir mostra um exemplo de criação direta de um índice. O "show..." os métodos abaixo são apenas para ilustrar o uso.

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

O chamador pode criar UIs diferentes usando essa classe. Por exemplo, um caractere de índice poderá ser omitido ou esmaecido se o bucket estiver vazio. Buckets pequenos também podem ser combinados com base no tamanho, como:

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

<Suporte> ao cliente h2</h2>

Os chamadores também podem usar o AlphabeticIndex.ImmutableIndex, ou o alphabeticIndex em si, para dar suporte à classificação em um cliente que não dá suporte à funcionalidade AlphabeticIndex.

O ImmutableIndex é imutável e thread-safe. Os métodos AlphabeticIndex correspondentes não são thread-safe porque criam "preguiçosamente" os buckets de índice. <ul><li>ImmutableIndex.getBucket(index) fornece acesso aleatório a todos os buckets e seus rótulos e tipos de rótulo. <li>AlphabeticIndex.getBucketLabels() ou o iterador de bucket em qualquer classe pode ser usado para obter uma lista dos rótulos, como "...", "A", "B",..., e enviar essa lista para o cliente. <li>Quando o cliente tem um novo nome, ele envia esse nome para o servidor. O servidor precisa chamar os métodos a seguir e comunicar o bucketIndex e o collationKey de volta ao cliente.

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

<li>O cliente colocaria o nome (e informações associadas) em seu bucket para bucketIndex. A collationKey é uma sequência de bytes que pode ser comparada com uma comparação binária e produz o resultado localizado correto.</li></ul>

Java documentação para android.icu.text.AlphabeticIndex.

Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Project Open Source do Open Source e usadas de acordo com os termos descritos na Creative Commons 2.5.