Save the date! Android Dev Summit is coming to Sunnyvale, CA on Oct 23-24, 2019.

ActionBarDrawerToggle

open class ActionBarDrawerToggle : DrawerLayout.DrawerListener
kotlin.Any
   ↳ androidx.legacy.app.ActionBarDrawerToggle

Deprecated.

This class provides a handy way to tie together the functionality of DrawerLayout and the framework ActionBar to implement the recommended design for navigation drawers.

To use ActionBarDrawerToggle, create one in your Activity and call through to the following methods corresponding to your Activity callbacks:

Call syncState() from your Activity's onPostCreate to synchronize the indicator with the state of the linked DrawerLayout after onRestoreInstanceState has occurred.

ActionBarDrawerToggle can be used directly as a DrawerLayout.DrawerListener, or if you are already providing your own listener, call through to each of the listener methods from your own.

Summary

Nested classes
abstract

abstract

Allows an implementing Activity to return an ActionBarDrawerToggle.Delegate to use with ActionBarDrawerToggle.

Public constructors
<init>(activity: Activity!, drawerLayout: DrawerLayout!, @DrawableRes drawerImageRes: Int, @StringRes openDrawerContentDescRes: Int, @StringRes closeDrawerContentDescRes: Int)

Construct a new ActionBarDrawerToggle.

<init>(activity: Activity!, drawerLayout: DrawerLayout!, animate: Boolean, @DrawableRes drawerImageRes: Int, @StringRes openDrawerContentDescRes: Int, @StringRes closeDrawerContentDescRes: Int)

Construct a new ActionBarDrawerToggle.

Public methods
open Boolean

open Unit

This method should always be called by your Activity's onConfigurationChanged method.

open Unit
onDrawerClosed(drawerView: View)

DrawerLayout.DrawerListener callback method.

open Unit
onDrawerOpened(drawerView: View)

DrawerLayout.DrawerListener callback method.

open Unit
onDrawerSlide(drawerView: View, slideOffset: Float)

DrawerLayout.DrawerListener callback method.

open Unit

DrawerLayout.DrawerListener callback method.

open Boolean

This method should be called by your Activity's onOptionsItemSelected method.

open Unit

Enable or disable the drawer indicator.

open Unit

Set the up indicator to display when the drawer indicator is not enabled.

open Unit

Set the up indicator to display when the drawer indicator is not enabled.

open Unit

Synchronize the state of the drawer indicator/affordance with the linked DrawerLayout.

Public constructors

<init>

ActionBarDrawerToggle(activity: Activity!, drawerLayout: DrawerLayout!, @DrawableRes drawerImageRes: Int, @StringRes openDrawerContentDescRes: Int, @StringRes closeDrawerContentDescRes: Int)

Construct a new ActionBarDrawerToggle.

The given Activity will be linked to the specified DrawerLayout. The provided drawer indicator drawable will animate slightly off-screen as the drawer is opened, indicating that in the open state the drawer will move off-screen when pressed and in the closed state the drawer will move on-screen when pressed.

String resources must be provided to describe the open/close drawer actions for accessibility services.

Parameters
activity Activity!: The Activity hosting the drawer
drawerLayout Activity!: The DrawerLayout to link to the given Activity's ActionBar
drawerImageRes Activity!: A Drawable resource to use as the drawer indicator
openDrawerContentDescRes Activity!: A String resource to describe the "open drawer" action for accessibility
closeDrawerContentDescRes Activity!: A String resource to describe the "close drawer" action for accessibility

<init>

ActionBarDrawerToggle(activity: Activity!, drawerLayout: DrawerLayout!, animate: Boolean, @DrawableRes drawerImageRes: Int, @StringRes openDrawerContentDescRes: Int, @StringRes closeDrawerContentDescRes: Int)

Construct a new ActionBarDrawerToggle.

The given Activity will be linked to the specified DrawerLayout. The provided drawer indicator drawable will animate slightly off-screen as the drawer is opened, indicating that in the open state the drawer will move off-screen when pressed and in the closed state the drawer will move on-screen when pressed.

