「Spinner」チュートリアルを日本語への翻訳と内容を補足しながらみていきます。

Spinner

Spinnerの説明についてみていきます。

[訳]

Spinnerは、項目を選択するためのドロップダウンリストに似たウィジットです。

このチュートリアルでは、惑星のリストを表示する簡単なスピナーウィジットを作ります。1つが選択されたときに、トーストメッセージでその選択項目を表示します。

• プロジェクト名（Project name）HelloSpinner
• 内容(Contents)ワークスペース内に新規プロジェクトを作成
• ビルド・ターゲット(Build Target)Android 1.6
• アプリケーション名（Application Name）HelloSpinner
• パッケージ名（Package Name）localhost.helloview
• アクティビティの作成（Create Activity）HelloSpinner
• 最小 SDKバージョン（Min SDK Version）4

プロジェクト作成については「新規 Android プロジェクトを作成する」の記事に詳しく書いたので参考にしてください。パッケージ名については公開するつもりもないので、とりあえずローカル環境用という意味合いで「localhost」にしました。

[訳]

res/layout/main.xml ファイルを開き、次のコードを挿入します。

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:orientation="vertical"
    android:padding="10dip"
    android:layout_width="fill_parent"
    android:layout_height="wrap_content">
    <TextView
        android:layout_width="fill_parent"
        android:layout_height="wrap_content"
        android:layout_marginTop="10dip"
        android:text="@string/planet_prompt"
    />
    <Spinner
        android:id="@+id/spinner"
        android:layout_width="fill_parent"
        android:layout_height="wrap_content"
        android:prompt="@string/planet_prompt"
    />
</LinearLayout>

[訳]

TextViewの android:text属性とSpinnerの android:prompt属性両方が、同じ文字列リソースを参照していることに注目してください。このテキストはウィジットのタイトルとして作用します。Spinnerに適用したとき、選択ダイアログ中にタイトルテキストが表示されます。この選択ダイアログは選択しているウィジット上に表示されます。

※この時点ではまだ@string/planet_prompt リソースを作成していません。エディターによっては「Not resource found ・・・・」のようなリソースが存在しない旨のエラーが表示されます。データリソースは、この後作成します。

[訳]

res/values/内にstrings.xmlファイルを作って、このコードのようにファイルを編集してください。

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <string name="hello">Hello World, HelloSpinner!</string>
    <string name="app_name">HelloSpinner</string>
    <string name="planet_prompt">Choose a planet</string>
    <string-array name="planets_array">
        <item>Mercury</item>
        <item>Venus</item>
        <item>Earth</item>
        <item>Mars</item>
        <item>Jupiter</item>
        <item>Saturn</item>
        <item>Uranus</item>
        <item>Neptune</item>
    </string-array>
</resources>

[訳]

<string>要素は、上記のレイアウトのTextViewとSpinnerによって参照されるタイトル文字列を定義します。<string-array>要素は、Spinnerウィジットのリストとして表示される文字列のリストを定義します。

[訳]

では、HelloSpinner.javaファイルを開いて、次のコードをonCreate() メソッドに挿入してください。

※チュートリアルでは追加部分だけ記載されていましたが、この記事ではHelloSpinner.java の全コードを記載しておきます。

package localhost.helloview;

import android.app.Activity;
import android.os.Bundle;
import android.view.View;
import android.widget.AdapterView;
import android.widget.AdapterView.OnItemSelectedListener;
import android.widget.ArrayAdapter;
import android.widget.Spinner;
import android.widget.Toast;

public class HelloSpinner extends Activity {
    /** Called when the activity is first created. */
	@Override
	public void onCreate(Bundle savedInstanceState) {
	    super.onCreate(savedInstanceState);
	    setContentView(R.layout.main);

	    Spinner spinner
	        = (Spinner) findViewById(R.id.spinner);
	    ArrayAdapter<CharSequence> adapter
	        = ArrayAdapter.createFromResource(
	                this, R.array.planets_array,
	                android.R.layout.simple_spinner_item
	             );
	    adapter.setDropDownViewResource(
	    		android.R.layout.simple_spinner_dropdown_item
	    	);
	    spinner.setAdapter(adapter);

	    spinner.setOnItemSelectedListener(
	    		new MyOnItemSelectedListener()
	    	);
	}

	public class MyOnItemSelectedListener implements OnItemSelectedListener {
	    public void onItemSelected(AdapterView<?> parent,
	        View view, int pos, long id) {
	      Toast.makeText(parent.getContext(), "The planet is " +
	          parent.getItemAtPosition(pos).toString(),
	          Toast.LENGTH_LONG).show();
	    }
	    public void onNothingSelected(AdapterView parent) {
	      // Do nothing.
	    }
	}
}

[訳]

main.xmlがコンテントビューとして設定された後、Spinnerウィジットをレイアウトから findViewById(int)メソッドを使って取得します。それからcreateFromResource()メソッドにより新規にArrayAdapterを生成します。ArrayAdapterは文字列配列のそれぞれの項目をバインドし、Spinnerの最初の外観になります（選択されたときに、それぞれの項目がスピナー上でどのように表示されるかを決めます）。 R.array.planets_array IDは、上記で定義したstring-arrayを参照し、android.R.layout.simple_spinner_item IDは、プラットフォームによって定義された標準のスピナー外観であるレイアウトを参照します。それからsetDropDownViewResource(int) が呼ばれ、ウィジットが開かれたときのそれぞれの項目の外観を定義します（simple_spinner_dropdown_itemは、プラットフォームで定義された別の標準レイアウトです）。最後に、項目のすべてをSpinnerと関連づけるため、setAdapter(T)を呼びArrayAdapterをセットします。

[訳]

では、AdapterView.OnItemSelectedListener を実装した内部クラスを作ります。これは、スピナーから項目が選択されたときアプリケーションに通知するコールバックメソッドを提供します。AdapterView.OnItemSelectedListenerには、onItemSelected()とonNothingSelected() コールバックメソッドが必要になります。前者は、AdapterViewから項目が選択されたとき呼ばれます。この場合、選択されたテキストが短いToastメッセージで表示されます。そして後者は、AdapterViewから選択がなくなったとき呼ばれますが、この場合は起こらないので無視されます。

[訳]

では、MyOnItemSelectedListenerをSpinnerに適用しなければなりません。

ここでは新しいMyOnItemSelectedListenerの匿名インスタンスを作り、それをSpinnerのリスナーとしてセットしています。

AVDによるアプリケーションの実行については「AVDでアプリケーションを実行する」の記事で詳しく書きました。参考にしてください。

実行結果をみてみます。次のような画面が表示されました。

「Form Stuff」チュートリアルを日本語への翻訳と内容を補足しながらみていきます。今回はRating Barについてみていきます。

Rating Bar

Rating Barの説明についてみていきます。

[訳]
このセクションではRatingBar ウィジットを使って、ユーザがレーティングできるウィジットを作ります。

AndroidチュートリアルではCustom Button、Edit Text、Checkbox、Radio Buttons、Toggle Button、Rating Barは1つのプロジェクト内で説明していますが、このブログでは各フォーム要素ごとにプロジェクトを作成します。

• プロジェクト名（Project name）
  FormStuffRatingBar
• 内容(Contents)
  ワークスペース内に新規プロジェクトを作成
• ビルド・ターゲット(Build Target)
  Android 1.6
• アプリケーション名（Application Name）
  FormStuffRatingBar
• パッケージ名（Package Name）
  localhost.helloview
• アクティビティの作成（Create Activity）
  FormStuffRatingBar
• 最小 SDKバージョン（Min SDK Version）
  4

