Controller (conductor API)

java.lang.Object
- com.bluelinelabs.conductor.Controller

Direct Known Subclasses:

RestoreViewOnCreateController
```
public abstract class Controller
extends java.lang.Object
```
A Controller manages portions of the UI. It is similar to an Activity or Fragment in that it manages its own lifecycle and controls interactions between the UI and whatever logic is required. It is, however, a much lighter weight component than either Activities or Fragments. While it offers several lifecycle methods, they are much simpler and more predictable than those of Activities and Fragments.

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`static class`	`Controller.LifecycleListener` Allows external classes to listen for lifecycle events in a Controller
`static class`	`Controller.RetainViewMode` Modes that will influence when the Controller will allow its view to be destroyed

Constructor Summary

Constructors
Modifier	Constructor and Description
`protected`	`Controller()` Convenience constructor for use when no arguments are needed.
`protected`	`Controller(android.os.Bundle args)` Constructor that takes arguments that need to be retained across restarts.

Method Summary

All Methods Instance Methods Abstract Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`addLifecycleListener(Controller.LifecycleListener lifecycleListener)` Adds a listener for all of this Controller's lifecycle events
`android.app.Activity`	`getActivity()` Returns the host Activity of this Controller's `Router` or `null` if this Controller has not yet been attached to an Activity or if the Activity has been destroyed.
`android.content.Context`	`getApplicationContext()` Returns the Application Context derived from the host Activity or `null` if this Controller has not yet been attached to an Activity or if the Activity has been destroyed.
`android.os.Bundle`	`getArgs()` Returns any arguments that were set in this Controller's constructor
`Router`	`getChildRouter(android.view.ViewGroup container)` Retrieves the child `Router` for the given container.
`Router`	`getChildRouter(android.view.ViewGroup container, java.lang.String tag)` Retrieves the child `Router` for the given container/tag combination.
`Router`	`getChildRouter(android.view.ViewGroup container, java.lang.String tag, boolean createIfNeeded)` Retrieves the child `Router` for the given container/tag combination.
`java.util.List<Router>`	`getChildRouters()` Returns all of this Controller's child Routers
`java.lang.String`	`getInstanceId()` Returns this Controller's instance ID, which is generated when the instance is created and retained across restarts.
`ControllerChangeHandler`	`getOverriddenPopHandler()` Returns the `ControllerChangeHandler` that should be used for popping this Controller, or null if the handler from the `RouterTransaction` should be used instead.
`ControllerChangeHandler`	`getOverriddenPushHandler()` Returns the `ControllerChangeHandler` that should be used for pushing this Controller, or null if the handler from the `RouterTransaction` should be used instead.
`Controller`	`getParentController()` Returns this Controller's parent Controller if it is a child Controller or `null` if it has no parent.
`android.content.res.Resources`	`getResources()` Returns the Resources from the host Activity or `null` if this Controller has not yet been attached to an Activity or if the Activity has been destroyed.
`Controller.RetainViewMode`	`getRetainViewMode()` Returns this Controller's `Controller.RetainViewMode`.
`Router`	`getRouter()` Returns the `Router` object that can be used for pushing or popping other Controllers
`Controller`	`getTargetController()` Returns the target Controller that was set with the `setTargetController(Controller)` method or `null` if this Controller has no target.
`android.view.View`	`getView()` Return this Controller's View or `null` if it has not yet been created or has been destroyed.
`boolean`	`handleBack()` Should be overridden if this Controller needs to handle the back button being pressed.
`boolean`	`isAttached()` Returns whether or not this Controller is currently attached to a host View.
`boolean`	`isBeingDestroyed()` Returns whether or not this Controller is currently in the process of being destroyed.
`boolean`	`isDestroyed()` Returns whether or not this Controller has been destroyed.
`protected void`	`onActivityPaused(android.app.Activity activity)` Called when this Controller's host Activity is paused
`void`	`onActivityResult(int requestCode, int resultCode, android.content.Intent data)` Should be overridden if this Controller has called startActivityForResult and needs to handle the result.
`protected void`	`onActivityResumed(android.app.Activity activity)` Called when this Controller's host Activity is resumed
`protected void`	`onActivityStarted(android.app.Activity activity)` Called when this Controller's host Activity is started
`protected void`	`onActivityStopped(android.app.Activity activity)` Called when this Controller's host Activity is stopped
`protected void`	`onAttach(android.view.View view)` Called when this Controller is attached to its host ViewGroup
`protected void`	`onChangeEnded(ControllerChangeHandler changeHandler, ControllerChangeType changeType)` Called when this Controller completes the process of being swapped in or out of the host view.
`protected void`	`onChangeStarted(ControllerChangeHandler changeHandler, ControllerChangeType changeType)` Called when this Controller begins the process of being swapped in or out of the host view.
`protected void`	`onContextAvailable(android.content.Context context)` Called when this Controller has a Context available to it.
`protected void`	`onContextUnavailable()` Called when this Controller's Context is no longer available.
`void`	`onCreateOptionsMenu(android.view.Menu menu, android.view.MenuInflater inflater)` Adds option items to the host Activity's standard options menu.
`protected abstract android.view.View`	`onCreateView(android.view.LayoutInflater inflater, android.view.ViewGroup container)` Called when the controller is ready to display its view.
`protected void`	`onDestroy()` Called when this Controller has been destroyed.
`protected void`	`onDestroyView(android.view.View view)` Called when this Controller's View is being destroyed.
`protected void`	`onDetach(android.view.View view)` Called when this Controller is detached from its host ViewGroup
`boolean`	`onOptionsItemSelected(android.view.MenuItem item)` Called when an option menu item has been selected by the user.
`void`	`onPrepareOptionsMenu(android.view.Menu menu)` Prepare the screen's options menu to be displayed.
`void`	`onRequestPermissionsResult(int requestCode, java.lang.String[] permissions, int[] grantResults)` Should be overridden if this Controller has requested runtime permissions and needs to handle the user's response.
`protected void`	`onRestoreInstanceState(android.os.Bundle savedInstanceState)` Restores data that was saved in the `onSaveInstanceState(Bundle)` method.
`protected void`	`onRestoreViewState(android.view.View view, android.os.Bundle savedViewState)` Restores data that was saved in the `onSaveViewState(View, Bundle)` method.
`protected void`	`onSaveInstanceState(android.os.Bundle outState)` Called to save this Controller's state in the event that its host Activity is destroyed.
`protected void`	`onSaveViewState(android.view.View view, android.os.Bundle outState)` Called to save this Controller's View state.
`void`	`overridePopHandler(ControllerChangeHandler overriddenPopHandler)` Overrides the `ControllerChangeHandler` that should be used for popping this Controller.
`void`	`overridePushHandler(ControllerChangeHandler overriddenPushHandler)` Overrides the `ControllerChangeHandler` that should be used for pushing this Controller.
`void`	`registerForActivityResult(int requestCode)` Registers this Controller to handle onActivityResult responses.
`void`	`removeChildRouter(Router childRouter)` Removes a child `Router` from this Controller.
`void`	`removeLifecycleListener(Controller.LifecycleListener lifecycleListener)` Removes a previously added lifecycle listener
`void`	`requestPermissions(java.lang.String[] permissions, int requestCode)` Calls requestPermission(String[], int) from this Controller's host Activity.
`void`	`setHasOptionsMenu(boolean hasOptionsMenu)` Registers/unregisters for participation in populating the options menu by receiving options-related callbacks, such as `onCreateOptionsMenu(Menu, MenuInflater)`
`void`	`setOptionsMenuHidden(boolean optionsMenuHidden)` Sets whether or not this controller's menu items should be visible.
`void`	`setRetainViewMode(Controller.RetainViewMode retainViewMode)` Sets this Controller's `Controller.RetainViewMode`, which will influence when its view will be released.
`void`	`setTargetController(Controller target)` Optional target for this Controller.
`boolean`	`shouldShowRequestPermissionRationale(java.lang.String permission)` Gets whether you should show UI with rationale for requesting a permission.
`void`	`startActivity(android.content.Intent intent)` Calls startActivity(Intent) from this Controller's host Activity.
`void`	`startActivityForResult(android.content.Intent intent, int requestCode)` Calls startActivityForResult(Intent, int) from this Controller's host Activity.
`void`	`startActivityForResult(android.content.Intent intent, int requestCode, android.os.Bundle options)` Calls startActivityForResult(Intent, int, Bundle) from this Controller's host Activity.
`void`	`startIntentSenderForResult(android.content.IntentSender intent, int requestCode, android.content.Intent fillInIntent, int flagsMask, int flagsValues, int extraFlags, android.os.Bundle options)` Calls startIntentSenderForResult(IntentSender, int, Intent, int, int, int, Bundle) from this Controller's host Activity.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - Controller
```
protected Controller()
```
    Convenience constructor for use when no arguments are needed.
  - Controller
