universum.studios.android.setting

Class SettingDialogPreferencesManager

java.lang.Object

universum.studios.android.setting.SettingDialogPreferencesManager

All Implemented Interfaces:

SettingDialogPreference.OnClickListener

public class SettingDialogPreferencesManager
extends Object
implements SettingDialogPreference.OnClickListener

Manager that may be used to manage dialog prefernces presented on a single preference screen. This manager handles attaching of SettingDialogPreference.OnClickListener to all dialog preferences of PreferenceScreen passed to attachToPreferenceScreen(PreferenceScreen) and showing of preference dialogs for the associated dialog preferences whenever SettingDialogPreference.OnClickListener.onDialogPreferenceClick(SettingDialogPreference) is fired for a particular dialog preference. Dialog preferences manager also provides default handling of button click events occurred in those shown preference dialogs via handleOnPreferenceDialogButtonClick(Dialog, int) where this method delegates the click event to the associated dialog preference via SettingDialogPreference.handleOnDialogButtonClick(Dialog, int).

Subclasses may inherit this manager and override any default behavior as needed.

Author:

Martin Albedinsky

Constructor Summary

Constructors

Constructor and Description
SettingDialogPreferencesManager() Creates a new instance of SettingDialogPreferencesManager without either DialogController nor default DialogController.DialogFactory.
SettingDialogPreferencesManager(Activity activity) Creates a new instance of SettingDialogPreferencesManager for the given activity context.
SettingDialogPreferencesManager(Fragment fragment) Creates a new instance of SettingDialogPreferencesManager for the given fragment context.
SettingDialogPreferencesManager(FragmentManager fragmentManager) Creates a new instance of SettingDialogPreferencesManager for the given fragmentManager context.

Method Summary

Modifier and Type	Method and Description
void	attachToPreferenceScreen(PreferenceScreen preferenceScreen) Attaches this manager to the given preferenceScreen.
void	detachFromPreferenceScreen(PreferenceScreen preferenceScreen) Detaches this manager from the given preferenceScreen if previously attached via attachToPreferenceScreen(PreferenceScreen).
SettingDialogPreference	findDialogPreference(int dialogId) Searches for the dialog preference associated with the specified dialogId.
DialogController	getDialogController() Returns the dialog controller used by this manager.
DialogController.DialogFactory	getDialogFactory() Returns the current dialog factory set to this manager.
boolean	handleOnPreferenceDialogButtonClick(Dialog dialog, int button) Handles button click occurred in the given preference dialog.
protected void	onAttachedToPreference(SettingDialogPreference dialogPreference) Called when this manager has been successfully attached to the given dialogPreference.
protected void	onDetachedFromPreference(SettingDialogPreference dialogPreference) Called when this manager has been successfully detached from the given dialogPreference.
boolean	onDialogPreferenceClick(SettingDialogPreference dialogPreference) This implementation check whether this manager has dialog factory attached and also if that factory provides dialog instance with dialog id associated with the clicked dialogPreference.
protected boolean	onShowPreferenceDialog(DialogController dialogController, SettingDialogPreference preference) Called from onDialogPreferenceClick(SettingDialogPreference) to show a dialog for the clicked preference.
void	setDialogController(DialogController dialogController) Sets a dialog controller that should be used by this manager to show dialogs for the clicked dialog preferences.
void	setDialogFactory(DialogController.DialogFactory dialogFactory) Sets a factory that provides dialog instances associated with the clicked dialog preferences.

Methods inherited from class java.lang.Object

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

Constructor Detail

SettingDialogPreferencesManager

public SettingDialogPreferencesManager()

Creates a new instance of SettingDialogPreferencesManager without either DialogController nor default DialogController.DialogFactory.

These should be specified via setDialogController(DialogController) and setDialogFactory(DialogController.DialogFactory) otherwise the new manager will throw an exception if functionality related to dialogs is requested.

See Also:

SettingDialogPreferencesManager(Activity), SettingDialogPreferencesManager(Fragment)

SettingDialogPreferencesManager

public SettingDialogPreferencesManager(@NonNull
                                       Activity activity)

Creates a new instance of SettingDialogPreferencesManager for the given activity context.

This constructor creates this manager with default instance of DialogController and default DialogXmlFactory with R.xml#ui_settings_dialogs file containing dialogs for all dialog preferences provided by the Settings library.

Parameters:

activity - The activity used to instantiate the default dialog controller along with default dialog factory.

See Also:

SettingDialogPreferencesManager(Fragment), DialogController#DialogController(Activity), getDialogController(), getDialogFactory()

SettingDialogPreferencesManager

public SettingDialogPreferencesManager(@NonNull
                                       Fragment fragment)

Creates a new instance of SettingDialogPreferencesManager for the given fragment context.

This constructor creates this manager with default instance of DialogController and default DialogXmlFactory with R.xml#ui_settings_dialogs file containing dialogs for all dialog preferences provided by the Settings library.

Parameters:

fragment - The fragment used to instantiate the default dialog controller along with default dialog factory.

See Also:

SettingDialogPreferencesManager(Activity), DialogController#DialogController(Fragment), getDialogController(), getDialogFactory()

SettingDialogPreferencesManager

public SettingDialogPreferencesManager(@NonNull
                                       FragmentManager fragmentManager)

Creates a new instance of SettingDialogPreferencesManager for the given fragmentManager context.

This constructor creates this manager with default instance of DialogController. The dialog factory need to be specified via setDialogFactory(DialogController.DialogFactory)

Parameters:

fragmentManager - The fragment manager used to instantiate the default dialog controller.

