ファイル選択アクティビティ（ Activity + ListView )

（開発環境として「Eclipse」を使用した、古い情報です。
　開発環境として「Android Studio」を使用した、新しい情報は、
　「ホーム > プログラミング > Android プログラミング」からたどれます。）

解説

標準では、ファイル選択アクティビティに関する関数、クラスは用意されていないので、自作します。

実現方法としては、Activity に ListView を View として登録する方法で実現します。

ファイル選択アクティビティに関するクラスとしては、３つのクラスを作成します。
・ViewとしてListViewを登録ファイル選択アクティビティクラス
・ListViewの表示要素を管理するファイル情報配列アダプタクラス
・ListViewで表示するときの一要素にあたるファイル情報クラス

サンプルコード

サンプルアプリの仕様

アプリを起動すると、メインアクティビティが表示される。
スマートフォンのメニューボタンを押すと、画面下部に、「Select File...」というメニュー項目が表示される。
「Select File..」というメニュー項目を選択すると、ファイル選択アクティビティが表示される。
ファイル選択アクティビティには、ディレクトリ・ファイルのリストと、「Cancel」ボタンが表示される。
ディレクトリ・ファイルのリストは、上の階層に戻る「..」、フォルダ、ファイルの順でリストされる。
ディレクトリ名は名前の末尾に「/」が付く。
ディレクトリ名をクリックすると、一階層下のディレクトリ・ファイルのリストが表示される。
ファイル名をクリックすると、ファイル選択アクティビティは閉じられ、選択したファイルパス名をトーストにて表示する。
「Cancel」ボタンを押すと、ファイル選択アクティビティは閉じられる。

プロジェクトの作成

（開発環境としては、Pleiades Version 3.7.2 ( Eclipse Version 3.7.2 ) を使用しています）

（この設定でプロジェクトを作成しなければいけない、というわけではありません。）

Eclipseを起動します。

メニュー「ファイル > 新規 > プロジェクト」を選択します。

Android プロジェクトを選択し、「次へ」ボタンを押します。

Project Name にプロジェクト名（たとえば、「FileSelectionActivitySample」）を入力し、「次へ」ボタンを押します。

ビルドターゲットを一つチェックし（たとえば、「Android 2.1」をチェックし）、「次へ」ボタンを押します。

Package Name にパッケージ名（たとえば、「com.hiramine.fileselectionactivitysample」）を入力し、「完了」ボタンを押します。

ファイル情報クラスの追加

ListViewで表示するときの一要素にあたるファイル情報クラスを追加します。

パッケージエクスプローラで、作成したプロジェクトの下の「src」の下の作成したパッケージ（たとえば、「com.hiramine.fileselectionactivitysample」）を右クリックし、右クリックメニューの「新規 > クラス」を選択します。

名前にクラス名（たとえば、「FileInfo」）を入力し、「完了」ボタンを押します。

FileInfoクラスの仕事は、
① ファイル・ディレクトリの表示名とFileオブジェクトの管理
② ソート用の比較関数の提供
です。

「① ファイル・ディレクトリの表示名とFileオブジェクトの管理」のために、メンバ変数、アクセサ関数を追加します。

「② ソート用の比較関数の提供」のために、Comparable<FileInfo> のインターフェースを実装します。
（クラス名の後ろに、implements Comparable<FileInfo> を追加し、インターフェースで宣言されている関数である compareTo関数を追加します。）

