1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
|
/*
* 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;
/**
* Interface that defines a dialog-type class that can be shown, dismissed, or
* canceled, and may have buttons that can be clicked.
*/
public interface DialogInterface {
/** The identifier for the positive button. */
int BUTTON_POSITIVE = -1;
/** The identifier for the negative button. */
int BUTTON_NEGATIVE = -2;
/** The identifier for the neutral button. */
int BUTTON_NEUTRAL = -3;
/** @deprecated Use {@link #BUTTON_POSITIVE} */
@Deprecated
int BUTTON1 = BUTTON_POSITIVE;
/** @deprecated Use {@link #BUTTON_NEGATIVE} */
@Deprecated
int BUTTON2 = BUTTON_NEGATIVE;
/** @deprecated Use {@link #BUTTON_NEUTRAL} */
@Deprecated
int BUTTON3 = BUTTON_NEUTRAL;
/**
* Cancels the dialog, invoking the {@link OnCancelListener}.
* <p>
* The {@link OnDismissListener} may also be called if cancellation
* dismisses the dialog.
*/
void cancel();
/**
* Dismisses the dialog, invoking the {@link OnDismissListener}.
*/
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
*/
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
*/
void onDismiss(DialogInterface dialog);
}
/**
* Interface used to allow the creator of a dialog to run some code when the
* dialog is shown.
*/
interface OnShowListener {
/**
* This method will be invoked when the dialog is shown.
*
* @param dialog the dialog that was shown will be passed into the
* method
*/
void onShow(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 (ex.
* {@link DialogInterface#BUTTON_POSITIVE}) or the position
* of the item clicked
*/
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 {@code true} if the click checked the item, else
* {@code false}
*/
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 {@code true} if the listener has consumed the event,
* {@code false} otherwise
*/
boolean onKey(DialogInterface dialog, int keyCode, KeyEvent event);
}
}
|
