de.dimensionv.android.androdialogs.common

Class FragmentDialogController<T extends ActionHandler>

java.lang.Object

de.dimensionv.android.androdialogs.common.FragmentDialogController<T>

public class FragmentDialogController<T extends ActionHandler>
extends Object

An abstract base-class for easing automated dialog creation.

This class will make use of the ConfirmationActionHandler. Should the Activity calling this dialog not implement this interface, a ClassCastException will be thrown with an appropriate error-message.

Since:

API 1.0.0

Constructor Summary

Constructors

Constructor and Description
FragmentDialogController(Class<T> type, boolean registerHandler, DialogFragmentInterface parent) This constructor initializes the BaseDialogFragment.

Method Summary

Methods

Modifier and Type	Method and Description
android.view.View	callInterceptor(android.view.View view) Calls the ViewInterceptor of the parent dialog fragment.
boolean	canRegisterHandler() Returns the registerHandler flag, which is used to determine whether an ActionHandler should be registered or not.
T	getActionHandler() Returns the currently set ActionHandler, or null if none was set.
String	getDialogTag() Returns the tag under which the parent dialog can be registered with the fragment manager.
ViewInterceptor	getViewInterceptor() Returns the ViewInterceptor of the parent dialog.
void	onAttach(android.app.Activity activity) Called when a fragment is first attached to its activity.
android.app.Dialog	onCreateDialog(android.os.Bundle savedInstanceState) Shows an AlertDialog, set the buttons and populate the Dialog with content.
void	setActionHandler(T handler) Sets the ActionHandler explicitly.
void	setRegisterHandler(boolean registerHandler) Sets the flag whether to allow automatic implicit registering of an ActionHandler.
void	setViewInterceptor(ViewInterceptor interceptor) Sets the ViewInterceptor for the parent dialog fragment.

Methods inherited from class java.lang.Object

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

Constructor Detail

FragmentDialogController

public FragmentDialogController(Class<T> type,
                        boolean registerHandler,
                        DialogFragmentInterface parent)

This constructor initializes the BaseDialogFragment. All descendents must call through to either this or the default constructor.

The registerHandler parameter is used to allow or forbid registering the parent Activity as an ActionHandler.

In case it is forbidden, the method setActionHandler() can (and should) be used to set an ActionHandler manually that can actually be any class, not just the parent Activity.

Parameters:

registerHandler - Flag whether to register an ActionHandler or not.

Method Detail

onCreateDialog

public android.app.Dialog onCreateDialog(android.os.Bundle savedInstanceState)

Shows an AlertDialog, set the buttons and populate the Dialog with content.

Parameters:

savedInstanceState - The last saved instance state of the Fragment, or null if this is a freshly created Fragment.

Returns:

Return a new Dialog instance to be displayed by the Fragment.

onAttach

public void onAttach(android.app.Activity activity)

Called when a fragment is first attached to its activity. onCreate(Bundle) will be called after this.

Parameters:

activity - the Activity this dialog is attached to.

setActionHandler

public void setActionHandler(T handler)

Sets the ActionHandler explicitly.

Parameters:

handler - the ActionHandler to set

canRegisterHandler

public boolean canRegisterHandler()

Returns the registerHandler flag, which is used to determine whether an ActionHandler should be registered or not.

Returns:

the registerHandler

setRegisterHandler

public void setRegisterHandler(boolean registerHandler)

Sets the flag whether to allow automatic implicit registering of an ActionHandler.

Parameters:

registerHandler - Flag whether to register an ActionHandler or not.

See Also:

ActionHandler

setViewInterceptor

public void setViewInterceptor(ViewInterceptor interceptor)

Sets the ViewInterceptor for the parent dialog fragment.

Parameters:

interceptor - The ViewInterceptor for the parent dialog fragment.

See Also:

ViewInterceptor

getViewInterceptor

public ViewInterceptor getViewInterceptor()

Returns the ViewInterceptor of the parent dialog.

Returns:

The ViewInterceptor of the parent dialog fragment.

callInterceptor

public android.view.View callInterceptor(android.view.View view)

Calls the ViewInterceptor of the parent dialog fragment.

Parameters:

view - The View containing this dialog's UI elements

Returns:

The view that's been handed over to this method.

getDialogTag

public String getDialogTag()

Returns the tag under which the parent dialog can be registered with the fragment manager.

Returns:

The default tag under which the parent dialog can be registered with the FragmentManager.

getActionHandler

public T getActionHandler()

Returns the currently set ActionHandler, or null if none was set.

Returns:

The ActionHandler of the parent dialog, or null if none was set.