package com.hiramine.fileselectionactivitysample; import java.io.File; public class FileInfo implements Comparable<FileInfo> { private String m_strName; // 表示名 private File m_file; // ファイルオブジェクト // コンストラクタ public FileInfo( String strName, File file ) { m_strName = strName; m_file = file; } public String getName() { return m_strName; } public File getFile() { return m_file; } // 比較 public int compareTo( FileInfo another ) { // ディレクトリ < ファイルの順 if( true == m_file.isDirectory() && false == another.getFile().isDirectory() ) { return -1; } if( false == m_file.isDirectory() && true == another.getFile().isDirectory() ) { return 1; } // ファイル同士、ディレクトリ同士の場合は、ファイル名（ディレクトリ名）の大文字小文字区別しない辞書順 return m_file.getName().toLowerCase().compareTo( another.getFile().getName().toLowerCase() ); } }

ファイル情報配列アダプタクラスの追加

ファイル選択アクティビティの実現方法としては、Activity に ListView をViewとして登録する方法で実現します。
ListViewの表示要素を管理するファイル情報配列アダプタクラスを追加します。

パッケージエクスプローラで、作成したプロジェクトの下の「src」の下の作成したパッケージ（たとえば、「com.hiramine.fileselectionactivitysample」）を右クリックし、右クリックメニューの「新規 > クラス」を選択します。

名前にクラス名（たとえば、「FileInfoArrayAdapter」）、
スーパークラスに、スーパークラス名（たとえば、「android.widget.ArrayAdapter<FileInfo>」）、
を入力し、「完了」ボタンを押します。

FileInfoArrayAdapterクラスの仕事は、
① ファイル情報リストの委譲、管理
② ListViewのリスト表示における一要素のビューの生成
です。

「① ファイル情報リストの委譲、管理」のために、メンバ変数、コンストラクタ、アクセサ関数を追加します。

「② ListViewのリスト表示における一要素分の表示行のビューの生成」のために、getView関数をオーバーライドし、処理を実装します。

package com.hiramine.fileselectionactivitysample; import java.util.List; import android.content.Context; import android.graphics.Color; import android.view.View; import android.view.ViewGroup; import android.widget.ArrayAdapter; import android.widget.LinearLayout; import android.widget.TextView; public class FileInfoArrayAdapter extends ArrayAdapter<FileInfo> { private List<FileInfo> m_listFileInfo; // ファイル情報リスト // コンストラクタ public FileInfoArrayAdapter( Context context, List<FileInfo> objects ) { super( context, -1, objects ); m_listFileInfo = objects; } // m_listFileInfoの一要素の取得 @Override public FileInfo getItem( int position ) { return m_listFileInfo.get( position ); } // 一要素のビューの生成 @Override public View getView( int position, View convertView, ViewGroup parent ) { // レイアウトの生成 if( null == convertView ) { Context context = getContext(); // レイアウト LinearLayout layout = new LinearLayout( context ); layout.setPadding( 10, 10, 10, 10 ); layout.setBackgroundColor( Color.WHITE ); convertView = layout; // テキスト TextView textview = new TextView( context ); textview.setTag( "text" ); textview.setTextColor( Color.BLACK ); textview.setPadding( 10, 10, 10, 10 ); layout.addView( textview ); } // 値の指定 FileInfo fileinfo = m_listFileInfo.get( position ); TextView textview = (TextView)convertView.findViewWithTag( "text" ); if( fileinfo.getFile().isDirectory() ) { // ディレクトリの場合は、名前の後ろに「/」を付ける textview.setText( fileinfo.getName() + "/" ); } else { textview.setText( fileinfo.getName() ); } return convertView; } }

ファイル選択アクティビティクラスの追加

ファイル選択アクティビティの作成と表示を行うファイル選択アクティビティクラスを追加します。

パッケージエクスプローラで、作成したプロジェクトの下の「src」の下の作成したパッケージ（たとえば、「com.hiramine.fileselectionactivitysample」）を右クリックし、右クリックメニューの「新規 > クラス」を選択します。

名前にクラス名（たとえば、「FileSelectionActivity」）、
スーパークラスに、android.app.Activity、
を入力し、「完了」ボタンを押します。

FileSelectionActivityクラスの仕事は、
① アクティビティの作成
② アクティビティのListView内の項目をクリックしたときの処理
③ アクティビティのCancelボタンをクリックしたときの処理
④ アクティビティ呼び出し元との情報のやりとりのためのインテントに関する処理
です。

「① アクティビティの作成」のために、onCreate関数と、fillという関数を追加します。

「② アクティビティのListView内の項目をクリックしたときの処理」のために、android.widget.AdapterView.OnItemClickListener のインターフェースを実装します。
（クラス名の後ろに、implements OnItemClickListener を追加し、インターフェースで宣言されている関数である onItemClick関数を追加します。）

「③ アクティビティのCancelボタンをクリックしたときの処理」のために、android.view.View.OnClickListener のインターフェースを実装します。
（クラス名の後ろの、implements OnItemClickListener の後ろに、 OnClickListener を追加し、インターフェースで宣言されている関数である onClick関数を追加します。）

「④ アクティビティ呼び出し元との情報のやりとりのためのインテントに関する処理」のために、onCreate関数に、呼び出し元からのパラメータ取得処理、onItemClick関数に、呼び出し元へのパラメータ設定処理、を追加します。

メンバ変数、コンストラクタも追加します。

package com.hiramine.fileselectionactivitysample; import java.io.File; import java.util.ArrayList; import java.util.Collections; import java.util.List; import android.app.Activity; import android.content.Intent; import android.os.Bundle; import android.view.View; import android.view.View.OnClickListener; import android.widget.AdapterView; import android.widget.Button; import android.widget.LinearLayout; import android.widget.ListView; import android.widget.AdapterView.OnItemClickListener; public class FileSelectionActivity extends Activity implements OnItemClickListener, OnClickListener { // レイアウトパラメーター private static final int WC = LinearLayout.LayoutParams.WRAP_CONTENT; private static final int FP = LinearLayout.LayoutParams.FILL_PARENT; // ボタンタグ private static final int BUTTONTAG_CANCEL = 0; private ListView m_listview; // リストビュー private FileInfoArrayAdapter m_fileinfoarrayadapter; // ファイル情報配列アダプタ // アクティビティ起動時に呼ばれる @Override public void onCreate( Bundle savedInstanceState ) { super.onCreate( savedInstanceState ); // アクティビティの戻り値の初期化 setResult( Activity.RESULT_CANCELED ); // 呼び出し元からパラメータ取得 String strInitialDir = null; Bundle extras = getIntent().getExtras(); if( null != extras ) { strInitialDir = extras.getString( "initialdir" ); } if( null == strInitialDir || false == new File( strInitialDir ).isDirectory() ) { strInitialDir = "/"; } // レイアウト LinearLayout layout = new LinearLayout( this ); layout.setOrientation( LinearLayout.VERTICAL ); setContentView( layout ); // リストビュー m_listview = new ListView( this ); m_listview.setScrollingCacheEnabled( false ); m_listview.setOnItemClickListener( this ); LinearLayout.LayoutParams layoutparams = new LinearLayout.LayoutParams( FP, 0 ); layoutparams.weight = 1; m_listview.setLayoutParams( layoutparams ); layout.addView( m_listview ); // ボタン Button button = new Button( this ); button.setText( "Cancel" ); button.setId( BUTTONTAG_CANCEL ); button.setOnClickListener( this ); layoutparams = new LinearLayout.LayoutParams( FP, WC ); button.setLayoutParams( layoutparams ); button.setPadding( 10, 10, 10, 10 ); layout.addView( button ); fill( new File( strInitialDir ) ); } // アクティビティ内の表示内容構築 private void fill( File fileDirectory ) { // タイトル setTitle( fileDirectory.getAbsolutePath() ); // ファイルリスト File[] aFile = fileDirectory.listFiles(); List<FileInfo> listFileInfo = new ArrayList<FileInfo>(); if( null != aFile ) { for( File fileTemp : aFile ) { listFileInfo.add( new FileInfo( fileTemp.getName(), fileTemp ) ); } Collections.sort( listFileInfo ); } // 親フォルダに戻るパスの追加 if( null != fileDirectory.getParent() ) { listFileInfo.add( 0, new FileInfo( "..", new File( fileDirectory.getParent() ) ) ); } m_fileinfoarrayadapter = new FileInfoArrayAdapter( this, listFileInfo ); m_listview.setAdapter( m_fileinfoarrayadapter ); } // ListView内の項目をクリックしたときの処理 public void onItemClick( AdapterView<?> l, View v, int position, long id ) { FileInfo fileinfo = m_fileinfoarrayadapter.getItem( position ); if( true == fileinfo.getFile().isDirectory() ) { fill( fileinfo.getFile() ); } else { // 呼び出し元へのパラメータ設定 Intent intent = new Intent(); intent.putExtra( "file", fileinfo.getFile() ); // アクティビティの戻り値の設定 setResult( Activity.RESULT_OK, intent ); // アクティビティ終了 finish(); } } // ボタンをクリックしたときの処理 public void onClick( View arg0 ) { final int iTag = (Integer)arg0.getTag(); switch( iTag ) { case BUTTONTAG_CANCEL: // アクティビティ終了 finish(); break; } } }

メインアクティビティクラスの実装

ファイル選択アクティビティに関する３つのクラスが出来たので、メインアクティビティに、ファイル選択アクティビティ呼び出しの処理を実装します。

メインアクティビティクラスの仕事は、
① スマートフォンのメニューボタンを押すと、画面下部に、「Select File...」というメニュー項目が表示される。
② 「Select File..」というメニュー項目を選択すると、ファイル選択アクティビティが表示される。
③ ファイル名をクリックされた場合に、選択したファイルパス名をトーストにて表示する。
です。

「① スマートフォンのメニューボタンを押すと、画面下部に、「Select File...」というメニュー項目が表示される。」のために、onCreateOptionsMenu関数をオーバーライドし、処理を実装します。

「② 「Select File..」というメニュー項目を選択すると、ファイル選択アクティビティが表示される。」のために、onOptionsItemSelected関数をオーバーライドし、処理を実装します。

「③ ファイル名をクリックされた場合に、選択したファイルパス名をトーストにて表示する。」のために、onFileSelect関数を追加します。

メンバ変数も追加します。

package com.hiramine.fileselectionactivitysample; import java.io.File; import android.app.Activity; import android.content.Intent; import android.os.Bundle; import android.view.Menu; import android.view.MenuItem; import android.widget.Toast; public class FileSelectionActivitySampleActivity extends Activity { // オプションメニューID private static final int MENUID_FILE = 0; // リクエストコード private static final int REQUEST_FILESELECT = 0; // 初期フォルダ private String m_strInitialDir = "/"; /** Called when the activity is first created. */ @Override public void onCreate( Bundle savedInstanceState ) { super.onCreate( savedInstanceState ); setContentView( R.layout.main ); } // オプションメニュー生成時 @Override public boolean onCreateOptionsMenu( Menu menu ) { super.onCreateOptionsMenu( menu ); menu.add( 0, MENUID_FILE, 0, "Select File..." ); return true; } // オプションメニュー選択時 @Override public boolean onOptionsItemSelected( MenuItem item ) { switch( item.getItemId() ) { case MENUID_FILE: // ファイル選択アクティビティ Intent intent = new Intent( this, FileSelectionActivity.class ); intent.putExtra( "initialdir", m_strInitialDir ); startActivityForResult( intent, REQUEST_FILESELECT ); return true; } return false; } // アクティビティ呼び出し結果の取得 @Override protected void onActivityResult( int requestCode, int resultCode, Intent intent ) { if( REQUEST_FILESELECT == requestCode && RESULT_OK == resultCode ) { Bundle extras = intent.getExtras(); if( null != extras ) { File file = (File)extras.getSerializable( "file" ); Toast.makeText( this, "File Selected : " + file.getPath(), Toast.LENGTH_SHORT ).show(); m_strInitialDir = file.getParent(); } } } }

AndroidManifest.xml へのファイル選択アクティビティの追加

サンプルアプリでは、メインとなる「FileSelectionActivitySampleActivity」の他に、ファイル選択アクティビティである「FileSelectionActivity」を使用します。

「FileSelectionActivity」を使用するためには、AndroidManifest.xml に、「FileSelectionActivity」に関する記述を追加する必要があります。

具体的には、AndroidManifest.xml に
<activity android:name="FileSelectionActivity"></activity>
という記述を、直接追記、もしくは、GUI操作で追記します。

（上記追記を実施したところ、「targetSdkVersionに関する記述をすべき」という旨の警告が出たので、
　<uses-sdk android:minSdkVersion="7"/>
　を
　<uses-sdk android:minSdkVersion="7" android:targetSdkVersion="7" />
　と書き換えました。）

<?xml version="1.0" encoding="utf-8"?> <manifest xmlns:android="http://schemas.android.com/apk/res/android" package="com.hiramine.fileselectionactivitysample" android:versionCode="1" android:versionName="1.0" > <uses-sdk android:minSdkVersion="7" android:targetSdkVersion="7" /> <application android:icon="@drawable/ic_launcher" android:label="@string/app_name" > <activity android:name=".FileSelectionActivitySampleActivity" android:label="@string/app_name" > <intent-filter> <action android:name="android.intent.action.MAIN" /> <category android:name="android.intent.category.LAUNCHER" /> </intent-filter> </activity> <activity android:name="FileSelectionActivity"></activity> </application> </manifest>

実行

Android Virtual Device にて、動作確認。

起動直後

スマートフォンのメニューボタンを押すと、画面下部に、「Select File...」というメニュー項目が表示されます。

「Select File..」というメニュー項目を選択すると、ファイル選択アクティビティが表示されます。

ディレクトリ名をクリックすると、一階層下のディレクトリ・ファイルのリストが表示されます。

ファイル名をクリックすると、ファイルパス名が、トーストで表示されます。