プロジェクト作成については「新規 Android プロジェクトを作成する」の記事に詳しく書いたので参考にしてください。パッケージ名については公開するつもりもないので、とりあえずローカル環境用という意味合いで「localhost」にしました。

[訳]
res/layout/main.xml ファイルを開き、RatingBar 要素を追加します（LinearLayoutの中に）。

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:orientation="vertical"
    android:layout_width="fill_parent"
    android:layout_height="fill_parent"
    >
    <RatingBar android:id="@+id/ratingbar"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:numStars="5"
        android:stepSize="1.0"/>
</LinearLayout>

※チュートリアルではエレメントの追加部分だけ記載されていましたが、この記事ではres/layout/main.xml の全コードを記載しておきます。

[訳]
android:numStars属性ではレーティングバーに星をいくつ表示するのか定義します。android:stepSize属性は各星の粒度を定義します（例えば0.5の値は星半分のレーティングになります）。

[訳]
新しいレーティングが設定されたときに何らかの処理をさせるためには、onCreate メソッドの最後に次のコードを追加します。

※チュートリアルでは追加部分だけ記載されていましたが、この記事ではFormStuffRatingBar.java の全コードを記載しておきます。

package localhost.helloview;

import android.app.Activity;
import android.os.Bundle;
import android.widget.RatingBar;
import android.widget.RatingBar.OnRatingBarChangeListener;
import android.widget.Toast;

public class FormStuffRatingBar extends Activity {
    /** アクティビティが最初に作られたときに呼ばれる */
    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.main);

        //レイアウトからRatingBarインスタンス生成
        final RatingBar ratingbar
            = (RatingBar) findViewById(R.id.ratingbar);
        //RatingBarインスタンスにリスナー追加
        ratingbar.setOnRatingBarChangeListener(new OnRatingBarChangeListener() {
            //レーティングが変化した場合
        	public void onRatingChanged(
            		RatingBar ratingBar,
            		float rating,
            		boolean fromUser
            ) {
        		//トーストメッセージ表示
                Toast.makeText(
                	FormStuffRatingBar.this,
                	"New Rating: " + rating,
                	Toast.LENGTH_SHORT).show();
            }
        });
    }
}

[訳]
ここではfindViewById(int)を使ってレイアウトからRatingBar ウィジットを取得します。それからRatingBar.OnRatingBarChangeListenerを設定します。onRatingChanged() コールバックメソッドはユーザがレーティングを設定したときに実行されるアクションを定義します。このケースでは、新しいレーティング状態が単純なToastメッセージで表示されます。

• 17行目ではレイアウトからRatingBarインスタンスを生成しています。
• 20行目ではsetOnRatingBarChangeListenerメソッドによりレーティングが変化したときに呼ばれるリスナーをセットしています。またパラメータのOnRatingBarChangeListenerはインターフェースであり、レーティングが変化したときにクライアントに通知するコールバックを作ります。このインターフェースを実装したらonRatingChangedメソッドをオーバーライドする必要があります。
  ※参考：RatingBar.OnRatingBarChangeListener
• 22行目でonRatingChangedをオーバーライドしています。
• 28～31行目で現状のレーティング状態をトーストで表示しています。

AVDによるアプリケーションの実行については「AVDでアプリケーションを実行する」の記事で詳しく書きました。参考にしてください。

実行結果をみてみます。次のような画面が表示されました。

「Form Stuff」チュートリアルを日本語への翻訳と内容を補足しながらみていきます。今回はToggle Buttonについてみていきます。

Toggle Button

Radio Buttonsの説明についてみていきます。

[訳]
このセクションではToggleButton ウィジットを使って、特に２つの状態を切り替えるトグルに使われるボタンを作ります。このウィジットは、互いに排他的な２つの単純な状態（例えば"on"と"off")を持っているときにラジオボタンの変わりとして使うには優秀です。

AndroidチュートリアルではCustom Button、Edit Text、Checkbox、Radio Buttons、Toggle Button、Rating Barは1つのプロジェクト内で説明していますが、このブログでは各フォーム要素ごとにプロジェクトを作成します。

• プロジェクト名（Project name）
  FormStuffToggleButton
• 内容(Contents)
  ワークスペース内に新規プロジェクトを作成
• ビルド・ターゲット(Build Target)
  Android 1.6
• アプリケーション名（Application Name）
  FormStuffToggleButton
• パッケージ名（Package Name）
  localhost.helloview
• アクティビティの作成（Create Activity）
  FormStuffToggleButton
• 最小 SDKバージョン（Min SDK Version）
  4

プロジェクト作成については「新規 Android プロジェクトを作成する」の記事に詳しく書いたので参考にしてください。パッケージ名については公開するつもりもないので、とりあえずローカル環境用という意味合いで「localhost」にしました。

[訳]
res/layout/main.xml ファイルを開き、ToggleButton要素を追加します（LinearLayoutの中に）。

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:orientation="vertical"
    android:layout_width="fill_parent"
    android:layout_height="fill_parent"
    >
    <ToggleButton android:id="@+id/togglebutton"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:textOn="Vibrate on"
        android:textOff="Vibrate off"/>
</LinearLayout>

※チュートリアルではエレメントの追加部分だけ記載されていましたが、この記事ではres/layout/main.xml の全コードを記載しておきます。

[訳]
属性android:textOn と android:textOff はボタンがonやoffの状態にトグルされたときに、ボタンに表示するテキストを明示します。デフォルト値は"On"と"Off"です。

[訳]
状態が変化したときに何らかの処理をさせるためには、onCreate メソッドの最後に次のコードを追加します。

※チュートリアルでは追加部分だけ記載されていましたが、この記事ではFormStuffToggleButton.java の全コードを記載しておきます。

package localhost.helloview;

import android.app.Activity;
import android.os.Bundle;
import android.view.View;
import android.view.View.OnClickListener;
import android.widget.Toast;
import android.widget.ToggleButton;

public class FormStuffToggleButton extends Activity {
    /** アクティビティが最初に作られたときに呼ばれます */
    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.main);

        //レイアウトからToggleButtonインスタンス生成
        final ToggleButton togglebutton = (ToggleButton) findViewById(R.id.togglebutton);
        //イベントリスナー追加
        togglebutton.setOnClickListener(new OnClickListener() {
            //トグルボタンがクリックされたとき
        	public void onClick(View v) {
                //チェックON状態
                if (togglebutton.isChecked()) {
                    Toast.makeText(
                    	FormStuffToggleButton.this,
                    	"Checked",
                    	Toast.LENGTH_SHORT).show();
                }
                //チェックOFF状態
                else {
                    Toast.makeText(
                    	FormStuffToggleButton.this,
                    	"Not checked",
                    	Toast.LENGTH_SHORT).show();
                }
            }
        });
    }
}

[訳]
ここではレイアウトからToggleButtonエレメントを取得し、それからView.OnClickListener を付与します。View.OnClickListener はonClick(View) コールバックメソッドを実装しなければなりません。このメソッドではボタンがクリックされたときに実行するアクションを定義します。サンプルでは、コールバックメソッドがボタンの新しい状態をチェックし、現在の状態を示すトーストメッセージを表示します。

ToggleButton は自分自身でチェックされているかされていないかの状態変化をハンドルするので、ただ状態がどっちなのか尋ねるだけでいいことに注目してください。

• 18行目ではレイアウトからToggleButtonインスタンスを生成しています。
• 20行目でOnClickListenerのインスタンスを生成しています。OnClickListenerはインターフェースなので実装する場合はonClickメソッドをオーバーライドしなければなりません。
  ※参考：android.view.OnClickListener
