universum.studios.android.setting

Class SettingsBaseActivity

java.lang.Object

android.content.Context

android.content.ContextWrapper

android.view.ContextThemeWrapper

android.app.Activity

android.app.ListActivity

android.preference.PreferenceActivity

universum.studios.android.setting.SettingsBaseActivity

All Implemented Interfaces:

android.content.ComponentCallbacks, android.content.ComponentCallbacks2, android.preference.PreferenceFragment.OnPreferenceStartFragmentCallback, android.view.KeyEvent.Callback, android.view.LayoutInflater.Factory, android.view.LayoutInflater.Factory2, android.view.View.OnCreateContextMenuListener, android.view.Window.Callback

public abstract class SettingsBaseActivity
extends android.preference.PreferenceActivity

A PreferenceActivity implementation that uses AppCompatDelegate to provide compatibility support features like attaching of custom action bar via setSupportActionBar(Toolbar).

This activity also intercepts default setting of list adapter with headers and uses SettingHeadersAdapter to provide item views for the loaded preference headers via loadHeadersFromResource(int, List). The headers adapter is specified via setHeadersAdapter(ListAdapter) and the current one may be obtained via setHeadersAdapter(ListAdapter). The headers that has been loaded and are used by the headers adapter may be obtained via getHeaders().

If a Toolbar should be presented in the activity's view hierarchy, it may be added via addToolbar() which also attacheds the added toolbar as support action bar.

Theme style attribute

uiSettingsActivityStyle

Author:

Martin Albedinsky

Nested Class Summary

Nested classes/interfaces inherited from class android.preference.PreferenceActivity

android.preference.PreferenceActivity.Header

Field Summary

Fields inherited from class android.preference.PreferenceActivity

EXTRA_NO_HEADERS, EXTRA_SHOW_FRAGMENT, EXTRA_SHOW_FRAGMENT_ARGUMENTS, EXTRA_SHOW_FRAGMENT_SHORT_TITLE, EXTRA_SHOW_FRAGMENT_TITLE, HEADER_ID_UNDEFINED

Fields inherited from class android.app.Activity

DEFAULT_KEYS_DIALER, DEFAULT_KEYS_DISABLE, DEFAULT_KEYS_SEARCH_GLOBAL, DEFAULT_KEYS_SEARCH_LOCAL, DEFAULT_KEYS_SHORTCUT, FOCUSED_STATE_SET, RESULT_CANCELED, RESULT_FIRST_USER, RESULT_OK

Fields inherited from class android.content.Context

ACCESSIBILITY_SERVICE, ACCOUNT_SERVICE, ACTIVITY_SERVICE, ALARM_SERVICE, APP_OPS_SERVICE, APPWIDGET_SERVICE, AUDIO_SERVICE, BATTERY_SERVICE, BIND_ABOVE_CLIENT, BIND_ADJUST_WITH_ACTIVITY, BIND_ALLOW_OOM_MANAGEMENT, BIND_AUTO_CREATE, BIND_DEBUG_UNBIND, BIND_EXTERNAL_SERVICE, BIND_IMPORTANT, BIND_NOT_FOREGROUND, BIND_WAIVE_PRIORITY, BLUETOOTH_SERVICE, CAMERA_SERVICE, CAPTIONING_SERVICE, CARRIER_CONFIG_SERVICE, CLIPBOARD_SERVICE, CONNECTIVITY_SERVICE, CONSUMER_IR_SERVICE, CONTEXT_IGNORE_SECURITY, CONTEXT_INCLUDE_CODE, CONTEXT_RESTRICTED, DEVICE_POLICY_SERVICE, DISPLAY_SERVICE, DOWNLOAD_SERVICE, DROPBOX_SERVICE, FINGERPRINT_SERVICE, HARDWARE_PROPERTIES_SERVICE, INPUT_METHOD_SERVICE, INPUT_SERVICE, JOB_SCHEDULER_SERVICE, KEYGUARD_SERVICE, LAUNCHER_APPS_SERVICE, LAYOUT_INFLATER_SERVICE, LOCATION_SERVICE, MEDIA_PROJECTION_SERVICE, MEDIA_ROUTER_SERVICE, MEDIA_SESSION_SERVICE, MIDI_SERVICE, MODE_APPEND, MODE_ENABLE_WRITE_AHEAD_LOGGING, MODE_MULTI_PROCESS, MODE_NO_LOCALIZED_COLLATORS, MODE_PRIVATE, MODE_WORLD_READABLE, MODE_WORLD_WRITEABLE, NETWORK_STATS_SERVICE, NFC_SERVICE, NOTIFICATION_SERVICE, NSD_SERVICE, POWER_SERVICE, PRINT_SERVICE, RESTRICTIONS_SERVICE, SEARCH_SERVICE, SENSOR_SERVICE, SHORTCUT_SERVICE, STORAGE_SERVICE, SYSTEM_HEALTH_SERVICE, TELECOM_SERVICE, TELEPHONY_SERVICE, TELEPHONY_SUBSCRIPTION_SERVICE, TEXT_SERVICES_MANAGER_SERVICE, TV_INPUT_SERVICE, UI_MODE_SERVICE, USAGE_STATS_SERVICE, USB_SERVICE, USER_SERVICE, VIBRATOR_SERVICE, WALLPAPER_SERVICE, WIFI_P2P_SERVICE, WIFI_SERVICE, WINDOW_SERVICE

