AppCompatActivity.java revision f3ad1351d8b40ec5defe35e79d3430ad3c384b6d
1f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes/* 2f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * Copyright (C) 2015 The Android Open Source Project 3f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * 4f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * Licensed under the Apache License, Version 2.0 (the "License"); 5f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * you may not use this file except in compliance with the License. 6f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * You may obtain a copy of the License at 7f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * 8f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * http://www.apache.org/licenses/LICENSE-2.0 9f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * 10f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * Unless required by applicable law or agreed to in writing, software 11f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * distributed under the License is distributed on an "AS IS" BASIS, 12f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * See the License for the specific language governing permissions and 14f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * limitations under the License. 15f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes */ 16f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes 17f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banespackage android.support.v7.app; 18f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes 19f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banesimport android.content.Intent; 20f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banesimport android.content.res.Configuration; 21f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banesimport android.os.Bundle; 22f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banesimport android.support.annotation.LayoutRes; 23f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banesimport android.support.annotation.Nullable; 24f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banesimport android.support.v4.app.ActivityCompat; 25f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banesimport android.support.v4.app.FragmentActivity; 26f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banesimport android.support.v4.app.NavUtils; 27f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banesimport android.support.v4.app.TaskStackBuilder; 28f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banesimport android.support.v7.view.ActionMode; 29f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banesimport android.support.v7.widget.Toolbar; 30f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banesimport android.view.MenuInflater; 31f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banesimport android.view.View; 32f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banesimport android.view.ViewGroup; 33f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes 34f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes/** 35f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * Base class for activities that use the 36f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * <a href="{@docRoot}tools/extras/support-library.html">support library</a> action bar features. 37f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * 38f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * <p>You can add an {@link android.support.v7.app.ActionBar} to your activity when running on API level 7 or higher 39f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * by extending this class for your activity and setting the activity theme to 40f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * {@link android.support.v7.appcompat.R.style#Theme_AppCompat Theme.AppCompat} or a similar theme. 41f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * 42f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * <div class="special reference"> 43f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * <h3>Developer Guides</h3> 44f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * 45f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * <p>For information about how to use the action bar, including how to add action items, navigation 46f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * modes and more, read the <a href="{@docRoot}guide/topics/ui/actionbar.html">Action 47f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * Bar</a> API guide.</p> 48f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * </div> 49f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes */ 50f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banespublic class AppCompatActivity extends FragmentActivity implements AppCompatActivityCallback, 51f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes TaskStackBuilder.SupportParentable, ActionBarDrawerToggle.DelegateProvider { 52f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes 53f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes private AppCompatDelegate mDelegate; 54f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes 55f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes @Override 56f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes protected void onCreate(Bundle savedInstanceState) { 57f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes getDelegate().installViewFactory(); 58f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes super.onCreate(savedInstanceState); 59f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes getDelegate().onCreate(savedInstanceState); 60f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes } 61f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes 62f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes @Override 63f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes protected void onPostCreate(Bundle savedInstanceState) { 64f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes super.onPostCreate(savedInstanceState); 65f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes getDelegate().onPostCreate(savedInstanceState); 66f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes } 67f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes 68f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes /** 69f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * Support library version of {@link android.app.Activity#getActionBar}. 70f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * 71f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * <p>Retrieve a reference to this activity's ActionBar. 72f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * 73f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * @return The Activity's ActionBar, or null if it does not have one. 74f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes */ 75f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes public ActionBar getSupportActionBar() { 76f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes return getDelegate().getSupportActionBar(); 77f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes } 78f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes 79f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes /** 80f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * Set a {@link android.widget.Toolbar Toolbar} to act as the {@link android.support.v7.app.ActionBar} for this 81f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * Activity window. 82f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * 83f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * <p>When set to a non-null value the {@link #getActionBar()} method will return 84f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * an {@link android.support.v7.app.ActionBar} object that can be used to control the given toolbar as if it were 85f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * a traditional window decor action bar. The toolbar's menu will be populated with the 86f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * Activity's options menu and the navigation button will be wired through the standard 87f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * {@link android.R.id#home home} menu select action.</p> 88f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * 89f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * <p>In order to use a Toolbar within the Activity's window content the application 90f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * must not request the window feature {@link android.view.Window#FEATURE_ACTION_BAR FEATURE_ACTION_BAR}.</p> 91f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * 92f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * @param toolbar Toolbar to set as the Activity's action bar 93f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes */ 94f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes public void setSupportActionBar(@Nullable Toolbar toolbar) { 95f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes getDelegate().setSupportActionBar(toolbar); 96f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes } 97f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes 98f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes @Override 99f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes public MenuInflater getMenuInflater() { 100f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes return getDelegate().getMenuInflater(); 101f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes } 102f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes 103f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes @Override 104f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes public void setContentView(@LayoutRes int layoutResID) { 105f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes getDelegate().setContentView(layoutResID); 106f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes } 107f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes 108f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes @Override 109f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes public void setContentView(View view) { 110f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes getDelegate().setContentView(view); 111f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes } 112f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes 113f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes @Override 114f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes public void setContentView(View view, ViewGroup.LayoutParams params) { 115f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes getDelegate().setContentView(view, params); 116f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes } 117f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes 118f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes @Override 119f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes public void addContentView(View view, ViewGroup.LayoutParams params) { 120f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes getDelegate().addContentView(view, params); 121f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes } 122f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes 123f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes @Override 124f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes public void onConfigurationChanged(Configuration newConfig) { 125f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes super.onConfigurationChanged(newConfig); 126f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes getDelegate().onConfigurationChanged(newConfig); 127f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes } 128f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes 129f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes @Override 130f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes protected void onStop() { 131f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes super.onStop(); 132f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes getDelegate().onStop(); 133f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes } 134f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes 135f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes @Override 136f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes protected void onPostResume() { 137f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes super.onPostResume(); 138f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes getDelegate().onPostResume(); 139f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes } 140f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes 141f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes @Override 142f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes public final boolean onMenuItemSelected(int featureId, android.view.MenuItem item) { 143f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes if (super.onMenuItemSelected(featureId, item)) { 144f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes return true; 145f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes } 146f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes 147f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes final ActionBar ab = getSupportActionBar(); 148f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes if (item.getItemId() == android.R.id.home && ab != null && 149f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes (ab.getDisplayOptions() & ActionBar.DISPLAY_HOME_AS_UP) != 0) { 150f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes return onSupportNavigateUp(); 151f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes } 152f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes return false; 153f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes } 154f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes 155f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes @Override 156f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes protected void onDestroy() { 157f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes super.onDestroy(); 158f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes getDelegate().onDestroy(); 159f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes } 160f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes 161f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes @Override 162f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes protected void onTitleChanged(CharSequence title, int color) { 163f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes super.onTitleChanged(title, color); 164f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes getDelegate().onTitleChanged(title); 165f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes } 166f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes 167f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes /** 168f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * Enable extended support library window features. 169f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * <p> 170f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * This is a convenience for calling 171f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * {@link android.view.Window#requestFeature getWindow().requestFeature()}. 172f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * </p> 173f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * 174f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * @param featureId The desired feature as defined in 175f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * {@link android.view.Window} or {@link android.support.v4.view.WindowCompat}. 176f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * @return Returns true if the requested feature is supported and now enabled. 177f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * 178f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * @see android.app.Activity#requestWindowFeature 179f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * @see android.view.Window#requestFeature 180f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes */ 181f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes public boolean supportRequestWindowFeature(int featureId) { 182f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes return getDelegate().requestWindowFeature(featureId); 183f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes } 184f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes 185f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes @Override 186f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes public void supportInvalidateOptionsMenu() { 187f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes getDelegate().invalidateOptionsMenu(); 188f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes } 189f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes 190f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes /** 191f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * @hide 192f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes */ 193f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes public void invalidateOptionsMenu() { 194f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes getDelegate().invalidateOptionsMenu(); 195f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes } 196f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes 197f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes /** 198f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * Notifies the Activity that a support action mode has been started. 199f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * Activity subclasses overriding this method should call the superclass implementation. 200f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * 201f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * @param mode The new action mode. 202f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes */ 203f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes public void onSupportActionModeStarted(ActionMode mode) { 204f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes } 205f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes 206f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes /** 207f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * Notifies the activity that a support action mode has finished. 208f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * Activity subclasses overriding this method should call the superclass implementation. 209f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * 210f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * @param mode The action mode that just finished. 211f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes */ 212f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes public void onSupportActionModeFinished(ActionMode mode) { 213f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes } 214f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes 215f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes public ActionMode startSupportActionMode(ActionMode.Callback callback) { 216f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes return getDelegate().startSupportActionMode(callback); 217f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes } 218f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes 219f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes /** 220f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * @deprecated Progress bars are no longer provided in AppCompat. 221f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes */ 222f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes @Deprecated 223f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes public void setSupportProgressBarVisibility(boolean visible) { 224f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes } 225f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes 226f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes /** 227f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * @deprecated Progress bars are no longer provided in AppCompat. 228f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes */ 229f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes @Deprecated 230f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes public void setSupportProgressBarIndeterminateVisibility(boolean visible) { 231f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes } 232f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes 233f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes /** 234f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * @deprecated Progress bars are no longer provided in AppCompat. 235f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes */ 236f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes @Deprecated 237f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes public void setSupportProgressBarIndeterminate(boolean indeterminate) { 238f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes } 239f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes 240f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes /** 241f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * @deprecated Progress bars are no longer provided in AppCompat. 242f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes */ 243f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes @Deprecated 244f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes public void setSupportProgress(int progress) { 245f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes } 246f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes 247f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes /** 248f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * Support version of {@link #onCreateNavigateUpTaskStack(android.app.TaskStackBuilder)}. 249f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * This method will be called on all platform versions. 250f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * 251f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * Define the synthetic task stack that will be generated during Up navigation from 252f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * a different task. 253f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * 254f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * <p>The default implementation of this method adds the parent chain of this activity 255f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * as specified in the manifest to the supplied {@link android.support.v4.app.TaskStackBuilder}. Applications 256f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * may choose to override this method to construct the desired task stack in a different 257f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * way.</p> 258f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * 259f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * <p>This method will be invoked by the default implementation of {@link #onNavigateUp()} 260f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * if {@link #shouldUpRecreateTask(android.content.Intent)} returns true when supplied with the intent 261f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * returned by {@link #getParentActivityIntent()}.</p> 262f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * 263f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * <p>Applications that wish to supply extra Intent parameters to the parent stack defined 264f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * by the manifest should override 265f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * {@link #onPrepareSupportNavigateUpTaskStack(android.support.v4.app.TaskStackBuilder)}.</p> 266f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * 267f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * @param builder An empty TaskStackBuilder - the application should add intents representing 268f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * the desired task stack 269f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes */ 270f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes public void onCreateSupportNavigateUpTaskStack(TaskStackBuilder builder) { 271f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes builder.addParentStack(this); 272f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes } 273f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes 274f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes /** 275f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * Support version of {@link #onPrepareNavigateUpTaskStack(android.app.TaskStackBuilder)}. 276f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * This method will be called on all platform versions. 277f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * 278f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * Prepare the synthetic task stack that will be generated during Up navigation 279f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * from a different task. 280f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * 281f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * <p>This method receives the {@link android.support.v4.app.TaskStackBuilder} with the constructed series of 282f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * Intents as generated by {@link #onCreateSupportNavigateUpTaskStack(android.support.v4.app.TaskStackBuilder)}. 283f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * If any extra data should be added to these intents before launching the new task, 284f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * the application should override this method and add that data here.</p> 285f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * 286f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * @param builder A TaskStackBuilder that has been populated with Intents by 287f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * onCreateNavigateUpTaskStack. 288f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes */ 289f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes public void onPrepareSupportNavigateUpTaskStack(TaskStackBuilder builder) { 290f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes } 291f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes 292f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes /** 293f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * This method is called whenever the user chooses to navigate Up within your application's 294f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * activity hierarchy from the action bar. 295f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * 296f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * <p>If a parent was specified in the manifest for this activity or an activity-alias to it, 297f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * default Up navigation will be handled automatically. See 298f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * {@link #getSupportParentActivityIntent()} for how to specify the parent. If any activity 299f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * along the parent chain requires extra Intent arguments, the Activity subclass 300f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * should override the method {@link #onPrepareSupportNavigateUpTaskStack(android.support.v4.app.TaskStackBuilder)} 301f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * to supply those arguments.</p> 302f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * 303f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * <p>See <a href="{@docRoot}guide/topics/fundamentals/tasks-and-back-stack.html">Tasks and 304f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * Back Stack</a> from the developer guide and 305f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * <a href="{@docRoot}design/patterns/navigation.html">Navigation</a> from the design guide 306f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * for more information about navigating within your app.</p> 307f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * 308f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * <p>See the {@link android.support.v4.app.TaskStackBuilder} class and the Activity methods 309f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * {@link #getSupportParentActivityIntent()}, {@link #supportShouldUpRecreateTask(android.content.Intent)}, and 310f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * {@link #supportNavigateUpTo(android.content.Intent)} for help implementing custom Up navigation.</p> 311f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * 312f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * @return true if Up navigation completed successfully and this Activity was finished, 313f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * false otherwise. 314f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes */ 315f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes public boolean onSupportNavigateUp() { 316f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes Intent upIntent = getSupportParentActivityIntent(); 317f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes 318f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes if (upIntent != null) { 319f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes if (supportShouldUpRecreateTask(upIntent)) { 320f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes TaskStackBuilder b = TaskStackBuilder.create(this); 321f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes onCreateSupportNavigateUpTaskStack(b); 322f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes onPrepareSupportNavigateUpTaskStack(b); 323f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes b.startActivities(); 324f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes 325f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes try { 326f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes ActivityCompat.finishAffinity(this); 327f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes } catch (IllegalStateException e) { 328f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes // This can only happen on 4.1+, when we don't have a parent or a result set. 329f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes // In that case we should just finish(). 330f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes finish(); 331f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes } 332f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes } else { 333f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes // This activity is part of the application's task, so simply 334f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes // navigate up to the hierarchical parent activity. 335f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes supportNavigateUpTo(upIntent); 336f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes } 337f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes return true; 338f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes } 339f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes return false; 340f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes } 341f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes 342f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes /** 343f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * Obtain an {@link android.content.Intent} that will launch an explicit target activity 344f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * specified by sourceActivity's {@link android.support.v4.app.NavUtils#PARENT_ACTIVITY} <meta-data> 345f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * element in the application's manifest. If the device is running 346f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * Jellybean or newer, the android:parentActivityName attribute will be preferred 347f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * if it is present. 348f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * 349f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * @return a new Intent targeting the defined parent activity of sourceActivity 350f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes */ 351f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes public Intent getSupportParentActivityIntent() { 352f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes return NavUtils.getParentActivityIntent(this); 353f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes } 354f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes 355f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes /** 356f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * Returns true if sourceActivity should recreate the task when navigating 'up' 357f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * by using targetIntent. 358f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * 359f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * <p>If this method returns false the app can trivially call 360f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * {@link #supportNavigateUpTo(android.content.Intent)} using the same parameters to correctly perform 361f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * up navigation. If this method returns false, the app should synthesize a new task stack 362f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * by using {@link android.support.v4.app.TaskStackBuilder} or another similar mechanism to perform up navigation.</p> 363f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * 364f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * @param targetIntent An intent representing the target destination for up navigation 365f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * @return true if navigating up should recreate a new task stack, false if the same task 366f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * should be used for the destination 367f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes */ 368f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes public boolean supportShouldUpRecreateTask(Intent targetIntent) { 369f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes return NavUtils.shouldUpRecreateTask(this, targetIntent); 370f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes } 371f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes 372f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes /** 373f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * Navigate from sourceActivity to the activity specified by upIntent, finishing sourceActivity 374f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * in the process. upIntent will have the flag {@link android.content.Intent#FLAG_ACTIVITY_CLEAR_TOP} set 375f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * by this method, along with any others required for proper up navigation as outlined 376f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * in the Android Design Guide. 377f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * 378f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * <p>This method should be used when performing up navigation from within the same task 379f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * as the destination. If up navigation should cross tasks in some cases, see 380f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * {@link #supportShouldUpRecreateTask(android.content.Intent)}.</p> 381f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * 382f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * @param upIntent An intent representing the target destination for up navigation 383f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes */ 384f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes public void supportNavigateUpTo(Intent upIntent) { 385f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes NavUtils.navigateUpTo(this, upIntent); 386f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes } 387f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes 388f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes @Override 389f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes public void onContentChanged() { 390f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes // Call onSupportContentChanged() for legacy reasons 391f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes onSupportContentChanged(); 392f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes } 393f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes 394f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes /** 395f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * @deprecated Use {@link #onContentChanged()} instead. 396f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes */ 397f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes @Deprecated 398f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes public void onSupportContentChanged() { 399f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes } 400f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes 401f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes @Nullable 402f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes @Override 403f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes public ActionBarDrawerToggle.Delegate getDrawerToggleDelegate() { 404f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes return getDelegate().getDrawerToggleDelegate(); 405f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes } 406f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes 407f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes /** 408f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * @return The {@link AppCompatDelegate} being used by this Activity. 409f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes */ 410f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes public AppCompatDelegate getDelegate() { 411f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes if (mDelegate == null) { 412f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes mDelegate = AppCompatDelegate.create(this, this); 413f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes } 414f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes return mDelegate; 415f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes } 416f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes} 417