```
protected Controller(android.os.Bundle args)
```
    Constructor that takes arguments that need to be retained across restarts.
    
    Parameters:
    
    args - Any arguments that need to be retained.
- Method Detail
  - onCreateView
```
protected abstract android.view.View onCreateView(android.view.LayoutInflater inflater,
                                                  android.view.ViewGroup container)
```
    Called when the controller is ready to display its view. A valid view must be returned. The standard body for this method will be return inflater.inflate(R.layout.my_layout, container, false);, plus any binding code.
    
    Parameters:
    
    inflater - The LayoutInflater that should be used to inflate views
    
    container - The parent view that this Controller's view will eventually be attached to. This Controller's view should NOT be added in this method. It is simply passed in so that valid LayoutParams can be used during inflation.
  - getRouter
```
public final Router getRouter()
```
    Returns the Router object that can be used for pushing or popping other Controllers
  - getArgs
```
public android.os.Bundle getArgs()
```
    Returns any arguments that were set in this Controller's constructor
  - getChildRouter
```
public final Router getChildRouter(android.view.ViewGroup container)
```
    Retrieves the child Router for the given container. If no child router for this container exists yet, it will be created.
    
    Parameters:
    
    container - The ViewGroup that hosts the child Router
  - getChildRouter
```
public final Router getChildRouter(android.view.ViewGroup container,
                                   java.lang.String tag)
```
    Retrieves the child Router for the given container/tag combination. If no child router for this container exists yet, it will be created. Note that multiple routers should not exist in the same container unless a lot of care is taken to maintain order between them. Avoid using the same container unless you have a great reason to do so (ex: ViewPagers).
    
    Parameters:
    
    container - The ViewGroup that hosts the child Router
    
    tag - The router's tag or null if none is needed
  - getChildRouter
