18章：AWT

トップ->Java Applet入門

Java入門内検索

このページの先頭に戻る

トップページに戻る

このページの先頭に戻る
 トップページに戻る

トップ-> Java入門：18章 AWT-> 19.List

前ページへ　:　トップへ　:　次ページへ

19. List

　　リストとはWindowsではリストボックスと呼ばれるコンポーネントで、Choiceのように指定された項目から選択するようなGUIコンポーネントです。Choiceでは現在選択された１つのみが表示され、プルダウンで複数の選択肢が表示されて選べるようになりますが、このListではあらかじめ複数行が表示されており、その中から選びます。Choiceに比べて表示面積が大きくなってしまうのがデメリットですが、あらかじめ選択肢が見えているのでユーザーにとってはわかりやすいというメリットがあります。また、Choiceと違って、複数選択できるのも特徴です。

　　通常、性別、年齢、血液型、お住まいの都道府県など、１つしか選択できず、１つを見ればその他のすべての選択肢が容易に想像できるような場合はChoiceを使用します。逆に１つを見ても他のすべての選択肢が想像できない場合（例えば、好きな色、感想など）はListを選びます。>

　　なお、ダブルクリックした場合はActionEventが発生します。必要ならばこれも使います。

血液型：
※この例では複数選択できないようにしています。

【使い方】

