AlphabeticIndex クラス

定義

[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

継承

Object

JavaObject

Object

AlphabeticIndex

属性

RegisterAttribute JavaTypeParametersAttribute

実装

IJavaObject IJavaPeerable IIterable IDisposable

注釈

AlphabeticIndex では、特定の言語に適した UI インデックスの作成がサポートされています。 直接使用をサポートすることも、ローカライズされた照合順序をサポートしていないクライアントで使用することもできます。 UI でのインデックスの外観の例を次に示します。

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

このクラスは、UI の "インデックス" として使用するラベルの一覧、つまり、ユーザーがより大きな "ターゲット" リストのセグメント (バケット) を表示できるようにするクリック可能な文字 (または文字シーケンス) のリストを生成できます。 つまり、各ラベルはターゲット リスト内のバケットに対応します。バケット内のすべてが文字以上です (ロケールの照合順序に従います)。 文字列はインデックスに追加できます。それらは、適切なバケットで並べ替えられた順序になります。

このクラスでは、最初の (アンダーフロー)、最後の (オーバーフロー) の後、およびスクリプト間 (インフロー) の前に文字列のバケットを持つこともサポートされています。 たとえば、インデックスがロシア語と英語のラベルで構成されている場合、ギリシャ語の文字は他の 2 つのスクリプト間のインフロー バケットに分類されます。

<em>Note:</em> ユーザーの言語の文字だけでなく、ASCII 文字やラテン文字が多い場合は、addLabels(ULocale.English) を呼び出することをお勧めします。

<h2>Direct Use</h2>

インデックスを直接作成する例を次に示します。 "show..."以下のメソッドは、使用方法を示すためだけにあります。

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

呼び出し元は、このクラスを使用して異なる UI を構築できます。 たとえば、バケットが空の場合は、インデックス文字を省略したり、灰色表示にしたりすることができます。 小さいバケットは、次のようなサイズに基づいて組み合わせることもできます。

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

<h2>Client サポート</h2>

呼び出し元は、 AlphabeticIndex.ImmutableIndexまたは AlphabeticIndex 自体を使用して、AlphabeticIndex 機能をサポートしていないクライアントでの並べ替えをサポートすることもできます。

ImmutableIndex は、不変とスレッド セーフの両方です。 対応する AlphabeticIndex メソッドは、インデックス バケットを "遅延" して構築するため、スレッド セーフではありません。 <ul><li>ImmutableIndex.getBucket(index) を使用すると、すべてのバケットとそのラベルとラベルの種類にランダムにアクセスできます。 <li>AlphabeticIndex.getBucketLabels() またはいずれかのクラスのバケット反復子を使用して、"..."、"A"、"B",...,などのラベルのリストを取得し、そのリストをクライアントに送信できます。 <li>クライアントが新しい名前を持っている場合は、その名前をサーバーに送信します。 サーバーは次のメソッドを呼び出し、bucketIndex と collationKey をクライアントに伝える必要があります。

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

<li>クライアントは bucketIndex の名前 (および関連情報) をバケットに格納します。 collationKey は、バイナリ比較と比較して適切なローカライズされた結果を生成できるバイト シーケンスです。</li></ul>

Javaドキュメント。

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。