ActivityGroup.java revision 2f04883ff880966d63d1aa4a1c7b05e497cfcc58
19066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/* 29066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Copyright (C) 2007 The Android Open Source Project 39066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 49066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Licensed under the Apache License, Version 2.0 (the "License"); 59066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * you may not use this file except in compliance with the License. 69066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * You may obtain a copy of the License at 79066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 89066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * http://www.apache.org/licenses/LICENSE-2.0 99066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Unless required by applicable law or agreed to in writing, software 119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * distributed under the License is distributed on an "AS IS" BASIS, 129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * See the License for the specific language governing permissions and 149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * limitations under the License. 159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpackage android.app; 189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport java.util.HashMap; 209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.content.Intent; 229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.Bundle; 239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.util.Log; 249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/** 262f04883ff880966d63d1aa4a1c7b05e497cfcc58Dianne Hackborn * @deprecated Use the new {@link Fragment} and {@link FragmentManager} APIs 272f04883ff880966d63d1aa4a1c7b05e497cfcc58Dianne Hackborn * instead; these are also 282f04883ff880966d63d1aa4a1c7b05e497cfcc58Dianne Hackborn * available on older platforms through the Android compatibility package. 292f04883ff880966d63d1aa4a1c7b05e497cfcc58Dianne Hackborn * 309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * A screen that contains and runs multiple embedded activities. 319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 322f04883ff880966d63d1aa4a1c7b05e497cfcc58Dianne Hackborn@Deprecated 339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpublic class ActivityGroup extends Activity { 349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final String TAG = "ActivityGroup"; 359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final String STATES_KEY = "android:states"; 369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project static final String PARENT_NON_CONFIG_INSTANCE_KEY = "android:parent_non_config_instance"; 379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This field should be made private, so it is hidden from the SDK. 409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@hide} 419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project protected LocalActivityManager mLocalActivityManager; 439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public ActivityGroup() { 459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project this(true); 469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public ActivityGroup(boolean singleActivityMode) { 499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mLocalActivityManager = new LocalActivityManager(this, singleActivityMode); 509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project protected void onCreate(Bundle savedInstanceState) { 549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project super.onCreate(savedInstanceState); 559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Bundle states = savedInstanceState != null 569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project ? (Bundle) savedInstanceState.getBundle(STATES_KEY) : null; 579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mLocalActivityManager.dispatchCreate(states); 589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project protected void onResume() { 629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project super.onResume(); 639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mLocalActivityManager.dispatchResume(); 649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project protected void onSaveInstanceState(Bundle outState) { 689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project super.onSaveInstanceState(outState); 699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Bundle state = mLocalActivityManager.saveInstanceState(); 709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (state != null) { 719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project outState.putBundle(STATES_KEY, state); 729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project protected void onPause() { 779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project super.onPause(); 789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mLocalActivityManager.dispatchPause(isFinishing()); 799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project protected void onStop() { 839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project super.onStop(); 849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mLocalActivityManager.dispatchStop(); 859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project protected void onDestroy() { 899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project super.onDestroy(); 909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mLocalActivityManager.dispatchDestroy(isFinishing()); 919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns a HashMap mapping from child activity ids to the return values 959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * from calls to their onRetainNonConfigurationInstance methods. 969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@hide} 989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 1009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public HashMap<String,Object> onRetainNonConfigurationChildInstances() { 1019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mLocalActivityManager.dispatchRetainNonConfigurationInstance(); 1029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public Activity getCurrentActivity() { 1059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mLocalActivityManager.getCurrentActivity(); 1069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final LocalActivityManager getLocalActivityManager() { 1099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mLocalActivityManager; 1109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 1139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project void dispatchActivityResult(String who, int requestCode, int resultCode, 1149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Intent data) { 1159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (who != null) { 1169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Activity act = mLocalActivityManager.getActivity(who); 1179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /* 1189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (Config.LOGV) Log.v( 1199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project TAG, "Dispatching result: who=" + who + ", reqCode=" + requestCode 1209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project + ", resCode=" + resultCode + ", data=" + data 1219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project + ", rec=" + rec); 1229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (act != null) { 1249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project act.onActivityResult(requestCode, resultCode, data); 1259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return; 1269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project super.dispatchActivityResult(who, requestCode, resultCode, data); 1299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project} 1319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 133