```
public final Router getChildRouter(android.view.ViewGroup container,
                                   java.lang.String tag,
                                   boolean createIfNeeded)
```
    Retrieves the child Router for the given container/tag combination. Note that multiple routers should not exist in the same container unless a lot of care is taken to maintain order between them. Avoid using the same container unless you have a great reason to do so (ex: ViewPagers). The only time this method will return null is when the child router does not exist prior to calling this method and the createIfNeeded parameter is set to false.
    
    Parameters:
    
    container - The ViewGroup that hosts the child Router
    
    tag - The router's tag or null if none is needed
    
    createIfNeeded - If true, a router will be created if one does not yet exist. Else null will be returned in this case.
  - removeChildRouter
```
public final void removeChildRouter(Router childRouter)
```
    Removes a child Router from this Controller. When removed, all Controllers currently managed by the Router will be destroyed.
    
    Parameters:
    
    childRouter - The router to be removed
  - isDestroyed
```
public final boolean isDestroyed()
```
    Returns whether or not this Controller has been destroyed.
  - isBeingDestroyed
```
public final boolean isBeingDestroyed()
```
    Returns whether or not this Controller is currently in the process of being destroyed.
  - isAttached
```
public final boolean isAttached()
```
    Returns whether or not this Controller is currently attached to a host View.
  - getView
```
public final android.view.View getView()
```
    Return this Controller's View or null if it has not yet been created or has been destroyed.
  - getActivity
```
public final android.app.Activity getActivity()
```
    Returns the host Activity of this Controller's Router or null if this Controller has not yet been attached to an Activity or if the Activity has been destroyed.
  - getResources
```
public final android.content.res.Resources getResources()
```
    Returns the Resources from the host Activity or null if this Controller has not yet been attached to an Activity or if the Activity has been destroyed.
  - getApplicationContext
```
public final android.content.Context getApplicationContext()
```
    Returns the Application Context derived from the host Activity or null if this Controller has not yet been attached to an Activity or if the Activity has been destroyed.
  - getParentController