• 22行目でonClickメソッドをオーバーライドしています。onClickメソッドはViewがクリックされたときに呼ばれます。パラメータとして渡されるのはクリックされたViewインスタンスです。
• 23～29行目でトグルボタンがON状態に変わったときの処理が書かれています。"Checked"のメッセージがトーストで表示されます。
• 30～36行目でトグルボタンがOFF状態に変わったときの処理が書かれています。"Not checked"のメッセージがトーストで表示されます。

AVDによるアプリケーションの実行については「AVDでアプリケーションを実行する」の記事で詳しく書きました。参考にしてください。

実行結果をみてみます。次のような画面が表示されました。

「Form Stuff」チュートリアルを日本語への翻訳と内容を補足しながらみていきます。今回はRadio Buttonsについてみていきます。

Radio Buttons

Radio Buttonsの説明についてみていきます。

[訳]
このセクションでは、RadioGroupとRadioButtonのウィジットを使って２つの相互に排他的なラジオボタン（１つが可能ならば他方が無効）を作ります。どちらかのラジオボタンが押されたときに、トーストメッセージを表示します。

AndroidチュートリアルではCustom Button、Edit Text、Checkbox、Radio Buttons、Toggle Button、Rating Barは1つのプロジェクト内で説明していますが、このブログでは各フォーム要素ごとにプロジェクトを作成します。

FormStuffRadioButtonsという名前の新規プロジェクトを作成します。

• プロジェクト名（Project name）
  FormStuffRadioButtons
• 内容(Contents)
  ワークスペース内に新規プロジェクトを作成
• ビルド・ターゲット(Build Target)
  Android 1.6
• アプリケーション名（Application Name）
  FormStuffRadioButtons
• パッケージ名（Package Name）
  localhost.helloview
• アクティビティの作成（Create Activity）
  FormStuffRadioButtons
• 最小 SDKバージョン（Min SDK Version）
  4

プロジェクト作成については「新規 Android プロジェクトを作成する」の記事に詳しく書いたので参考にしてください。パッケージ名については公開するつもりもないので、とりあえずローカル環境用という意味合いで「localhost」にしました。

[訳]
res/layout/main.xmlファイルを開き、RadioGroupでネストされた２つのRadioButtons要素を追加します（LinearLayoutの中に）。

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:orientation="vertical"
    android:layout_width="fill_parent"
    android:layout_height="fill_parent"
    >
    <RadioGroup
      android:layout_width="fill_parent"
      android:layout_height="wrap_content"
      android:orientation="vertical">
      <RadioButton android:id="@+id/radio_red"
          android:layout_width="wrap_content"
          android:layout_height="wrap_content"
          android:text="Red" />
      <RadioButton android:id="@+id/radio_blue"
          android:layout_width="wrap_content"
          android:layout_height="wrap_content"
          android:text="Blue" />
    </RadioGroup>
</LinearLayout>

※チュートリアルではエレメントの追加部分だけ記載されていましたが、この記事ではres/layout/main.xml の全コードを記載しておきます。

[訳]
RadioButtonsはRadioGroup要素によって一緒にグループ化されているということが重要です。そうすることにより同時に１つ以上は選択できなくなります。このロジックは自動的にAndroidシステムによってハンドルされます。１つのグループ内で１つのRadioButtonが選択されると、他の全てのラジオボタンは自動的に非選択状態になります。

package localhost.helloview;

import android.app.Activity;
import android.os.Bundle;
import android.view.View;
import android.view.View.OnClickListener;
import android.widget.RadioButton;
import android.widget.Toast;

public class FormStuffRadioButtons extends Activity {
    /** アクティビティが最初に作成されたときに呼ばれます */

	/** ラジオボタンがクリックされたときのリスナー */
    private OnClickListener radio_listener
                       = new OnClickListener() {
        public void onClick(View v) {
            // クリックされたときに実行されるアクション
            RadioButton rb = (RadioButton) v;
            Toast.makeText(
            	FormStuffRadioButtons.this,
            	rb.getText(),
            	Toast.LENGTH_SHORT).show();
        }
    };

    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.main);

        /** レイアウトからRadioButtonインスタンス生成 */
        final RadioButton radio_red
           = (RadioButton) findViewById(R.id.radio_red);
        final RadioButton radio_blue
           = (RadioButton) findViewById(R.id.radio_blue);
        /** RadioButtonインスタンスにリスナー追加 */
        radio_red.setOnClickListener(radio_listener);
        radio_blue.setOnClickListener(radio_listener);
    }
}

※チュートリアルでは追加部分だけ記載されていましたが、この記事ではFormStuffRadioButtons.java の全コードを記載しておきます。

[訳]
それぞれのRadioButtonが選択されたときに何らかの処理をさせるためには、View.OnClickListenerが必要です。このケースではリスナーを再利用したいので、次のコード(※このブログでは上記の3～24行目）を追加しFormStuffRadioButtonsアクティビティに新しいメンバを作ります。

最初にonClick(View)メソッドのパラメータとして渡されたViewをRadioButtonにキャストします。それから選択されたラジオボタンのテキストがToastメッセージで表示されます。

[訳]
では、onCreateメソッドの下に次のコード(※このブログでは上記31～38行目)を追加します。

ここではレイアウトからそれぞれのRadioButtonsを取得し、それぞれに対して新たに作られたView.OnClickListenerを追加します。

• 15行目でOnClickListenerのインスタンスを生成しています。OnClickListenerはインターフェースなので実装する場合はonClickメソッドをオーバーライドしなければなりません。
  ※参考：android.view.OnClickListener
• 16行目でonClickメソッドをオーバーライドしています。onClickメソッドはViewがクリックされたときに呼ばれます。パラメータとして渡されるのはクリックされたViewインスタンスです。
• 19～22行目でラジオボタンがクリックされたときの処理が書かれています。それぞれに応じたメッセージがトーストで表示されます。
• 31～35ではそれぞれのラジオボタンのインスタンスを生成しています。findViewByIdメソッドは対応するIDのレイアウトの要素からViewクラス型のインスタンスを生成し返します。Viewクラス型で返すのでRadioButtonクラス型にキャストし代入します。
• 37～38行目では各インスタンスにリスナーを追加しています。

AVDによるアプリケーションの実行については「AVDでアプリケーションを実行する」の記事で詳しく書きました。参考にしてください。

実行結果をみてみます。次のような画面が表示されました。

「Form Stuff」チュートリアルを日本語への翻訳と内容を補足しながらみていきます。今回はCheckboxについてみていきます。

CheckBox

CheckBoxの説明についてみていきます。

[訳]
このセクションでは、CheckBox ウィジットを使ってユーザが選択できるチェックボックスを作ります。チェックボックスが押されたときに、チェックボックスの現在の状態を示すトーストメッセージが表示されます。

AndroidチュートリアルではCustom Button、Edit Text、Checkbox、Radio Buttons、Toggle Button、Rating Barは1つのプロジェクト内で説明していますが、このブログでは各フォーム要素ごとにプロジェクトを作成します。

FormStuffCheckBoxという名前の新規プロジェクトを作成します。

• プロジェクト名（Project name）
  FormStuffCheckBox
• 内容(Contents)
  ワークスペース内に新規プロジェクトを作成
• ビルド・ターゲット(Build Target)
  Android 1.6
• アプリケーション名（Application Name）
  FormStuffCheckBox
• パッケージ名（Package Name）
  localhost.helloview
• アクティビティの作成（Create Activity）
  FormStuffCheckBox
• 最小 SDKバージョン（Min SDK Version）
  4

プロジェクト作成については「新規 Android プロジェクトを作成する」の記事に詳しく書いたので参考にしてください。パッケージ名については公開するつもりもないので、とりあえずローカル環境用という意味合いで「localhost」にしました。

[訳]
res/layout/main.xml ファイルを開き、CheckBox要素を追加します（LinearLayoutの中に）。

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:orientation="vertical"
    android:layout_width="fill_parent"
    android:layout_height="fill_parent"
    >
    <CheckBox android:id="@+id/checkbox"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="check it out" />
</LinearLayout>

※チュートリアルではエレメントの追加部分だけ記載されていましたが、この記事ではres/layout/main.xml の全コードを記載しておきます。

[訳]
状態が変化したときに何らかの処理をするため、次のコードをonCreate()メソッドの後ろに追加します。

package localhost.helloview;

import android.app.Activity;
import android.os.Bundle;
import android.view.View;
import android.view.View.OnClickListener;
import android.widget.CheckBox;
import android.widget.Toast;

public class FormStuffCheckBox extends Activity {
	/** アクティビティが最初に作られた時に呼ばれます */
    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.main);

        //レイアウトからCheckBoxインスタンス生成
        final CheckBox checkbox
             = (CheckBox) findViewById(R.id.checkbox);
        //クリックイベントハンドラを付与
        checkbox.setOnClickListener(new OnClickListener() {
            public void onClick(View v) {
                //チェックされている場合
                if (((CheckBox) v).isChecked()) {
                    Toast.makeText(
                    	FormStuffCheckBox.this,
                    	"Selected",
                    	Toast.LENGTH_SHORT).show();
                //チェックされていない場合
                }else{
                    Toast.makeText(
                    	FormStuffCheckBox.this,
                    	"Not selected",
                    	Toast.LENGTH_SHORT).show();
                }
            }
        });
    }
}

