Диалоговые окна в Android. Часть 1

Добрый день/вечер/утро, уважаемые хабравчане и Вы, %username%!
Я занимаюсь разработкой приложений для Android, обожаю эту операционную систему и хочу поделиться своим опытом использования в своих проектах диалоговых окон. В первую очередь эта статья записка очень пригодится начинающим в области разработки для Android.
Также для новичков в этой отрасли рекомендую сперва прочитать вот этот пост уважаемого Hoorsh.
А теперь приступим к рассмотрению данного вопроса (у которого есть несколько подводных камней) под катом.

Dialog

Dialog — это класс, принадлежащий Android SDK и помогающий нам, простым смертным программистам, работать с диалоговыми окнами в Android. Класс Dialog имеет 4 подкласса:

• AlertDialog: это диалоговое окно для различных сообщений приложения, например «Вы хотите купить мое приложение?» или что то в этом роде. AlertDialog поддерживает три кнопки — утвердительную (OK), отрицательную (Cancel) и нейтральную (Later).
• ProgressDialog: это диалоговое окно для отображения выполнения различных процессов, загрузки, например.
• DatePickerDialog: диалоговое окно предлагает пользователю выбрать дату.
• TimePickerDialog: диалоговое окно предлагает пользователю выбрать время

На первом из этого списка, AlertDialog мы и остановимся подробнее.

AlertDialog

Чтобы создать диалоговое окно AlertDialog нам в помощь потребуется экземпляр класса Builder:
AlertDialog.Builder builder = new AlertDialog.Builder(this);
Теперь, когда у нас есть builder, мы можем «строить» свое собственное диалоговое окно. В параметры диалогового окна Вы можете написать множество различных параметров, но основными являются эти:

• setTitle(int resID) — задает заголовок диалогового окна, принимает в качестве аргументов ссылку на ресурс или строку.
• setMessage(int resID) — задает сообщение в диалоговом окне, также принимает ссылку на ресурс или строку.
• setPositiveButton(int textID, DialogInterface.OnClickListener listener) — устанавливает на Вашем диалоговом окне утвердительную кнопку с текстом ресурса textID и слушателем listener. Методы setNegativeButton и setNeutralButton идентичны, с разницей в назначении кнопок.

Пример создания AlertDialog:

AlertDialog.Builder builder = new AlertDialog.Builder(activity);
builder.setTitle(R.string.dialog_about_title);
builder.setMessage(R.string.dialog_about_message);
builder.setCancelable(true);
builder.setPositiveButton(android.R.string.ok, new DialogInterface.OnClickListener() { // Кнопка ОК
	@Override
	public void onClick(DialogInterface dialog, int which) {
		dialog.dismiss(); // Отпускает диалоговое окно					
	}
});
AlertDialog dialog = builder.create();

В этом примере я использовал setCancelable(true) — это разрешает пользователю закрывать диалоговое окно с помощью хардварной кнопки Back. Еще я создал слушателя для утвердительной кнопки и использовал метод create(). Метод create() возвращает готовое диалоговое окно с вашими параметрами как экземпляр класса AlertDialog.
Вот мы и создали диалоговое окно! Следующая задача — показать его пользователю. Вот тут есть несколько вариантов:

• showDialog(AlertDialog dialog) — самый простой способ показать диалоговое окно, но начиная с версии 3.0 разработчики Android не рекомендуют пользоваться этим методом, и в результате вы получите предупреждение, которое можно обойти только @SurpressWarning, что есть не совсем хорошо.
• AlertDialog dialog.show() — альтернативный способ показать окно, для этого в экземпляре dialog должен лежать результат метода Builder.create().

Второй метод нам подходит больше, но писать в основной активности кучу различных Buider и AlertDialog портит читабельность кода. Поэтому целесообразней вынести создание и обработку диалоговых окон в новый класс, например:

public class DialogScreen {
	
	public static final int IDD_ABOUT = 1; // Идентификаторы диалоговых окон
	public static final int IDD_SETTINGS = 2;
	public static final int IDD_RATE = 3;
	
