app/src/main/java/com/stoutner/privacybrowser/activities/BookmarksActivity.java

   1 /*
   2  * Copyright © 2016-2018 Soren Stoutner <soren@stoutner.com>.
   3  *
   4  * This file is part of Privacy Browser <https://www.stoutner.com/privacy-browser>.
   5  *
   6  * Privacy Browser is free software: you can redistribute it and/or modify
   7  * it under the terms of the GNU General Public License as published by
   8  * the Free Software Foundation, either version 3 of the License, or
   9  * (at your option) any later version.
  10  *
  11  * Privacy Browser is distributed in the hope that it will be useful,
  12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  14  * GNU General Public License for more details.
  15  *
  16  * You should have received a copy of the GNU General Public License
  17  * along with Privacy Browser.  If not, see <http://www.gnu.org/licenses/>.
  18  */
  19
  20 package com.stoutner.privacybrowser.activities;
  21
  22 import android.app.Activity;
  23 import android.content.Context;
  24 import android.content.Intent;
  25 import android.database.Cursor;
  26 import android.graphics.Bitmap;
  27 import android.graphics.BitmapFactory;
  28 import android.graphics.Typeface;
  29 import android.graphics.drawable.BitmapDrawable;
  30 import android.graphics.drawable.Drawable;
  31 import android.os.Bundle;
  32 import android.support.design.widget.FloatingActionButton;
  33 import android.support.design.widget.Snackbar;
  34 import android.support.v4.app.NavUtils;
  35 import android.support.v7.app.ActionBar;
  36 import android.support.v7.app.AppCompatActivity;
  37 // `AppCompatDialogFragment` is required instead of `DialogFragment` or an error is produced on API <=22.
  38 import android.support.v7.app.AppCompatDialogFragment;
  39 import android.support.v7.widget.Toolbar;
  40 import android.util.SparseBooleanArray;
  41 import android.view.ActionMode;
  42 import android.view.Menu;
  43 import android.view.MenuItem;
  44 import android.view.View;
  45 import android.view.ViewGroup;
  46 import android.view.WindowManager;
  47 import android.widget.AbsListView;
  48 import android.widget.CursorAdapter;
  49 import android.widget.EditText;
  50 import android.widget.ImageView;
  51 import android.widget.ListView;
  52 import android.widget.RadioButton;
  53 import android.widget.TextView;
  54
  55 import com.stoutner.privacybrowser.dialogs.CreateBookmarkDialog;
  56 import com.stoutner.privacybrowser.dialogs.CreateBookmarkFolderDialog;
  57 import com.stoutner.privacybrowser.dialogs.EditBookmarkDialog;
  58 import com.stoutner.privacybrowser.dialogs.EditBookmarkFolderDialog;
  59 import com.stoutner.privacybrowser.dialogs.MoveToFolderDialog;
  60 import com.stoutner.privacybrowser.R;
  61 import com.stoutner.privacybrowser.helpers.BookmarksDatabaseHelper;
  62
  63 import java.io.ByteArrayOutputStream;
  64
  65 public class BookmarksActivity extends AppCompatActivity implements CreateBookmarkDialog.CreateBookmarkListener, CreateBookmarkFolderDialog.CreateBookmarkFolderListener, EditBookmarkDialog.EditBookmarkListener,
  66         EditBookmarkFolderDialog.EditBookmarkFolderListener, MoveToFolderDialog.MoveToFolderListener {
  67
  68     // `currentFolder` is public static so it can be accessed from `MoveToFolderDialog`.
  69     // It is used in `onCreate`, `onOptionsItemSelected()`, `onBackPressed()`, `onCreateBookmark()`, `onCreateBookmarkFolder()`, `onSaveBookmark()`, `onSaveBookmarkFolder()`, `onMoveToFolder()`, and `loadFolder()`.
  70     public static String currentFolder;
  71
  72     // `checkedItemIds` is public static so it can be accessed from `MoveToFolderDialog`.  It is also used in `onCreate()`, `onSaveBookmark()`, `onSaveBookmarkFolder()`, `onMoveToFolder()`, and `updateMoveIcons()`.
  73     public static long[] checkedItemIds;
  74
  75
  76     // `bookmarksDatabaseHelper` is used in `onCreate()`, `onOptionsItemSelected()`, `onBackPressed()`, `onCreateBookmark()`, `onCreateBookmarkFolder()`, `onSaveBookmark()`, `onSaveBookmarkFolder()`, `onMoveToFolder()`, `deleteBookmarkFolderContents()`,
  77     // and `loadFolder().
  78     private BookmarksDatabaseHelper bookmarksDatabaseHelper;
  79
  80     // `bookmarksListView` is used in `onCreate()`, `onOptionsItemSelected()`, `onCreateBookmark()`, `onCreateBookmarkFolder()`, `onSaveBookmark()`, `onSaveBookmarkFolder()`, `onMoveToFolder()`, `updateMoveIcons()`, `scrollBookmarks()`,
  81     // and `loadFolder()`.
  82     private ListView bookmarksListView;
  83
  84     // `bookmarksCursor` is used in `onCreate()`, `onCreateBookmark()`, `onCreateBookmarkFolder()`, `onSaveBookmark()`, `onSaveBookmarkFolder()`, `onMoveToFolder()`, `deleteBookmarkFolderContents()`, and `loadFolder()`.
  85     private Cursor bookmarksCursor;
  86
  87     // `bookmarksCursorAdapter` is used in `onCreate(), `onCreateBookmark()`, `onCreateBookmarkFolder()`, `onSaveBookmark()`, `onSaveBookmarkFolder()`, `onMoveToFolder()`, and `onLoadFolder()`.
  88     private CursorAdapter bookmarksCursorAdapter;
  89
  90     // `contextualActionMode` is used in `onCreate()`, `onSaveEditBookmark()`, `onSaveEditBookmarkFolder()` and `onMoveToFolder()`.
  91     private ActionMode contextualActionMode;
  92
  93     // `appBar` is used in `onCreate()` and `loadFolder()`.
  94     private ActionBar appBar;
  95
  96     // `oldFolderName` is used in `onCreate()` and `onSaveBookmarkFolder()`.
  97     private String oldFolderNameString;
  98
  99     // `moveBookmarkUpMenuItem` is used in `onCreate()` and `updateMoveIcons`.
 100     private MenuItem moveBookmarkUpMenuItem;
 101
 102     // `moveBookmarkDownMenuItem` is used in `onCreate()` and `updateMoveIcons`.
 103     private MenuItem moveBookmarkDownMenuItem;
 104
 105     @Override
 106     protected void onCreate(Bundle savedInstanceState) {
 107         // Disable screenshots if not allowed.
 108         if (!MainWebViewActivity.allowScreenshots) {
 109             getWindow().addFlags(WindowManager.LayoutParams.FLAG_SECURE);
 110         }
 111
 112         // Set the activity theme.
 113         if (MainWebViewActivity.darkTheme) {
 114             setTheme(R.style.PrivacyBrowserDark_SecondaryActivity);
 115         } else {
 116             setTheme(R.style.PrivacyBrowserLight_SecondaryActivity);
 117         }
 118
 119         // Run the default commands.
 120         super.onCreate(savedInstanceState);
 121
 122         // Get the intent that launched the activity.
 123         Intent launchingIntent = getIntent();
 124
 125         // Set the current folder variable.
 126         if (launchingIntent.getStringExtra("Current Folder") != null) {  // Set the current folder from the intent.
 127             currentFolder = launchingIntent.getStringExtra("Current Folder");
 128         } else {  // Set the current folder to be `""`, which is the home folder.
 129             currentFolder = "";
 130         }
 131
 132         // Set the content view.
 133         setContentView(R.layout.bookmarks_coordinatorlayout);
 134
 135         // Use the `SupportActionBar` from `android.support.v7.app.ActionBar` until the minimum API is >= 21.
 136         final Toolbar bookmarksAppBar = findViewById(R.id.bookmarks_toolbar);
 137         setSupportActionBar(bookmarksAppBar);
 138
 139         // Get a handle for the activity, the app bar, and the ListView.
 140         final Activity bookmarksActivity = this;
 141         appBar = getSupportActionBar();
 142         bookmarksListView = findViewById(R.id.bookmarks_listview);
 143
 144         // Remove the incorrect lint warning that `appBar` might be null.
 145         assert appBar != null;
 146
 147         // Display the home arrow on the app bar.
 148         appBar.setDisplayHomeAsUpEnabled(true);
 149
 150         // Initialize the database helper.  `this` specifies the context.  The two `nulls` do not specify the database name or a `CursorFactory`.
 151         // The `0` specifies a database version, but that is ignored and set instead using a constant in `BookmarksDatabaseHelper`.
 152         bookmarksDatabaseHelper = new BookmarksDatabaseHelper(this, null, null, 0);
 153
 154         // Load the home folder.
 155         loadFolder();
 156
 157         // Set a listener so that tapping a list item loads the URL or folder.
 158         bookmarksListView.setOnItemClickListener((parent, view, position, id) -> {
 159             // Convert the id from long to int to match the format of the bookmarks database.
 160             int databaseID = (int) id;
 161
 162             // Get the bookmark cursor for this ID and move it to the first row.
 163             Cursor bookmarkCursor = bookmarksDatabaseHelper.getBookmarkCursor(databaseID);
 164             bookmarkCursor.moveToFirst();
 165
 166             // Act upon the bookmark according to the type.
 167             if (bookmarkCursor.getInt(bookmarkCursor.getColumnIndex(BookmarksDatabaseHelper.IS_FOLDER)) == 1) {  // The selected bookmark is a folder.
 168                 // Update the current folder.
 169                 currentFolder = bookmarkCursor.getString(bookmarkCursor.getColumnIndex(BookmarksDatabaseHelper.BOOKMARK_NAME));
 170
 171                 // Load the new folder.
 172                 loadFolder();
 173             } else {  // The selected bookmark is not a folder.
 174                 // Get the bookmark URL and assign it to `formattedUrlString`.
 175                 MainWebViewActivity.formattedUrlString = bookmarkCursor.getString(bookmarkCursor.getColumnIndex(BookmarksDatabaseHelper.BOOKMARK_URL));
 176
 177                 // Set `MainWebViewActivity` to load the new URL on restart.
 178                 MainWebViewActivity.loadUrlOnRestart = true;
 179
 180                 // Update the bookmarks folder for the bookmarks drawer in `MainWebViewActivity`.
 181                 MainWebViewActivity.currentBookmarksFolder = currentFolder;
 182
 183                 // Close the bookmarks drawer and reload the bookmarks `ListView` when returning to `MainWebViewActivity`.
 184                 MainWebViewActivity.restartFromBookmarksActivity = true;
 185
 186                 // Return to `MainWebViewActivity`.
 187                 NavUtils.navigateUpFromSameTask(bookmarksActivity);
 188             }
 189
 190             // Close the `Cursor`.
 191             bookmarkCursor.close();
 192         });
 193
 194         // `MultiChoiceModeListener` handles long clicks.
 195         bookmarksListView.setMultiChoiceModeListener(new AbsListView.MultiChoiceModeListener() {
 196             // Instantiate the common variables.
 197             MenuItem editBookmarkMenuItem;
 198             MenuItem deleteBookmarksMenuItem;
 199             MenuItem selectAllBookmarksMenuItem;
 200             boolean deletingBookmarks;
 201
 202             @Override
 203             public boolean onCreateActionMode(ActionMode mode, Menu menu) {
 204                 // Inflate the menu for the contextual app bar and set the title.
 205                 getMenuInflater().inflate(R.menu.bookmarks_context_menu, menu);
 206
 207                 // Set the title.
 208                 if (currentFolder.isEmpty()) {
 209                     // Use `R.string.bookmarks` if we are in the home folder.
 210                     mode.setTitle(R.string.bookmarks);
 211                 } else {  // Use the current folder name as the title.
 212                     mode.setTitle(currentFolder);
 213                 }
 214
 215                 // Get a handle for `MenuItems` that need to be selectively disabled.
 216                 moveBookmarkUpMenuItem = menu.findItem(R.id.move_bookmark_up);
 217                 moveBookmarkDownMenuItem = menu.findItem(R.id.move_bookmark_down);
 218                 editBookmarkMenuItem = menu.findItem(R.id.edit_bookmark);
 219                 deleteBookmarksMenuItem = menu.findItem(R.id.delete_bookmark);
 220                 selectAllBookmarksMenuItem = menu.findItem(R.id.context_menu_select_all_bookmarks);
 221
 222                 // Disable the delete bookmarks menu item if a delete is pending.
 223                 if (deletingBookmarks) {
 224                     deleteBookmarksMenuItem.setEnabled(false);
 225                 }
 226
 227                 // Store `contextualActionMode` so it can be closed programatically.
 228                 contextualActionMode = mode;
 229
 230                 // Make it so.
 231                 return true;
 232             }
 233
 234             @Override
 235             public boolean onPrepareActionMode(ActionMode mode, Menu menu) {
 236                 // Get a handle for the move to folder menu item.
 237                 MenuItem moveToFolderMenuItem = menu.findItem(R.id.move_to_folder);
 238
 239                 // Get a `Cursor` with all of the folders.
 240                 Cursor folderCursor = bookmarksDatabaseHelper.getAllFoldersCursor();
 241
 242                 // Enable the move to folder menu item if at least one folder exists.
 243                 moveToFolderMenuItem.setVisible(folderCursor.getCount() > 0);
 244
 245                 // Make it so.
 246                 return true;
 247             }
 248
 249             @Override
 250             public void onItemCheckedStateChanged(ActionMode mode, int position, long id, boolean checked) {
 251                 // Get a long array of the selected bookmarks.
 252                 long[] selectedBookmarksLongArray = bookmarksListView.getCheckedItemIds();
 253
 254                 // Calculate the number of selected bookmarks.
 255                 int numberOfSelectedBookmarks = selectedBookmarksLongArray.length;
 256
 257                 // Adjust the `ActionMode` and the `Menu` according to the number of selected bookmarks.
 258                 if (numberOfSelectedBookmarks == 0) {  // No bookmarks are selected.
 259                     // Close the `ActionMode`.
 260                     mode.finish();
 261                 } else if (numberOfSelectedBookmarks == 1) {  // One bookmark is selected.
 262                     // List the number of selected bookmarks in the subtitle.
 263                     mode.setSubtitle(getString(R.string.one_selected));
 264
 265                     // Show the `Move Up`, `Move Down`, and  `Edit` options.
 266                     moveBookmarkUpMenuItem.setVisible(true);
 267                     moveBookmarkDownMenuItem.setVisible(true);
 268                     editBookmarkMenuItem.setVisible(true);
 269
 270                     // Update the enabled status of the move icons.
 271                     updateMoveIcons();
 272                 } else {  // More than one bookmark is selected.
 273                     // List the number of selected bookmarks in the subtitle.
 274                     mode.setSubtitle(numberOfSelectedBookmarks + " " + getString(R.string.selected));
 275
 276                     // Hide non-applicable `MenuItems`.
 277                     moveBookmarkUpMenuItem.setVisible(false);
 278                     moveBookmarkDownMenuItem.setVisible(false);
 279                     editBookmarkMenuItem.setVisible(false);
 280                 }
 281
 282                 // Do not show `Select All` if all the bookmarks are already checked.
 283                 if (bookmarksListView.getCheckedItemIds().length == bookmarksListView.getCount()) {
 284                     selectAllBookmarksMenuItem.setVisible(false);
 285                 } else {
 286                     selectAllBookmarksMenuItem.setVisible(true);
 287                 }
 288             }
 289
 290             @Override
 291             public boolean onActionItemClicked(ActionMode mode, MenuItem item) {
 292                 // Get the menu item ID.
 293                 int menuItemId = item.getItemId();
 294
 295                 // Instantiate the common variables.
 296                 int selectedBookmarkPosition;
 297                 int selectedBookmarkNewPosition;
 298                 final SparseBooleanArray selectedBookmarksPositionsSparseBooleanArray;
 299
 300                 switch (menuItemId) {
 301                     case R.id.move_bookmark_up:
 302                         // Get the array of checked bookmark positions.
 303                         selectedBookmarksPositionsSparseBooleanArray = bookmarksListView.getCheckedItemPositions();
 304
 305                         // Store the position of the selected bookmark.  Only one bookmark is selected when `move_bookmark_up` is enabled.
 306                         selectedBookmarkPosition = selectedBookmarksPositionsSparseBooleanArray.keyAt(0);
 307
 308                         // Calculate the new position of the selected bookmark.
 309                         selectedBookmarkNewPosition = selectedBookmarkPosition - 1;
 310
 311                         // Iterate through the bookmarks.
 312                         for (int i = 0; i < bookmarksListView.getCount(); i++) {
 313                             // Get the database ID for the current bookmark.
 314                             int currentBookmarkDatabaseId = (int) bookmarksListView.getItemIdAtPosition(i);
 315
 316                             // Update the display order for the current bookmark.
 317                             if (i == selectedBookmarkPosition) {  // The current bookmark is the selected bookmark.
 318                                 // Move the current bookmark up one.
 319                                 bookmarksDatabaseHelper.updateDisplayOrder(currentBookmarkDatabaseId, i - 1);
 320                             } else if ((i + 1) == selectedBookmarkPosition){  // The current bookmark is immediately above the selected bookmark.
 321                                 // Move the current bookmark down one.
 322                                 bookmarksDatabaseHelper.updateDisplayOrder(currentBookmarkDatabaseId, i + 1);
 323                             } else {  // The current bookmark is not changing positions.
 324                                 // Move `bookmarksCursor` to the current bookmark position.
 325                                 bookmarksCursor.moveToPosition(i);
 326
 327                                 // Update the display order only if it is not correct in the database.
 328                                 if (bookmarksCursor.getInt(bookmarksCursor.getColumnIndex(BookmarksDatabaseHelper.DISPLAY_ORDER)) != i) {
 329                                     bookmarksDatabaseHelper.updateDisplayOrder(currentBookmarkDatabaseId, i);
 330                                 }
 331                             }
 332                         }
 333
 334                         // Update `bookmarksCursor` with the current contents of the bookmarks database.
 335                         bookmarksCursor = bookmarksDatabaseHelper.getAllBookmarksCursorByDisplayOrder(currentFolder);
 336
 337                         // Update the `ListView`.
 338                         bookmarksCursorAdapter.changeCursor(bookmarksCursor);
 339
 340                         // Scroll with the bookmark.
 341                         scrollBookmarks(selectedBookmarkNewPosition);
 342
 343                         // Update the enabled status of the move icons.
 344                         updateMoveIcons();
 345                         break;
 346
 347                     case R.id.move_bookmark_down:
 348                         // Get the array of checked bookmark positions.
 349                         selectedBookmarksPositionsSparseBooleanArray = bookmarksListView.getCheckedItemPositions();
 350
 351                         // Store the position of the selected bookmark.  Only one bookmark is selected when `move_bookmark_down` is enabled.
 352                         selectedBookmarkPosition = selectedBookmarksPositionsSparseBooleanArray.keyAt(0);
 353
 354                         // Calculate the new position of the selected bookmark.
 355                         selectedBookmarkNewPosition = selectedBookmarkPosition + 1;
 356
 357                         // Iterate through the bookmarks.
 358                         for (int i = 0; i <bookmarksListView.getCount(); i++) {
 359                             // Get the database ID for the current bookmark.
 360                             int currentBookmarkDatabaseId = (int) bookmarksListView.getItemIdAtPosition(i);
 361
 362                             // Update the display order for the current bookmark.
 363                             if (i == selectedBookmarkPosition) {  // The current bookmark is the selected bookmark.
 364                                 // Move the current bookmark down one.
 365                                 bookmarksDatabaseHelper.updateDisplayOrder(currentBookmarkDatabaseId, i + 1);
 366                             } else if ((i - 1) == selectedBookmarkPosition) {  // The current bookmark is immediately below the selected bookmark.
 367                                 // Move the bookmark below the selected bookmark up one.
 368                                 bookmarksDatabaseHelper.updateDisplayOrder(currentBookmarkDatabaseId, i - 1);
 369                             } else {  // The current bookmark is not changing positions.
 370                                 // Move `bookmarksCursor` to the current bookmark position.
 371                                 bookmarksCursor.moveToPosition(i);
 372
 373                                 // Update the display order only if it is not correct in the database.
 374                                 if (bookmarksCursor.getInt(bookmarksCursor.getColumnIndex(BookmarksDatabaseHelper.DISPLAY_ORDER)) != i) {
 375                                     bookmarksDatabaseHelper.updateDisplayOrder(currentBookmarkDatabaseId, i);
 376                                 }
 377                             }
 378                         }
 379
 380                         // Update `bookmarksCursor` with the current contents of the bookmarks database.
 381                         bookmarksCursor = bookmarksDatabaseHelper.getAllBookmarksCursorByDisplayOrder(currentFolder);
 382
 383                         // Update the `ListView`.
 384                         bookmarksCursorAdapter.changeCursor(bookmarksCursor);
 385
 386                         // Scroll with the bookmark.
 387                         scrollBookmarks(selectedBookmarkNewPosition);
 388
 389                         // Update the enabled status of the move icons.
 390                         updateMoveIcons();
 391                         break;
 392
 393                     case R.id.move_to_folder:
 394                         // Store `checkedItemIds` for use by the `AlertDialog`.
 395                         checkedItemIds = bookmarksListView.getCheckedItemIds();
 396
 397                         // Show the `MoveToFolderDialog` `AlertDialog` and name the instance `@string/move_to_folder
 398                         AppCompatDialogFragment moveToFolderDialog = new MoveToFolderDialog();
 399                         moveToFolderDialog.show(getSupportFragmentManager(), getResources().getString(R.string.move_to_folder));
 400                         break;
 401
 402                     case R.id.edit_bookmark:
 403                         // Get the array of checked bookmark positions.
 404                         selectedBookmarksPositionsSparseBooleanArray = bookmarksListView.getCheckedItemPositions();
 405
 406                         // Get the position of the selected bookmark.  Only one bookmark is selected when `edit_bookmark_down` is enabled.
 407                         selectedBookmarkPosition = selectedBookmarksPositionsSparseBooleanArray.keyAt(0);
 408
 409                         // Move the `Cursor` to the selected position and find out if it is a folder.
 410                         bookmarksCursor.moveToPosition(selectedBookmarkPosition);
 411                         boolean isFolder = (bookmarksCursor.getInt(bookmarksCursor.getColumnIndex(BookmarksDatabaseHelper.IS_FOLDER)) == 1);
 412
 413                         // Get the selected bookmark database ID.
 414                         int databaseId = bookmarksCursor.getInt(bookmarksCursor.getColumnIndex(BookmarksDatabaseHelper._ID));
 415
 416                         // Show the edit bookmark or edit bookmark folder dialog.
 417                         if (isFolder) {
 418                             // Save the current folder name, which is used in `onSaveBookmarkFolder()`.
 419                             oldFolderNameString = bookmarksCursor.getString(bookmarksCursor.getColumnIndex(BookmarksDatabaseHelper.BOOKMARK_NAME));
 420
 421                             // Show the edit bookmark folder dialog.
 422                             AppCompatDialogFragment editFolderDialog = EditBookmarkFolderDialog.folderDatabaseId(databaseId);
 423                             editFolderDialog.show(getSupportFragmentManager(), getResources().getString(R.string.edit_folder));
 424                         } else {
 425                             // Show the edit bookmark dialog.
 426                             AppCompatDialogFragment editBookmarkDialog = EditBookmarkDialog.bookmarkDatabaseId(databaseId);
 427                             editBookmarkDialog.show(getSupportFragmentManager(), getResources().getString(R.string.edit_bookmark));
 428                         }
 429                         break;
 430
 431                     case R.id.delete_bookmark:
 432                         // Set the deleting bookmarks flag, which prevents the delete menu item from being enabled until the current process finishes.
 433                         deletingBookmarks = true;
 434
 435                         // Get an array of the selected row IDs.
 436                         final long[] selectedBookmarksIdsLongArray = bookmarksListView.getCheckedItemIds();
 437
 438                         // Get the array of checked bookmarks.  `.clone()` makes a copy that won't change if `bookmarksListView` is reloaded, which is needed for re-selecting the bookmarks on undelete.
 439                         selectedBookmarksPositionsSparseBooleanArray = bookmarksListView.getCheckedItemPositions().clone();
 440
 441                         // Update `bookmarksCursor` with the current contents of the bookmarks database except for the specified database IDs.
 442                         bookmarksCursor = bookmarksDatabaseHelper.getBookmarksCursorExcept(selectedBookmarksIdsLongArray, currentFolder);
 443
 444                         // Update the `ListView`.
 445                         bookmarksCursorAdapter.changeCursor(bookmarksCursor);
 446
 447                         // Instantiate `snackbarMessage`.
 448                         String snackbarMessage;
 449
 450                         // Determine how many items are in the array and prepare an appropriate `Snackbar` message.
 451                         if (selectedBookmarksIdsLongArray.length == 1) {
 452                             snackbarMessage = getString(R.string.one_bookmark_deleted);
 453                         } else {
 454                             snackbarMessage = selectedBookmarksIdsLongArray.length + " " + getString(R.string.bookmarks_deleted);
 455                         }
 456
 457                         // Show a SnackBar.
 458                         Snackbar.make(findViewById(R.id.bookmarks_coordinatorlayout), snackbarMessage, Snackbar.LENGTH_LONG)
 459                                 .setAction(R.string.undo, view -> {
 460                                     // Do nothing because everything will be handled by `onDismissed()` below.
 461                                 })
 462                                 .addCallback(new Snackbar.Callback() {
 463                                     @Override
 464                                     public void onDismissed(Snackbar snackbar, int event) {
 465                                         switch (event) {
 466                                             // The user pushed the `Undo` button.
 467                                             case Snackbar.Callback.DISMISS_EVENT_ACTION:
 468                                                 // Update `bookmarksCursor` with the current contents of the bookmarks database, including the "deleted" bookmarks.
 469                                                 bookmarksCursor = bookmarksDatabaseHelper.getAllBookmarksCursorByDisplayOrder(currentFolder);
 470
 471                                                 // Update the `ListView`.
 472                                                 bookmarksCursorAdapter.changeCursor(bookmarksCursor);
 473
 474                                                 // Re-select the previously selected bookmarks.
 475                                                 for (int i = 0; i < selectedBookmarksPositionsSparseBooleanArray.size(); i++) {
 476                                                     bookmarksListView.setItemChecked(selectedBookmarksPositionsSparseBooleanArray.keyAt(i), true);
 477                                                 }
 478
 479                                                 break;
 480
 481                                             // The `Snackbar` was dismissed without the `Undo` button being pushed.
 482                                             default:
 483                                                 // Delete each selected bookmark.
 484                                                 for (long databaseIdLong : selectedBookmarksIdsLongArray) {
 485                                                     // Convert `databaseIdLong` to an int.
 486                                                     int databaseIdInt = (int) databaseIdLong;
 487
 488                                                     // Delete the contents of the folder if the selected bookmark is a folder.
 489                                                     if (bookmarksDatabaseHelper.isFolder(databaseIdInt)) {
 490                                                         deleteBookmarkFolderContents(databaseIdInt);
 491                                                     }
 492
 493                                                     // Delete the selected bookmark.
 494                                                     bookmarksDatabaseHelper.deleteBookmark(databaseIdInt);
 495                                                 }
 496
 497                                                 // Update the display order.
 498                                                 for (int i = 0; i < bookmarksListView.getCount(); i++) {
 499                                                     // Get the database ID for the current bookmark.
 500                                                     int currentBookmarkDatabaseId = (int) bookmarksListView.getItemIdAtPosition(i);
 501
 502                                                     // Move `bookmarksCursor` to the current bookmark position.
 503                                                     bookmarksCursor.moveToPosition(i);
 504
 505                                                     // Update the display order only if it is not correct in the database.
 506                                                     if (bookmarksCursor.getInt(bookmarksCursor.getColumnIndex(BookmarksDatabaseHelper.DISPLAY_ORDER)) != i) {
 507                                                         bookmarksDatabaseHelper.updateDisplayOrder(currentBookmarkDatabaseId, i);
 508                                                     }
 509                                                 }
 510                                         }
 511
 512                                         // Enable the delete bookmarks menu item.
 513                                         deleteBookmarksMenuItem.setEnabled(true);
 514
 515                                         // Reset the deleting bookmarks flag.
 516                                         deletingBookmarks = false;
 517                                     }
 518                                 })
 519                                 //Show the `SnackBar`.
 520                                 .show();
 521
 522                         // Close the `ActionBar`.
 523                         mode.finish();
 524                         break;
 525
 526                     case R.id.context_menu_select_all_bookmarks:
 527                         // Get the total number of bookmarks.
 528                         int numberOfBookmarks = bookmarksListView.getCount();
 529
 530                         // Select them all.
 531                         for (int i = 0; i < numberOfBookmarks; i++) {
 532                             bookmarksListView.setItemChecked(i, true);
 533                         }
 534                         break;
 535                 }
 536
 537                 // Consume the click.
 538                 return true;
 539             }
 540
 541             @Override
 542             public void onDestroyActionMode(ActionMode mode) {
 543                 // Do nothing.
 544             }
 545         });
 546
 547         // Get handles for the `FloatingActionButtons`.
 548         FloatingActionButton createBookmarkFolderFab = findViewById(R.id.create_bookmark_folder_fab);
 549         FloatingActionButton createBookmarkFab = findViewById(R.id.create_bookmark_fab);
 550
 551         // Set the create new bookmark folder FAB to display the `AlertDialog`.
 552         createBookmarkFolderFab.setOnClickListener(v -> {
 553             // Show the `CreateBookmarkFolderDialog` `AlertDialog` and name the instance `@string/create_folder`.
 554             AppCompatDialogFragment createBookmarkFolderDialog = new CreateBookmarkFolderDialog();
 555             createBookmarkFolderDialog.show(getSupportFragmentManager(), getResources().getString(R.string.create_folder));
 556         });
 557
 558         // Set the create new bookmark FAB to display the `AlertDialog`.
 559         createBookmarkFab.setOnClickListener(view -> {
 560             // Show the `CreateBookmarkDialog` `AlertDialog` and name the instance `@string/create_bookmark`.
 561             AppCompatDialogFragment createBookmarkDialog = new CreateBookmarkDialog();
 562             createBookmarkDialog.show(getSupportFragmentManager(), getResources().getString(R.string.create_bookmark));
 563         });
 564     }
 565
 566     @Override
 567     public boolean onCreateOptionsMenu(Menu menu) {
 568         // Inflate the menu.
 569         getMenuInflater().inflate(R.menu.bookmarks_options_menu, menu);
 570
 571         // Success.
 572         return true;
 573     }
 574
 575     @Override
 576     public boolean onOptionsItemSelected(MenuItem menuItem) {
 577         // Get the ID of the `MenuItem` that was selected.
 578         int menuItemId = menuItem.getItemId();
 579
 580         switch (menuItemId) {
 581             case android.R.id.home:  // The home arrow is identified as `android.R.id.home`, not just `R.id.home`.
 582                 if (currentFolder.isEmpty()) {  // Currently in the home folder.
 583                     // Update the bookmarks folder for the bookmarks drawer in `MainWebViewActivity`.
 584                     MainWebViewActivity.currentBookmarksFolder = "";
 585
 586                     // Close the bookmarks drawer and reload the bookmarks `ListView` when returning to `MainWebViewActivity`.
 587                     MainWebViewActivity.restartFromBookmarksActivity = true;
 588
 589                     // Return to `MainWebViewActivity`.
 590                     NavUtils.navigateUpFromSameTask(this);
 591                 } else {  // Currently in a subfolder.
 592                     // Place the former parent folder in `currentFolder`.
 593                     currentFolder = bookmarksDatabaseHelper.getParentFolder(currentFolder);
 594
 595                     // Load the new folder.
 596                     loadFolder();
 597                 }
 598                 break;
 599
 600             case R.id.options_menu_select_all_bookmarks:
 601                 // Get the total number of bookmarks.
 602                 int numberOfBookmarks = bookmarksListView.getCount();
 603
 604                 // Select them all.
 605                 for (int i = 0; i < numberOfBookmarks; i++) {
 606                     bookmarksListView.setItemChecked(i, true);
 607                 }
 608                 break;
 609
 610             case R.id.bookmarks_database_view:
 611                 // Launch `BookmarksDatabaseViewActivity`.
 612                 Intent bookmarksDatabaseViewIntent = new Intent(this, BookmarksDatabaseViewActivity.class);
 613                 startActivity(bookmarksDatabaseViewIntent);
 614                 break;
 615         }
 616         return true;
 617     }
 618
 619     @Override
 620     public void onBackPressed() {
 621         if (currentFolder.isEmpty()) {  // Currently in the home folder.
 622             // Update the bookmarks folder for the bookmarks drawer in `MainWebViewActivity`.
 623             MainWebViewActivity.currentBookmarksFolder = "";
 624
 625             // Close the bookmarks drawer and reload the bookmarks `ListView` when returning to `MainWebViewActivity`.
 626             MainWebViewActivity.restartFromBookmarksActivity = true;
 627
 628             // Exit `BookmarksActivity`.
 629             super.onBackPressed();
 630         } else {  // Currently in a subfolder.
 631             // Place the former parent folder in `currentFolder`.
 632             currentFolder = bookmarksDatabaseHelper.getParentFolder(currentFolder);
 633
 634             // Load the new folder.
 635             loadFolder();
 636         }
 637     }
 638
 639     @Override
 640     public void onCreateBookmark(AppCompatDialogFragment dialogFragment) {
 641         // Get the `EditTexts` from the `dialogFragment`.
 642         EditText createBookmarkNameEditText = dialogFragment.getDialog().findViewById(R.id.create_bookmark_name_edittext);
 643         EditText createBookmarkUrlEditText = dialogFragment.getDialog().findViewById(R.id.create_bookmark_url_edittext);
 644
 645         // Extract the strings from the `EditTexts`.
 646         String bookmarkNameString = createBookmarkNameEditText.getText().toString();
 647         String bookmarkUrlString = createBookmarkUrlEditText.getText().toString();
 648
 649         // Convert the favoriteIcon Bitmap to a byte array.  `0` is for lossless compression (the only option for a PNG).
 650         ByteArrayOutputStream favoriteIconByteArrayOutputStream = new ByteArrayOutputStream();
 651         MainWebViewActivity.favoriteIconBitmap.compress(Bitmap.CompressFormat.PNG, 0, favoriteIconByteArrayOutputStream);
 652         byte[] favoriteIconByteArray = favoriteIconByteArrayOutputStream.toByteArray();
 653
 654         // Display the new bookmark below the current items in the (0 indexed) list.
 655         int newBookmarkDisplayOrder = bookmarksListView.getCount();
 656
 657         // Create the bookmark.
 658         bookmarksDatabaseHelper.createBookmark(bookmarkNameString, bookmarkUrlString, currentFolder, newBookmarkDisplayOrder, favoriteIconByteArray);
 659
 660         // Update `bookmarksCursor` with the current contents of this folder.
 661         bookmarksCursor = bookmarksDatabaseHelper.getAllBookmarksCursorByDisplayOrder(currentFolder);
 662
 663         // Update the `ListView`.
 664         bookmarksCursorAdapter.changeCursor(bookmarksCursor);
 665
 666         // Scroll to the new bookmark.
 667         bookmarksListView.setSelection(newBookmarkDisplayOrder);
 668     }
 669
 670     @Override
 671     public void onCreateBookmarkFolder(AppCompatDialogFragment dialogFragment) {
 672         // Get handles for the views in `dialogFragment`.
 673         EditText createFolderNameEditText = dialogFragment.getDialog().findViewById(R.id.create_folder_name_edittext);
 674         RadioButton defaultFolderIconRadioButton = dialogFragment.getDialog().findViewById(R.id.create_folder_default_icon_radiobutton);
 675         ImageView folderIconImageView = dialogFragment.getDialog().findViewById(R.id.create_folder_default_icon);
 676
 677         // Get new folder name string.
 678         String folderNameString = createFolderNameEditText.getText().toString();
 679
 680         // Get the new folder icon `Bitmap`.
 681         Bitmap folderIconBitmap;
 682         if (defaultFolderIconRadioButton.isChecked()) {  // Use the default folder icon.
 683             // Get the default folder icon and convert it to a `Bitmap`.
 684             Drawable folderIconDrawable = folderIconImageView.getDrawable();
 685             BitmapDrawable folderIconBitmapDrawable = (BitmapDrawable) folderIconDrawable;
 686             folderIconBitmap = folderIconBitmapDrawable.getBitmap();
 687         } else {  // Use the `WebView` favorite icon.
 688             folderIconBitmap = MainWebViewActivity.favoriteIconBitmap;
 689         }
 690
 691         // Convert `folderIconBitmap` to a byte array.  `0` is for lossless compression (the only option for a PNG).
 692         ByteArrayOutputStream folderIconByteArrayOutputStream = new ByteArrayOutputStream();
 693         folderIconBitmap.compress(Bitmap.CompressFormat.PNG, 0, folderIconByteArrayOutputStream);
 694         byte[] folderIconByteArray = folderIconByteArrayOutputStream.toByteArray();
 695
 696         // Move all the bookmarks down one in the display order.
 697         for (int i = 0; i < bookmarksListView.getCount(); i++) {
 698             int databaseId = (int) bookmarksListView.getItemIdAtPosition(i);
 699             bookmarksDatabaseHelper.updateDisplayOrder(databaseId, i + 1);
 700         }
 701
 702         // Create the folder, which will be placed at the top of the `ListView`.
 703         bookmarksDatabaseHelper.createFolder(folderNameString, currentFolder, folderIconByteArray);
 704
 705         // Update `bookmarksCursor` with the current contents of this folder.
 706         bookmarksCursor = bookmarksDatabaseHelper.getAllBookmarksCursorByDisplayOrder(currentFolder);
 707
 708         // Update the `ListView`.
 709         bookmarksCursorAdapter.changeCursor(bookmarksCursor);
 710
 711         // Scroll to the new folder.
 712         bookmarksListView.setSelection(0);
 713     }
 714
 715     @Override
 716     public void onSaveBookmark(AppCompatDialogFragment dialogFragment, int selectedBookmarkDatabaseId) {
 717         // Get handles for the views from `dialogFragment`.
 718         EditText editBookmarkNameEditText = dialogFragment.getDialog().findViewById(R.id.edit_bookmark_name_edittext);
 719         EditText editBookmarkUrlEditText = dialogFragment.getDialog().findViewById(R.id.edit_bookmark_url_edittext);
 720         RadioButton currentBookmarkIconRadioButton = dialogFragment.getDialog().findViewById(R.id.edit_bookmark_current_icon_radiobutton);
 721
 722         // Store the bookmark strings.
 723         String bookmarkNameString = editBookmarkNameEditText.getText().toString();
 724         String bookmarkUrlString = editBookmarkUrlEditText.getText().toString();
 725
 726         // Update the bookmark.
 727         if (currentBookmarkIconRadioButton.isChecked()) {  // Update the bookmark without changing the favorite icon.
 728             bookmarksDatabaseHelper.updateBookmark(selectedBookmarkDatabaseId, bookmarkNameString, bookmarkUrlString);
 729         } else {  // Update the bookmark using the `WebView` favorite icon.
 730             // Convert the favorite icon to a byte array.  `0` is for lossless compression (the only option for a PNG).
 731             ByteArrayOutputStream newFavoriteIconByteArrayOutputStream = new ByteArrayOutputStream();
 732             MainWebViewActivity.favoriteIconBitmap.compress(Bitmap.CompressFormat.PNG, 0, newFavoriteIconByteArrayOutputStream);
 733             byte[] newFavoriteIconByteArray = newFavoriteIconByteArrayOutputStream.toByteArray();
 734
 735             //  Update the bookmark and the favorite icon.
 736             bookmarksDatabaseHelper.updateBookmark(selectedBookmarkDatabaseId, bookmarkNameString, bookmarkUrlString, newFavoriteIconByteArray);
 737         }
 738
 739         // Close the contextual action mode.
 740         contextualActionMode.finish();
 741
 742         // Update `bookmarksCursor` with the contents of the current folder.
 743         bookmarksCursor = bookmarksDatabaseHelper.getAllBookmarksCursorByDisplayOrder(currentFolder);
 744
 745         // Update the `ListView`.
 746         bookmarksCursorAdapter.changeCursor(bookmarksCursor);
 747     }
 748
 749     @Override
 750     public void onSaveBookmarkFolder(AppCompatDialogFragment dialogFragment, int selectedFolderDatabaseId) {
 751         // Get handles for the views from `dialogFragment`.
 752         RadioButton currentFolderIconRadioButton = dialogFragment.getDialog().findViewById(R.id.edit_folder_current_icon_radiobutton);
 753         RadioButton defaultFolderIconRadioButton = dialogFragment.getDialog().findViewById(R.id.edit_folder_default_icon_radiobutton);
 754         ImageView defaultFolderIconImageView = dialogFragment.getDialog().findViewById(R.id.edit_folder_default_icon_imageview);
 755         EditText editFolderNameEditText = dialogFragment.getDialog().findViewById(R.id.edit_folder_name_edittext);
 756
 757         // Get the new folder name.
 758         String newFolderNameString = editFolderNameEditText.getText().toString();
 759
 760         // Check if the favorite icon has changed.
 761         if (currentFolderIconRadioButton.isChecked()) {  // Only the name has changed.
 762             // Update the name in the database.
 763             bookmarksDatabaseHelper.updateFolder(selectedFolderDatabaseId, oldFolderNameString, newFolderNameString);
 764         } else if (!currentFolderIconRadioButton.isChecked() && newFolderNameString.equals(oldFolderNameString)) {  // Only the icon has changed.
 765             // Get the new folder icon `Bitmap`.
 766             Bitmap folderIconBitmap;
 767             if (defaultFolderIconRadioButton.isChecked()) {
 768                 // Get the default folder icon and convert it to a `Bitmap`.
 769                 Drawable folderIconDrawable = defaultFolderIconImageView.getDrawable();
 770                 BitmapDrawable folderIconBitmapDrawable = (BitmapDrawable) folderIconDrawable;
 771                 folderIconBitmap = folderIconBitmapDrawable.getBitmap();
 772             } else {  // Use the `WebView` favorite icon.
 773                 folderIconBitmap = MainWebViewActivity.favoriteIconBitmap;
 774             }
 775
 776             // Convert the folder `Bitmap` to a byte array.  `0` is for lossless compression (the only option for a PNG).
 777             ByteArrayOutputStream folderIconByteArrayOutputStream = new ByteArrayOutputStream();
 778             folderIconBitmap.compress(Bitmap.CompressFormat.PNG, 0, folderIconByteArrayOutputStream);
 779             byte[] folderIconByteArray = folderIconByteArrayOutputStream.toByteArray();
 780
 781             // Update the folder icon in the database.
 782             bookmarksDatabaseHelper.updateFolder(selectedFolderDatabaseId, folderIconByteArray);
 783         } else {  // The folder icon and the name have changed.
 784             // Instantiate the new folder icon `Bitmap`.
 785             Bitmap folderIconBitmap;
 786
 787             // Populate the new folder icon bitmap.
 788             if (defaultFolderIconRadioButton.isChecked()) {
 789                 // Get the default folder icon and convert it to a `Bitmap`.
 790                 Drawable folderIconDrawable = defaultFolderIconImageView.getDrawable();
 791                 BitmapDrawable folderIconBitmapDrawable = (BitmapDrawable) folderIconDrawable;
 792                 folderIconBitmap = folderIconBitmapDrawable.getBitmap();
 793             } else {  // Use the `WebView` favorite icon.
 794                 folderIconBitmap = MainWebViewActivity.favoriteIconBitmap;
 795             }
 796
 797             // Convert the folder `Bitmap` to a byte array.  `0` is for lossless compression (the only option for a PNG).
 798             ByteArrayOutputStream folderIconByteArrayOutputStream = new ByteArrayOutputStream();
 799             folderIconBitmap.compress(Bitmap.CompressFormat.PNG, 0, folderIconByteArrayOutputStream);
 800             byte[] folderIconByteArray = folderIconByteArrayOutputStream.toByteArray();
 801
 802             // Update the folder name and icon in the database.
 803             bookmarksDatabaseHelper.updateFolder(selectedFolderDatabaseId, oldFolderNameString, newFolderNameString, folderIconByteArray);
 804         }
 805
 806         // Update `bookmarksCursor` with the current contents of this folder.
 807         bookmarksCursor = bookmarksDatabaseHelper.getAllBookmarksCursorByDisplayOrder(currentFolder);
 808
 809         // Update the `ListView`.
 810         bookmarksCursorAdapter.changeCursor(bookmarksCursor);
 811
 812         // Close the contextual action mode.
 813         contextualActionMode.finish();
 814     }
 815
 816     @Override
 817     public void onMoveToFolder(AppCompatDialogFragment dialogFragment) {
 818         // Get a handle for the `ListView` from `dialogFragment`.
 819         ListView folderListView = dialogFragment.getDialog().findViewById(R.id.move_to_folder_listview);
 820
 821         // Store a long array of the selected folders.
 822         long[] newFolderLongArray = folderListView.getCheckedItemIds();
 823
 824         // Get the new folder database ID.  Only one folder will be selected.
 825         int newFolderDatabaseId = (int) newFolderLongArray[0];
 826
 827         // Instantiate `newFolderName`.
 828         String newFolderName;
 829
 830         // Set the new folder name.
 831         if (newFolderDatabaseId == 0) {
 832             // The new folder is the home folder, represented as `""` in the database.
 833             newFolderName = "";
 834         } else {
 835             // Get the new folder name from the database.
 836             newFolderName = bookmarksDatabaseHelper.getFolderName(newFolderDatabaseId);
 837         }
 838
 839         // Get a long array with the the database ID of the selected bookmarks.
 840         long[] selectedBookmarksLongArray = bookmarksListView.getCheckedItemIds();
 841
 842         // Move each of the selected bookmarks to the new folder.
 843         for (long databaseIdLong : selectedBookmarksLongArray) {
 844             // Get `databaseIdInt` for each selected bookmark.
 845             int databaseIdInt = (int) databaseIdLong;
 846
 847             // Move the selected bookmark to the new folder.
 848             bookmarksDatabaseHelper.moveToFolder(databaseIdInt, newFolderName);
 849         }
 850
 851         // Update `bookmarksCursor` with the current contents of this folder.
 852         bookmarksCursor = bookmarksDatabaseHelper.getAllBookmarksCursorByDisplayOrder(currentFolder);
 853
 854         // Update the `ListView`.
 855         bookmarksCursorAdapter.changeCursor(bookmarksCursor);
 856
 857         // Close the contextual app bar.
 858         contextualActionMode.finish();
 859     }
 860
 861     private void deleteBookmarkFolderContents(int databaseId) {
 862         // Get the name of the folder.
 863         String folderName = bookmarksDatabaseHelper.getFolderName(databaseId);
 864
 865         // Get the contents of the folder.
 866         Cursor folderCursor = bookmarksDatabaseHelper.getAllBookmarksCursorByDisplayOrder(folderName);
 867
 868         // Delete each of the bookmarks in the folder.
 869         for (int i = 0; i < folderCursor.getCount(); i++) {
 870             // Move `folderCursor` to the current row.
 871             folderCursor.moveToPosition(i);
 872
 873             // Get the database ID of the item.
 874             int itemDatabaseId = folderCursor.getInt(folderCursor.getColumnIndex(BookmarksDatabaseHelper._ID));
 875
 876             // If this is a folder, recursively delete the contents first.
 877             if (bookmarksDatabaseHelper.isFolder(itemDatabaseId)) {
 878                 deleteBookmarkFolderContents(itemDatabaseId);
 879             }
 880
 881             // Delete the bookmark.
 882             bookmarksDatabaseHelper.deleteBookmark(itemDatabaseId);
 883         }
 884     }
 885
 886     private void updateMoveIcons() {
 887         // Get a long array of the selected bookmarks.
 888         long[] selectedBookmarksLongArray = bookmarksListView.getCheckedItemIds();
 889
 890         // Get the database IDs for the first, last, and selected bookmarks.
 891         int selectedBookmarkDatabaseId = (int) selectedBookmarksLongArray[0];
 892         int firstBookmarkDatabaseId = (int) bookmarksListView.getItemIdAtPosition(0);
 893         // bookmarksListView is 0 indexed.
 894         int lastBookmarkDatabaseId = (int) bookmarksListView.getItemIdAtPosition(bookmarksListView.getCount() - 1);
 895
 896         // Update the move bookmark up `MenuItem`.
 897         if (selectedBookmarkDatabaseId == firstBookmarkDatabaseId) {  // The selected bookmark is in the first position.
 898             // Disable the move bookmark up `MenuItem`.
 899             moveBookmarkUpMenuItem.setEnabled(false);
 900
 901             //  Set the move bookmark up icon to be ghosted.
 902             moveBookmarkUpMenuItem.setIcon(R.drawable.move_up_disabled);
 903         } else {  // The selected bookmark is not in the first position.
 904             // Enable the move bookmark up `MenuItem`.
 905             moveBookmarkUpMenuItem.setEnabled(true);
 906
 907             // Set the icon according to the theme.
 908             if (MainWebViewActivity.darkTheme) {
 909                 moveBookmarkUpMenuItem.setIcon(R.drawable.move_up_enabled_dark);
 910             } else {
 911                 moveBookmarkUpMenuItem.setIcon(R.drawable.move_up_enabled_light);
 912             }
 913         }
 914
 915         // Update the move bookmark down `MenuItem`.
 916         if (selectedBookmarkDatabaseId == lastBookmarkDatabaseId) {  // The selected bookmark is in the last position.
 917             // Disable the move bookmark down `MenuItem`.
 918             moveBookmarkDownMenuItem.setEnabled(false);
 919
 920             // Set the move bookmark down icon to be ghosted.
 921             moveBookmarkDownMenuItem.setIcon(R.drawable.move_down_disabled);
 922         } else {  // The selected bookmark is not in the last position.
 923             // Enable the move bookmark down `MenuItem`.
 924             moveBookmarkDownMenuItem.setEnabled(true);
 925
 926             // Set the icon according to the theme.
 927             if (MainWebViewActivity.darkTheme) {
 928                 moveBookmarkDownMenuItem.setIcon(R.drawable.move_down_enabled_dark);
 929             } else {
 930                 moveBookmarkDownMenuItem.setIcon(R.drawable.move_down_enabled_light);
 931             }
 932         }
 933     }
 934
 935     private void scrollBookmarks(int selectedBookmarkPosition) {
 936         // Get the first and last visible bookmark positions.
 937         int firstVisibleBookmarkPosition = bookmarksListView.getFirstVisiblePosition();
 938         int lastVisibleBookmarkPosition = bookmarksListView.getLastVisiblePosition();
 939
 940         // Calculate the number of bookmarks per screen.
 941         int numberOfBookmarksPerScreen = lastVisibleBookmarkPosition - firstVisibleBookmarkPosition;
 942
 943         // Scroll with the moved bookmark if necessary.
 944         if (selectedBookmarkPosition <= firstVisibleBookmarkPosition) {  // The selected bookmark position is at or above the top of the screen.
 945             // Scroll to the selected bookmark position.
 946             bookmarksListView.setSelection(selectedBookmarkPosition);
 947         } else if (selectedBookmarkPosition >= (lastVisibleBookmarkPosition - 1)) {  // The selected bookmark is at or below the bottom of the screen.  The `-1` handles partial bookmarks displayed at the bottom of the `ListView`.
 948             // Scroll to display the selected bookmark at the bottom of the screen.  `+1` assured that the entire bookmark will be displayed in situations where only a partial bookmark fits at the bottom of the `ListView`.
 949             bookmarksListView.setSelection(selectedBookmarkPosition - numberOfBookmarksPerScreen + 1);
 950         }
 951     }
 952
 953     private void loadFolder() {
 954         // Update `bookmarksCursor` with the contents of the bookmarks database for the current folder.
 955         bookmarksCursor = bookmarksDatabaseHelper.getAllBookmarksCursorByDisplayOrder(currentFolder);
 956
 957         // Setup a `CursorAdapter`.  `this` specifies the `Context`.  `false` disables `autoRequery`.
 958         bookmarksCursorAdapter = new CursorAdapter(this, bookmarksCursor, false) {
 959             @Override
 960             public View newView(Context context, Cursor cursor, ViewGroup parent) {
 961                 // Inflate the individual item layout.  `false` does not attach it to the root.
 962                 return getLayoutInflater().inflate(R.layout.bookmarks_activity_item_linearlayout, parent, false);
 963             }
 964
 965             @Override
 966             public void bindView(View view, Context context, Cursor cursor) {
 967                 // Get handles for the views.
 968                 ImageView bookmarkFavoriteIcon = view.findViewById(R.id.bookmark_favorite_icon);
 969                 TextView bookmarkNameTextView = view.findViewById(R.id.bookmark_name);
 970
 971                 // Get the favorite icon byte array from the `Cursor`.
 972                 byte[] favoriteIconByteArray = cursor.getBlob(cursor.getColumnIndex(BookmarksDatabaseHelper.FAVORITE_ICON));
 973
 974                 // Convert the byte array to a `Bitmap` beginning at the first byte and ending at the last.
 975                 Bitmap favoriteIconBitmap = BitmapFactory.decodeByteArray(favoriteIconByteArray, 0, favoriteIconByteArray.length);
 976
 977                 // Display the bitmap in `bookmarkFavoriteIcon`.
 978                 bookmarkFavoriteIcon.setImageBitmap(favoriteIconBitmap);
 979
 980                 // Get the bookmark name from the cursor and display it in `bookmarkNameTextView`.
 981                 String bookmarkNameString = cursor.getString(cursor.getColumnIndex(BookmarksDatabaseHelper.BOOKMARK_NAME));
 982                 bookmarkNameTextView.setText(bookmarkNameString);
 983
 984                 // Make the font bold for folders.
 985                 if (cursor.getInt(cursor.getColumnIndex(BookmarksDatabaseHelper.IS_FOLDER)) == 1) {
 986                     bookmarkNameTextView.setTypeface(Typeface.DEFAULT_BOLD);
 987                 } else {  // Reset the font to default for normal bookmarks.
 988                     bookmarkNameTextView.setTypeface(Typeface.DEFAULT);
 989                 }
 990             }
 991         };
 992
 993         // Populate the `ListView` with the adapter.
 994         bookmarksListView.setAdapter(bookmarksCursorAdapter);
 995
 996         // Set the `AppBar` title.
 997         if (currentFolder.isEmpty()) {
 998             appBar.setTitle(R.string.bookmarks);
 999         } else {
1000             appBar.setTitle(currentFolder);
1001         }
1002     }
1003 }