※チュートリアルでは追加部分だけ記載されていましたが、この記事ではFormStuffCheckBox.java の全コードを記載しておきます。

[訳]
ここではレイアウトからCheckBox エレメントを取得し、View.OnClickListenerを付与します。OnClickListenerはonClick(View)コールバックメソッドを実装しなければなりません。onClickメソッドにはチェックボックスがクリックされたときに処理されるアクションを定義します。クリックしたときに、新しいチェックの状態をチェックするためisChecked()メソッドが呼ばれます。もしチェックされている状態ならばトーストには"Selected"というメッセージが表示され、そうでなければ"Not selected"と表示されます。onClick(View)コールバックで渡されるViewオブジェクトはCheckBoxにキャストしなければなりません。なぜならisChecked()は親のViewクラスには定義されていないからです。CheckBoxは自分自身の状態変化をハンドルします。なので現在の状態を尋ねるだけでよくなります。

• 18行目でレイアウトのIDがcheckboxの要素からCheckBoxインスタンスを生成します。
• 21行目でCheckBoxインスタンスにをView.OnClickListenerを付与しています。OnClickListenerはインターフェースなので実装する場合はonClickメソッドをオーバーライドしなければなりません。
  ※参考：android.view.OnClickListener
• 22行目でonClickメソッドをオーバーライドしています。onClickメソッドはViewがクリックされたときに呼ばれます。パラメータとして渡されるのはクリックされたViewインスタンスです。
• 24行目でチェックボックスがチェック状態であるか判定しています。パラメータとして渡されたvはViewクラス型なのでisCheckedメソッドは定義されていません。そこでメソッドが定義されているCheckBoxクラス型にキャストします。CheckBoxクラスのリファレンスをみるとこのクラス自体が定義しているわけではないようです。ViewからChecBoxまでには次のようなクラス階層があります。

        android.view.View
          Ｌ android.widget.TextView
              Ｌ android.widget.Button
                  Ｌ android.widget.CompoundButton
                      Ｌ 	android.widget.CheckBox

  　CheckBoxのスーパークラスであるCompoundButtonクラスで実装されおり、それを継承してます。

• 23～28行目がチェックボックスがチェックされたときの処理が、29行目から35行目はチェックが外れたときの処理が書かれています。それぞれに応じたメッセージがトーストで表示されます。

AVDによるアプリケーションの実行については「AVDでアプリケーションを実行する」の記事で詳しく書きました。参考にしてください。

実行結果をみてみます。次のような画面が表示されました。

「Form Stuff」チュートリアルを日本語への翻訳と内容を補足しながらみていきます。今回はForm Stuffの編集テキスト（入力ボックス）についてみていきます。

Edit Text(編集テキスト)

Edit Textの説明についてみていきます。

[訳]
このセクションでは、EditText ウィジットを使ってユーザが入力できるテキストフィールドを作ります。一度そのフィールドにテキストを入力し、"Enter"キーを押せばトーストメッセージでそのテキストが表示されます。

AndroidチュートリアルではCustom Button、Edit Text、Checkbox、Radio Buttons、Toggle Button、Rating Barは1つのプロジェクト内で説明していますが、このブログでは各フォーム要素ごとにプロジェクトを作成します。

FormStuffEditText という名前の新規プロジェクトを作成します。

• プロジェクト名（Project name）
  FormStuffEditText
• 内容(Contents)
  ワークスペース内に新規プロジェクトを作成
• ビルド・ターゲット(Build Target)
  Android 1.6
• アプリケーション名（Application Name）
  FormStuffEditText
• パッケージ名（Package Name）
  localhost.helloview
• アクティビティの作成（Create Activity）
  FormStuffEditText
• 最小 SDKバージョン（Min SDK Version）
  4

プロジェクト作成については「新規 Android プロジェクトを作成する」の記事に詳しく書いたので参考にしてください。パッケージ名については公開するつもりもないので、とりあえずローカル環境用という意味合いで「localhost」にしました。

[訳]

res/layout/main.xml ファイルを開き、EditTextを追加します（LinearLayoutの中に）。

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:orientation="vertical"
    android:layout_width="fill_parent"
    android:layout_height="fill_parent"
    >
    <EditText
        android:id="@+id/edittext"
        android:layout_width="fill_parent"
        android:layout_height="wrap_content"/>
</LinearLayout>

※チュートリアルではエレメントの追加部分だけ記載されていましたが、この記事ではres/layout/main.xml の全コードを記載しておきます。

[訳]
ユーザがタイプするテキストに何か動作させる為には、onCreate()メソッドの後ろに次のコードを追加します。

package localhost.helloview;

import android.app.Activity;
import android.os.Bundle;
import android.view.KeyEvent;
import android.view.View;
import android.view.View.OnKeyListener;
import android.widget.EditText;
import android.widget.Toast;

public class FormStuffEditText extends Activity {
    /** アクティビティが最初に作られた時に呼ばれます */
    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.main);
        final EditText edittext
                     = (EditText) findViewById(R.id.edittext);
        edittext.setOnKeyListener(new OnKeyListener() {
            public boolean onKey(View v, int keyCode, KeyEvent event) {
                //イベントが"enter"キーでのkey-downイベントならば
                if ((event.getAction()==KeyEvent.ACTION_DOWN) &&
                    (keyCode==KeyEvent.KEYCODE_ENTER)) {
                  // キーが押された時に行うアクション
                  Toast.makeText(
                       FormStuffEditText.this
                      ,edittext.getText()
                      ,Toast.LENGTH_SHORT
                  ).show();
                  return true;
                }
                return false;
            }
        });
    }
}

※チュートリアルではリスナーの追加部分だけ記載されていましたが、この記事ではFormStuffEditText.java の全コードを記載しておきます。

