import android.graphics.drawable.BitmapDrawable;
import android.graphics.drawable.Drawable;
import android.os.Bundle;
-import android.support.annotation.NonNull;
-// If we don't use android.support.v7.app.AlertDialog instead of android.app.AlertDialog then the dialog will be covered by the keyboard.
+// If we don't use `android.support.v7.app.AlertDialog` instead of `android.app.AlertDialog` then the dialog will be covered by the keyboard.
import android.support.v7.app.AlertDialog;
import android.view.KeyEvent;
-import android.view.LayoutInflater;
import android.view.View;
import android.view.WindowManager;
import android.widget.EditText;
public class CreateBookmark extends DialogFragment {
// The public interface is used to send information back to the parent activity.
public interface CreateBookmarkListener {
- void onCreateBookmarkCancel(DialogFragment createBookmarkDialogFragment);
+ void onCancelCreateBookmark(DialogFragment dialogFragment);
- void onCreateBookmarkCreate(DialogFragment createBookmarkDialogFragment);
+ void onCreateBookmark(DialogFragment dialogFragment);
}
- // createBookmarkListener is used in onAttach() and onCreateDialog()
+ // `createBookmarkListener` is used in `onAttach()` and `onCreateDialog()`
private CreateBookmarkListener createBookmarkListener;
- // Check to make sure the parent activity implements the listener.
+
public void onAttach(Activity parentActivity) {
super.onAttach(parentActivity);
+
+ // Get a handle for `CreateBookmarkListener` from `parentActivity`.
try {
createBookmarkListener = (CreateBookmarkListener) parentActivity;
} catch(ClassCastException exception) {
}
}
- // onCreateDialog requires @NonNull.
@Override
- @NonNull
public Dialog onCreateDialog(Bundle savedInstanceState) {
// Create a drawable version of the favorite icon.
Drawable favoriteIconDrawable = new BitmapDrawable(getResources(), MainWebViewActivity.favoriteIcon);
- // Get the activity's layout inflater.
- LayoutInflater customDialogInflater = getActivity().getLayoutInflater();
+ // Use `AlertDialog.Builder` to create the `AlertDialog`. The style formats the color of the button text.
+ AlertDialog.Builder dialogBuilder = new AlertDialog.Builder(getActivity(), R.style.LightAlertDialog);
+ dialogBuilder.setTitle(R.string.create_bookmark);
+ dialogBuilder.setIcon(favoriteIconDrawable);
+ // The parent view is `null` because it will be assigned by the `AlertDialog`.
+ dialogBuilder.setView(getActivity().getLayoutInflater().inflate(R.layout.create_bookmark_dialog, null));
- // Use AlertDialog.Builder to create the AlertDialog. The style formats the color of the button text.
- AlertDialog.Builder createBookmarkDialogBuilder = new AlertDialog.Builder(getActivity(), R.style.PrivacyBrowser_AlertDialog);
- createBookmarkDialogBuilder.setTitle(R.string.create_bookmark);
- createBookmarkDialogBuilder.setIcon(favoriteIconDrawable);
- // The parent view is "null" because it will be assigned by AlertDialog.
- createBookmarkDialogBuilder.setView(customDialogInflater.inflate(R.layout.create_bookmark_dialog, null));
-
- // Set an onClick listener on the negative button.
- createBookmarkDialogBuilder.setNegativeButton(R.string.cancel, new DialogInterface.OnClickListener() {
+ // Set an `onClick()` listener for the negative button.
+ dialogBuilder.setNegativeButton(R.string.cancel, new DialogInterface.OnClickListener() {
@Override
public void onClick(DialogInterface dialog, int which) {
- createBookmarkListener.onCreateBookmarkCancel(CreateBookmark.this);
+ // Return the `DialogFragment` to the parent activity on cancel.
+ createBookmarkListener.onCancelCreateBookmark(CreateBookmark.this);
}
});
- // Set an onClick listener on the positive button.
- createBookmarkDialogBuilder.setPositiveButton(R.string.create, new DialogInterface.OnClickListener() {
+ // Set an `onClick()` listener for the positive button.
+ dialogBuilder.setPositiveButton(R.string.create, new DialogInterface.OnClickListener() {
@Override
public void onClick(DialogInterface dialog, int which) {
- createBookmarkListener.onCreateBookmarkCreate(CreateBookmark.this);
+ // Return the `DialogFragment` to the parent activity on create.
+ createBookmarkListener.onCreateBookmark(CreateBookmark.this);
}
});
- // Create an AlertDialog from the AlertDialog.Builder.
- final AlertDialog createBookmarkDialog = createBookmarkDialogBuilder.create();
+ // Create an `AlertDialog` from the `AlertDialog.Builder`.
+ final AlertDialog alertDialog = dialogBuilder.create();
- // Show the keyboard when the Dialog is displayed on the screen.
- createBookmarkDialog.getWindow().setSoftInputMode(WindowManager.LayoutParams.SOFT_INPUT_STATE_ALWAYS_VISIBLE);
+ // Show the keyboard when the `Dialog` is displayed on the screen.
+ alertDialog.getWindow().setSoftInputMode(WindowManager.LayoutParams.SOFT_INPUT_STATE_ALWAYS_VISIBLE);
- // We need to show the AlertDialog before we can call setOnKeyListener() below.
- createBookmarkDialog.show();
+ // We need to show the `AlertDialog` before we can call `setOnKeyListener()` below.
+ alertDialog.show();
- // Allow the "enter" key on the keyboard to create the bookmark from "create_bookmark_name_edittext".
- EditText createBookmarkNameEditText = (EditText) createBookmarkDialog.findViewById(R.id.create_bookmark_name_edittext);
- assert createBookmarkNameEditText != null; // Remove the warning below that createBookmarkNameEditText might be null.
+ // Allow the `enter` key on the keyboard to create the bookmark from `create_bookmark_name_edittext`.
+ EditText createBookmarkNameEditText = (EditText) alertDialog.findViewById(R.id.create_bookmark_name_edittext);
+ assert createBookmarkNameEditText != null; // Remove the warning below that `createBookmarkNameEditText` might be `null`.
createBookmarkNameEditText.setOnKeyListener(new View.OnKeyListener() {
public boolean onKey(View v, int keyCode, KeyEvent event) {
- // If the event is a key-down on the "enter" button, select the PositiveButton "Create".
+ // If the event is a key-down on the `enter` button, select the `PositiveButton` `Create`.
if ((event.getAction() == KeyEvent.ACTION_DOWN) && (keyCode == KeyEvent.KEYCODE_ENTER)) {
- // Trigger the createBookmarkListener.
- createBookmarkListener.onCreateBookmarkCreate(CreateBookmark.this);
-
- // Manually dismiss the AlertDialog.
- createBookmarkDialog.dismiss();
-
+ // Trigger `createBookmarkListener` and return the `DialogFragment` to the parent activity.
+ createBookmarkListener.onCreateBookmark(CreateBookmark.this);
+ // Manually dismiss the `AlertDialog`.
+ alertDialog.dismiss();
// Consume the event.
return true;
} else { // If any other key was pressed, do not consume the event.
}
});
- // Set the formattedUrlString as the initial text of "create_bookmark_url_edittext".
- EditText createBookmarkUrlEditText = (EditText) createBookmarkDialog.findViewById(R.id.create_bookmark_url_edittext);
- assert createBookmarkUrlEditText != null;// Remove the warning below that createBookmarkUrlEditText might be null.
+ // Set the formattedUrlString as the initial text of `create_bookmark_url_edittext`.
+ EditText createBookmarkUrlEditText = (EditText) alertDialog.findViewById(R.id.create_bookmark_url_edittext);
+ assert createBookmarkUrlEditText != null;// Remove the warning below that `createBookmarkUrlEditText` might be `null`.
createBookmarkUrlEditText.setText(MainWebViewActivity.formattedUrlString);
- // Allow the "enter" key on the keyboard to create the bookmark from "create_bookmark_url_edittext".
+ // Allow the `enter` key on the keyboard to create the bookmark from `create_bookmark_url_edittext`.
createBookmarkUrlEditText.setOnKeyListener(new View.OnKeyListener() {
public boolean onKey(View v, int keyCode, KeyEvent event) {
// If the event is a key-down on the "enter" button, select the PositiveButton "Create".
if ((event.getAction() == KeyEvent.ACTION_DOWN) && (keyCode == KeyEvent.KEYCODE_ENTER)) {
- // Trigger the create listener.
- createBookmarkListener.onCreateBookmarkCreate(CreateBookmark.this);
-
- // Manually dismiss the AlertDialog.
- createBookmarkDialog.dismiss();
-
+ // Trigger `createBookmarkListener` and return the DialogFragment to the parent activity.
+ createBookmarkListener.onCreateBookmark(CreateBookmark.this);
+ // Manually dismiss the `AlertDialog`.
+ alertDialog.dismiss();
// Consume the event.
return true;
} else { // If any other key was pressed, do not consume the event.
}
});
- // onCreateDialog requires the return of an AlertDialog
- return createBookmarkDialog;
+ // `onCreateDialog()` requires the return of an `AlertDialog`.
+ return alertDialog;
}
}
\ No newline at end of file