	public static AlertDialog getDialog(Activity activity, int ID) {
		AlertDialog.Builder builder = new AlertDialog.Builder(activity);

		switch(ID) {
		case IDD_ABOUT: // Диалоговое окно About
			builder.setTitle(R.string.dialog_about_title);
			builder.setMessage(R.string.dialog_about_message);
			builder.setCancelable(true);
			builder.setPositiveButton(android.R.string.ok, new DialogInterface.OnClickListener() { // Кнопка ОК
				@Override
				public void onClick(DialogInterface dialog, int which) {
					dialog.dismiss(); // Отпускает диалоговое окно					
				}
			});
			return builder.create();
		case IDD_RATE: // Диалоговое окно Rate the app
			builder.setTitle(R.string.dialog_rate_title);
			builder.setMessage(R.string.dialog_rate_message);
			builder.setCancelable(true);
			builder.setPositiveButton(R.string.dialog_rate_ok, new DialogInterface.OnClickListener() { // Переход на оценку приложения
				@Override
				public void onClick(DialogInterface dialog, int which) {
					// Переход	
					dialog.dismiss();
				}
			});
			builder.setNeutralButton(R.string.dialog_rate_cancel, new DialogInterface.OnClickListener() { // Оценить приложение потом
				@Override
				public void onClick(DialogInterface dialog, int which) {
					dialog.dismiss(); // Отпускает диалоговое окно
				}
			});
			builder.setNegativeButton(R.string.dialog_rate_buy, new DialogInterface.OnClickListener() { // Переход на покупку AdFree версии
				@Override
				public void onClick(DialogInterface dialog, int which) {
					// Переход		
					dialog.dismiss();
				}
			});
			return builder.create();
		case IDD_SETTINGS: // Диалог настроек
			View view = activity.getLayoutInflater().inflate(R.layout.settings, null); // Получаем layout по его ID
			builder.setView(view);
			builder.setTitle(R.string.dialog_settings_title);
			builder.setPositiveButton(android.R.string.ok, new DialogInterface.OnClickListener() { // Кнопка ОК
                public void onClick(DialogInterface dialog, int whichButton) {
                    MainActivity.doSaveSettings(); // Переход в сохранение настроек MainActivity
                    dialog.dismiss();
                }
            });
			builder.setNegativeButton(android.R.string.cancel, new DialogInterface.OnClickListener() { // Кнопка Отмена 
				public void onClick(DialogInterface dialog, int which) {
					dialog.dismiss();
				}
			});
			builder.setCancelable(true);
			return builder.create();
		default:
			return null;
		}		
	}
}

Единственная заметка по поводу этого кода будет про использования метода setView(View view) в диалоге IDD_SETTINGS. У AlertDialog как и у всех остальных диалоговых окон есть одна приятная особенность — им можно задавать собственные Layout, что позволяет полностью видоизменять диалоговые окна и их содержимое. Здесь есть один подводный камень: обработку элементов этого Layout вы должны будете производить именно в той Activity, где вызываете это диалоговое окно. Например я показываю диалоговое окно IDD_SETTINGS в MainActivity с Layout по имени settings:

<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent" >

    <SeekBar
        android:id="@+id/seekVol"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:layout_alignParentLeft="true"
        android:layout_below="@+id/seekSense"
        android:layout_marginTop="42dp" />

    <TextView
        android:id="@+id/textVol"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_alignParentLeft="true"
        android:layout_below="@+id/seekSense"
        android:layout_marginTop="20dp"
        android:text="@string/dialog_settings_vol"
        android:textAppearance="?android:attr/textAppearanceMedium" />

    <TextView
        android:id="@+id/textSense"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_alignParentLeft="true"
        android:layout_alignParentTop="true"
        android:text="@string/dialog_settings_sense"
        android:textAppearance="?android:attr/textAppearanceMedium" />

    <SeekBar
        android:id="@+id/seekSense"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:layout_alignParentLeft="true"
        android:layout_below="@+id/textSense" />

</RelativeLayout>

Соответственно я загружаю это окно в MainActivity:

		AlertDialog dialog = DialogScreen.getDialog(this, DialogScreen.IDD_SETTINGS);
		dialog.show();
			initSettings(dialog);
		}

Метод initSettings класса MainActivity в данном случае будет выглядеть так:

		// Определяем SeekBar и привязываем к нему дельты настроек
		SeekBar sb_sense = (SeekBar)dialog.findViewById(R.id.seekSense);
		SeekBar sb_vol = (SeekBar)dialog.findViewById(R.id.seekVol);			
		// Задаем этим SeekBar текущие значения настроек
		sb_sense.setProgress(sense);
		sb_vol.setProgress(volume);

Ну а дальше обрабатываете свои объекты как вам угодно.

Небольшой итог

1) Для большинства целей диалоговых окон подходит AlertDialog
2) AlertDialog может принимать вид layout с любыми объектами
3) Гораздо лучше использовать для диалоговых окон отдельный класс и пользоваться AlertDialog.show()
4) Обработка объектов кастомного layout производится в активности, вызвавшей диалог

В следующей части этой статьи пойдет речь о DialogFragment, который был включен в Android SDK начиная с 3.0 Honeycomb. Надеюсь эта статья поможет новичкам и не очень в своих квестах по завоеванию Google Play.

P.S.

Это моя первая статья для хабра, поэтому принимаю любую конструктивную критику. Заранее спасибо.