[訳]
ここではレイアウトからEditText エレメントを取得し、 View.OnKeyListenerを付与します。View.OnKeyListenerはonKey(View, int, KeyEvent)メソッドを実装しなければなりません。onKeyメソッドにはウィジットがフォーカスされている間、キーが押されたときに処理されるアクションを定義します。このケースでは、メソッドにEnterキーからの応答（押されたとき）に対するアクションが定義されており、入力されているテキストをToastメッセージでポップアップ表示します。onKey(View, int, KeyEvent)メソッドはイベントがハンドルされたならば常にtrueを返すべきであり、そうすることによりイベントが他に伝達しなくなります（テキストフィールドでの改行コードの結果はそのようになります）。

[補足]

• 17行目でレイアウトのIDがedittextの要素からEditTextインスタンスを生成します。
• 19行目でEditTextインスタンスにOnKeyListenerリスナーを付与しています。OnKeyListenerはインターフェースなので実装する場合はonKeyメソッドをオーバーライドしなければなりません。
  ※参考：android.view.View.OnKeyListener
• 20行目でonKeyメソッドをオーバーライドしています。
• 25～28行目では"Enter"キーが押されたときの処理が書かれており、このサンプルでは入力されたテキストがToastメッセージで表示させます。

onKeyメソッドについてリファレンスを詳しくみてみます。

[訳]
キーからビューに処理実行権を割り当てるときに呼ばれます。このことはリスナーが対象となるビューより前に応答の変化を取得できることを可能にします。

AVDによるアプリケーションの実行については「AVDでアプリケーションを実行する」の記事で詳しく書きました。参考にしてください。

実行結果をみてみます。次のような画面が表示されました。

今回から6回に分けて「Form Stuff」チュートリアルを日本語への翻訳と内容を補足しながらみていきます。今回はカスタムボタンについてみていきます。

Custom Button(カスタムボタン)

Custom Buttonの説明についてみていきます。

[訳]
このセクションでは、テキストの代わりにカスタム画像を使ってボタンを作成します。カスタムボタンにはButtonウィジットとXMLファイルを使いますが、XMLでは異なったボタン状態に対応する異なった3つの画像を定義します。ボタンを押したときに短いメッセージを表示します。

[訳]
HelloFormStuff という名前の新規プロジェクトを開始します。

• プロジェクト名（Project name）
  HelloFormStuff
• 内容(Contents)
  ワークスペース内に新規プロジェクトを作成
• ビルド・ターゲット(Build Target)
  Android 1.6
• アプリケーション名（Application Name）
  HelloFormStuff
• パッケージ名（Package Name）
  localhost.helloview
• アクティビティの作成（Create Activity）
  HelloFormStuff
• 最小 SDKバージョン（Min SDK Version）
  4

プロジェクト作成については「新規 Android プロジェクトを作成する」の記事に詳しく書いたので参考にしてください。パッケージ名については公開するつもりもないので、とりあえずローカル環境用という意味合いで「localhost」にしました。

[訳]
右の画像をあなたのプロジェクトのres/drawableディレクトリにコピーしてください。これらは異なるボタン状態で使われます。

[補足]
Androidチュートリアルに表示されている画像を上記にも表示しました。上記画像をres/drawableディレクトリに保存してもらっても構いません。また

• 基本状態：android_pressed.png
• フォーカス状態：android_focused.png
• クリック状態：android_pressed.png

上記ファイル名でオリジナル画像にしてもらっても構いません。

[訳]
res/drawable/ディレクトリにandroid_button.xmlという名前で新しいファイルを作ってください。次のXMLを挿入してください。

<?xml version="1.0" encoding="utf-8"?>
<selector
    xmlns:android="http://schemas.android.com/apk/res/android">
    <item android:drawable="@drawable/android_pressed"
          android:state_pressed="true" />
    <item android:drawable="@drawable/android_focused"
          android:state_focused="true" />
    <item android:drawable="@drawable/android_normal" />
</selector>

[訳]
ここでは1つのdrawableリソースを定義し、現在のボタンの状態に基づいて画像を変化させます。最初の<item>はボタンが押されている（アクティブ状態）のときの画像としてandroid_pressed.pngを定義しています。2番目の<item>はボタンがフォーカスされている（ボタンがトラックボールや十字キーを使ってハイライトされている）ときの画像としてandroid_focused.pngを定義しています。そして3番目の<item>は通常の状態（押されてもフォーカスもされていない）ときの画像としてandroid_normal.pngを定義しています。このXMLファイルは今1つのdrawableリソースを表し、レイアウトファイルでButton:background属性にによって参照されると、表示される画像はこれら3つの状態に基づいて変化します。

[訳]
メモ：<item>エレメントの順番は重要です。このdrawableが参照されたとき、現在のボタン状態に適切なものを決めるために<item>を順番にみていきます。"通常"画像が最後にあるのは、android:state_pressedとandroid:state_focusedの状態が両方ともfalseと判定されたときに単に適用させる為です。

[訳]
res/layout/main.xml ファイルを開き、ボタンエレメントを追加します。

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:orientation="vertical"
    android:layout_width="fill_parent"
    android:layout_height="fill_parent"
    >
   <Button
        android:id="@+id/button"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:padding="10dp"
        android:background="@drawable/android_button" />
</LinearLayout>

※チュートリアルではボタンエレメントの追加部分だけ記載されていましたが、この記事ではres/layout/main.xml の全コードを記載しておきます。

[訳]
android:background属性ではボタン背景の為に使うdrawableリソースを指定します(res/drawable/android.xmlで保存されていれば、@drawable/androidと指定すれば参照されます）。これによりシステムを通してボタンに使われる通常の背景画像が置き換わります。drawableリソースがボタン状態に基づいて変化させる為には、画像を背景に適用させる必要があります。

[補足]
このサンプルでは res/drawable/android_button.xml で保存してますので@drawable/android_button で参照しています。


[訳]
押されたときにボタンになんらかの動作をさせるためにonCreate()メソッドの最後に次のコードを追加します。

package localhost.helloview;

import android.app.Activity;
import android.os.Bundle;
import android.view.View;
import android.view.View.OnClickListener;
import android.widget.Button;
import android.widget.Toast;

public class HelloFormStuff extends Activity {
    /** Called when the activity is first created. */
    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.main);

        final Button button = (Button) findViewById(R.id.button);
        button.setOnClickListener(new OnClickListener() {
            public void onClick(View v) {
                // Perform action on clicks
                Toast.makeText(
                	HelloFormStuff.this
                	,"Beep Bop"
                	,Toast.LENGTH_SHORT
                ).show();
            }
        });
    }
}

※チュートリアルではリスナーの追加部分だけ記載されていましたが、この記事ではHelloFormStuff.java の全コードを記載しておきます。

[訳]
ここではレイアウトからButtonインスタンスを取得しそれからView.OnClickListenerを付与します。View.OnClickListenerはonClick(View)コールバックメソッドを実装しなければなりません。onClick(View)にはボタンがクリックされたときに処理されるアクションを定義します。例えば、Toastメッセージを表示させるなどです。

[補足]

• 17行目でレイアウトのIDがbuttonの要素からButtonインスタンスを生成しています。
• 18行目でButtonインスタンスにOnClickListenerリスナーを付与しています。OnClickListenerはインターフェースなので実装する場合はonClickメソッドをオーバーライドしなければなりません。
• 19行目でonClickメソッドをオーバーライドしています。
• 20～25行目ではクリックされたときの処理が書かれており、このサンプルでは「Beep Bop」というToastメッセージを表示させます。

AVDによるアプリケーションの実行については「AVDでアプリケーションを実行する」の記事で詳しく書きました。参考にしてください。

実行結果をみてみます。次のような画面が表示されました。