```
public final Controller getParentController()
```
    Returns this Controller's parent Controller if it is a child Controller or null if it has no parent.
  - getInstanceId
```
public final java.lang.String getInstanceId()
```
    Returns this Controller's instance ID, which is generated when the instance is created and retained across restarts.
  - getChildRouters
```
public final java.util.List<Router> getChildRouters()
```
    Returns all of this Controller's child Routers
  - setTargetController
```
public void setTargetController(Controller target)
```
    Optional target for this Controller. One reason this could be used is to send results back to the Controller that started this one. Target Controllers are retained across instances. It is recommended that Controllers enforce that their target Controller conform to a specific Interface.
    
    Parameters:
    
    target - The Controller that is the target of this one.
  - getTargetController
```
public final Controller getTargetController()
```
    Returns the target Controller that was set with the setTargetController(Controller) method or null if this Controller has no target.
    
    Returns:
    
    This Controller's target
  - onDestroyView
```
protected void onDestroyView(android.view.View view)
```
    Called when this Controller's View is being destroyed. This should overridden to unbind the View from any local variables.
    
    Parameters:
    
    view - The View to which this Controller should be bound.
  - onChangeStarted
```
protected void onChangeStarted(ControllerChangeHandler changeHandler,
                               ControllerChangeType changeType)
```
    Called when this Controller begins the process of being swapped in or out of the host view.
    
    Parameters:
    
    changeHandler - The ControllerChangeHandler that's managing the swap
    
    changeType - The type of change that's occurring
  - onChangeEnded
```
protected void onChangeEnded(ControllerChangeHandler changeHandler,
                             ControllerChangeType changeType)
```
    Called when this Controller completes the process of being swapped in or out of the host view.
    
    Parameters:
    
    changeHandler - The ControllerChangeHandler that's managing the swap
    
    changeType - The type of change that occurred
  - onContextAvailable
```
protected void onContextAvailable(android.content.Context context)
```
    Called when this Controller has a Context available to it. This will happen very early on in the lifecycle (before a view is created). If the host activity is re-created (ex: for orientation change), this will be called again when the new context is available.
  - onContextUnavailable
```
protected void onContextUnavailable()
```
    Called when this Controller's Context is no longer available. This can happen when the Controller is destroyed or when the host Activity is destroyed.
  - onAttach
```
protected void onAttach(android.view.View view)
```
    Called when this Controller is attached to its host ViewGroup
    
    Parameters:
    
    view - The View for this Controller (passed for convenience)
  - onDetach
```
protected void onDetach(android.view.View view)
```
    Called when this Controller is detached from its host ViewGroup
    
    Parameters:
    
    view - The View for this Controller (passed for convenience)
  - onDestroy
```
protected void onDestroy()
```
    Called when this Controller has been destroyed.
  - onActivityStarted
```
protected void onActivityStarted(android.app.Activity activity)
```
    Called when this Controller's host Activity is started
  - onActivityResumed
```
protected void onActivityResumed(android.app.Activity activity)
```
    Called when this Controller's host Activity is resumed
  - onActivityPaused
```
protected void onActivityPaused(android.app.Activity activity)
```
    Called when this Controller's host Activity is paused
  - onActivityStopped
```
protected void onActivityStopped(android.app.Activity activity)
```
    Called when this Controller's host Activity is stopped
  - onSaveViewState
```
protected void onSaveViewState(android.view.View view,
                               android.os.Bundle outState)
```
    Called to save this Controller's View state. As Views can be detached and destroyed as part of the Controller lifecycle (ex: when another Controller has been pushed on top of it), care should be taken to save anything needed to reconstruct the View.
    
    Parameters:
    
    view - This Controller's View, passed for convenience
    
    outState - The Bundle into which the View state should be saved
  - onRestoreViewState
```
protected void onRestoreViewState(android.view.View view,
                                  android.os.Bundle savedViewState)
```
    Restores data that was saved in the onSaveViewState(View, Bundle) method. This should be overridden to restore the View's state to where it was before it was destroyed.
    
    Parameters:
    
    view - This Controller's View, passed for convenience
    
    savedViewState - The bundle that has data to be restored
  - onSaveInstanceState