Fields inherited from interface android.content.ComponentCallbacks2

TRIM_MEMORY_BACKGROUND, TRIM_MEMORY_COMPLETE, TRIM_MEMORY_MODERATE, TRIM_MEMORY_RUNNING_CRITICAL, TRIM_MEMORY_RUNNING_LOW, TRIM_MEMORY_RUNNING_MODERATE, TRIM_MEMORY_UI_HIDDEN

Constructor Summary

Constructors

Constructor and Description
SettingsBaseActivity()

Method Summary

Modifier and Type	Method and Description
void	addContentView(android.view.View view, android.view.ViewGroup.LayoutParams params)
protected Toolbar	addToolbar() Adds Toolbar into view hierarchy of this activity if it has not been added yet.
protected AppCompatDelegate	delegate() Returns the application compatibility delegate that is used by this activity to provide compatibility features like attaching of support action bar via setSupportActionBar(Toolbar).
android.view.View	findViewById(int id)
protected android.view.View	getContentView() Returns the content (root) view of this activity.
protected List<android.preference.PreferenceActivity.Header>	getHeaders() Returns the list of headers that has been loaded via loadHeadersFromResource(int, List).
android.widget.ListAdapter	getHeadersAdapter() Returns the current headers adapter specified for this activity.
android.widget.ListAdapter	getListAdapter() Deprecated. Use getHeadersAdapter() instead.
android.view.MenuInflater	getMenuInflater()
ActionBar	getSupportActionBar() Returns the support action bar attached to this activity via setSupportActionBar(Toolbar).
protected Toolbar	getToolbar() Returns the toolbar added to the view hierarchy of this activity via addToolbar().
void	invalidateOptionsMenu()
void	loadHeadersFromResource(int resid, List<android.preference.PreferenceActivity.Header> target)
void	onConfigurationChanged(android.content.res.Configuration newConfig)
void	onContentChanged()
protected void	onCreate(android.os.Bundle savedInstanceState)
protected Toolbar	onCreateToolbar(android.view.LayoutInflater inflater, android.view.ViewGroup root) Invoked as result to call of addToolbar() to create a new instance of Toolbar that will be added into view hierarchy of this activity.
protected void	onDestroy()
protected void	onListItemClick(android.widget.ListView l, android.view.View v, int position, long id)
protected void	onPostCreate(android.os.Bundle savedInstanceState)
protected void	onPostResume()
protected void	onSaveInstanceState(android.os.Bundle state)
protected void	onStop()
protected void	onTitleChanged(CharSequence title, int color)
void	setContentView(int layoutResID)
void	setContentView(android.view.View view)
void	setContentView(android.view.View view, android.view.ViewGroup.LayoutParams params)
void	setHeadersAdapter(android.widget.ListAdapter adapter) Sets an adapter that will provide item views for preference items to be presented in the view hierarchy of this activity.
void	setListAdapter(android.widget.ListAdapter adapter) Deprecated. Use setHeadersAdapter(ListAdapter) instead.
void	setSupportActionBar(Toolbar toolbar) Attaches the given toolbar to this activity as support action bar.