今回は「Time Picker」チュートリアルについて日本語への翻訳と内容を補足しながらみていきます。

Time Picker

Time Pickerの説明についてみていきます。

[訳]
時間を選択するウィジットを提供するのに TimePickerウィジットを使います。このウィジットを使えばユーザは時、分をなじみ深いインターフェースで選択できます。
このチュートリアルでは TimePickerDialog,を作ります。ボタンを押したときにダイアログボックスが浮き上がり時間ピッカーが現れます。ユーザが時間をセットしたときに、TextView が新しい時間で更新されます。

[訳]
HelloTimePicker という名前の新規プロジェクトを開始します。

• プロジェクト名（Project name）
  HelloTimePicker
• 内容(Contents)
  ワークスペース内に新規プロジェクトを作成
• ビルド・ターゲット(Build Target)
  Android 1.6
• アプリケーション名（Application Name）
  HelloTimePicker
• パッケージ名（Package Name）
  localhost.helloview
• アクティビティの作成（Create Activity）
  HelloTimePicker
• 最小 SDKバージョン（Min SDK Version）
  4

プロジェクト作成については「新規 Android プロジェクトを作成する」の記事に詳しく書いたので参考にしてください。パッケージ名については公開するつもりもないので、とりあえずローカル環境用という意味合いで「localhost」にしました。

新規プロジェクト作成時に res/layout/main.xml のレイアウトファイルができていますが、次のコードと入れ変えます。

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:orientation="vertical">
    <TextView android:id="@+id/timeDisplay"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text=""/>
    <Button android:id="@+id/pickTime"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="Change the time"/>
</LinearLayout>

src/HelloTimePicker.java を開き以下のコードと差し替えます。チュートリアルは別々に分割されて説明されていますがまとめました。また足りないimport文も追加し完全版を記載しておきます。

package localhost.helloview;

import java.util.Calendar;
import android.app.Activity;
import android.app.Dialog;
import android.app.TimePickerDialog;
import android.os.Bundle;
import android.view.View;
import android.widget.Button;
import android.widget.TextView;
import android.widget.TimePicker;

public class HelloTimePicker extends Activity {

	//TextView「@+id/mTimeDisplay」のインスタンス
    private TextView mTimeDisplay;
    //Button「@+id/mPickTime」のインスタンス
    private Button mPickTime;
    //時分
    private int mHour;
    private int mMinute;

    static final int TIME_DIALOG_ID = 0;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.main);

        // TextView「@+id/timeDisplay」エレメントを取得
        mTimeDisplay = (TextView) findViewById(R.id.timeDisplay);
        // Button「@+id/pickTime」エレメントを取得
        mPickTime = (Button) findViewById(R.id.pickTime);
        //ボタンにクリックリスナ追加
        mPickTime.setOnClickListener(new View.OnClickListener() {
            public void onClick(View v) {
                showDialog(TIME_DIALOG_ID);
            }
        });

        //現在の時間を取得する
        final Calendar c = Calendar.getInstance();
        mHour = c.get(Calendar.HOUR_OF_DAY);
        mMinute = c.get(Calendar.MINUTE);

        //TextViewの時間を更新するメソッド実行
        updateDisplay();
    }

    //TextViewの時間を更新する
    private void updateDisplay() {
        mTimeDisplay.setText(
            new StringBuilder()
                    .append(pad(mHour)).append(":")
                    .append(pad(mMinute)));
    }

    //時、分の値が1桁の場合に前に0を追加するメソッド
    //※例）8 ⇒ 08など
    private static String pad(int c) {
        if (c >= 10)
            return String.valueOf(c);
        else
            return "0" + String.valueOf(c);
    }

    //時間ダイアログ内の「sets」ボタンクリック時にコールバック
    private TimePickerDialog.OnTimeSetListener mTimeSetListener =
        new TimePickerDialog.OnTimeSetListener() {
            public void onTimeSet(
            	TimePicker view, int hourOfDay, int minute) {
                	mHour = hourOfDay;
                	mMinute = minute;
                	updateDisplay();
            	}
            };

    @Override
    protected Dialog onCreateDialog(int id) {
        switch (id) {
        case TIME_DIALOG_ID:
            return new TimePickerDialog(this,
            	mTimeSetListener, mHour, mMinute, false);
        }
        return null;
    }
}

【15～23行目に関する説明】

[訳]
ここではレイアウトエレメント と日付項目に関する変数を定義しています。TIME_DIALOG_IDは時間ピッカーを表示するダイアルログに対するユニークな識別子でstatic修飾子のint型で指定しています。

[補足]
mTimeDisplayとmPickTimeがレイアウトエレメントに関するメンバ変数で、mHour、mMinuteが時間に関するメンバ変数です。23行目でTIME_DIALOG_IDを定義し「0」を代入していますが、staticとfinal修飾子がついているので定数です。日付ピッカー用のダイアログには「0」という識別子をつけてアクティビティがダイアログを管理します。

【26～51行目に関する説明】

[訳]
最初にmain.xmlレイアウトをコンテンツに設定します。それから TextViewと ButtonエレメントをfindViewById(int)を指定してレイアウトから取得します。ボタンにはView.OnClickListener メソッドでリスナを作ります。これによりボタンをクリックしたときにshowDialog(int)が呼ばれ、パラメータとして時間ピッカーダイアログの為のID（ユニークな数値）を渡します。showDialog(int)により Activity がダイアログのライフサイクルを管理することができ、onCreateDialog(int)コールバックメソッドを呼んで表示するダイアログを要求します（後ほど定義します）。
on-clickリスナが設定された後、新しいCalendarインスタンスが作られ、現在の時、分を取得します。最後に、アクセス修飾子privateのupdateDisplayメソッドが呼ばれ、 TextViewに現在時間で満たします。

[補足]

onCreateメソッド内の説明です。onCreateはアクティビティが最初に作られたときに呼ばれます。onCreateメソッド内の大体の流れは次のようになります。

1. XML レイアウト ファイルからエレメントを取得してインスタンスを生成
2. ボタン（Button「@+id/pickTime」）にクリックリスナを付ける
3. Calendarクラスを利用して現在の時間を取得する
4. 現在の時間をTextViewに表示する。

Android XML レイアウトファイルの構造はXML 要素がツリー構造になっており、含まれた各ノードが View クラスの名前を表しています。30～33行目ではXML情報からインスタンスを生成しています。

34～39行目ではボタン（Button「@+id/pickTime」）にクリックしたときに時間ピッカーダイアログが表示されるようリスナを付けます。この段階ではリスナを付けただけなので時間ピッカーダイアログは表示されていません。

41～44行目ではCalendarクラスを利用して現在の時間を取得しています。時、分を別々に取得し各情報をメンバ変数に代入にしています。

46～47行目ではupdateDisplayメソッドを実行し、TextViewの時間を更新しています。

【49～65行目に関する説明】

[訳]
updateDisplay()メソッドは時間に関するメンバ変数の値を使ってmTimeDisplayTextViewに値を挿入します。pad()メソッドは時間や分を表現する適切な文字列を返します。1桁のときに前に0を付け加えます。

[補足]
padメソッドでは、例えば5時1分の場合「5：1」と表示するのではなく「05:01」と0を付けて2桁に調整します。

【66～76行目に関する説明】

[訳]
ユーザが時間を設定したとき（「Set」ボタンをクリックすることにより）にonTimeSet()メソッドが呼ばれます。そして新しい時間で日付に関するメンバが更新され、さらにレイアウトTextViewの内容も更新されます。

【77～87行目に関する説明】