```
protected void onSaveInstanceState(android.os.Bundle outState)
```
    Called to save this Controller's state in the event that its host Activity is destroyed.
    
    Parameters:
    
    outState - The Bundle into which data should be saved
  - onRestoreInstanceState
```
protected void onRestoreInstanceState(android.os.Bundle savedInstanceState)
```
    Restores data that was saved in the onSaveInstanceState(Bundle) method. This should be overridden to restore this Controller's state to where it was before it was destroyed.
    
    Parameters:
    
    savedInstanceState - The bundle that has data to be restored
  - startActivity
```
public final void startActivity(android.content.Intent intent)
```
    Calls startActivity(Intent) from this Controller's host Activity.
  - startActivityForResult
```
public final void startActivityForResult(android.content.Intent intent,
                                         int requestCode)
```
    Calls startActivityForResult(Intent, int) from this Controller's host Activity.
  - startActivityForResult
```
public final void startActivityForResult(android.content.Intent intent,
                                         int requestCode,
                                         android.os.Bundle options)
```
    Calls startActivityForResult(Intent, int, Bundle) from this Controller's host Activity.
  - startIntentSenderForResult
```
public final void startIntentSenderForResult(android.content.IntentSender intent,
                                             int requestCode,
                                             android.content.Intent fillInIntent,
                                             int flagsMask,
                                             int flagsValues,
                                             int extraFlags,
                                             android.os.Bundle options)
                                      throws android.content.IntentSender.SendIntentException
```
    Calls startIntentSenderForResult(IntentSender, int, Intent, int, int, int, Bundle) from this Controller's host Activity.
    
    Throws:
    
    android.content.IntentSender.SendIntentException
  - registerForActivityResult
```
public final void registerForActivityResult(int requestCode)
```
    Registers this Controller to handle onActivityResult responses. Calling this method is NOT necessary when calling startActivityForResult(Intent, int)
    
    Parameters:
    
    requestCode - The request code being registered for.
  - onActivityResult
```
public void onActivityResult(int requestCode,
                             int resultCode,
                             android.content.Intent data)
```
    Should be overridden if this Controller has called startActivityForResult and needs to handle the result.
    
    Parameters:
    
    requestCode - The requestCode passed to startActivityForResult
    
    resultCode - The resultCode that was returned to the host Activity's onActivityResult method
    
    data - The data Intent that was returned to the host Activity's onActivityResult method
  - requestPermissions
```
public final void requestPermissions(java.lang.String[] permissions,
                                     int requestCode)
```
    Calls requestPermission(String[], int) from this Controller's host Activity. Results for this request, including shouldShowRequestPermissionRationale(String) and onRequestPermissionsResult(int, String[], int[]) will be forwarded back to this Controller by the system.
  - shouldShowRequestPermissionRationale
```
public boolean shouldShowRequestPermissionRationale(java.lang.String permission)
```
    Gets whether you should show UI with rationale for requesting a permission. Activity.shouldShowRequestPermissionRationale(String)
    
    Parameters:
    
    permission - A permission this Controller has requested
  - onRequestPermissionsResult
```
public void onRequestPermissionsResult(int requestCode,
                                       java.lang.String[] permissions,
                                       int[] grantResults)
```
    Should be overridden if this Controller has requested runtime permissions and needs to handle the user's response.
    
    Parameters:
    
    requestCode - The requestCode that was used to request the permissions
    
    permissions - The array of permissions requested
    
    grantResults - The results for each permission requested
  - handleBack
```
public boolean handleBack()
```
    Should be overridden if this Controller needs to handle the back button being pressed.
    
    Returns:
    
    True if this Controller has consumed the back button press, otherwise false
  - addLifecycleListener
```
public final void addLifecycleListener(Controller.LifecycleListener lifecycleListener)
```
    Adds a listener for all of this Controller's lifecycle events
    
    Parameters:
    
    lifecycleListener - The listener
  - removeLifecycleListener
```
public final void removeLifecycleListener(Controller.LifecycleListener lifecycleListener)
```
    Removes a previously added lifecycle listener
    
    Parameters:
    
    lifecycleListener - The listener to be removed
  - getRetainViewMode
```
public Controller.RetainViewMode getRetainViewMode()
```
    Returns this Controller's Controller.RetainViewMode. Defaults to Controller.RetainViewMode.RELEASE_DETACH.
  - setRetainViewMode