See Also:

DialogController#DialogController(FragmentManager), getDialogController()

Method Detail

setDialogController

public void setDialogController(@NonNull
                                DialogController dialogController)

Sets a dialog controller that should be used by this manager to show dialogs for the clicked dialog preferences.

Note, that if the specified dialog controller does not have specified any dialog factory, the one specified for this manager will be set to it via DialogController#setDialogFactory(DialogController.DialogFactory).

Parameters:

dialogController - The desired dialog controller.

See Also:

getDialogController(), setDialogFactory(DialogController.DialogFactory)

getDialogController

@NonNull
public DialogController getDialogController()

Returns the dialog controller used by this manager.

Returns:

Default dialog controller or the one specified via setDialogController(DialogController).

See Also:

SettingDialogPreferencesManager(Activity), SettingDialogPreferencesManager(Fragment), SettingDialogPreferencesManager(FragmentManager)

setDialogFactory

public void setDialogFactory(@Nullable
                             DialogController.DialogFactory dialogFactory)

Sets a factory that provides dialog instances associated with the clicked dialog preferences. The given factory will be attached to the current dialog controller via DialogController#setDialogFactory(DialogController.DialogFactory).

Parameters:

dialogFactory - The desired dialog factory. May be null to clear the current one.

See Also:

getDialogFactory(), setDialogController(DialogController)

getDialogFactory

@Nullable
public DialogController.DialogFactory getDialogFactory()

Returns the current dialog factory set to this manager.

Returns:

Default dialog factory or the one specified via setDialogFactory(DialogController.DialogFactory)

See Also:

setDialogFactory(DialogController.DialogFactory), SettingDialogPreferencesManager(Activity), SettingDialogPreferencesManager(Fragment)

attachToPreferenceScreen

public void attachToPreferenceScreen(@NonNull
                                     PreferenceScreen preferenceScreen)

Attaches this manager to the given preferenceScreen.

Dialog preferences manager will use the preference screen to look up for all instances of dialog preferences that are added to that preference screen. To all those dialog preferences is than this manager attached as SettingDialogPreference.OnClickListener so it may receive the preference click callback and show dialog for that particular preference. The context that is using this manager should dispatch Dialog.OnDialogListener#onDialogButtonClick(Dialog, int) callback to this manager via handleOnPreferenceDialogButtonClick(Dialog, int).

When this manager is no more needed it should be detached from the attached preference screen via detachFromPreferenceScreen(PreferenceScreen).

Parameters:

preferenceScreen - The preference screen to attach to.

onAttachedToPreference

protected void onAttachedToPreference(@NonNull
                                      SettingDialogPreference dialogPreference)

Called when this manager has been successfully attached to the given dialogPreference.

Parameters:

dialogPreference - The dialog preference to which has been this manager just attached.

See Also:

attachToPreferenceScreen(PreferenceScreen)

findDialogPreference

@Nullable
public SettingDialogPreference findDialogPreference(int dialogId)

Searches for the dialog preference associated with the specified dialogId.

Note, that the manager should be attached to preference screen via attachToPreferenceScreen(PreferenceScreen) otherwise this method will always return null.

Parameters:

dialogId - Id of the dialog associated with the desired preference to find.

Returns:

Found dialog preference or null if this manager is not attached to preference screen at this time or there is no dialog preference with such dialog id associated.

detachFromPreferenceScreen

public void detachFromPreferenceScreen(@NonNull
                                       PreferenceScreen preferenceScreen)

Detaches this manager from the given preferenceScreen if previously attached via attachToPreferenceScreen(PreferenceScreen).

Parameters:

preferenceScreen - The preference screen from which to detach this manager.

onDetachedFromPreference

protected void onDetachedFromPreference(@NonNull
                                        SettingDialogPreference dialogPreference)

Called when this manager has been successfully detached from the given dialogPreference.

Parameters:

dialogPreference - The dialog preference from which has been this manager just detached.

See Also:

detachFromPreferenceScreen(PreferenceScreen)

onDialogPreferenceClick

public boolean onDialogPreferenceClick(@NonNull
                                       SettingDialogPreference dialogPreference)

This implementation check whether this manager has dialog factory attached and also if that factory provides dialog instance with dialog id associated with the clicked dialogPreference. If so, onShowPreferenceDialog(DialogController, SettingDialogPreference) is called to show the preference dialog.

Specified by:

onDialogPreferenceClick in interface SettingDialogPreference.OnClickListener

Parameters:

dialogPreference - The clicked dialog preference.

Returns:

True if the click event has been handled, false otherwise.

onShowPreferenceDialog

protected boolean onShowPreferenceDialog(@NonNull
                                         DialogController dialogController,
                                         @NonNull
                                         SettingDialogPreference preference)

Called from onDialogPreferenceClick(SettingDialogPreference) to show a dialog for the clicked preference.

Parameters:

dialogController - Current dialog controller of this manager that may be used to show the dialog associated with the clicked preference..

preference - The preference that has been clicked.

Returns:

True if the preference dialog has been successfully shown, false otherwise.

handleOnPreferenceDialogButtonClick

public boolean handleOnPreferenceDialogButtonClick(@NonNull
                                                   Dialog dialog,
                                                   int button)

Handles button click occurred in the given preference dialog.

Parameters:

dialog - The preference dialog where the button has been clicked.

button - The clicked dialog button.

Returns:

True if this manager is attached to preference screen and the button click has been successfully handled by the associated dialog preference, false otherwise.

See Also:

SettingDialogPreference.handleOnDialogButtonClick(Dialog, int)