Methods inherited from class android.preference.PreferenceActivity

addPreferencesFromIntent, addPreferencesFromResource, findPreference, finishPreferencePanel, getPreferenceManager, getPreferenceScreen, hasHeaders, invalidateHeaders, isMultiPane, isValidFragment, onActivityResult, onBuildHeaders, onBuildStartFragmentIntent, onGetInitialHeader, onGetNewHeader, onHeaderClick, onIsHidingHeaders, onIsMultiPane, onNewIntent, onPreferenceStartFragment, onPreferenceTreeClick, onRestoreInstanceState, setListFooter, setParentTitle, setPreferenceScreen, showBreadCrumbs, startPreferenceFragment, startPreferencePanel, startWithFragment, startWithFragment, switchToHeader, switchToHeader

Methods inherited from class android.app.ListActivity

getListView, getSelectedItemId, getSelectedItemPosition, setSelection

Methods inherited from class android.app.Activity

closeContextMenu, closeOptionsMenu, createPendingResult, dismissDialog, dismissKeyboardShortcutsHelper, dispatchGenericMotionEvent, dispatchKeyEvent, dispatchKeyShortcutEvent, dispatchPopulateAccessibilityEvent, dispatchTouchEvent, dispatchTrackballEvent, dump, enterPictureInPictureMode, finish, finishActivity, finishActivityFromChild, finishAffinity, finishAfterTransition, finishAndRemoveTask, finishFromChild, getActionBar, getApplication, getCallingActivity, getCallingPackage, getChangingConfigurations, getComponentName, getContentScene, getContentTransitionManager, getCurrentFocus, getFragmentManager, getIntent, getLastNonConfigurationInstance, getLayoutInflater, getLoaderManager, getLocalClassName, getMediaController, getParent, getParentActivityIntent, getPreferences, getReferrer, getRequestedOrientation, getSearchEvent, getSystemService, getTaskId, getTitle, getTitleColor, getVoiceInteractor, getVolumeControlStream, getWindow, getWindowManager, hasWindowFocus, isChangingConfigurations, isChild, isDestroyed, isFinishing, isImmersive, isInMultiWindowMode, isInPictureInPictureMode, isLocalVoiceInteractionSupported, isTaskRoot, isVoiceInteraction, isVoiceInteractionRoot, managedQuery, moveTaskToBack, navigateUpTo, navigateUpToFromChild, onActionModeFinished, onActionModeStarted, onActivityReenter, onApplyThemeResource, onAttachedToWindow, onAttachFragment, onBackPressed, onChildTitleChanged, onContextItemSelected, onContextMenuClosed, onCreate, onCreateContextMenu, onCreateDescription, onCreateDialog, onCreateDialog, onCreateNavigateUpTaskStack, onCreateOptionsMenu, onCreatePanelMenu, onCreatePanelView, onCreateThumbnail, onCreateView, onCreateView, onDetachedFromWindow, onEnterAnimationComplete, onGenericMotionEvent, onKeyDown, onKeyLongPress, onKeyMultiple, onKeyShortcut, onKeyUp, onLocalVoiceInteractionStarted, onLocalVoiceInteractionStopped, onLowMemory, onMenuItemSelected, onMenuOpened, onMultiWindowModeChanged, onNavigateUp, onNavigateUpFromChild, onOptionsItemSelected, onOptionsMenuClosed, onPanelClosed, onPause, onPictureInPictureModeChanged, onPostCreate, onPrepareDialog, onPrepareDialog, onPrepareNavigateUpTaskStack, onPrepareOptionsMenu, onPreparePanel, onProvideAssistContent, onProvideAssistData, onProvideKeyboardShortcuts, onProvideReferrer, onRequestPermissionsResult, onRestart, onRestoreInstanceState, onResume, onRetainNonConfigurationInstance, onSaveInstanceState, onSearchRequested, onSearchRequested, onStart, onStateNotSaved, onTouchEvent, onTrackballEvent, onTrimMemory, onUserInteraction, onUserLeaveHint, onVisibleBehindCanceled, onWindowAttributesChanged, onWindowFocusChanged, onWindowStartingActionMode, onWindowStartingActionMode, openContextMenu, openOptionsMenu, overridePendingTransition, postponeEnterTransition, recreate, registerForContextMenu, releaseInstance, removeDialog, reportFullyDrawn, requestDragAndDropPermissions, requestPermissions, requestShowKeyboardShortcuts, requestVisibleBehind, requestWindowFeature, runOnUiThread, setActionBar, setContentTransitionManager, setDefaultKeyMode, setEnterSharedElementCallback, setExitSharedElementCallback, setFeatureDrawable, setFeatureDrawableAlpha, setFeatureDrawableResource, setFeatureDrawableUri, setFinishOnTouchOutside, setImmersive, setIntent, setMediaController, setProgress, setProgressBarIndeterminate, setProgressBarIndeterminateVisibility, setProgressBarVisibility, setRequestedOrientation, setResult, setResult, setSecondaryProgress, setTaskDescription, setTheme, setTitle, setTitle, setTitleColor, setVisible, setVolumeControlStream, setVrModeEnabled, shouldShowRequestPermissionRationale, shouldUpRecreateTask, showAssist, showDialog, showDialog, showLockTaskEscapeMessage, startActionMode, startActionMode, startActivities, startActivities, startActivity, startActivity, startActivityForResult, startActivityForResult, startActivityFromChild, startActivityFromChild, startActivityFromFragment, startActivityFromFragment, startActivityIfNeeded, startActivityIfNeeded, startIntentSender, startIntentSender, startIntentSenderForResult, startIntentSenderForResult, startIntentSenderFromChild, startIntentSenderFromChild, startLocalVoiceInteraction, startLockTask, startManagingCursor, startNextMatchingActivity, startNextMatchingActivity, startPostponedEnterTransition, startSearch, stopLocalVoiceInteraction, stopLockTask, stopManagingCursor, takeKeyEvents, triggerSearch, unregisterForContextMenu

