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
|
/*
* Jitsi, the OpenSource Java VoIP and Instant Messaging client.
*
* Copyright @ 2015 Atlassian Pty Ltd
*
* 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 net.java.sip.communicator.service.gui;
/**
* The <tt>AlertUIService</tt> is a service that allows to show error messages
* and warnings.
*
* @author Yana Stamcheva
*/
public interface AlertUIService
{
/**
* Indicates that the OK button is pressed.
*/
public static final int OK_RETURN_CODE = 0;
/**
* Indicates that the Cancel button is pressed.
*/
public static final int CANCEL_RETURN_CODE = 1;
/**
* Indicates that the OK button is pressed and the Don't ask check box is
* checked.
*/
public static final int OK_DONT_ASK_CODE = 2;
/**
* The type of the alert dialog, which displays a warning instead of an
* error.
*/
public static final int WARNING = 1;
/**
* The type of alert dialog which displays a warning instead of an error.
*/
public static final int ERROR = 0;
/**
* Shows an alert dialog with the given title and message.
*
* @param title the title of the dialog
* @param message the message to be displayed
*/
public void showAlertDialog(String title,
String message);
/**
* Shows an alert dialog with the given title message and exception
* corresponding to the error.
*
* @param title the title of the dialog
* @param message the message to be displayed
* @param e the exception corresponding to the error
*/
public void showAlertDialog(String title,
String message,
Throwable e);
/**
* Shows an alert dialog with the given title, message and type of message.
*
* @param title the title of the error dialog
* @param message the message to be displayed
* @param type the dialog type (warning or error)
*/
public void showAlertDialog(String title,
String message,
int type);
/**
* Shows an notification pop-up which can be clicked. An error dialog is
* shown when the notification is clicked.
*
* @param title the title of the error dialog and the notification pop-up
* @param message the message to be displayed in the error dialog and the
* pop-up
*/
public void showAlertPopup(String title, String message);
/**
* Shows an notification pop-up which can be clicked. An error dialog is
* shown when the notification is clicked.
*
* @param title the title of the error dialog and the notification pop-up
* @param message the message to be displayed in the error dialog and the
* pop-up
* @param e the exception that can be shown in the error dialog
*/
public void showAlertPopup(String title, String message,
Throwable e);
/**
* Shows an notification pop-up which can be clicked. An error dialog is
* shown when the notification is clicked.
*
* @param title the title of the notification pop-up
* @param message the message of the pop-up
* @param errorDialogTitle the title of the error dialog
* @param errorDialogMessage the message of the error dialog
*/
public void showAlertPopup(String title, String message,
String errorDialogTitle, String errorDialogMessage);
/**
* Shows an notification pop-up which can be clicked. An error dialog is
* shown when the notification is clicked.
*
* @param title the title of the notification pop-up
* @param message the message of the pop-up
* @param errorDialogTitle the title of the error dialog
* @param errorDialogMessage the message of the error dialog
* @param e the exception that can be shown in the error dialog
*/
public void showAlertPopup(String title, String message,
String errorDialogTitle, String errorDialogMessage, Throwable e);
/**
* Releases the resources acquired by this instance throughout its lifetime
* and removes the listeners.
*/
public void dispose();
}
|
