diff options
author | The Android Open Source Project <initial-contribution@android.com> | 2008-10-21 07:00:00 -0700 |
---|---|---|
committer | The Android Open Source Project <initial-contribution@android.com> | 2008-10-21 07:00:00 -0700 |
commit | 54b6cfa9a9e5b861a9930af873580d6dc20f773c (patch) | |
tree | 35051494d2af230dce54d6b31c6af8fc24091316 /core/java/android/content/DialogInterface.java | |
download | frameworks_base-54b6cfa9a9e5b861a9930af873580d6dc20f773c.zip frameworks_base-54b6cfa9a9e5b861a9930af873580d6dc20f773c.tar.gz frameworks_base-54b6cfa9a9e5b861a9930af873580d6dc20f773c.tar.bz2 |
Initial Contribution
Diffstat (limited to 'core/java/android/content/DialogInterface.java')
-rw-r--r-- | core/java/android/content/DialogInterface.java | 113 |
1 files changed, 113 insertions, 0 deletions
diff --git a/core/java/android/content/DialogInterface.java b/core/java/android/content/DialogInterface.java new file mode 100644 index 0000000..fc94aa6 --- /dev/null +++ b/core/java/android/content/DialogInterface.java @@ -0,0 +1,113 @@ +/* + * Copyright (C) 2006 The Android Open Source Project + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package android.content; + +import android.view.KeyEvent; + +/** + * + */ +public interface DialogInterface { + public static final int BUTTON1 = -1; + public static final int BUTTON2 = -2; + public static final int BUTTON3 = -3; + + public void cancel(); + + public void dismiss(); + + /** + * Interface used to allow the creator of a dialog to run some code when the + * dialog is canceled. + * <p> + * This will only be called when the dialog is canceled, if the creator + * needs to know when it is dismissed in general, use + * {@link DialogInterface.OnDismissListener}. + */ + interface OnCancelListener { + /** + * This method will be invoked when the dialog is canceled. + * + * @param dialog The dialog that was canceled will be passed into the + * method. + */ + public void onCancel(DialogInterface dialog); + } + + /** + * Interface used to allow the creator of a dialog to run some code when the + * dialog is dismissed. + */ + interface OnDismissListener { + /** + * This method will be invoked when the dialog is dismissed. + * + * @param dialog The dialog that was dismissed will be passed into the + * method. + */ + public void onDismiss(DialogInterface dialog); + } + + /** + * Interface used to allow the creator of a dialog to run some code when an + * item on the dialog is clicked.. + */ + interface OnClickListener { + /** + * This method will be invoked when a button in the dialog is clicked. + * + * @param dialog The dialog that received the click. + * @param which The button that was clicked, i.e. BUTTON1 or BUTTON2 or + * the position of the item clicked. + */ + public void onClick(DialogInterface dialog, int which); + } + + /** + * Interface used to allow the creator of a dialog to run some code when an + * item in a multi-choice dialog is clicked. + */ + interface OnMultiChoiceClickListener { + /** + * This method will be invoked when an item in the dialog is clicked. + * + * @param dialog The dialog where the selection was made. + * @param which The position of the item in the list that was clicked. + * @param isChecked True if the click checked the item, else false. + */ + public void onClick(DialogInterface dialog, int which, boolean isChecked); + } + + /** + * Interface definition for a callback to be invoked when a key event is + * dispatched to this dialog. The callback will be invoked before the key + * event is given to the dialog. + */ + interface OnKeyListener { + /** + * Called when a key is dispatched to a dialog. This allows listeners to + * get a chance to respond before the dialog. + * + * @param dialog The dialog the key has been dispatched to. + * @param keyCode The code for the physical key that was pressed + * @param event The KeyEvent object containing full information about + * the event. + * @return True if the listener has consumed the event, false otherwise. + */ + public boolean onKey(DialogInterface dialog, int keyCode, KeyEvent event); + } +} |