Methods inherited from class android.view.ContextThemeWrapper

applyOverrideConfiguration, attachBaseContext, getAssets, getResources, getTheme

Methods inherited from class android.content.ContextWrapper

bindService, checkCallingOrSelfPermission, checkCallingOrSelfUriPermission, checkCallingPermission, checkCallingUriPermission, checkPermission, checkSelfPermission, checkUriPermission, checkUriPermission, clearWallpaper, createConfigurationContext, createDeviceProtectedStorageContext, createDisplayContext, createPackageContext, databaseList, deleteDatabase, deleteFile, deleteSharedPreferences, enforceCallingOrSelfPermission, enforceCallingOrSelfUriPermission, enforceCallingPermission, enforceCallingUriPermission, enforcePermission, enforceUriPermission, enforceUriPermission, fileList, getApplicationContext, getApplicationInfo, getBaseContext, getCacheDir, getClassLoader, getCodeCacheDir, getContentResolver, getDatabasePath, getDataDir, getDir, getExternalCacheDir, getExternalCacheDirs, getExternalFilesDir, getExternalFilesDirs, getExternalMediaDirs, getFilesDir, getFileStreamPath, getMainLooper, getNoBackupFilesDir, getObbDir, getObbDirs, getPackageCodePath, getPackageManager, getPackageName, getPackageResourcePath, getSharedPreferences, getSystemServiceName, getWallpaper, getWallpaperDesiredMinimumHeight, getWallpaperDesiredMinimumWidth, grantUriPermission, isDeviceProtectedStorage, isRestricted, moveDatabaseFrom, moveSharedPreferencesFrom, openFileInput, openFileOutput, openOrCreateDatabase, openOrCreateDatabase, peekWallpaper, registerReceiver, registerReceiver, removeStickyBroadcast, removeStickyBroadcastAsUser, revokeUriPermission, sendBroadcast, sendBroadcast, sendBroadcastAsUser, sendBroadcastAsUser, sendOrderedBroadcast, sendOrderedBroadcast, sendOrderedBroadcastAsUser, sendStickyBroadcast, sendStickyBroadcastAsUser, sendStickyOrderedBroadcast, sendStickyOrderedBroadcastAsUser, setWallpaper, setWallpaper, startInstrumentation, startService, stopService, unbindService, unregisterReceiver

