universum.studios.android.setting

Class SettingDialogPreferenceManager

java.lang.Object

universum.studios.android.setting.SettingDialogPreferenceManager

All Implemented Interfaces:

SettingDialogPreference.OnClickListener

public class SettingDialogPreferenceManager
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
SettingDialogPreferenceManager() Creates a new instance of SettingDialogPreferencesManager without either DialogController nor default DialogFactory.
SettingDialogPreferenceManager(android.app.Activity activity) Creates a new instance of SettingDialogPreferencesManager for the given activity context.
SettingDialogPreferenceManager(android.app.Fragment fragment) Creates a new instance of SettingDialogPreferencesManager for the given fragment context.
SettingDialogPreferenceManager(android.app.FragmentManager fragmentManager) Creates a new instance of SettingDialogPreferencesManager for the given fragmentManager context.

Method Summary

Modifier and Type	Method and Description
void	attachToPreferenceScreen(android.preference.PreferenceScreen preferenceScreen) Attaches this manager to the given preferenceScreen.
void	detachFromPreferenceScreen(android.preference.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.
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(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

SettingDialogPreferenceManager

public SettingDialogPreferenceManager()

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

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

See Also:

SettingDialogPreferenceManager(Activity), SettingDialogPreferenceManager(Fragment)

SettingDialogPreferenceManager

public SettingDialogPreferenceManager(android.app.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:

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

SettingDialogPreferenceManager

public SettingDialogPreferenceManager(android.app.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:

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

SettingDialogPreferenceManager

public SettingDialogPreferenceManager(android.app.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(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(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#setFactory(DialogFactory).

Parameters:

dialogController - The desired dialog controller.

See Also:

getDialogController(), setDialogFactory(DialogFactory)

getDialogController

public DialogController getDialogController()

Returns the dialog controller used by this manager.

Returns:

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

See Also:

SettingDialogPreferenceManager(Activity), SettingDialogPreferenceManager(Fragment), SettingDialogPreferenceManager(FragmentManager)

setDialogFactory

public void setDialogFactory(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#setFactory(DialogFactory).

Parameters:

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

See Also:

getDialogFactory(), setDialogController(DialogController)

getDialogFactory

public DialogFactory getDialogFactory()

Returns the current dialog factory set to this manager.

Returns:

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

See Also:

setDialogFactory(DialogFactory), SettingDialogPreferenceManager(Activity), SettingDialogPreferenceManager(Fragment)

attachToPreferenceScreen

public void attachToPreferenceScreen(android.preference.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(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

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(android.preference.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(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(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(DialogController dialogController,
                                         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(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)