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 17ac5fe7c617c66850fff75a9fce9979c6e5674b0fAurimas Liutikaspackage androidx.appcompat.app; 18f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes 19f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banesimport android.content.Intent; 20f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banesimport android.content.res.Configuration; 215fa121a1f51114f3a2f6d705139e83c0e0aea610Chris Banesimport android.content.res.Resources; 225ed351700cfa30de2d4f7e431dea2b30e23d7982Alan Viveretteimport android.os.Build; 23f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banesimport android.os.Bundle; 243de8a4e8305507475d7890205184946a25cf45e7Aurimas Liutikasimport android.util.DisplayMetrics; 253de8a4e8305507475d7890205184946a25cf45e7Aurimas Liutikasimport android.view.KeyEvent; 263de8a4e8305507475d7890205184946a25cf45e7Aurimas Liutikasimport android.view.Menu; 273de8a4e8305507475d7890205184946a25cf45e7Aurimas Liutikasimport android.view.MenuInflater; 283de8a4e8305507475d7890205184946a25cf45e7Aurimas Liutikasimport android.view.View; 293de8a4e8305507475d7890205184946a25cf45e7Aurimas Liutikasimport android.view.ViewGroup; 303de8a4e8305507475d7890205184946a25cf45e7Aurimas Liutikasimport android.view.Window; 313de8a4e8305507475d7890205184946a25cf45e7Aurimas Liutikas 32ac5fe7c617c66850fff75a9fce9979c6e5674b0fAurimas Liutikasimport androidx.annotation.CallSuper; 33ac5fe7c617c66850fff75a9fce9979c6e5674b0fAurimas Liutikasimport androidx.annotation.IdRes; 34ac5fe7c617c66850fff75a9fce9979c6e5674b0fAurimas Liutikasimport androidx.annotation.LayoutRes; 35ac5fe7c617c66850fff75a9fce9979c6e5674b0fAurimas Liutikasimport androidx.annotation.NonNull; 36ac5fe7c617c66850fff75a9fce9979c6e5674b0fAurimas Liutikasimport androidx.annotation.Nullable; 37ac5fe7c617c66850fff75a9fce9979c6e5674b0fAurimas Liutikasimport androidx.annotation.StyleRes; 38ac5fe7c617c66850fff75a9fce9979c6e5674b0fAurimas Liutikasimport androidx.appcompat.view.ActionMode; 39ac5fe7c617c66850fff75a9fce9979c6e5674b0fAurimas Liutikasimport androidx.appcompat.widget.Toolbar; 40ac5fe7c617c66850fff75a9fce9979c6e5674b0fAurimas Liutikasimport androidx.appcompat.widget.VectorEnabledTintResources; 413de8a4e8305507475d7890205184946a25cf45e7Aurimas Liutikasimport androidx.core.app.ActivityCompat; 423de8a4e8305507475d7890205184946a25cf45e7Aurimas Liutikasimport androidx.core.app.NavUtils; 433de8a4e8305507475d7890205184946a25cf45e7Aurimas Liutikasimport androidx.core.app.TaskStackBuilder; 443de8a4e8305507475d7890205184946a25cf45e7Aurimas Liutikasimport androidx.fragment.app.FragmentActivity; 45f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes 46f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes/** 47f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * Base class for activities that use the 48f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * <a href="{@docRoot}tools/extras/support-library.html">support library</a> action bar features. 49f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * 50ac5fe7c617c66850fff75a9fce9979c6e5674b0fAurimas Liutikas * <p>You can add an {@link androidx.appcompat.app.ActionBar} to your activity when running on API level 7 or higher 51f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * by extending this class for your activity and setting the activity theme to 52ac5fe7c617c66850fff75a9fce9979c6e5674b0fAurimas Liutikas * {@link androidx.appcompat.R.style#Theme_AppCompat Theme.AppCompat} or a similar theme. 53f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * 54f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * <div class="special reference"> 55f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * <h3>Developer Guides</h3> 56f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * 57f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * <p>For information about how to use the action bar, including how to add action items, navigation 58f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * modes and more, read the <a href="{@docRoot}guide/topics/ui/actionbar.html">Action 59f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * Bar</a> API guide.</p> 60f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * </div> 61f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes */ 6216e8d4dd91083260223c007c797e46bc8f631055Chris Banespublic class AppCompatActivity extends FragmentActivity implements AppCompatCallback, 63f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes TaskStackBuilder.SupportParentable, ActionBarDrawerToggle.DelegateProvider { 64f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes 65f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes private AppCompatDelegate mDelegate; 66ff7f258a9b0781de5c6325358c7075128bf05a91Chris Banes private int mThemeId = 0; 675fa121a1f51114f3a2f6d705139e83c0e0aea610Chris Banes private Resources mResources; 68f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes 69f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes @Override 70c861fd8b28b0b878ccc194ee6099b3b1bc4c3ae8Scott Kennedy protected void onCreate(@Nullable Bundle savedInstanceState) { 71ff7f258a9b0781de5c6325358c7075128bf05a91Chris Banes final AppCompatDelegate delegate = getDelegate(); 72ff7f258a9b0781de5c6325358c7075128bf05a91Chris Banes delegate.installViewFactory(); 73ff7f258a9b0781de5c6325358c7075128bf05a91Chris Banes delegate.onCreate(savedInstanceState); 74ff7f258a9b0781de5c6325358c7075128bf05a91Chris Banes if (delegate.applyDayNight() && mThemeId != 0) { 755ed351700cfa30de2d4f7e431dea2b30e23d7982Alan Viverette // If DayNight has been applied, we need to re-apply the theme for 765ed351700cfa30de2d4f7e431dea2b30e23d7982Alan Viverette // the changes to take effect. On API 23+, we should bypass 775ed351700cfa30de2d4f7e431dea2b30e23d7982Alan Viverette // setTheme(), which will no-op if the theme ID is identical to the 785ed351700cfa30de2d4f7e431dea2b30e23d7982Alan Viverette // current theme ID. 795ed351700cfa30de2d4f7e431dea2b30e23d7982Alan Viverette if (Build.VERSION.SDK_INT >= 23) { 805ed351700cfa30de2d4f7e431dea2b30e23d7982Alan Viverette onApplyThemeResource(getTheme(), mThemeId, false); 815ed351700cfa30de2d4f7e431dea2b30e23d7982Alan Viverette } else { 825ed351700cfa30de2d4f7e431dea2b30e23d7982Alan Viverette setTheme(mThemeId); 835ed351700cfa30de2d4f7e431dea2b30e23d7982Alan Viverette } 84ff7f258a9b0781de5c6325358c7075128bf05a91Chris Banes } 85df71544bda1bce474389328ce24ce46bb4d96d1dChris Banes super.onCreate(savedInstanceState); 86f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes } 87f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes 88f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes @Override 89ff7f258a9b0781de5c6325358c7075128bf05a91Chris Banes public void setTheme(@StyleRes final int resid) { 90ff7f258a9b0781de5c6325358c7075128bf05a91Chris Banes super.setTheme(resid); 91ff7f258a9b0781de5c6325358c7075128bf05a91Chris Banes // Keep hold of the theme id so that we can re-set it later if needed 92ff7f258a9b0781de5c6325358c7075128bf05a91Chris Banes mThemeId = resid; 93ff7f258a9b0781de5c6325358c7075128bf05a91Chris Banes } 94ff7f258a9b0781de5c6325358c7075128bf05a91Chris Banes 95ff7f258a9b0781de5c6325358c7075128bf05a91Chris Banes @Override 96c861fd8b28b0b878ccc194ee6099b3b1bc4c3ae8Scott Kennedy protected void onPostCreate(@Nullable Bundle savedInstanceState) { 97f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes super.onPostCreate(savedInstanceState); 98f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes getDelegate().onPostCreate(savedInstanceState); 99f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes } 100f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes 101f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes /** 102f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * Support library version of {@link android.app.Activity#getActionBar}. 103f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * 104f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * <p>Retrieve a reference to this activity's ActionBar. 105f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * 106f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * @return The Activity's ActionBar, or null if it does not have one. 107f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes */ 108c861fd8b28b0b878ccc194ee6099b3b1bc4c3ae8Scott Kennedy @Nullable 109f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes public ActionBar getSupportActionBar() { 110f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes return getDelegate().getSupportActionBar(); 111f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes } 112f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes 113f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes /** 114740e50456ff7aa7b93d40e7bdc59f8a619197ed5Chris Banes * Set a {@link android.widget.Toolbar Toolbar} to act as the 115ac5fe7c617c66850fff75a9fce9979c6e5674b0fAurimas Liutikas * {@link androidx.appcompat.app.ActionBar} for this Activity window. 116f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * 117f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * <p>When set to a non-null value the {@link #getActionBar()} method will return 118ac5fe7c617c66850fff75a9fce9979c6e5674b0fAurimas Liutikas * an {@link androidx.appcompat.app.ActionBar} object that can be used to control the given 119740e50456ff7aa7b93d40e7bdc59f8a619197ed5Chris Banes * toolbar as if it were a traditional window decor action bar. The toolbar's menu will be 120740e50456ff7aa7b93d40e7bdc59f8a619197ed5Chris Banes * populated with the Activity's options menu and the navigation button will be wired through 121740e50456ff7aa7b93d40e7bdc59f8a619197ed5Chris Banes * the standard {@link android.R.id#home home} menu select action.</p> 122f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * 123f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * <p>In order to use a Toolbar within the Activity's window content the application 124d25af35061a9f20d59b25329d613c62c20184dadChris Banes * must not request the window feature 125d25af35061a9f20d59b25329d613c62c20184dadChris Banes * {@link android.view.Window#FEATURE_ACTION_BAR FEATURE_SUPPORT_ACTION_BAR}.</p> 126f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * 127740e50456ff7aa7b93d40e7bdc59f8a619197ed5Chris Banes * @param toolbar Toolbar to set as the Activity's action bar, or {@code null} to clear it 128f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes */ 129f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes public void setSupportActionBar(@Nullable Toolbar toolbar) { 130f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes getDelegate().setSupportActionBar(toolbar); 131f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes } 132f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes 133f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes @Override 134f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes public MenuInflater getMenuInflater() { 135f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes return getDelegate().getMenuInflater(); 136f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes } 137f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes 138f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes @Override 139f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes public void setContentView(@LayoutRes int layoutResID) { 140f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes getDelegate().setContentView(layoutResID); 141f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes } 142f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes 143f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes @Override 144f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes public void setContentView(View view) { 145f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes getDelegate().setContentView(view); 146f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes } 147f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes 148f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes @Override 149f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes public void setContentView(View view, ViewGroup.LayoutParams params) { 150f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes getDelegate().setContentView(view, params); 151f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes } 152f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes 153f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes @Override 154f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes public void addContentView(View view, ViewGroup.LayoutParams params) { 155f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes getDelegate().addContentView(view, params); 156f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes } 157f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes 158f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes @Override 159f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes public void onConfigurationChanged(Configuration newConfig) { 160f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes super.onConfigurationChanged(newConfig); 161f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes getDelegate().onConfigurationChanged(newConfig); 1625fa121a1f51114f3a2f6d705139e83c0e0aea610Chris Banes if (mResources != null) { 1635fa121a1f51114f3a2f6d705139e83c0e0aea610Chris Banes // The real (and thus managed) resources object was already updated 1645fa121a1f51114f3a2f6d705139e83c0e0aea610Chris Banes // by ResourcesManager, so pull the current metrics from there. 1655fa121a1f51114f3a2f6d705139e83c0e0aea610Chris Banes final DisplayMetrics newMetrics = super.getResources().getDisplayMetrics(); 1665fa121a1f51114f3a2f6d705139e83c0e0aea610Chris Banes mResources.updateConfiguration(newConfig, newMetrics); 1675fa121a1f51114f3a2f6d705139e83c0e0aea610Chris Banes } 168f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes } 169f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes 170f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes @Override 171f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes protected void onPostResume() { 172f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes super.onPostResume(); 173f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes getDelegate().onPostResume(); 174f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes } 175f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes 176dc8e099ed130434c0238f558277c5bcb6a533121Aurimas Liutikas @Override 17712acd8f6d6926aaa5cc16543386e0aeee64716edChris Banes protected void onStart() { 17812acd8f6d6926aaa5cc16543386e0aeee64716edChris Banes super.onStart(); 17912acd8f6d6926aaa5cc16543386e0aeee64716edChris Banes getDelegate().onStart(); 18012acd8f6d6926aaa5cc16543386e0aeee64716edChris Banes } 18112acd8f6d6926aaa5cc16543386e0aeee64716edChris Banes 18212acd8f6d6926aaa5cc16543386e0aeee64716edChris Banes @Override 18312acd8f6d6926aaa5cc16543386e0aeee64716edChris Banes protected void onStop() { 18412acd8f6d6926aaa5cc16543386e0aeee64716edChris Banes super.onStop(); 18512acd8f6d6926aaa5cc16543386e0aeee64716edChris Banes getDelegate().onStop(); 18612acd8f6d6926aaa5cc16543386e0aeee64716edChris Banes } 18712acd8f6d6926aaa5cc16543386e0aeee64716edChris Banes 188ad1b0e82100ee31e70040d77bfa4d847b2bf0864Aurimas Liutikas @SuppressWarnings("TypeParameterUnusedInFormals") 18912acd8f6d6926aaa5cc16543386e0aeee64716edChris Banes @Override 1909bc9998b48c673096c4704204d14a87a80b24324Alan Viverette public <T extends View> T findViewById(@IdRes int id) { 1918c3845ebb7e8198950510cd7a08bc8e66e2195feChris Banes return getDelegate().findViewById(id); 1928c3845ebb7e8198950510cd7a08bc8e66e2195feChris Banes } 1938c3845ebb7e8198950510cd7a08bc8e66e2195feChris Banes 194f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes @Override 195f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes public final boolean onMenuItemSelected(int featureId, android.view.MenuItem item) { 196f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes if (super.onMenuItemSelected(featureId, item)) { 197f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes return true; 198f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes } 199f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes 200f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes final ActionBar ab = getSupportActionBar(); 201f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes if (item.getItemId() == android.R.id.home && ab != null && 202f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes (ab.getDisplayOptions() & ActionBar.DISPLAY_HOME_AS_UP) != 0) { 203f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes return onSupportNavigateUp(); 204f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes } 205f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes return false; 206f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes } 207f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes 208f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes @Override 209f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes protected void onDestroy() { 210f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes super.onDestroy(); 211f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes getDelegate().onDestroy(); 212f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes } 213f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes 214f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes @Override 215f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes protected void onTitleChanged(CharSequence title, int color) { 216f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes super.onTitleChanged(title, color); 21716e8d4dd91083260223c007c797e46bc8f631055Chris Banes getDelegate().setTitle(title); 218f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes } 219f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes 220f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes /** 221f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * Enable extended support library window features. 222f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * <p> 223f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * This is a convenience for calling 224f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * {@link android.view.Window#requestFeature getWindow().requestFeature()}. 225f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * </p> 226f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * 227f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * @param featureId The desired feature as defined in 228ac5fe7c617c66850fff75a9fce9979c6e5674b0fAurimas Liutikas * {@link android.view.Window} or {@link androidx.core.view.WindowCompat}. 229f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * @return Returns true if the requested feature is supported and now enabled. 230f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * 231f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * @see android.app.Activity#requestWindowFeature 232f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * @see android.view.Window#requestFeature 233f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes */ 234f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes public boolean supportRequestWindowFeature(int featureId) { 235f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes return getDelegate().requestWindowFeature(featureId); 236f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes } 237f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes 238f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes @Override 239f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes public void supportInvalidateOptionsMenu() { 240f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes getDelegate().invalidateOptionsMenu(); 241f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes } 242f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes 243161e026f3153b1a8e208dfc148b4bd772a6bd74bAlan Viverette @Override 244f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes public void invalidateOptionsMenu() { 245f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes getDelegate().invalidateOptionsMenu(); 246f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes } 247f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes 248f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes /** 249f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * Notifies the Activity that a support action mode has been started. 250f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * Activity subclasses overriding this method should call the superclass implementation. 251f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * 252f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * @param mode The new action mode. 253f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes */ 254dc8e099ed130434c0238f558277c5bcb6a533121Aurimas Liutikas @Override 25570acb0c19be3831a2080e4f902324de16bfbf62eTor Norbye @CallSuper 256740e50456ff7aa7b93d40e7bdc59f8a619197ed5Chris Banes public void onSupportActionModeStarted(@NonNull ActionMode mode) { 257f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes } 258f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes 259f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes /** 260f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * Notifies the activity that a support action mode has finished. 261f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * Activity subclasses overriding this method should call the superclass implementation. 262f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * 263f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * @param mode The action mode that just finished. 264f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes */ 265dc8e099ed130434c0238f558277c5bcb6a533121Aurimas Liutikas @Override 26670acb0c19be3831a2080e4f902324de16bfbf62eTor Norbye @CallSuper 267740e50456ff7aa7b93d40e7bdc59f8a619197ed5Chris Banes public void onSupportActionModeFinished(@NonNull ActionMode mode) { 268f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes } 269f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes 270547a80d347e0dc9751bbe3cf91f947477145bdbaChris Banes /** 271547a80d347e0dc9751bbe3cf91f947477145bdbaChris Banes * Called when a support action mode is being started for this window. Gives the 272547a80d347e0dc9751bbe3cf91f947477145bdbaChris Banes * callback an opportunity to handle the action mode in its own unique and 273547a80d347e0dc9751bbe3cf91f947477145bdbaChris Banes * beautiful way. If this method returns null the system can choose a way 274547a80d347e0dc9751bbe3cf91f947477145bdbaChris Banes * to present the mode or choose not to start the mode at all. 275547a80d347e0dc9751bbe3cf91f947477145bdbaChris Banes * 276547a80d347e0dc9751bbe3cf91f947477145bdbaChris Banes * @param callback Callback to control the lifecycle of this action mode 277547a80d347e0dc9751bbe3cf91f947477145bdbaChris Banes * @return The ActionMode that was started, or null if the system should present it 278547a80d347e0dc9751bbe3cf91f947477145bdbaChris Banes */ 279547a80d347e0dc9751bbe3cf91f947477145bdbaChris Banes @Nullable 280547a80d347e0dc9751bbe3cf91f947477145bdbaChris Banes @Override 281740e50456ff7aa7b93d40e7bdc59f8a619197ed5Chris Banes public ActionMode onWindowStartingSupportActionMode(@NonNull ActionMode.Callback callback) { 282547a80d347e0dc9751bbe3cf91f947477145bdbaChris Banes return null; 283547a80d347e0dc9751bbe3cf91f947477145bdbaChris Banes } 284547a80d347e0dc9751bbe3cf91f947477145bdbaChris Banes 285740e50456ff7aa7b93d40e7bdc59f8a619197ed5Chris Banes /** 286740e50456ff7aa7b93d40e7bdc59f8a619197ed5Chris Banes * Start an action mode. 287740e50456ff7aa7b93d40e7bdc59f8a619197ed5Chris Banes * 288740e50456ff7aa7b93d40e7bdc59f8a619197ed5Chris Banes * @param callback Callback that will manage lifecycle events for this context mode 289740e50456ff7aa7b93d40e7bdc59f8a619197ed5Chris Banes * @return The ContextMode that was started, or null if it was canceled 290740e50456ff7aa7b93d40e7bdc59f8a619197ed5Chris Banes */ 291740e50456ff7aa7b93d40e7bdc59f8a619197ed5Chris Banes @Nullable 292740e50456ff7aa7b93d40e7bdc59f8a619197ed5Chris Banes public ActionMode startSupportActionMode(@NonNull ActionMode.Callback callback) { 293f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes return getDelegate().startSupportActionMode(callback); 294f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes } 295f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes 296f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes /** 297f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * @deprecated Progress bars are no longer provided in AppCompat. 298f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes */ 299f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes @Deprecated 300f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes public void setSupportProgressBarVisibility(boolean visible) { 301f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes } 302f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes 303f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes /** 304f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * @deprecated Progress bars are no longer provided in AppCompat. 305f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes */ 306f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes @Deprecated 307f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes public void setSupportProgressBarIndeterminateVisibility(boolean visible) { 308f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes } 309f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes 310f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes /** 311f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * @deprecated Progress bars are no longer provided in AppCompat. 312f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes */ 313f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes @Deprecated 314f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes public void setSupportProgressBarIndeterminate(boolean indeterminate) { 315f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes } 316f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes 317f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes /** 318f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * @deprecated Progress bars are no longer provided in AppCompat. 319f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes */ 320f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes @Deprecated 321f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes public void setSupportProgress(int progress) { 322f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes } 323f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes 324f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes /** 325f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * Support version of {@link #onCreateNavigateUpTaskStack(android.app.TaskStackBuilder)}. 326f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * This method will be called on all platform versions. 327f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * 328f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * Define the synthetic task stack that will be generated during Up navigation from 329f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * a different task. 330f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * 331f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * <p>The default implementation of this method adds the parent chain of this activity 332ac5fe7c617c66850fff75a9fce9979c6e5674b0fAurimas Liutikas * as specified in the manifest to the supplied {@link androidx.core.app.TaskStackBuilder}. Applications 333f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * may choose to override this method to construct the desired task stack in a different 334f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * way.</p> 335f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * 336f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * <p>This method will be invoked by the default implementation of {@link #onNavigateUp()} 337f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * if {@link #shouldUpRecreateTask(android.content.Intent)} returns true when supplied with the intent 338f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * returned by {@link #getParentActivityIntent()}.</p> 339f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * 340f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * <p>Applications that wish to supply extra Intent parameters to the parent stack defined 341f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * by the manifest should override 342ac5fe7c617c66850fff75a9fce9979c6e5674b0fAurimas Liutikas * {@link #onPrepareSupportNavigateUpTaskStack(androidx.core.app.TaskStackBuilder)}.</p> 343f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * 344f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * @param builder An empty TaskStackBuilder - the application should add intents representing 345f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * the desired task stack 346f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes */ 347740e50456ff7aa7b93d40e7bdc59f8a619197ed5Chris Banes public void onCreateSupportNavigateUpTaskStack(@NonNull TaskStackBuilder builder) { 348f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes builder.addParentStack(this); 349f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes } 350f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes 351f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes /** 352f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * Support version of {@link #onPrepareNavigateUpTaskStack(android.app.TaskStackBuilder)}. 353f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * This method will be called on all platform versions. 354f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * 355f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * Prepare the synthetic task stack that will be generated during Up navigation 356f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * from a different task. 357f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * 358ac5fe7c617c66850fff75a9fce9979c6e5674b0fAurimas Liutikas * <p>This method receives the {@link androidx.core.app.TaskStackBuilder} with the constructed series of 359ac5fe7c617c66850fff75a9fce9979c6e5674b0fAurimas Liutikas * Intents as generated by {@link #onCreateSupportNavigateUpTaskStack(androidx.core.app.TaskStackBuilder)}. 360f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * If any extra data should be added to these intents before launching the new task, 361f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * the application should override this method and add that data here.</p> 362f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * 363f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * @param builder A TaskStackBuilder that has been populated with Intents by 364f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * onCreateNavigateUpTaskStack. 365f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes */ 366740e50456ff7aa7b93d40e7bdc59f8a619197ed5Chris Banes public void onPrepareSupportNavigateUpTaskStack(@NonNull TaskStackBuilder builder) { 367f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes } 368f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes 369f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes /** 370f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * This method is called whenever the user chooses to navigate Up within your application's 371f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * activity hierarchy from the action bar. 372f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * 373f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * <p>If a parent was specified in the manifest for this activity or an activity-alias to it, 374f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * default Up navigation will be handled automatically. See 375f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * {@link #getSupportParentActivityIntent()} for how to specify the parent. If any activity 376f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * along the parent chain requires extra Intent arguments, the Activity subclass 377ac5fe7c617c66850fff75a9fce9979c6e5674b0fAurimas Liutikas * should override the method {@link #onPrepareSupportNavigateUpTaskStack(androidx.core.app.TaskStackBuilder)} 378f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * to supply those arguments.</p> 379f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * 380f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * <p>See <a href="{@docRoot}guide/topics/fundamentals/tasks-and-back-stack.html">Tasks and 381f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * Back Stack</a> from the developer guide and 382f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * <a href="{@docRoot}design/patterns/navigation.html">Navigation</a> from the design guide 383f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * for more information about navigating within your app.</p> 384f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * 385ac5fe7c617c66850fff75a9fce9979c6e5674b0fAurimas Liutikas * <p>See the {@link androidx.core.app.TaskStackBuilder} class and the Activity methods 386f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * {@link #getSupportParentActivityIntent()}, {@link #supportShouldUpRecreateTask(android.content.Intent)}, and 387f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * {@link #supportNavigateUpTo(android.content.Intent)} for help implementing custom Up navigation.</p> 388f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * 389f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * @return true if Up navigation completed successfully and this Activity was finished, 390f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * false otherwise. 391f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes */ 392f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes public boolean onSupportNavigateUp() { 393f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes Intent upIntent = getSupportParentActivityIntent(); 394f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes 395f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes if (upIntent != null) { 396f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes if (supportShouldUpRecreateTask(upIntent)) { 397f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes TaskStackBuilder b = TaskStackBuilder.create(this); 398f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes onCreateSupportNavigateUpTaskStack(b); 399f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes onPrepareSupportNavigateUpTaskStack(b); 400f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes b.startActivities(); 401f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes 402f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes try { 403f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes ActivityCompat.finishAffinity(this); 404f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes } catch (IllegalStateException e) { 405f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes // This can only happen on 4.1+, when we don't have a parent or a result set. 406f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes // In that case we should just finish(). 407f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes finish(); 408f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes } 409f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes } else { 410f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes // This activity is part of the application's task, so simply 411f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes // navigate up to the hierarchical parent activity. 412f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes supportNavigateUpTo(upIntent); 413f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes } 414f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes return true; 415f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes } 416f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes return false; 417f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes } 418f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes 419f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes /** 420f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * Obtain an {@link android.content.Intent} that will launch an explicit target activity 421ac5fe7c617c66850fff75a9fce9979c6e5674b0fAurimas Liutikas * specified by sourceActivity's {@link androidx.core.app.NavUtils#PARENT_ACTIVITY} <meta-data> 422f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * element in the application's manifest. If the device is running 423f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * Jellybean or newer, the android:parentActivityName attribute will be preferred 424f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * if it is present. 425f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * 426f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * @return a new Intent targeting the defined parent activity of sourceActivity 427f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes */ 428c861fd8b28b0b878ccc194ee6099b3b1bc4c3ae8Scott Kennedy @Nullable 429dc8e099ed130434c0238f558277c5bcb6a533121Aurimas Liutikas @Override 430f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes public Intent getSupportParentActivityIntent() { 431f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes return NavUtils.getParentActivityIntent(this); 432f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes } 433f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes 434f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes /** 435f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * Returns true if sourceActivity should recreate the task when navigating 'up' 436f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * by using targetIntent. 437f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * 438f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * <p>If this method returns false the app can trivially call 439f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * {@link #supportNavigateUpTo(android.content.Intent)} using the same parameters to correctly perform 440f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * up navigation. If this method returns false, the app should synthesize a new task stack 441ac5fe7c617c66850fff75a9fce9979c6e5674b0fAurimas Liutikas * by using {@link androidx.core.app.TaskStackBuilder} or another similar mechanism to perform up navigation.</p> 442f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * 443f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * @param targetIntent An intent representing the target destination for up navigation 444f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * @return true if navigating up should recreate a new task stack, false if the same task 445f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * should be used for the destination 446f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes */ 447740e50456ff7aa7b93d40e7bdc59f8a619197ed5Chris Banes public boolean supportShouldUpRecreateTask(@NonNull Intent targetIntent) { 448f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes return NavUtils.shouldUpRecreateTask(this, targetIntent); 449f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes } 450f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes 451f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes /** 452f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * Navigate from sourceActivity to the activity specified by upIntent, finishing sourceActivity 453f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * in the process. upIntent will have the flag {@link android.content.Intent#FLAG_ACTIVITY_CLEAR_TOP} set 454f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * by this method, along with any others required for proper up navigation as outlined 455f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * in the Android Design Guide. 456f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * 457f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * <p>This method should be used when performing up navigation from within the same task 458f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * as the destination. If up navigation should cross tasks in some cases, see 459f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * {@link #supportShouldUpRecreateTask(android.content.Intent)}.</p> 460f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * 461f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * @param upIntent An intent representing the target destination for up navigation 462f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes */ 463740e50456ff7aa7b93d40e7bdc59f8a619197ed5Chris Banes public void supportNavigateUpTo(@NonNull Intent upIntent) { 464f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes NavUtils.navigateUpTo(this, upIntent); 465f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes } 466f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes 467f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes @Override 468f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes public void onContentChanged() { 469f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes // Call onSupportContentChanged() for legacy reasons 470f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes onSupportContentChanged(); 471f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes } 472f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes 473f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes /** 474f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * @deprecated Use {@link #onContentChanged()} instead. 475f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes */ 476f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes @Deprecated 477f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes public void onSupportContentChanged() { 478f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes } 479f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes 480f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes @Nullable 481f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes @Override 482f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes public ActionBarDrawerToggle.Delegate getDrawerToggleDelegate() { 483f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes return getDelegate().getDrawerToggleDelegate(); 484f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes } 485f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes 486f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes /** 487d25af35061a9f20d59b25329d613c62c20184dadChris Banes * {@inheritDoc} 488d25af35061a9f20d59b25329d613c62c20184dadChris Banes * 48944ece5ceaaee232f9139ccbde40ac4a5e642bdeeChristophe Beyls * <p>Please note: AppCompat uses its own feature id for the action bar: 490d25af35061a9f20d59b25329d613c62c20184dadChris Banes * {@link AppCompatDelegate#FEATURE_SUPPORT_ACTION_BAR FEATURE_SUPPORT_ACTION_BAR}.</p> 491d25af35061a9f20d59b25329d613c62c20184dadChris Banes */ 492d25af35061a9f20d59b25329d613c62c20184dadChris Banes @Override 493d25af35061a9f20d59b25329d613c62c20184dadChris Banes public boolean onMenuOpened(int featureId, Menu menu) { 494d25af35061a9f20d59b25329d613c62c20184dadChris Banes return super.onMenuOpened(featureId, menu); 495d25af35061a9f20d59b25329d613c62c20184dadChris Banes } 496d25af35061a9f20d59b25329d613c62c20184dadChris Banes 497d25af35061a9f20d59b25329d613c62c20184dadChris Banes /** 498d25af35061a9f20d59b25329d613c62c20184dadChris Banes * {@inheritDoc} 499d25af35061a9f20d59b25329d613c62c20184dadChris Banes * 50044ece5ceaaee232f9139ccbde40ac4a5e642bdeeChristophe Beyls * <p>Please note: AppCompat uses its own feature id for the action bar: 501d25af35061a9f20d59b25329d613c62c20184dadChris Banes * {@link AppCompatDelegate#FEATURE_SUPPORT_ACTION_BAR FEATURE_SUPPORT_ACTION_BAR}.</p> 502d25af35061a9f20d59b25329d613c62c20184dadChris Banes */ 503d25af35061a9f20d59b25329d613c62c20184dadChris Banes @Override 504d25af35061a9f20d59b25329d613c62c20184dadChris Banes public void onPanelClosed(int featureId, Menu menu) { 505d25af35061a9f20d59b25329d613c62c20184dadChris Banes super.onPanelClosed(featureId, menu); 506d25af35061a9f20d59b25329d613c62c20184dadChris Banes } 507d25af35061a9f20d59b25329d613c62c20184dadChris Banes 508ff7f258a9b0781de5c6325358c7075128bf05a91Chris Banes @Override 509ff7f258a9b0781de5c6325358c7075128bf05a91Chris Banes protected void onSaveInstanceState(Bundle outState) { 510ff7f258a9b0781de5c6325358c7075128bf05a91Chris Banes super.onSaveInstanceState(outState); 511ff7f258a9b0781de5c6325358c7075128bf05a91Chris Banes getDelegate().onSaveInstanceState(outState); 512ff7f258a9b0781de5c6325358c7075128bf05a91Chris Banes } 513ff7f258a9b0781de5c6325358c7075128bf05a91Chris Banes 514d25af35061a9f20d59b25329d613c62c20184dadChris Banes /** 515f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes * @return The {@link AppCompatDelegate} being used by this Activity. 516f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes */ 517740e50456ff7aa7b93d40e7bdc59f8a619197ed5Chris Banes @NonNull 518f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes public AppCompatDelegate getDelegate() { 519f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes if (mDelegate == null) { 520f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes mDelegate = AppCompatDelegate.create(this, this); 521f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes } 522f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes return mDelegate; 523f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes } 524a6d085f83e2aec7ebda1fbbc69a5fd63c5f2e235George Mount 525a6d085f83e2aec7ebda1fbbc69a5fd63c5f2e235George Mount @Override 526a6d085f83e2aec7ebda1fbbc69a5fd63c5f2e235George Mount public boolean dispatchKeyEvent(KeyEvent event) { 52749b39d17068f2d6ff09378827b2a7d56163b6ffdEvan Rosky // Let support action bars open menus in response to the menu key prioritized over 52849b39d17068f2d6ff09378827b2a7d56163b6ffdEvan Rosky // the window handling it 52949b39d17068f2d6ff09378827b2a7d56163b6ffdEvan Rosky final int keyCode = event.getKeyCode(); 53049b39d17068f2d6ff09378827b2a7d56163b6ffdEvan Rosky final ActionBar actionBar = getSupportActionBar(); 53149b39d17068f2d6ff09378827b2a7d56163b6ffdEvan Rosky if (keyCode == KeyEvent.KEYCODE_MENU 53249b39d17068f2d6ff09378827b2a7d56163b6ffdEvan Rosky && actionBar != null && actionBar.onMenuKeyEvent(event)) { 53349b39d17068f2d6ff09378827b2a7d56163b6ffdEvan Rosky return true; 53449b39d17068f2d6ff09378827b2a7d56163b6ffdEvan Rosky } 535a6d085f83e2aec7ebda1fbbc69a5fd63c5f2e235George Mount return super.dispatchKeyEvent(event); 536a6d085f83e2aec7ebda1fbbc69a5fd63c5f2e235George Mount } 5375fa121a1f51114f3a2f6d705139e83c0e0aea610Chris Banes 5385fa121a1f51114f3a2f6d705139e83c0e0aea610Chris Banes @Override 5395fa121a1f51114f3a2f6d705139e83c0e0aea610Chris Banes public Resources getResources() { 5405fa121a1f51114f3a2f6d705139e83c0e0aea610Chris Banes if (mResources == null && VectorEnabledTintResources.shouldBeUsed()) { 5415fa121a1f51114f3a2f6d705139e83c0e0aea610Chris Banes mResources = new VectorEnabledTintResources(this, super.getResources()); 5425fa121a1f51114f3a2f6d705139e83c0e0aea610Chris Banes } 5435fa121a1f51114f3a2f6d705139e83c0e0aea610Chris Banes return mResources == null ? super.getResources() : mResources; 5445fa121a1f51114f3a2f6d705139e83c0e0aea610Chris Banes } 54509231da6d922e91d30d06876521106f13230a791Peeyush Agarwal 54609231da6d922e91d30d06876521106f13230a791Peeyush Agarwal /** 547b227890c6a2110aad2ad6f70ad815f66cf3a82ecPeeyush Agarwal * KeyEvents with non-default modifiers are not dispatched to menu's performShortcut in API 25 54809231da6d922e91d30d06876521106f13230a791Peeyush Agarwal * or lower. Here, we check if the keypress corresponds to a menuitem's shortcut combination 54909231da6d922e91d30d06876521106f13230a791Peeyush Agarwal * and perform the corresponding action. 55009231da6d922e91d30d06876521106f13230a791Peeyush Agarwal */ 55109231da6d922e91d30d06876521106f13230a791Peeyush Agarwal private boolean performMenuItemShortcut(int keycode, KeyEvent event) { 5527301f0cca4f9dc9249cd660c05d5b2107f5b3d04Aurimas Liutikas if (!(Build.VERSION.SDK_INT >= 26) && !event.isCtrlPressed() 553b227890c6a2110aad2ad6f70ad815f66cf3a82ecPeeyush Agarwal && !KeyEvent.metaStateHasNoModifiers(event.getMetaState()) 55409231da6d922e91d30d06876521106f13230a791Peeyush Agarwal && event.getRepeatCount() == 0 55509231da6d922e91d30d06876521106f13230a791Peeyush Agarwal && !KeyEvent.isModifierKey(event.getKeyCode())) { 55609231da6d922e91d30d06876521106f13230a791Peeyush Agarwal final Window currentWindow = getWindow(); 55709231da6d922e91d30d06876521106f13230a791Peeyush Agarwal if (currentWindow != null && currentWindow.getDecorView() != null) { 55809231da6d922e91d30d06876521106f13230a791Peeyush Agarwal final View decorView = currentWindow.getDecorView(); 55909231da6d922e91d30d06876521106f13230a791Peeyush Agarwal if (decorView.dispatchKeyShortcutEvent(event)) { 56009231da6d922e91d30d06876521106f13230a791Peeyush Agarwal return true; 56109231da6d922e91d30d06876521106f13230a791Peeyush Agarwal } 56209231da6d922e91d30d06876521106f13230a791Peeyush Agarwal } 56309231da6d922e91d30d06876521106f13230a791Peeyush Agarwal } 56409231da6d922e91d30d06876521106f13230a791Peeyush Agarwal return false; 56509231da6d922e91d30d06876521106f13230a791Peeyush Agarwal } 56609231da6d922e91d30d06876521106f13230a791Peeyush Agarwal 56709231da6d922e91d30d06876521106f13230a791Peeyush Agarwal @Override 56809231da6d922e91d30d06876521106f13230a791Peeyush Agarwal public boolean onKeyDown(int keyCode, KeyEvent event) { 56909231da6d922e91d30d06876521106f13230a791Peeyush Agarwal if (performMenuItemShortcut(keyCode, event)) { 57009231da6d922e91d30d06876521106f13230a791Peeyush Agarwal return true; 57109231da6d922e91d30d06876521106f13230a791Peeyush Agarwal } 57209231da6d922e91d30d06876521106f13230a791Peeyush Agarwal return super.onKeyDown(keyCode, event); 57309231da6d922e91d30d06876521106f13230a791Peeyush Agarwal } 57449b39d17068f2d6ff09378827b2a7d56163b6ffdEvan Rosky 57549b39d17068f2d6ff09378827b2a7d56163b6ffdEvan Rosky @Override 57649b39d17068f2d6ff09378827b2a7d56163b6ffdEvan Rosky public void openOptionsMenu() { 57749b39d17068f2d6ff09378827b2a7d56163b6ffdEvan Rosky ActionBar actionBar = getSupportActionBar(); 57849b39d17068f2d6ff09378827b2a7d56163b6ffdEvan Rosky if (getWindow().hasFeature(Window.FEATURE_OPTIONS_PANEL) 57949b39d17068f2d6ff09378827b2a7d56163b6ffdEvan Rosky && (actionBar == null || !actionBar.openOptionsMenu())) { 58049b39d17068f2d6ff09378827b2a7d56163b6ffdEvan Rosky super.openOptionsMenu(); 58149b39d17068f2d6ff09378827b2a7d56163b6ffdEvan Rosky } 58249b39d17068f2d6ff09378827b2a7d56163b6ffdEvan Rosky } 58349b39d17068f2d6ff09378827b2a7d56163b6ffdEvan Rosky 58449b39d17068f2d6ff09378827b2a7d56163b6ffdEvan Rosky @Override 58549b39d17068f2d6ff09378827b2a7d56163b6ffdEvan Rosky public void closeOptionsMenu() { 58649b39d17068f2d6ff09378827b2a7d56163b6ffdEvan Rosky ActionBar actionBar = getSupportActionBar(); 58749b39d17068f2d6ff09378827b2a7d56163b6ffdEvan Rosky if (getWindow().hasFeature(Window.FEATURE_OPTIONS_PANEL) 58849b39d17068f2d6ff09378827b2a7d56163b6ffdEvan Rosky && (actionBar == null || !actionBar.closeOptionsMenu())) { 58949b39d17068f2d6ff09378827b2a7d56163b6ffdEvan Rosky super.closeOptionsMenu(); 59049b39d17068f2d6ff09378827b2a7d56163b6ffdEvan Rosky } 59149b39d17068f2d6ff09378827b2a7d56163b6ffdEvan Rosky } 592f3ad1351d8b40ec5defe35e79d3430ad3c384b6dChris Banes} 593