Methods inherited from class android.content.Context

getColor, getColorStateList, getDrawable, getString, getString, getSystemService, getText, obtainStyledAttributes, obtainStyledAttributes, obtainStyledAttributes, obtainStyledAttributes, registerComponentCallbacks, unregisterComponentCallbacks

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

SettingsBaseActivity

public SettingsBaseActivity()

Method Detail

delegate

protected final AppCompatDelegate delegate()

Returns the application compatibility delegate that is used by this activity to provide compatibility features like attaching of support action bar via setSupportActionBar(Toolbar).

Returns:

This activity's compatibility delegate.

onCreate

protected void onCreate(android.os.Bundle savedInstanceState)

Overrides:

onCreate in class android.preference.PreferenceActivity

loadHeadersFromResource

public void loadHeadersFromResource(int resid,
                                    List<android.preference.PreferenceActivity.Header> target)

Overrides:

loadHeadersFromResource in class android.preference.PreferenceActivity

getHeaders

protected final List<android.preference.PreferenceActivity.Header> getHeaders()

Returns the list of headers that has been loaded via loadHeadersFromResource(int, List).

Returns:

The loaded list of headers or null if no headers has been loaded yet.

setHeadersAdapter

public void setHeadersAdapter(android.widget.ListAdapter adapter)

Sets an adapter that will provide item views for preference items to be presented in the view hierarchy of this activity.

Parameters:

adapter - The desired adapter providing headers for this activity's list view. May be null to clear the current one.

getHeadersAdapter

public android.widget.ListAdapter getHeadersAdapter()

Returns the current headers adapter specified for this activity.

Returns:

This activity's headers adapter or null if there was no adapter specified yet.

See Also:

setHeadersAdapter(ListAdapter)

setListAdapter

@Deprecated
public final void setListAdapter(android.widget.ListAdapter adapter)

Deprecated. Use setHeadersAdapter(ListAdapter) instead.

This method does nothing.

Overrides:

setListAdapter in class android.app.ListActivity

getListAdapter

@Deprecated
public final android.widget.ListAdapter getListAdapter()

Deprecated. Use getHeadersAdapter() instead.

Overrides:

getListAdapter in class android.app.ListActivity

Returns:

Always null.

onPostCreate

protected void onPostCreate(android.os.Bundle savedInstanceState)

Overrides:

onPostCreate in class android.app.Activity

getMenuInflater

public android.view.MenuInflater getMenuInflater()

Overrides:

getMenuInflater in class android.app.Activity

invalidateOptionsMenu

public void invalidateOptionsMenu()

Overrides:

invalidateOptionsMenu in class android.app.Activity

setContentView

public void setContentView(int layoutResID)

Overrides:

setContentView in class android.app.Activity

setContentView

public void setContentView(android.view.View view)

Overrides:

setContentView in class android.app.Activity

setContentView

public void setContentView(android.view.View view,
                           android.view.ViewGroup.LayoutParams params)

Overrides:

setContentView in class android.app.Activity

addContentView

