Android 関数メモ
public void startSearch(String initialQuery, boolean selectInitialQuery, Bundle appSearchData; boolean globalSearch)
このフックは、検索UIを起動するために呼び出される
引数のinitialQueryは、任意のnull以外の文字列が検索ボックスに入力テキストとして挿入される
selectInitialQueryは、trueならinitialQueryが選択をれた状態になる
タイプすればinitialQueryの変更ができる
つまり検索ワードの変更
falseなら、選択ポイントが挿入されたqueryの末尾になる
これは、入力したテキストの後に追加するときに使う
appSearchDataは、アプリ固有のContextの挿入
このデータは、1つ、もしくは複数のSEARCHインテントで返される
extraDataが必要ないならnullにする
globalSearchは、falseならアプリにより明確に定義されている検索を起動する
現在のアプリ、またはActivityでデフォルトサーチが定義されていない場合
グローバル検索が起動する
trueだと、プラットホーム上のグローバル検索、例えばWebベースの検索を起動する
public void takeKeyEvents(boolean get)
キーをActivityに移すことを要求する
Activityがフォーカスを持ったViewを持っていない場合で、Activityがまだキーイベントを処理するときに使う
public void triggerSearch(String query, Bundle appSearchData)
startSearch(String, boolean, Bundle, boolean)と似てるけど
検索ダイアログを呼び出した後に検索queryをOFFにする
これほ、テストで使う
引数のqueryは、トリガー用のquery
空なら要求は無視
appSearchDataは、独自の検索の質や特異性の向上のため、アプリ固有のContextを挿入
このデータは、SEARCH intent(s)で返される
Extraデータが必要ないならnullを指定
public void unregisterForContextMenu(View view)
指定されたViewに対してContextMenuが表示されないようにする
このメソッドは
Viewの
View.onCreateContextMenuListener
を削除する
引数のviewは、ContextMenuの表示を停止するView
protected void onActivityResult(int requestCode, int resultCode, Intent data)
起動したActivityが終了するときに、Activity開始時に与えたrequestCodeと
Activityから返されたresultCode
そして追加データを与えて呼び出される
引数のrequestCodeは、
startActivityForResult()に与えられた整数のRequestCode
この結果で、どのActivityから来たか特定できる
resultCodeは、setResult()を介して子Activityにより返される整数の結果コード
dataは、呼び出し元へ、結果データを戻すためのIntent
これは、IntentのExtraにアタッチされた様々なデータ
protected void onApplyThemeResource(Resources.Theme theme, int resId_ boolean first)
現在のThemeオブジェクトにテーマのリソースを適用するsetTheme(int)と
getTheme()により呼び出される
デフォルト動作変更のためOverrideすることが可能
このメソッドは、マルチスレッドで同時に呼び出されることはない
引数のthemeは、変更しようとするテーマのオブジェクト
resIdは、テーマに適用されるスタイルリソース
firstは、スタイルを初めてテーマに適用するならtrue
protected void onCreate(Bundle savedInstanceState)
Activityが開始されたときに呼び出される
ほとんどの初期化が行われる場所
派生クラスは、このメソッドのスーパークラスの実装に介して呼び出す必要がある
そうでない場合、例外がスローされる
引数のsavedInstanceStateは
以前にシャットダウンされた後、Activityが再起動される場合
このBundleは、直近の
onSaveInstanceState(Bundle)
で提供されたデータがふくまれる
protected void onDestroy()
Activityが破棄される前に任意の最終的なクリーンアップを実行
Activityがfinish()で終了している、もしくは
システムがスペース節約のため一時的にActivityのインスタンスを破棄しているときに発生する
isFinishing()を使い、そのどちらかを判別できる
派生クラスは、このメソッドの実装に
スーパークラスのメソッドを呼び出す必要がある
呼び出さないと例外がスローされる
protected void onNewIntent(Intent intent)
package内のインスタンス singleTop に設定された launchModeのActivityのために呼ばれる
または、クライアントが
FLAG_ACTIVITY_SINGLE_TOPフラグで
startActivity(Intent)
を呼び出したときに呼ばれる
引数のintentは、
Activityを開始された新しいActivity
protected void onPause()
ActivityがBackgroundへ移動するActivityのライフサイクルの一部として
呼び出されるがkillされていない
これは、onResume()の対になる
派生クラスは、このメソッドの実装に
スーパークラスのメソッドを呼び出す必要がある
呼び出さないと、例外がスローされる
protected void onPostCreate(Bundle savedInstanceState)
Activityの起動が、完了したときに
onStartと
onRestoreInstanceState(Bundle)
が呼び出された後に呼び出される
アプリは、一般的にはこのメソッドを実装してはいけない
protected void onPostResume()
Activityの再開が完了したとき
つまりonResume()が呼び出された後に呼び出される
派生クラスは、このメソッドの実装に
スーパークラスのメソッドを呼び出す必要がある
そうでないと例外がスローされる
protected void onRestart()
現在のActivityがユーザーにより再表示される
つまり、ユーザーが戻る動作をしたときに
onStop()の後に呼び出される
派生クラスは、このメソッドの実装に
スーパークラスのメソッドを呼び出す必要がある
呼び出さないと例外をスローする
protected void onRestoreInstanceState(Bundle savedInstanceState)
Activityが以前に保存した状態から再初期化される前に
savedInstanceStateを与えられて
onStart()の前に呼び出される
引数の
savedInstanceStateは、
onSavedInstanceState(Bundle)で供給された最新のデータ
protected void onResume()
Activityがユーザーとの対話を開始するため
onRestoreInstanceState(Bundle)
onRestart()
または、onPause()した後に呼び出される
派生クラスは、このメソッドの実装にスーパークラスのメソッドを呼び出す必要がある
呼び出さないと例外をスローする
protected void onSavedInstanceState(Bundle outState)
onCreate(Bundle)
または、onRestoreInstanceState(Bundle)
で復元できるように
Activityがkillされる前に
Activityからインスタンスごとの状態を取得するため呼び出される
呼び出された場合、onStop()の前に呼び出される
onPause()の前後では発生する保証はない
引数のoutStateは、保存した状態を配置したBundle
protected void onStart()
onCreate(Bundle)した後
または、Activityが停止したけどonRestart()でユーザーに表示された後の状態のときに呼び出される
そして、onResume()が続けて呼び出される
派生クラスは、このメソッドの実装にスーパークラスを呼び出す必要がある
呼び出さないと例外をスローする
protected void onStop()
Activityがしばらくの間、ユーザーに表示されていない場合呼び出される
この後のユーザーの行動に応じ、
onRestart()
onDestroy()
または、何もしない
派生クラスは、このメソッドの実装にスーパークラスを呼び出す必要がある
呼び出さないと例外をスローする
protected void onUserLeaveHint()
Activityがユーザー選択の結果として
backgroundへ入ろうとしているときに
Activityのライフサイクルの一つとして呼び出される