[訳]
このメソッドはActivityコールメソッドであり、showDialog(int)に与えられた識別子が引数として渡されます（ボタンのon-clickリスナによって呼ばれます）。switch case構文でIDが一致すれば、TimePickerDialogはonCreate() の最後で初期化された日付メンバと前のステップで作成されたTimePickerDialog.OnTimeSetListenerで初期化されます。

[補足]
showDialog(int)により Activity がダイアログのライフサイクルを管理しています。showDialogが呼び出されると最初の一回だけonCreateDialog()がコールされダイアログを作成します。ここで作成されたダイアログは自動的に保存されいつでも呼び出すことができるようになります。

AVDによるアプリケーションの実行については「AVDでアプリケーションを実行する」の記事で詳しく書きました。参考にしてください。

実行結果をみてみます。次のような画面が表示されました。

今回は「Date Picker」チュートリアルについて日本語への翻訳と内容を補足しながらみていきます。

Date Picker

Date Pickerの説明についてみていきます。

[訳]
日付を選択するウィジットを提供するのに DatePickerウィジットを使います。このウィジットを使えばユーザは月、日、年をなじみ深いインターフェースで選択できます。
このチュートリアルではDatePickerDialogを作ります。ボタンを押したときにダイアログボックスが浮き上がり日付ピッカーが現れます。ユーザが日付をセットしたときに、TextView が新しい日付で更新されます。

[訳]
HelloDatePicker という名前の新規プロジェクトを開始します。

• プロジェクト名（Project name）
  HelloDatePicker
• 内容(Contents)
  ワークスペース内に新規プロジェクトを作成
• ビルド・ターゲット(Build Target)
  Android 1.6
• アプリケーション名（Application Name）
  HelloDatePicker
• パッケージ名（Package Name）
  localhost.helloview
• アクティビティの作成（Create Activity）
  HelloDatePicker
• 最小 SDKバージョン（Min SDK Version）
  4

プロジェクト作成については「新規 Android プロジェクトを作成する」の記事に詳しく書いたので参考にしてください。パッケージ名については公開するつもりもないので、とりあえずローカル環境用という意味合いで「localhost」にしました。

新規プロジェクト作成時に res/layout/main.xml のレイアウトファイルができていますが、次のコードと入れ変えます。

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:orientation="vertical">
    <TextView android:id="@+id/dateDisplay"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text=""/>
    <Button android:id="@+id/pickDate"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="Change the date"/>
</LinearLayout>

src/HelloDatePicker.java を開き以下のコードと差し替えます。チュートリアルは別々に分割されて説明されていますがまとめました。また足りないimport文も追加し完全版を記載しておきます。

package localhost.helloview;

import java.util.Calendar;
import android.app.Activity;
import android.app.DatePickerDialog;
import android.app.Dialog;
import android.os.Bundle;
import android.view.View;
import android.widget.Button;
import android.widget.DatePicker;
import android.widget.TextView;

public class HelloDatePicker extends Activity {

	//TextView「@+id/dateDisplay」のインスタンス
	private TextView mDateDisplay;
	//Button「@+id/pickDate」のインスタンス
    private Button mPickDate;
    //日付
    private int mYear;	//年
    private int mMonth;	//月
    private int mDay;	//日

    static final int DATE_DIALOG_ID = 0;

	/** Called when the activity is first created. */
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.main);

        // TextView「@+id/dateDisplay」エレメントを取得
        mDateDisplay = (TextView) findViewById(R.id.dateDisplay);
        // Button「@+id/pickDate」エレメントを取得
        mPickDate = (Button) findViewById(R.id.pickDate);
        //ボタンにクリックリスナ追加
        mPickDate.setOnClickListener(new View.OnClickListener() {
            public void onClick(View v) {
                showDialog(DATE_DIALOG_ID);
            }
        });

        //現在の日付を取得する
        final Calendar c = Calendar.getInstance();
        mYear = c.get(Calendar.YEAR);
        mMonth = c.get(Calendar.MONTH);
        mDay = c.get(Calendar.DAY_OF_MONTH);

        //TextViewの日付を更新するメソッド実行
        updateDisplay();
    }

    //TextViewの日付を更新する
    private void updateDisplay() {
        mDateDisplay.setText(
            new StringBuilder()
                 //月は「0～11」の値を取るので表示は+1
                 .append(mMonth + 1).append("-")
                 .append(mDay).append("-")
                 .append(mYear).append(" "));
    }

    //日付ダイアログ内の「sets」ボタンクリック時にコールバック
    private DatePickerDialog.OnDateSetListener mDateSetListener =
            new DatePickerDialog.OnDateSetListener() {
                public void onDateSet(
                		DatePicker view, int year,
                        int monthOfYear, int dayOfMonth
                ){
                    mYear = year;
                    mMonth = monthOfYear;
                    mDay = dayOfMonth;
                    updateDisplay();
                }
            };

    @Override
    protected Dialog onCreateDialog(int id) {
        switch (id) {
        case DATE_DIALOG_ID:
            return new DatePickerDialog(
            			this,
                        mDateSetListener,
                        mYear, mMonth, mDay);
        }
        return null;
    }
}

【15～24行目に関する説明】

[訳]
メンバの最初のグループでレイアウトView と日付項目に関する変数を定義しています。DATE_DIALOG_IDは日付ピッカーを表示するダイアルログに対するユニークな識別子でstatic修飾子のint型で指定しています。

[補足]
mDateDisplayとmPickDateがレイアウトViewに関するメンバ変数で、mYear、mMonth、mDayが日付に関するメンバ変数です。24行目でDATE_DIALOG_IDを定義し「0」を代入していますが、staticとfinal修飾子がついているので定数です。日付ピッカー用のダイアログには「0」という識別子をつけてアクティビティがダイアログを管理します。

【26～51行目に関する説明】

[訳]
最初にmain.xmlレイアウトをコンテンツに設定します。それから TextViewと ButtonエレメントをfindViewById(int)を指定してレイアウトから取得します。ボタンには新たにView.OnClickListener メソッドでリスナを作ります。これによりボタンをクリックしたときにshowDialog(int)が呼ばれ、パラメータとして日付ピッカーダイアログの為のID（ユニークな数値）を渡します。showDialog(int)により Activity がダイアログのライフサイクルを管理することができ、onCreateDialog(int)コールバックメソッドを呼んで表示するダイアログを要求します（後ほど定義します）。
on-clickリスナが設定された後、新しいCalendarが作られ、現在の年、月、日を取得します。最後に、アクセス修飾子privateのupdateDisplayメソッドが呼ばれ、 TextViewに現在日付で満たします。

[補足]

onCreateメソッド内の説明です。onCreateはアクティビティが最初に作られたときに呼ばれます。onCreateメソッド内の大体の流れは次のようになります。

1. XML レイアウト ファイルからエレメントを取得してインスタンスを生成
2. ボタン（Button「@+id/pickDate」）にクリックリスナを付ける
3. Calendarクラスを利用して現在の日付を取得する
4. 現在の日付をTextViewに表示する。

Android XML レイアウトファイルの構造はXML 要素がツリー構造になっており、含まれた各ノードが View クラスの名前を表しています。32～35行目ではXML情報からインスタンスを生成しています。
36～41行目ではボタン（Button「@+id/pickDate」）にクリックしたときに日付ピッカーダイアログが表示されるようリスナを付けます。この段階ではリスナを付けただけなので日付ピッカーダイアログは表示されていません。
43～47行目ではCalendarクラスを利用して現在の日付を取得しています。年、月、日を別々に取得し各情報をメンバ変数に代入にしています。
49～51行目ではupdateDisplayメソッドを実行し、TextViewの日付を更新しています。