Listのインスタンスを作成します。
このインスタンスを配置するFrameなどContainerに追加(addメソッド)する。
項目を追加(addメソッド)します。
ItemListenerを追加(addItemListenerメソッド）します。
選択項目に変化があった場合に呼ばれるitemStateChangedメソッドを実装します。

コンストラクタ

List()
　　　　　　デフォルト（表示行数４行、複数選択不可）のListコンポーネントを作ります。
　　　　　　表示行数はプログラムで変更できませんので、注意してください。

List(int rows)
　　　　　　表示行数をrowsとして複数選択不可のListコンポーネントを作ります。
　　　　　　表示行数はプログラムで変更できませんので、注意してください。

List(int rows, boolean multi)
　　　　　　表示行数をrowsとしてListコンポーネントを作ります。
　　　　　　 multiがtrueの場合は複数選択が可能になります。
　　　　　　表示行数はプログラムで変更できませんので、注意してください。

メソッド

void add(String item)
　　　　Listの最後に項目を追加します。

void add(String item, int index)
　　　　indexで指定した位置にメニューの項目を挿入します。indexが０の場合は一番最初に挿入されます。
　　　　indexが現在登録されているメニューよりも後ろ、もしくは負数の場合は、一番最後に追加します。

void remove(int index)
　　　　indexで指定した位置にメニューを削除します。indexが０の場合は一番最初が削除されます。
　　　　indexが不正な場合、ArrayIndexOutOfBoundsExceptionが投げられます。

void remove(String item)
　　　　itemで指定したメニューを削除します。
　　　　itemが登録されていない場合は、IllegalArgumentExceptionが投げられます。

void removeAll()
　　　　登録されている項目すべてを削除し、からにします。

void select(int index)
　　　　indexで指定したメニューを選択します。
　　　　このメソッドを実行してもItemEventは発生しません。
　　　　通常デフォルトでは何も選択されていませんので、初期値を設定するのに使います。
　　　　複数選択可能モードで、indexが-1を指定した場合はすべてを選択します。項目数よりも大きい値を指定した場合や、複数選択できないモードでindexが-1の場合は無視されます。

void deselect(int index)
　　　　indexで指定したメニューを選択解除します。
　　　　このメソッドを実行してもItemEventは発生しません。
　　　　indexが不正な場合、無視されます。

String getItem(int index)
　　　　indexで指定した項目を返します。
　　　　indexが不正な場合はArrayIndexOutOfBoundsExceptionが投げられます。

String[] getItems()
　　　　登録されている項目すべてをString配列として返します。
　　　　登録されていない場合は、配列の長さが０のString配列が返されます。

int getItemCount()
　　　　登録されている項目数を返します。

int getSelectedIndex()
　　　　選択されている項目のインデックスを返します。
　　　　選択されていない場合、複数選択されている場合は-1が返ります。
　　　　主に１つしか選択できないモードで作成されている時に使います。

int getSelectedIndexes()
　　　　選択されている項目のインデックスをint型の配列として返します。
　　　　選択されていない場合、配列の長さが０のint型配列が返されます。
　　　　通常は複数選択可能なモードで作成された場合に使いますが、１つしか選択できないモードで作成された場合でも、少しでも今後複数選択可能モードにバージョンアップする可能性があるならば、こちらのメソッドを使うべきです。

String getSelectedItem()
　　　　選択されている項目を返します。
　　　　選択されていない場合、複数選択されている場合はnullが返ります。
　　　　主に１つしか選択できないモードで作成されている時に使います。

String[] getSelectedItems()
　　　　選択されている項目をStringの配列として返します。
　　　　選択されていない場合、複数選択されている場合は配列の長さが０のString配列が返されます。
　　　　通常は複数選択可能なモードで作成された場合に使いますが、１つしか選択できないモードで作成された場合でも、少しでも今後複数選択可能モードにバージョンアップする可能性があるならば、こちらのメソッドを使うべきです。

boolean isIndexSelected(int index)
　　　　indexで指定された項目が選択されていればtrueが、非選択ならfalseが返ります。
　　　　indexが不正な場合は、falseが返ります。

void addItemListener(AcitonListener il)
　　　　イベントが発生した場合のAcitonListenerを登録します。

void removeItemListener(ItemListener il)
　　　　ilで指定したItemListenerを削除します。

int getRows()
　　　　リストの表示行数を返します。コンストラクタで指定した値です。

boolean isMultipleMode()
　　　　複数選択可能かどうかを返します。

void setMultipleMode(boolean multi)
　　　　複数選択可能・不可能を設定します。

　　Listの選択項目が変更された場合はItemEventというイベントが発生します。これを受け取るのはItemListenerです。ItemListenerの項でも解説しましたように、このItemListenerをインプリメントしたクラスをListに登録(addItemListenerメソッド)します。
　　このItemListenerインターフェースをインプリメントするためには、itemStateChangedメソッドを実装しておく必要があります。

メソッド

void itemStateChanged(ItemEvent e)
　　　　イベントが発生した時に呼ばれます。

　　以下、例を示します。この例では上下２つのパネルを用意し、上のパネルにはチョイスを、下のパネルにはラベルを配置します。チョイスを変更するとラベルにもその結果が反映されるようにします。

import java.awt.*; import java.awt.event.*; public class Test18_19 implements ItemListener{ List list; Label label1; Label label2; public static void main(String args[]){ new Test18_19(); } public Test18_19(){ /* フレームを作成します。*/ Frame frm = new Frame(); /* レイアウトを設定します。*/ frm.setLayout(new BorderLayout()); /* フレームのサイズを設定します。*/ frm.setSize(new Dimension(400,150)); /* リストを作成します。*/ list = new List(3, true); list.add("北海道"); list.add("青森"); list.add("東京"); list.add("大阪"); list.add("京都"); list.add("沖縄"); /* リスナーに登録します。*/ list.addItemListener(this); /* ラベルを作成します。*/ label1 = new Label("行ってみたい県を選んでください。", Label.LEFT); label2 = new Label("", Label.LEFT); /* フレームに登録します。*/ frm.add(label1, BorderLayout.NORTH); frm.add(list , BorderLayout.CENTER); frm.add(label2, BorderLayout.SOUTH); /* フレームを表示させます。*/ frm.setVisible(true); } /* リストの選択が変更されると呼ばれます。*/ public void itemStateChanged(ItemEvent e){ if( e.getSource() == list ){ String strLabel = "あなたは"; for( int i = 0 ; i < list.getItemCount() ; i++ ){ strLabel += list.isIndexSelected(i) ? list.getItem(i) + ", " : ""; } strLabel += "に行きたいんですね。"; label2.setText(strLabel); } } }

前ページへ　:　トップへ　:　次ページへ