public void addContentView(android.view.View view,
                           android.view.ViewGroup.LayoutParams params)

Overrides:

addContentView in class android.app.Activity

onContentChanged

public void onContentChanged()

Specified by:

onContentChanged in interface android.view.Window.Callback

Overrides:

onContentChanged in class android.preference.PreferenceActivity

getContentView

protected final android.view.View getContentView()

Returns the content (root) view of this activity.

Returns:

This activity's content view.

Throws:

IllegalStateException - If content view of this activity has not been created yet.

See Also:

onContentChanged()

addToolbar

protected Toolbar addToolbar()

Adds Toolbar into view hierarchy of this activity if it has not been added yet.

This implementation creates a new instance of the toolbar via onCreateToolbar(LayoutInflater, ViewGroup) if it is not created and added yet and adds it into this activity's content view at the 0 position, which is at the top. Also the added toolbar is attached to this activity as support action bar via setSupportActionBar(Toolbar) and if this activity is not currently in state of hiding headers, the displaying of home as up for the attached action bar is enabled via ActionBar#setDisplayHomeAsUpEnabled(boolean) and View.OnClickListener is attached to the toolbar via Toolbar#setNavigationOnClickListener(View.OnClickListener) which when its View.OnClickListener#onClick(View) callback is fired calls Activity.onBackPressed() of this activity.

Returns:

The added toolbar.

Throws:

android.util.AndroidRuntimeException - If the content view of this activity is not a ViewGroup, which should not happen.

See Also:

getToolbar(), getSupportActionBar()

onCreateToolbar

protected Toolbar onCreateToolbar(android.view.LayoutInflater inflater,
                                  android.view.ViewGroup root)

Invoked as result to call of addToolbar() to create a new instance of Toolbar that will be added into view hierarchy of this activity.

This implementation by default inflates R.layout#ui_toolbar layout which contains single Toolbar. Subclasses may override this method to create or inflate custom toolbar.

Parameters:

inflater - Layout inflater that may be used to inflate the requested toolbar.

root - This activity's root view.

Returns:

Instance of toolbar to be added into this activity's view hierarchy.

getToolbar

protected Toolbar getToolbar()

Returns the toolbar added to the view hierarchy of this activity via addToolbar().

If added, this toolbar may be also obtained as support action bar via getSupportActionBar().

Returns:

This activity's toolbar if added, null otherwise.

findViewById

public android.view.View findViewById(int id)

Overrides:

findViewById in class android.app.Activity

setSupportActionBar

public void setSupportActionBar(Toolbar toolbar)

Attaches the given toolbar to this activity as support action bar.

Parameters:

toolbar - The desired toolbar to attach as action bar. May be null to clear the current one.

See Also:

getSupportActionBar()

getSupportActionBar

public ActionBar getSupportActionBar()

Returns the support action bar attached to this activity via setSupportActionBar(Toolbar).

Returns:

This activity's support action bar or null if there is no action bar attached.

onPostResume

protected void onPostResume()

Overrides:

onPostResume in class android.app.Activity

onListItemClick

protected void onListItemClick(android.widget.ListView l,
                               android.view.View v,
                               int position,
                               long id)

Overrides:

onListItemClick in class android.preference.PreferenceActivity

onSaveInstanceState

protected void onSaveInstanceState(android.os.Bundle state)

Overrides:

onSaveInstanceState in class android.preference.PreferenceActivity

onTitleChanged

protected void onTitleChanged(CharSequence title,
                              int color)

Overrides:

onTitleChanged in class android.app.Activity

onConfigurationChanged

public void onConfigurationChanged(android.content.res.Configuration newConfig)

Specified by:

onConfigurationChanged in interface android.content.ComponentCallbacks

Overrides:

onConfigurationChanged in class android.app.Activity

onStop

protected void onStop()

Overrides:

onStop in class android.preference.PreferenceActivity

onDestroy

protected void onDestroy()

Overrides:

onDestroy in class android.preference.PreferenceActivity