```
public void setRetainViewMode(Controller.RetainViewMode retainViewMode)
```
    Sets this Controller's Controller.RetainViewMode, which will influence when its view will be released. This is useful when a Controller's view hierarchy is expensive to tear down and rebuild.
  - getOverriddenPushHandler
```
public final ControllerChangeHandler getOverriddenPushHandler()
```
    Returns the ControllerChangeHandler that should be used for pushing this Controller, or null if the handler from the RouterTransaction should be used instead.
  - overridePushHandler
```
public void overridePushHandler(ControllerChangeHandler overriddenPushHandler)
```
    Overrides the ControllerChangeHandler that should be used for pushing this Controller. If this is a non-null value, it will be used instead of the handler from the RouterTransaction.
  - getOverriddenPopHandler
```
public ControllerChangeHandler getOverriddenPopHandler()
```
    Returns the ControllerChangeHandler that should be used for popping this Controller, or null if the handler from the RouterTransaction should be used instead.
  - overridePopHandler
```
public void overridePopHandler(ControllerChangeHandler overriddenPopHandler)
```
    Overrides the ControllerChangeHandler that should be used for popping this Controller. If this is a non-null value, it will be used instead of the handler from the RouterTransaction.
  - setHasOptionsMenu
```
public final void setHasOptionsMenu(boolean hasOptionsMenu)
```
    Registers/unregisters for participation in populating the options menu by receiving options-related callbacks, such as onCreateOptionsMenu(Menu, MenuInflater)
    
    Parameters:
    
    hasOptionsMenu - If true, this controller's options menu callbacks will be called.
  - setOptionsMenuHidden
```
public final void setOptionsMenuHidden(boolean optionsMenuHidden)
```
    Sets whether or not this controller's menu items should be visible. This is useful for hiding the controller's options menu items when its UI is hidden, and not just when it is detached from the window (the default).
    
    Parameters:
    
    optionsMenuHidden - Defaults to false. If true, this controller's menu items will not be shown.
  - onCreateOptionsMenu
```
public void onCreateOptionsMenu(android.view.Menu menu,
                                android.view.MenuInflater inflater)
```
    Adds option items to the host Activity's standard options menu. This will only be called if setHasOptionsMenu(boolean) has been called.
    
    Parameters:
    
    menu - The menu into which your options should be placed.
    
    inflater - The inflater that can be used to inflate your menu items.
  - onPrepareOptionsMenu
```
public void onPrepareOptionsMenu(android.view.Menu menu)
```
    Prepare the screen's options menu to be displayed. This is called directly before showing the menu and can be used modify its contents.
    
    Parameters:
    
    menu - The menu that will be displayed
  - onOptionsItemSelected
```
public boolean onOptionsItemSelected(android.view.MenuItem item)
```
    Called when an option menu item has been selected by the user.
    
    Parameters:
    
    item - The selected item.
    
    Returns:
    
    True if this event has been consumed, false if it has not.

Class Controller

Nested Class Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

Controller

Controller

Method Detail

onCreateView

getRouter

getArgs

getChildRouter

getChildRouter

getChildRouter

removeChildRouter

isDestroyed

isBeingDestroyed

isAttached

getView

getActivity

getResources

getApplicationContext

getParentController

getInstanceId

getChildRouters

setTargetController

getTargetController

onDestroyView

onChangeStarted

onChangeEnded

onContextAvailable

onContextUnavailable

onAttach

onDetach

onDestroy

onActivityStarted

onActivityResumed

onActivityPaused

onActivityStopped

onSaveViewState

onRestoreViewState

onSaveInstanceState

onRestoreInstanceState

startActivity

startActivityForResult

startActivityForResult

startIntentSenderForResult

registerForActivityResult

onActivityResult

requestPermissions

shouldShowRequestPermissionRationale

onRequestPermissionsResult

handleBack

addLifecycleListener

removeLifecycleListener

getRetainViewMode

setRetainViewMode

getOverriddenPushHandler

overridePushHandler

getOverriddenPopHandler

overridePopHandler

setHasOptionsMenu

setOptionsMenuHidden

onCreateOptionsMenu

onPrepareOptionsMenu

onOptionsItemSelected