【52～61行目に関する説明】

[訳]
このメソッドはメンバ変数の値を使います。レイアウトTextViewに日付を書き込むため、これらのメンバ変数をクラスに宣言しました。メンバ変数は上記で宣言され初期化されています。

[補足]

.append(mMonth + 1).append("-")

カレンダークラスや日付ピッカーで取得する月の値は0～11の範囲を取るので+1をして表示します。

【62～75行目に関する説明】

[訳]
DatePickerDialog.OnDateSetListenerのリスナはユーザが日付を設定したとき（「Set」ボタンをクリックすることにより）に処理が走ります。その時 onDateSet() コールバックメソッドが呼ばれ、mYear、mMonth、そしてmDay のメンバ変数の値を新しい日付で更新します。それからアクセス修飾子privateのupdateDisplay() メソッドが呼ばれTextViewの内容を更新します。

【76～88行目に関する説明】

[訳]
このメソッドはActivityコールメソッドであり、showDialog(int)に与えられたID（数値型）が引数として渡されます（ボタンのView.OnClickListererによって呼ばれます）。ここで定義されたswitch case構文でIDが一致すれば、DatePickerDialogのインスタンスが作られます。このインスタンス化には前ステップで作られたDatePickerDialog.OnDateSetListener、そしてwidgetの日付を初期化する為の日付変数をパラメータとして渡します。

[補足]
showDialog(int)により Activity がダイアログのライフサイクルを管理しています。showDialogが呼び出されると最初の一回だけonCreateDialog()がコールされダイアログを作成します。ここで作成されたダイアログは自動的に保存されいつでも呼び出すことができるようになります。

AVDによるアプリケーションの実行については「AVDでアプリケーションを実行する」の記事で詳しく書きました。参考にしてください。

実行結果をみてみます。次のような画面が表示されました。

今回は「List View」チュートリアルについて日本語への翻訳と内容を補足しながらみていきます。

List View

List Viewの説明についてみていきます。

[訳]
ListViewはスクロール可能な項目のリストを作るViewGroupです。リスト項目はListAdapterを使って自動的にリストに挿入されます。
このチュートリアルでは文字列配列から国名を読み込み、スクロール可能な国名リストを作ります。リスト項目が選択されたときは、そのリストでの項目の位置をトーストメッセージで表示します。

[訳]
HelloListView という名前の新規プロジェクトを開始します。

• プロジェクト名（Project name）
  HelloListView
• 内容(Contents)
  ワークスペース内に新規プロジェクトを作成
• ビルド・ターゲット(Build Target)
  Android 1.6
• アプリケーション名（Application Name）
  HelloListView
• パッケージ名（Package Name）
  localhost.helloview
• アクティビティの作成（Create Activity）
  HelloListView
• 最小 SDKバージョン（Min SDK Version）
  4

プロジェクト作成については「新規 Android プロジェクトを作成する」の記事に詳しく書いたので参考にしてください。パッケージ名については公開するつもりもないので、とりあえずローカル環境用という意味合いで「localhost」にしました。

list_item.xml という名前のxmlファイルを作成し、/res/layout/　に保存します。list_item.xml のコードを次のコードと入れ変えます。

<?xml version="1.0" encoding="utf-8"?>
<TextView
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="fill_parent"
    android:layout_height="fill_parent"
    android:padding="10dp"
    android:textSize="16sp" >
</TextView>

src/HelloListView.java を開きスーパークラスをListActivity に変更します。またpublic void Create以下をリファレンスのコードと差し替えます。そして足りないimport文などを追加したのが下記コードになります。

package localhost.helloview;

import android.app.ListActivity;
import android.os.Bundle;
import android.view.View;
import android.widget.AdapterView;
import android.widget.AdapterView.OnItemClickListener;
import android.widget.ArrayAdapter;
import android.widget.ListView;
import android.widget.TextView;
import android.widget.Toast;

public class HelloListView extends ListActivity {
    /** Called when the activity is first created. */
	public void onCreate(Bundle savedInstanceState) {
		super.onCreate(savedInstanceState);
		setListAdapter(
			new ArrayAdapter<String>(
				this,
				R.layout.list_item,
				COUNTRIES
			)
		);

		ListView lv = getListView();
		lv.setTextFilterEnabled(true);

		lv.setOnItemClickListener(new OnItemClickListener() {
		    public void onItemClick(
			    AdapterView<?> parent,
			    View view,
			    int position,
			    long id
			){
		       // When clicked, show a toast with the TextView text
		       Toast.makeText(
		    	   getApplicationContext(),
		    	   ((TextView) view).getText(),
		           Toast.LENGTH_SHORT
		       ).show();
		    }
		});
	}

    static final String[] COUNTRIES = new String[] {
        "Afghanistan", "Albania", "Algeria", "American Samoa",
        "Andorra","Angola", "Anguilla", "Antarctica",
        "Antigua and Barbuda", "Argentina",
    };
}

[訳]
ここではアクティビティでレイアウトファイルを読み込んでいないことに注目してください。（通常ではsetContentView(int)メソッドを使って読み込みます。）その代わりに、setListAdapter(ListAdapter)メソッドを使うことにより自動的にListViewが追加されListActivityの画面全体にリストが表示されます。このメソッドはArrayAdapterインスタンスをパラメータとして受け取り、ListView内で配置する項目の配列を管理します。ArrayAdapterインスタンス生成にはコンストラクタとしてアプリケーションのContext、各リストアイテムの為のレイアウト記述（前ステップで作成した）、そしてListViewに挿入するオブジェクトのList（次のステップで定義します）をパラメータとして渡します。

setTextFilterEnabled(boolean)メソッドはListViewに対してテキストフィルタリングをつけます。それによりユーザがタイプし始めるときにリストがフィルタされます。

setOnItemClickListener(OnItemClickListener)メソッドは各項目に対してon-clickリスナーを定義します。ListViewの項目がクリックされたときにonItemClick()メソッドが呼ばれ、クリックされた項目からテキストを取得してToastメッセージを表示します。

setListAdapter(
    new ArrayAdapter<String>(
        this,
        R.layout.list_item,
        COUNTRIES
    )
);

ビューと表示するデータのやりとりにAdapter(アダプタ）を通しています。アダプタという言葉はよく耳にしますが、異なる規格や形状の差異を吸収す る中間装置（処理）の総称です。ArrayAdapterはデータリソースを加工して表示する形にしListViewに渡します。このようにアダプタが中間に入ってくれることでデータリソースが配列であれリストであれ違いはアダプタが吸収するのでビューは表示に専念することができます。

ArrayAdapterは第2引数で各項目のデザイン情報を、第3引数でデータリソースを受け取ってます。上記の「レイアウトファイルの作成」でlist_item.xmlを作成しましたが、ここでのレイアウト情報はデータリソースの各項目に対してのもので全体に対してのものでないようです。ArrayAdapterで加工したデータをListViewに渡すわけですが、今回はレイアウトファイルを読み込む代わりにsetListAdapterアダプタを使っています。setListAdapterは自動的にListViewを作成するのでsetListAdapterにArrayAdapterを渡すことでListViewに渡すのと同様の効果になっています。

lv.setOnItemClickListener(new OnItemClickListener() {

ListViewの項目がクリックされたときに実行されるコールバックを登録します。今回はToastクラスを使って国名を表示するだけです。トーストとは一定の時間表示するポップアップウィンドウのことです。

AVDによるアプリケーションの実行については「AVDでアプリケーションを実行する」の記事で詳しく書きました。参考にしてください。

実行結果をみてみます。次のような画面が表示されました。