String resources must be provided to describe the open/close drawer actions for accessibility services.

Parameters
activity Activity!: The Activity hosting the drawer
drawerLayout Activity!: The DrawerLayout to link to the given Activity's ActionBar
animate Activity!: True to animate the drawer indicator along with the drawer's position. Material apps should set this to false.
drawerImageRes Activity!: A Drawable resource to use as the drawer indicator
openDrawerContentDescRes Activity!: A String resource to describe the "open drawer" action for accessibility
closeDrawerContentDescRes Activity!: A String resource to describe the "close drawer" action for accessibility

Public methods

isDrawerIndicatorEnabled

open fun isDrawerIndicatorEnabled(): Boolean
Return
Boolean: true if the enhanced drawer indicator is enabled, false otherwise

onConfigurationChanged

open fun onConfigurationChanged(newConfig: Configuration!): Unit

This method should always be called by your Activity's onConfigurationChanged method.

Parameters
newConfig Configuration!: The new configuration

onDrawerClosed

open fun onDrawerClosed(drawerView: View): Unit

DrawerLayout.DrawerListener callback method. If you do not use your ActionBarDrawerToggle instance directly as your DrawerLayout's listener, you should call through to this method from your own listener object.

Parameters
drawerView View: Drawer view that is now closed

onDrawerOpened

open fun onDrawerOpened(drawerView: View): Unit

DrawerLayout.DrawerListener callback method. If you do not use your ActionBarDrawerToggle instance directly as your DrawerLayout's listener, you should call through to this method from your own listener object.

Parameters
drawerView View: Drawer view that is now open

onDrawerSlide

open fun onDrawerSlide(drawerView: View, slideOffset: Float): Unit

DrawerLayout.DrawerListener callback method. If you do not use your ActionBarDrawerToggle instance directly as your DrawerLayout's listener, you should call through to this method from your own listener object.

Parameters
drawerView View: The child view that was moved
slideOffset View: The new offset of this drawer within its range, from 0-1

onDrawerStateChanged

open fun onDrawerStateChanged(newState: Int): Unit

DrawerLayout.DrawerListener callback method. If you do not use your ActionBarDrawerToggle instance directly as your DrawerLayout's listener, you should call through to this method from your own listener object.

Parameters
newState Int: The new drawer motion state

onOptionsItemSelected

open fun onOptionsItemSelected(item: MenuItem!): Boolean

This method should be called by your Activity's onOptionsItemSelected method. If it returns true, your onOptionsItemSelected method should return true and skip further processing.

Parameters
item MenuItem!: the MenuItem instance representing the selected menu item
Return
Boolean: true if the event was handled and further processing should not occur

setDrawerIndicatorEnabled

open fun setDrawerIndicatorEnabled(enable: Boolean): Unit

Enable or disable the drawer indicator. The indicator defaults to enabled.

When the indicator is disabled, the ActionBar will revert to displaying the home-as-up indicator provided by the Activity's theme in the android.R.attr.homeAsUpIndicator attribute instead of the animated drawer glyph.

Parameters
enable Boolean: true to enable, false to disable

setHomeAsUpIndicator

open fun setHomeAsUpIndicator(indicator: Drawable!): Unit

Set the up indicator to display when the drawer indicator is not enabled.

If you pass null to this method, the default drawable from the theme will be used.

Parameters
indicator Drawable!: A drawable to use for the up indicator, or null to use the theme's default

setHomeAsUpIndicator

open fun setHomeAsUpIndicator(resId: Int): Unit

Set the up indicator to display when the drawer indicator is not enabled.

If you pass 0 to this method, the default drawable from the theme will be used.

Parameters
resId Int: Resource ID of a drawable to use for the up indicator, or 0 to use the theme's default

syncState

open fun syncState(): Unit

Synchronize the state of the drawer indicator/affordance with the linked DrawerLayout.

This should be called from your Activity's onPostCreate method to synchronize after the DrawerLayout's instance state has been restored, and any other time when the state may have diverged in such a way that the ActionBarDrawerToggle was not notified. (For example, if you stop forwarding appropriate drawer events for a period of time.)