Launcher.java revision 6569f2c80e179c2f8ed73dae6b01d971ec20f005
1/* 2 * Copyright (C) 2008 The Android Open Source Project 3 * 4 * Licensed under the Apache License, Version 2.0 (the "License"); 5 * you may not use this file except in compliance with the License. 6 * You may obtain a copy of the License at 7 * 8 * http://www.apache.org/licenses/LICENSE-2.0 9 * 10 * Unless required by applicable law or agreed to in writing, software 11 * distributed under the License is distributed on an "AS IS" BASIS, 12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13 * See the License for the specific language governing permissions and 14 * limitations under the License. 15 */ 16 17package com.android.launcher2; 18 19import com.android.common.Search; 20import com.android.launcher.R; 21 22import android.app.Activity; 23import android.app.AlertDialog; 24import android.app.Dialog; 25import android.app.SearchManager; 26import android.app.StatusBarManager; 27import android.app.WallpaperManager; 28import android.appwidget.AppWidgetManager; 29import android.appwidget.AppWidgetProviderInfo; 30import android.content.ActivityNotFoundException; 31import android.content.BroadcastReceiver; 32import android.content.ComponentName; 33import android.content.ContentResolver; 34import android.content.Context; 35import android.content.DialogInterface; 36import android.content.Intent; 37import android.content.IntentFilter; 38import android.content.Intent.ShortcutIconResource; 39import android.content.pm.ActivityInfo; 40import android.content.pm.PackageManager; 41import android.content.pm.ResolveInfo; 42import android.content.res.Configuration; 43import android.content.res.Resources; 44import android.content.res.TypedArray; 45import android.database.ContentObserver; 46import android.graphics.Bitmap; 47import android.graphics.Canvas; 48import android.graphics.Rect; 49import android.graphics.drawable.ColorDrawable; 50import android.graphics.drawable.Drawable; 51import android.net.Uri; 52import android.os.Bundle; 53import android.os.Handler; 54import android.os.Parcelable; 55import android.os.SystemClock; 56import android.os.SystemProperties; 57import android.provider.LiveFolders; 58import android.text.Selection; 59import android.text.SpannableStringBuilder; 60import android.text.TextUtils; 61import android.text.method.TextKeyListener; 62import android.util.Log; 63import android.view.Display; 64import android.view.HapticFeedbackConstants; 65import android.view.KeyEvent; 66import android.view.LayoutInflater; 67import android.view.Menu; 68import android.view.MenuItem; 69import android.view.MotionEvent; 70import android.view.View; 71import android.view.ViewGroup; 72import android.view.WindowManager; 73import android.view.View.OnLongClickListener; 74import android.view.animation.Animation; 75import android.view.animation.AnimationUtils; 76import android.view.inputmethod.InputMethodManager; 77import android.widget.EditText; 78import android.widget.ImageView; 79import android.widget.LinearLayout; 80import android.widget.PopupWindow; 81import android.widget.TabHost; 82import android.widget.TextView; 83import android.widget.Toast; 84 85import java.io.DataInputStream; 86import java.io.DataOutputStream; 87import java.io.FileNotFoundException; 88import java.io.IOException; 89import java.util.ArrayList; 90import java.util.HashMap; 91import java.util.List; 92 93/** 94 * Default launcher application. 95 */ 96public final class Launcher extends Activity 97 implements View.OnClickListener, OnLongClickListener, LauncherModel.Callbacks, 98 AllAppsView.Watcher, View.OnTouchListener { 99 static final String TAG = "Launcher"; 100 static final boolean LOGD = false; 101 102 static final boolean PROFILE_STARTUP = false; 103 static final boolean DEBUG_WIDGETS = false; 104 static final boolean DEBUG_USER_INTERFACE = false; 105 106 private static final int WALLPAPER_SCREENS_SPAN = 2; 107 108 private static final int MENU_GROUP_ADD = 1; 109 private static final int MENU_GROUP_WALLPAPER = MENU_GROUP_ADD + 1; 110 111 private static final int MENU_ADD = Menu.FIRST + 1; 112 private static final int MENU_WALLPAPER_SETTINGS = MENU_ADD + 1; 113 private static final int MENU_SEARCH = MENU_WALLPAPER_SETTINGS + 1; 114 private static final int MENU_NOTIFICATIONS = MENU_SEARCH + 1; 115 private static final int MENU_SETTINGS = MENU_NOTIFICATIONS + 1; 116 117 private static final int REQUEST_CREATE_SHORTCUT = 1; 118 private static final int REQUEST_CREATE_LIVE_FOLDER = 4; 119 private static final int REQUEST_CREATE_APPWIDGET = 5; 120 private static final int REQUEST_PICK_APPLICATION = 6; 121 private static final int REQUEST_PICK_SHORTCUT = 7; 122 private static final int REQUEST_PICK_LIVE_FOLDER = 8; 123 private static final int REQUEST_PICK_APPWIDGET = 9; 124 private static final int REQUEST_PICK_WALLPAPER = 10; 125 126 static final String EXTRA_SHORTCUT_DUPLICATE = "duplicate"; 127 128 static final int SCREEN_COUNT = 5; 129 static final int DEFAULT_SCREEN = 2; 130 static final int NUMBER_CELLS_X = 4; 131 static final int NUMBER_CELLS_Y = 4; 132 133 static final int DIALOG_CREATE_SHORTCUT = 1; 134 static final int DIALOG_RENAME_FOLDER = 2; 135 136 private static final String PREFERENCES = "launcher.preferences"; 137 138 // Type: int 139 private static final String RUNTIME_STATE_CURRENT_SCREEN = "launcher.current_screen"; 140 // Type: boolean 141 private static final String RUNTIME_STATE_ALL_APPS_FOLDER = "launcher.all_apps_folder"; 142 // Type: long 143 private static final String RUNTIME_STATE_USER_FOLDERS = "launcher.user_folder"; 144 // Type: int 145 private static final String RUNTIME_STATE_PENDING_ADD_SCREEN = "launcher.add_screen"; 146 // Type: int 147 private static final String RUNTIME_STATE_PENDING_ADD_CELL_X = "launcher.add_cellX"; 148 // Type: int 149 private static final String RUNTIME_STATE_PENDING_ADD_CELL_Y = "launcher.add_cellY"; 150 // Type: int 151 private static final String RUNTIME_STATE_PENDING_ADD_SPAN_X = "launcher.add_spanX"; 152 // Type: int 153 private static final String RUNTIME_STATE_PENDING_ADD_SPAN_Y = "launcher.add_spanY"; 154 // Type: int 155 private static final String RUNTIME_STATE_PENDING_ADD_COUNT_X = "launcher.add_countX"; 156 // Type: int 157 private static final String RUNTIME_STATE_PENDING_ADD_COUNT_Y = "launcher.add_countY"; 158 // Type: int[] 159 private static final String RUNTIME_STATE_PENDING_ADD_OCCUPIED_CELLS = "launcher.add_occupied_cells"; 160 // Type: boolean 161 private static final String RUNTIME_STATE_PENDING_FOLDER_RENAME = "launcher.rename_folder"; 162 // Type: long 163 private static final String RUNTIME_STATE_PENDING_FOLDER_RENAME_ID = "launcher.rename_folder_id"; 164 165 static final int APPWIDGET_HOST_ID = 1024; 166 167 private static final Object sLock = new Object(); 168 private static int sScreen = DEFAULT_SCREEN; 169 170 private final BroadcastReceiver mCloseSystemDialogsReceiver 171 = new CloseSystemDialogsIntentReceiver(); 172 private final ContentObserver mWidgetObserver = new AppWidgetResetObserver(); 173 174 private LayoutInflater mInflater; 175 176 private DragController mDragController; 177 private Workspace mWorkspace; 178 179 private AppWidgetManager mAppWidgetManager; 180 private LauncherAppWidgetHost mAppWidgetHost; 181 182 private CellLayout.CellInfo mAddItemCellInfo; 183 private CellLayout.CellInfo mMenuAddInfo; 184 private final int[] mCellCoordinates = new int[2]; 185 private FolderInfo mFolderInfo; 186 187 private DeleteZone mDeleteZone; 188 private HandleView mHandleView; 189 private AllAppsView mAllAppsGrid; 190 private TabHost mHomeCustomizationDrawer; 191 192 private Bundle mSavedState; 193 194 private SpannableStringBuilder mDefaultKeySsb = null; 195 196 private boolean mWorkspaceLoading = true; 197 198 private boolean mPaused = true; 199 private boolean mRestoring; 200 private boolean mWaitingForResult; 201 202 private Bundle mSavedInstanceState; 203 204 private LauncherModel mModel; 205 private IconCache mIconCache; 206 207 private ArrayList<ItemInfo> mDesktopItems = new ArrayList<ItemInfo>(); 208 private static HashMap<Long, FolderInfo> mFolders = new HashMap<Long, FolderInfo>(); 209 210 private ImageView mPreviousView; 211 private ImageView mNextView; 212 213 // Hotseats (quick-launch icons next to AllApps) 214 private static final int NUM_HOTSEATS = 2; 215 private String[] mHotseatConfig = null; 216 private Intent[] mHotseats = null; 217 private Drawable[] mHotseatIcons = null; 218 private CharSequence[] mHotseatLabels = null; 219 220 221 @Override 222 protected void onCreate(Bundle savedInstanceState) { 223 super.onCreate(savedInstanceState); 224 225 if (LauncherApplication.isInPlaceRotationEnabled()) { 226 // hide the status bar (temporary until we get the status bar design figured out) 227 getWindow().setFlags(WindowManager.LayoutParams.FLAG_FULLSCREEN, WindowManager.LayoutParams.FLAG_FULLSCREEN); 228 this.setRequestedOrientation(ActivityInfo.SCREEN_ORIENTATION_SENSOR); 229 } 230 231 LauncherApplication app = ((LauncherApplication)getApplication()); 232 mModel = app.setLauncher(this); 233 mIconCache = app.getIconCache(); 234 mDragController = new DragController(this); 235 mInflater = getLayoutInflater(); 236 237 mAppWidgetManager = AppWidgetManager.getInstance(this); 238 mAppWidgetHost = new LauncherAppWidgetHost(this, APPWIDGET_HOST_ID); 239 mAppWidgetHost.startListening(); 240 241 if (PROFILE_STARTUP) { 242 android.os.Debug.startMethodTracing("/sdcard/launcher"); 243 } 244 245 loadHotseats(); 246 checkForLocaleChange(); 247 setWallpaperDimension(); 248 setContentView(R.layout.launcher); 249 mHomeCustomizationDrawer = (TabHost) findViewById(com.android.internal.R.id.tabhost); 250 if (mHomeCustomizationDrawer != null) { 251 mHomeCustomizationDrawer.setup(); 252 253 String widgetsLabel = getString(R.string.widgets_tab_label); 254 mHomeCustomizationDrawer.addTab(mHomeCustomizationDrawer.newTabSpec("widgets") 255 .setIndicator(widgetsLabel).setContent(R.id.widget_chooser)); 256 String foldersLabel = getString(R.string.folders_tab_label); 257 mHomeCustomizationDrawer.addTab(mHomeCustomizationDrawer.newTabSpec("folders") 258 .setIndicator(foldersLabel).setContent(R.id.folder_chooser)); 259 String shortcutsLabel = getString(R.string.shortcuts_tab_label); 260 mHomeCustomizationDrawer.addTab(mHomeCustomizationDrawer.newTabSpec("shortcuts") 261 .setIndicator(shortcutsLabel).setContent(R.id.shortcut_chooser)); 262 String wallpapersLabel = getString(R.string.wallpapers_tab_label); 263 mHomeCustomizationDrawer.addTab(mHomeCustomizationDrawer.newTabSpec("wallpapers") 264 .setIndicator(wallpapersLabel).setContent(R.id.wallpaperstab)); 265 266 mHomeCustomizationDrawer.setCurrentTab(0); 267 } 268 setupViews(); 269 270 registerContentObservers(); 271 272 lockAllApps(); 273 274 mSavedState = savedInstanceState; 275 restoreState(mSavedState); 276 277 if (PROFILE_STARTUP) { 278 android.os.Debug.stopMethodTracing(); 279 } 280 281 if (!mRestoring) { 282 mModel.startLoader(this, true); 283 } 284 285 // For handling default keys 286 mDefaultKeySsb = new SpannableStringBuilder(); 287 Selection.setSelection(mDefaultKeySsb, 0); 288 289 IntentFilter filter = new IntentFilter(Intent.ACTION_CLOSE_SYSTEM_DIALOGS); 290 registerReceiver(mCloseSystemDialogsReceiver, filter); 291 } 292 293 @Override 294 public void onConfigurationChanged(Configuration newConfig) { 295 // TODO Auto-generated method stub 296 super.onConfigurationChanged(newConfig); 297 298 if (LauncherApplication.isInPlaceRotationEnabled()) { 299 mModel.updateOrientation(); 300 mWorkspace.refreshWorkspaceChildren(); 301 mWorkspace.rotateCurrentScreensChildren(); 302 } 303 } 304 305 306 private void checkForLocaleChange() { 307 final LocaleConfiguration localeConfiguration = new LocaleConfiguration(); 308 readConfiguration(this, localeConfiguration); 309 310 final Configuration configuration = getResources().getConfiguration(); 311 312 final String previousLocale = localeConfiguration.locale; 313 final String locale = configuration.locale.toString(); 314 315 final int previousMcc = localeConfiguration.mcc; 316 final int mcc = configuration.mcc; 317 318 final int previousMnc = localeConfiguration.mnc; 319 final int mnc = configuration.mnc; 320 321 boolean localeChanged = !locale.equals(previousLocale) || mcc != previousMcc || mnc != previousMnc; 322 323 if (localeChanged) { 324 localeConfiguration.locale = locale; 325 localeConfiguration.mcc = mcc; 326 localeConfiguration.mnc = mnc; 327 328 writeConfiguration(this, localeConfiguration); 329 mIconCache.flush(); 330 331 loadHotseats(); 332 } 333 } 334 335 private static class LocaleConfiguration { 336 public String locale; 337 public int mcc = -1; 338 public int mnc = -1; 339 } 340 341 private static void readConfiguration(Context context, LocaleConfiguration configuration) { 342 DataInputStream in = null; 343 try { 344 in = new DataInputStream(context.openFileInput(PREFERENCES)); 345 configuration.locale = in.readUTF(); 346 configuration.mcc = in.readInt(); 347 configuration.mnc = in.readInt(); 348 } catch (FileNotFoundException e) { 349 // Ignore 350 } catch (IOException e) { 351 // Ignore 352 } finally { 353 if (in != null) { 354 try { 355 in.close(); 356 } catch (IOException e) { 357 // Ignore 358 } 359 } 360 } 361 } 362 363 private static void writeConfiguration(Context context, LocaleConfiguration configuration) { 364 DataOutputStream out = null; 365 try { 366 out = new DataOutputStream(context.openFileOutput(PREFERENCES, MODE_PRIVATE)); 367 out.writeUTF(configuration.locale); 368 out.writeInt(configuration.mcc); 369 out.writeInt(configuration.mnc); 370 out.flush(); 371 } catch (FileNotFoundException e) { 372 // Ignore 373 } catch (IOException e) { 374 //noinspection ResultOfMethodCallIgnored 375 context.getFileStreamPath(PREFERENCES).delete(); 376 } finally { 377 if (out != null) { 378 try { 379 out.close(); 380 } catch (IOException e) { 381 // Ignore 382 } 383 } 384 } 385 } 386 387 static int getScreen() { 388 synchronized (sLock) { 389 return sScreen; 390 } 391 } 392 393 static void setScreen(int screen) { 394 synchronized (sLock) { 395 sScreen = screen; 396 } 397 } 398 399 private void setWallpaperDimension() { 400 WallpaperManager wpm = (WallpaperManager)getSystemService(WALLPAPER_SERVICE); 401 402 Display display = getWindowManager().getDefaultDisplay(); 403 boolean isPortrait = display.getWidth() < display.getHeight(); 404 405 final int width = isPortrait ? display.getWidth() : display.getHeight(); 406 final int height = isPortrait ? display.getHeight() : display.getWidth(); 407 wpm.suggestDesiredDimensions(width * WALLPAPER_SCREENS_SPAN, height); 408 } 409 410 // Note: This doesn't do all the client-id magic that BrowserProvider does 411 // in Browser. (http://b/2425179) 412 private Uri getDefaultBrowserUri() { 413 String url = getString(R.string.default_browser_url); 414 if (url.indexOf("{CID}") != -1) { 415 url = url.replace("{CID}", "android-google"); 416 } 417 return Uri.parse(url); 418 } 419 420 // Load the Intent templates from arrays.xml to populate the hotseats. For 421 // each Intent, if it resolves to a single app, use that as the launch 422 // intent & use that app's label as the contentDescription. Otherwise, 423 // retain the ResolveActivity so the user can pick an app. 424 private void loadHotseats() { 425 if (mHotseatConfig == null) { 426 mHotseatConfig = getResources().getStringArray(R.array.hotseats); 427 if (mHotseatConfig.length > 0) { 428 mHotseats = new Intent[mHotseatConfig.length]; 429 mHotseatLabels = new CharSequence[mHotseatConfig.length]; 430 mHotseatIcons = new Drawable[mHotseatConfig.length]; 431 } else { 432 mHotseats = null; 433 mHotseatIcons = null; 434 mHotseatLabels = null; 435 } 436 437 TypedArray hotseatIconDrawables = getResources().obtainTypedArray(R.array.hotseat_icons); 438 for (int i=0; i<mHotseatConfig.length; i++) { 439 // load icon for this slot; currently unrelated to the actual activity 440 try { 441 mHotseatIcons[i] = hotseatIconDrawables.getDrawable(i); 442 } catch (ArrayIndexOutOfBoundsException ex) { 443 Log.w(TAG, "Missing hotseat_icons array item #" + i); 444 mHotseatIcons[i] = null; 445 } 446 } 447 hotseatIconDrawables.recycle(); 448 } 449 450 PackageManager pm = getPackageManager(); 451 for (int i=0; i<mHotseatConfig.length; i++) { 452 Intent intent = null; 453 if (mHotseatConfig[i].equals("*BROWSER*")) { 454 // magic value meaning "launch user's default web browser" 455 // replace it with a generic web request so we can see if there is indeed a default 456 String defaultUri = getString(R.string.default_browser_url); 457 intent = new Intent( 458 Intent.ACTION_VIEW, 459 ((defaultUri != null) 460 ? Uri.parse(defaultUri) 461 : getDefaultBrowserUri()) 462 ).addCategory(Intent.CATEGORY_BROWSABLE); 463 // note: if the user launches this without a default set, she 464 // will always be taken to the default URL above; this is 465 // unavoidable as we must specify a valid URL in order for the 466 // chooser to appear, and once the user selects something, that 467 // URL is unavoidably sent to the chosen app. 468 } else { 469 try { 470 intent = Intent.parseUri(mHotseatConfig[i], 0); 471 } catch (java.net.URISyntaxException ex) { 472 Log.w(TAG, "Invalid hotseat intent: " + mHotseatConfig[i]); 473 // bogus; leave intent=null 474 } 475 } 476 477 if (intent == null) { 478 mHotseats[i] = null; 479 mHotseatLabels[i] = getText(R.string.activity_not_found); 480 continue; 481 } 482 483 if (LOGD) { 484 Log.d(TAG, "loadHotseats: hotseat " + i 485 + " initial intent=[" 486 + intent.toUri(Intent.URI_INTENT_SCHEME) 487 + "]"); 488 } 489 490 ResolveInfo bestMatch = pm.resolveActivity(intent, PackageManager.MATCH_DEFAULT_ONLY); 491 List<ResolveInfo> allMatches = pm.queryIntentActivities(intent, PackageManager.MATCH_DEFAULT_ONLY); 492 if (LOGD) { 493 Log.d(TAG, "Best match for intent: " + bestMatch); 494 Log.d(TAG, "All matches: "); 495 for (ResolveInfo ri : allMatches) { 496 Log.d(TAG, " --> " + ri); 497 } 498 } 499 // did this resolve to a single app, or the resolver? 500 if (allMatches.size() == 0 || bestMatch == null) { 501 // can't find any activity to handle this. let's leave the 502 // intent as-is and let Launcher show a toast when it fails 503 // to launch. 504 mHotseats[i] = intent; 505 506 // set accessibility text to "Not installed" 507 mHotseatLabels[i] = getText(R.string.activity_not_found); 508 } else { 509 boolean found = false; 510 for (ResolveInfo ri : allMatches) { 511 if (bestMatch.activityInfo.name.equals(ri.activityInfo.name) 512 && bestMatch.activityInfo.applicationInfo.packageName 513 .equals(ri.activityInfo.applicationInfo.packageName)) { 514 found = true; 515 break; 516 } 517 } 518 519 if (!found) { 520 if (LOGD) Log.d(TAG, "Multiple options, no default yet"); 521 // the bestMatch is probably the ResolveActivity, meaning the 522 // user has not yet selected a default 523 // so: we'll keep the original intent for now 524 mHotseats[i] = intent; 525 526 // set the accessibility text to "Select shortcut" 527 mHotseatLabels[i] = getText(R.string.title_select_shortcut); 528 } else { 529 // we have an app! 530 // now reconstruct the intent to launch it through the front 531 // door 532 ComponentName com = new ComponentName( 533 bestMatch.activityInfo.applicationInfo.packageName, 534 bestMatch.activityInfo.name); 535 mHotseats[i] = new Intent(Intent.ACTION_MAIN).setComponent(com); 536 537 // load the app label for accessibility 538 mHotseatLabels[i] = bestMatch.activityInfo.loadLabel(pm); 539 } 540 } 541 542 if (LOGD) { 543 Log.d(TAG, "loadHotseats: hotseat " + i 544 + " final intent=[" 545 + ((mHotseats[i] == null) 546 ? "null" 547 : mHotseats[i].toUri(Intent.URI_INTENT_SCHEME)) 548 + "] label=[" + mHotseatLabels[i] 549 + "]" 550 ); 551 } 552 } 553 } 554 555 @Override 556 protected void onActivityResult(int requestCode, int resultCode, Intent data) { 557 mWaitingForResult = false; 558 559 // The pattern used here is that a user PICKs a specific application, 560 // which, depending on the target, might need to CREATE the actual target. 561 562 // For example, the user would PICK_SHORTCUT for "Music playlist", and we 563 // launch over to the Music app to actually CREATE_SHORTCUT. 564 565 if (resultCode == RESULT_OK && mAddItemCellInfo != null) { 566 switch (requestCode) { 567 case REQUEST_PICK_APPLICATION: 568 completeAddApplication(this, data, mAddItemCellInfo); 569 break; 570 case REQUEST_PICK_SHORTCUT: 571 processShortcut(data); 572 break; 573 case REQUEST_CREATE_SHORTCUT: 574 completeAddShortcut(data, mAddItemCellInfo); 575 break; 576 case REQUEST_PICK_LIVE_FOLDER: 577 addLiveFolder(data); 578 break; 579 case REQUEST_CREATE_LIVE_FOLDER: 580 completeAddLiveFolder(data, mAddItemCellInfo); 581 break; 582 case REQUEST_PICK_APPWIDGET: 583 addAppWidgetFromPick(data); 584 break; 585 case REQUEST_CREATE_APPWIDGET: 586 int appWidgetId = data.getIntExtra(AppWidgetManager.EXTRA_APPWIDGET_ID, -1); 587 completeAddAppWidget(appWidgetId, mAddItemCellInfo); 588 break; 589 case REQUEST_PICK_WALLPAPER: 590 // We just wanted the activity result here so we can clear mWaitingForResult 591 break; 592 } 593 } else if ((requestCode == REQUEST_PICK_APPWIDGET || 594 requestCode == REQUEST_CREATE_APPWIDGET) && resultCode == RESULT_CANCELED && 595 data != null) { 596 // Clean up the appWidgetId if we canceled 597 int appWidgetId = data.getIntExtra(AppWidgetManager.EXTRA_APPWIDGET_ID, -1); 598 if (appWidgetId != -1) { 599 mAppWidgetHost.deleteAppWidgetId(appWidgetId); 600 } 601 } 602 } 603 604 @Override 605 protected void onResume() { 606 super.onResume(); 607 608 mPaused = false; 609 610 if (mRestoring) { 611 mWorkspaceLoading = true; 612 mModel.startLoader(this, true); 613 mRestoring = false; 614 } 615 } 616 617 @Override 618 protected void onPause() { 619 super.onPause(); 620 // Some launcher layouts don't have a previous and next view 621 if (mPreviousView != null) { 622 dismissPreview(mPreviousView); 623 dismissPreview(mNextView); 624 } 625 mDragController.cancelDrag(); 626 } 627 628 @Override 629 public Object onRetainNonConfigurationInstance() { 630 // Flag the loader to stop early before switching 631 mModel.stopLoader(); 632 mAllAppsGrid.surrender(); 633 return Boolean.TRUE; 634 } 635 636 // We can't hide the IME if it was forced open. So don't bother 637 /* 638 @Override 639 public void onWindowFocusChanged(boolean hasFocus) { 640 super.onWindowFocusChanged(hasFocus); 641 642 if (hasFocus) { 643 final InputMethodManager inputManager = (InputMethodManager) 644 getSystemService(Context.INPUT_METHOD_SERVICE); 645 WindowManager.LayoutParams lp = getWindow().getAttributes(); 646 inputManager.hideSoftInputFromWindow(lp.token, 0, new android.os.ResultReceiver(new 647 android.os.Handler()) { 648 protected void onReceiveResult(int resultCode, Bundle resultData) { 649 Log.d(TAG, "ResultReceiver got resultCode=" + resultCode); 650 } 651 }); 652 Log.d(TAG, "called hideSoftInputFromWindow from onWindowFocusChanged"); 653 } 654 } 655 */ 656 657 private boolean acceptFilter() { 658 final InputMethodManager inputManager = (InputMethodManager) 659 getSystemService(Context.INPUT_METHOD_SERVICE); 660 return !inputManager.isFullscreenMode(); 661 } 662 663 @Override 664 public boolean onKeyDown(int keyCode, KeyEvent event) { 665 boolean handled = super.onKeyDown(keyCode, event); 666 if (!handled && acceptFilter() && keyCode != KeyEvent.KEYCODE_ENTER) { 667 boolean gotKey = TextKeyListener.getInstance().onKeyDown(mWorkspace, mDefaultKeySsb, 668 keyCode, event); 669 if (gotKey && mDefaultKeySsb != null && mDefaultKeySsb.length() > 0) { 670 // something usable has been typed - start a search 671 // the typed text will be retrieved and cleared by 672 // showSearchDialog() 673 // If there are multiple keystrokes before the search dialog takes focus, 674 // onSearchRequested() will be called for every keystroke, 675 // but it is idempotent, so it's fine. 676 return onSearchRequested(); 677 } 678 } 679 680 // Eat the long press event so the keyboard doesn't come up. 681 if (keyCode == KeyEvent.KEYCODE_MENU && event.isLongPress()) { 682 return true; 683 } 684 685 return handled; 686 } 687 688 private String getTypedText() { 689 return mDefaultKeySsb.toString(); 690 } 691 692 private void clearTypedText() { 693 mDefaultKeySsb.clear(); 694 mDefaultKeySsb.clearSpans(); 695 Selection.setSelection(mDefaultKeySsb, 0); 696 } 697 698 /** 699 * Restores the previous state, if it exists. 700 * 701 * @param savedState The previous state. 702 */ 703 private void restoreState(Bundle savedState) { 704 if (savedState == null) { 705 return; 706 } 707 708 final boolean allApps = savedState.getBoolean(RUNTIME_STATE_ALL_APPS_FOLDER, false); 709 if (allApps) { 710 showAllApps(false); 711 } 712 713 final int currentScreen = savedState.getInt(RUNTIME_STATE_CURRENT_SCREEN, -1); 714 if (currentScreen > -1) { 715 mWorkspace.setCurrentScreen(currentScreen); 716 } 717 718 final int addScreen = savedState.getInt(RUNTIME_STATE_PENDING_ADD_SCREEN, -1); 719 if (addScreen > -1) { 720 mAddItemCellInfo = new CellLayout.CellInfo(); 721 final CellLayout.CellInfo addItemCellInfo = mAddItemCellInfo; 722 addItemCellInfo.valid = true; 723 addItemCellInfo.screen = addScreen; 724 addItemCellInfo.cellX = savedState.getInt(RUNTIME_STATE_PENDING_ADD_CELL_X); 725 addItemCellInfo.cellY = savedState.getInt(RUNTIME_STATE_PENDING_ADD_CELL_Y); 726 addItemCellInfo.spanX = savedState.getInt(RUNTIME_STATE_PENDING_ADD_SPAN_X); 727 addItemCellInfo.spanY = savedState.getInt(RUNTIME_STATE_PENDING_ADD_SPAN_Y); 728 addItemCellInfo.findVacantCellsFromOccupied( 729 savedState.getBooleanArray(RUNTIME_STATE_PENDING_ADD_OCCUPIED_CELLS), 730 savedState.getInt(RUNTIME_STATE_PENDING_ADD_COUNT_X), 731 savedState.getInt(RUNTIME_STATE_PENDING_ADD_COUNT_Y)); 732 mRestoring = true; 733 } 734 735 boolean renameFolder = savedState.getBoolean(RUNTIME_STATE_PENDING_FOLDER_RENAME, false); 736 if (renameFolder) { 737 long id = savedState.getLong(RUNTIME_STATE_PENDING_FOLDER_RENAME_ID); 738 mFolderInfo = mModel.getFolderById(this, mFolders, id); 739 mRestoring = true; 740 } 741 } 742 743 /** 744 * Finds all the views we need and configure them properly. 745 */ 746 private void setupViews() { 747 DragController dragController = mDragController; 748 749 DragLayer dragLayer = (DragLayer) findViewById(R.id.drag_layer); 750 dragLayer.setDragController(dragController); 751 752 mAllAppsGrid = (AllAppsView)dragLayer.findViewById(R.id.all_apps_view); 753 mAllAppsGrid.setLauncher(this); 754 mAllAppsGrid.setDragController(dragController); 755 ((View) mAllAppsGrid).setWillNotDraw(false); // We don't want a hole punched in our window. 756 // Manage focusability manually since this thing is always visible 757 ((View) mAllAppsGrid).setFocusable(false); 758 759 mWorkspace = (Workspace) dragLayer.findViewById(R.id.workspace); 760 final Workspace workspace = mWorkspace; 761 workspace.setHapticFeedbackEnabled(false); 762 763 // We only intercept touch events to dismiss the home customization drawer; if it doesn't 764 // exist, then no need to do this 765 if (mHomeCustomizationDrawer != null) 766 workspace.setOnInterceptTouchListener(this); 767 768 DeleteZone deleteZone = (DeleteZone) dragLayer.findViewById(R.id.delete_zone); 769 mDeleteZone = deleteZone; 770 771 mHandleView = (HandleView) findViewById(R.id.all_apps_button); 772 mHandleView.setLauncher(this); 773 mHandleView.setOnClickListener(this); 774 mHandleView.setOnLongClickListener(this); 775 776 WidgetChooser widgetChooser = (WidgetChooser) findViewById(R.id.widget_chooser); 777 if (widgetChooser != null) { 778 WidgetListAdapter widgetGalleryAdapter = new WidgetListAdapter(this); 779 widgetChooser.setAdapter(widgetGalleryAdapter); 780 widgetChooser.setDragController(dragController); 781 widgetChooser.setLauncher(this); 782 783 FolderChooser folderChooser = (FolderChooser) findViewById(R.id.folder_chooser); 784 IntentListAdapter folderTypes = new FolderListAdapter(this, LiveFolders.ACTION_CREATE_LIVE_FOLDER); 785 folderChooser.setAdapter(folderTypes); 786 folderChooser.setLauncher(this); 787 788 ShortcutChooser shortcutChooser = (ShortcutChooser) findViewById(R.id.shortcut_chooser); 789 IntentListAdapter shortcutTypes = new ShortcutListAdapter(this, Intent.ACTION_CREATE_SHORTCUT); 790 shortcutChooser.setAdapter(shortcutTypes); 791 shortcutChooser.setLauncher(this); 792 } else { 793 ImageView hotseatLeft = (ImageView) findViewById(R.id.hotseat_left); 794 hotseatLeft.setContentDescription(mHotseatLabels[0]); 795 hotseatLeft.setImageDrawable(mHotseatIcons[0]); 796 ImageView hotseatRight = (ImageView) findViewById(R.id.hotseat_right); 797 hotseatRight.setContentDescription(mHotseatLabels[1]); 798 hotseatRight.setImageDrawable(mHotseatIcons[1]); 799 800 mPreviousView = (ImageView) dragLayer.findViewById(R.id.previous_screen); 801 mNextView = (ImageView) dragLayer.findViewById(R.id.next_screen); 802 803 Drawable previous = mPreviousView.getDrawable(); 804 Drawable next = mNextView.getDrawable(); 805 mWorkspace.setIndicators(previous, next); 806 807 mPreviousView.setHapticFeedbackEnabled(false); 808 mPreviousView.setOnLongClickListener(this); 809 mNextView.setHapticFeedbackEnabled(false); 810 mNextView.setOnLongClickListener(this); 811 } 812 813 workspace.setOnLongClickListener(this); 814 workspace.setDragController(dragController); 815 workspace.setLauncher(this); 816 817 deleteZone.setLauncher(this); 818 deleteZone.setDragController(dragController); 819 int deleteZoneHandleId = LauncherApplication.isScreenXLarge() ? R.id.add_button : R.id.all_apps_button_cluster; 820 deleteZone.setHandle(findViewById(deleteZoneHandleId)); 821 822 dragController.setDragScoller(workspace); 823 dragController.setDragListener(deleteZone); 824 dragController.setScrollView(dragLayer); 825 dragController.setMoveTarget(workspace); 826 827 // The order here is bottom to top. 828 dragController.addDropTarget(workspace); 829 dragController.addDropTarget(deleteZone); 830 } 831 832 @SuppressWarnings({"UnusedDeclaration"}) 833 public void previousScreen(View v) { 834 if (!isAllAppsVisible()) { 835 mWorkspace.scrollLeft(); 836 } 837 } 838 839 @SuppressWarnings({"UnusedDeclaration"}) 840 public void nextScreen(View v) { 841 if (!isAllAppsVisible()) { 842 mWorkspace.scrollRight(); 843 } 844 } 845 846 @SuppressWarnings({"UnusedDeclaration"}) 847 public void launchHotSeat(View v) { 848 if (isAllAppsVisible()) return; 849 850 int index = -1; 851 if (v.getId() == R.id.hotseat_left) { 852 index = 0; 853 } else if (v.getId() == R.id.hotseat_right) { 854 index = 1; 855 } 856 857 // reload these every tap; you never know when they might change 858 loadHotseats(); 859 if (index >= 0 && index < mHotseats.length && mHotseats[index] != null) { 860 Intent intent = mHotseats[index]; 861 startActivitySafely( 862 mHotseats[index], 863 "hotseat" 864 ); 865 } 866 } 867 868 /** 869 * Creates a view representing a shortcut. 870 * 871 * @param info The data structure describing the shortcut. 872 * 873 * @return A View inflated from R.layout.application. 874 */ 875 View createShortcut(ShortcutInfo info) { 876 return createShortcut(R.layout.application, 877 (ViewGroup) mWorkspace.getChildAt(mWorkspace.getCurrentScreen()), info); 878 } 879 880 /** 881 * Creates a view representing a shortcut inflated from the specified resource. 882 * 883 * @param layoutResId The id of the XML layout used to create the shortcut. 884 * @param parent The group the shortcut belongs to. 885 * @param info The data structure describing the shortcut. 886 * 887 * @return A View inflated from layoutResId. 888 */ 889 View createShortcut(int layoutResId, ViewGroup parent, ShortcutInfo info) { 890 TextView favorite = (TextView) mInflater.inflate(layoutResId, parent, false); 891 892 favorite.setCompoundDrawablesWithIntrinsicBounds(null, 893 new FastBitmapDrawable(info.getIcon(mIconCache)), 894 null, null); 895 favorite.setText(info.title); 896 favorite.setTag(info); 897 favorite.setOnClickListener(this); 898 899 return favorite; 900 } 901 902 /** 903 * Add an application shortcut to the workspace. 904 * 905 * @param data The intent describing the application. 906 * @param cellInfo The position on screen where to create the shortcut. 907 */ 908 void completeAddApplication(Context context, Intent data, CellLayout.CellInfo cellInfo) { 909 cellInfo.screen = mWorkspace.getCurrentScreen(); 910 if (!findSingleSlot(cellInfo)) return; 911 912 final ShortcutInfo info = mModel.getShortcutInfo(context.getPackageManager(), 913 data, context); 914 915 if (info != null) { 916 info.setActivity(data.getComponent(), Intent.FLAG_ACTIVITY_NEW_TASK | 917 Intent.FLAG_ACTIVITY_RESET_TASK_IF_NEEDED); 918 info.container = ItemInfo.NO_ID; 919 mWorkspace.addApplicationShortcut(info, cellInfo, isWorkspaceLocked()); 920 } else { 921 Log.e(TAG, "Couldn't find ActivityInfo for selected application: " + data); 922 } 923 } 924 925 /** 926 * Add a shortcut to the workspace. 927 * 928 * @param data The intent describing the shortcut. 929 * @param cellInfo The position on screen where to create the shortcut. 930 */ 931 private void completeAddShortcut(Intent data, CellLayout.CellInfo cellInfo) { 932 cellInfo.screen = mWorkspace.getCurrentScreen(); 933 if (!findSingleSlot(cellInfo)) return; 934 935 final ShortcutInfo info = mModel.addShortcut(this, data, cellInfo, false); 936 937 if (!mRestoring) { 938 final View view = createShortcut(info); 939 mWorkspace.addInCurrentScreen(view, cellInfo.cellX, cellInfo.cellY, 1, 1, 940 isWorkspaceLocked()); 941 } 942 } 943 944 945 /** 946 * Add a widget to the workspace. 947 * 948 * @param data The intent describing the appWidgetId. 949 * @param cellInfo The position on screen where to create the widget. 950 */ 951 private void completeAddAppWidget(int appWidgetId, CellLayout.CellInfo cellInfo) { 952 AppWidgetProviderInfo appWidgetInfo = mAppWidgetManager.getAppWidgetInfo(appWidgetId); 953 954 // Calculate the grid spans needed to fit this widget 955 CellLayout layout = (CellLayout) mWorkspace.getChildAt(cellInfo.screen); 956 int[] spans = layout.rectToCell(appWidgetInfo.minWidth, appWidgetInfo.minHeight); 957 958 // Try finding open space on Launcher screen 959 final int[] xy = mCellCoordinates; 960 if (!findSlot(cellInfo, xy, spans[0], spans[1])) { 961 if (appWidgetId != -1) mAppWidgetHost.deleteAppWidgetId(appWidgetId); 962 return; 963 } 964 965 // Build Launcher-specific widget info and save to database 966 LauncherAppWidgetInfo launcherInfo = new LauncherAppWidgetInfo(appWidgetId); 967 launcherInfo.spanX = spans[0]; 968 launcherInfo.spanY = spans[1]; 969 970 LauncherModel.addItemToDatabase(this, launcherInfo, 971 LauncherSettings.Favorites.CONTAINER_DESKTOP, 972 mWorkspace.getCurrentScreen(), xy[0], xy[1], false); 973 974 if (!mRestoring) { 975 mDesktopItems.add(launcherInfo); 976 977 // Perform actual inflation because we're live 978 launcherInfo.hostView = mAppWidgetHost.createView(this, appWidgetId, appWidgetInfo); 979 980 launcherInfo.hostView.setAppWidget(appWidgetId, appWidgetInfo); 981 launcherInfo.hostView.setTag(launcherInfo); 982 983 mWorkspace.addInCurrentScreen(launcherInfo.hostView, xy[0], xy[1], 984 launcherInfo.spanX, launcherInfo.spanY, isWorkspaceLocked()); 985 } 986 } 987 988 public void removeAppWidget(LauncherAppWidgetInfo launcherInfo) { 989 mDesktopItems.remove(launcherInfo); 990 launcherInfo.hostView = null; 991 } 992 993 public LauncherAppWidgetHost getAppWidgetHost() { 994 return mAppWidgetHost; 995 } 996 997 void closeSystemDialogs() { 998 getWindow().closeAllPanels(); 999 1000 try { 1001 dismissDialog(DIALOG_CREATE_SHORTCUT); 1002 // Unlock the workspace if the dialog was showing 1003 } catch (Exception e) { 1004 // An exception is thrown if the dialog is not visible, which is fine 1005 } 1006 1007 try { 1008 dismissDialog(DIALOG_RENAME_FOLDER); 1009 // Unlock the workspace if the dialog was showing 1010 } catch (Exception e) { 1011 // An exception is thrown if the dialog is not visible, which is fine 1012 } 1013 1014 // Whatever we were doing is hereby canceled. 1015 mWaitingForResult = false; 1016 } 1017 1018 @Override 1019 protected void onNewIntent(Intent intent) { 1020 super.onNewIntent(intent); 1021 1022 // Close the menu 1023 if (Intent.ACTION_MAIN.equals(intent.getAction())) { 1024 // also will cancel mWaitingForResult. 1025 closeSystemDialogs(); 1026 1027 boolean alreadyOnHome = ((intent.getFlags() & Intent.FLAG_ACTIVITY_BROUGHT_TO_FRONT) 1028 != Intent.FLAG_ACTIVITY_BROUGHT_TO_FRONT); 1029 boolean allAppsVisible = isAllAppsVisible(); 1030 if (!mWorkspace.isDefaultScreenShowing()) { 1031 mWorkspace.moveToDefaultScreen(alreadyOnHome && !allAppsVisible); 1032 } 1033 closeAllApps(alreadyOnHome && allAppsVisible); 1034 1035 final View v = getWindow().peekDecorView(); 1036 if (v != null && v.getWindowToken() != null) { 1037 InputMethodManager imm = (InputMethodManager)getSystemService( 1038 INPUT_METHOD_SERVICE); 1039 imm.hideSoftInputFromWindow(v.getWindowToken(), 0); 1040 } 1041 } 1042 } 1043 1044 @Override 1045 protected void onRestoreInstanceState(Bundle savedInstanceState) { 1046 // Do not call super here 1047 mSavedInstanceState = savedInstanceState; 1048 1049 if (mHomeCustomizationDrawer != null) { 1050 String cur = savedInstanceState.getString("currentTab"); 1051 if (cur != null) { 1052 mHomeCustomizationDrawer.setCurrentTabByTag(cur); 1053 } 1054 } 1055 } 1056 1057 @Override 1058 protected void onSaveInstanceState(Bundle outState) { 1059 outState.putInt(RUNTIME_STATE_CURRENT_SCREEN, mWorkspace.getCurrentScreen()); 1060 1061 final ArrayList<Folder> folders = mWorkspace.getOpenFolders(); 1062 if (folders.size() > 0) { 1063 final int count = folders.size(); 1064 long[] ids = new long[count]; 1065 for (int i = 0; i < count; i++) { 1066 final FolderInfo info = folders.get(i).getInfo(); 1067 ids[i] = info.id; 1068 } 1069 outState.putLongArray(RUNTIME_STATE_USER_FOLDERS, ids); 1070 } else { 1071 super.onSaveInstanceState(outState); 1072 } 1073 1074 // TODO should not do this if the drawer is currently closing. 1075 if (isAllAppsVisible()) { 1076 outState.putBoolean(RUNTIME_STATE_ALL_APPS_FOLDER, true); 1077 } 1078 1079 if (mAddItemCellInfo != null && mAddItemCellInfo.valid && mWaitingForResult) { 1080 final CellLayout.CellInfo addItemCellInfo = mAddItemCellInfo; 1081 final CellLayout layout = (CellLayout) mWorkspace.getChildAt(addItemCellInfo.screen); 1082 1083 outState.putInt(RUNTIME_STATE_PENDING_ADD_SCREEN, addItemCellInfo.screen); 1084 outState.putInt(RUNTIME_STATE_PENDING_ADD_CELL_X, addItemCellInfo.cellX); 1085 outState.putInt(RUNTIME_STATE_PENDING_ADD_CELL_Y, addItemCellInfo.cellY); 1086 outState.putInt(RUNTIME_STATE_PENDING_ADD_SPAN_X, addItemCellInfo.spanX); 1087 outState.putInt(RUNTIME_STATE_PENDING_ADD_SPAN_Y, addItemCellInfo.spanY); 1088 outState.putInt(RUNTIME_STATE_PENDING_ADD_COUNT_X, layout.getCountX()); 1089 outState.putInt(RUNTIME_STATE_PENDING_ADD_COUNT_Y, layout.getCountY()); 1090 outState.putBooleanArray(RUNTIME_STATE_PENDING_ADD_OCCUPIED_CELLS, 1091 layout.getOccupiedCellsFlattened()); 1092 } 1093 1094 if (mFolderInfo != null && mWaitingForResult) { 1095 outState.putBoolean(RUNTIME_STATE_PENDING_FOLDER_RENAME, true); 1096 outState.putLong(RUNTIME_STATE_PENDING_FOLDER_RENAME_ID, mFolderInfo.id); 1097 } 1098 1099 if (mHomeCustomizationDrawer != null) { 1100 String currentTabTag = mHomeCustomizationDrawer.getCurrentTabTag(); 1101 if (currentTabTag != null) { 1102 outState.putString("currentTab", currentTabTag); 1103 } 1104 } 1105 } 1106 1107 @Override 1108 public void onDestroy() { 1109 super.onDestroy(); 1110 1111 try { 1112 mAppWidgetHost.stopListening(); 1113 } catch (NullPointerException ex) { 1114 Log.w(TAG, "problem while stopping AppWidgetHost during Launcher destruction", ex); 1115 } 1116 1117 TextKeyListener.getInstance().release(); 1118 1119 mModel.stopLoader(); 1120 1121 unbindDesktopItems(); 1122 1123 getContentResolver().unregisterContentObserver(mWidgetObserver); 1124 1125 dismissPreview(mPreviousView); 1126 dismissPreview(mNextView); 1127 1128 unregisterReceiver(mCloseSystemDialogsReceiver); 1129 } 1130 1131 @Override 1132 public void startActivityForResult(Intent intent, int requestCode) { 1133 if (requestCode >= 0) mWaitingForResult = true; 1134 super.startActivityForResult(intent, requestCode); 1135 } 1136 1137 @Override 1138 public void startSearch(String initialQuery, boolean selectInitialQuery, 1139 Bundle appSearchData, boolean globalSearch) { 1140 1141 closeAllApps(true); 1142 1143 if (initialQuery == null) { 1144 // Use any text typed in the launcher as the initial query 1145 initialQuery = getTypedText(); 1146 clearTypedText(); 1147 } 1148 if (appSearchData == null) { 1149 appSearchData = new Bundle(); 1150 appSearchData.putString(Search.SOURCE, "launcher-search"); 1151 } 1152 1153 final SearchManager searchManager = 1154 (SearchManager) getSystemService(Context.SEARCH_SERVICE); 1155 searchManager.startSearch(initialQuery, selectInitialQuery, getComponentName(), 1156 appSearchData, globalSearch); 1157 } 1158 1159 @Override 1160 public boolean onCreateOptionsMenu(Menu menu) { 1161 if (isWorkspaceLocked()) { 1162 return false; 1163 } 1164 1165 super.onCreateOptionsMenu(menu); 1166 1167 menu.add(MENU_GROUP_ADD, MENU_ADD, 0, R.string.menu_add) 1168 .setIcon(android.R.drawable.ic_menu_add) 1169 .setAlphabeticShortcut('A'); 1170 menu.add(MENU_GROUP_WALLPAPER, MENU_WALLPAPER_SETTINGS, 0, R.string.menu_wallpaper) 1171 .setIcon(android.R.drawable.ic_menu_gallery) 1172 .setAlphabeticShortcut('W'); 1173 menu.add(0, MENU_SEARCH, 0, R.string.menu_search) 1174 .setIcon(android.R.drawable.ic_search_category_default) 1175 .setAlphabeticShortcut(SearchManager.MENU_KEY); 1176 menu.add(0, MENU_NOTIFICATIONS, 0, R.string.menu_notifications) 1177 .setIcon(com.android.internal.R.drawable.ic_menu_notifications) 1178 .setAlphabeticShortcut('N'); 1179 1180 final Intent settings = new Intent(android.provider.Settings.ACTION_SETTINGS); 1181 settings.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK | 1182 Intent.FLAG_ACTIVITY_RESET_TASK_IF_NEEDED); 1183 1184 menu.add(0, MENU_SETTINGS, 0, R.string.menu_settings) 1185 .setIcon(android.R.drawable.ic_menu_preferences).setAlphabeticShortcut('P') 1186 .setIntent(settings); 1187 1188 return true; 1189 } 1190 1191 @Override 1192 public boolean onPrepareOptionsMenu(Menu menu) { 1193 super.onPrepareOptionsMenu(menu); 1194 1195 // If all apps is animating, don't show the menu, because we don't know 1196 // which one to show. 1197 if (mAllAppsGrid.isVisible() && !mAllAppsGrid.isOpaque()) { 1198 return false; 1199 } 1200 1201 // Only show the add and wallpaper options when we're not in all apps. 1202 boolean visible = !mAllAppsGrid.isOpaque(); 1203 menu.setGroupVisible(MENU_GROUP_ADD, visible); 1204 menu.setGroupVisible(MENU_GROUP_WALLPAPER, visible); 1205 1206 // Disable add if the workspace is full. 1207 if (visible) { 1208 mMenuAddInfo = mWorkspace.findAllVacantCells(null); 1209 menu.setGroupEnabled(MENU_GROUP_ADD, mMenuAddInfo != null && mMenuAddInfo.valid); 1210 } 1211 1212 return true; 1213 } 1214 1215 // we need to initialize mAddItemCellInfo before adding something to the homescreen -- when 1216 // using the settings menu to add an item, something similar happens in showAddDialog 1217 public void prepareAddItemFromHomeCustomizationDrawer() { 1218 mMenuAddInfo = mWorkspace.findAllVacantCells(null); 1219 mAddItemCellInfo = mMenuAddInfo; 1220 } 1221 1222 @Override 1223 public boolean onOptionsItemSelected(MenuItem item) { 1224 switch (item.getItemId()) { 1225 case MENU_ADD: 1226 addItems(); 1227 return true; 1228 case MENU_WALLPAPER_SETTINGS: 1229 startWallpaper(); 1230 return true; 1231 case MENU_SEARCH: 1232 onSearchRequested(); 1233 return true; 1234 case MENU_NOTIFICATIONS: 1235 showNotifications(); 1236 return true; 1237 } 1238 1239 return super.onOptionsItemSelected(item); 1240 } 1241 1242 /** 1243 * Indicates that we want global search for this activity by setting the globalSearch 1244 * argument for {@link #startSearch} to true. 1245 */ 1246 1247 @Override 1248 public boolean onSearchRequested() { 1249 startSearch(null, false, null, true); 1250 return true; 1251 } 1252 1253 public boolean isWorkspaceLocked() { 1254 return mWorkspaceLoading || mWaitingForResult; 1255 } 1256 1257 private void addItems() { 1258 closeAllApps(true); 1259 showAddDialog(mMenuAddInfo); 1260 } 1261 1262 void addAppWidgetFromDrop(ComponentName appWidgetProvider, CellLayout.CellInfo cellInfo) { 1263 mAddItemCellInfo = cellInfo; 1264 int appWidgetId = getAppWidgetHost().allocateAppWidgetId(); 1265 AppWidgetManager.getInstance(this).bindAppWidgetId(appWidgetId, appWidgetProvider); 1266 addAppWidgetImpl(appWidgetId); 1267 } 1268 1269 void addAppWidgetFromPick(Intent data) { 1270 // TODO: catch bad widget exception when sent 1271 int appWidgetId = data.getIntExtra(AppWidgetManager.EXTRA_APPWIDGET_ID, -1); 1272 // TODO: Is this log message meaningful? 1273 if (LOGD) Log.d(TAG, "dumping extras content=" + data.getExtras()); 1274 addAppWidgetImpl(appWidgetId); 1275 } 1276 1277 void addAppWidgetImpl(int appWidgetId) { 1278 AppWidgetProviderInfo appWidget = mAppWidgetManager.getAppWidgetInfo(appWidgetId); 1279 1280 if (appWidget.configure != null) { 1281 // Launch over to configure widget, if needed 1282 Intent intent = new Intent(AppWidgetManager.ACTION_APPWIDGET_CONFIGURE); 1283 intent.setComponent(appWidget.configure); 1284 intent.putExtra(AppWidgetManager.EXTRA_APPWIDGET_ID, appWidgetId); 1285 1286 startActivityForResultSafely(intent, REQUEST_CREATE_APPWIDGET); 1287 } else { 1288 // Otherwise just add it 1289 completeAddAppWidget(appWidgetId, mAddItemCellInfo); 1290 } 1291 } 1292 1293 void processShortcut(Intent intent) { 1294 // Handle case where user selected "Applications" 1295 String applicationName = getResources().getString(R.string.group_applications); 1296 String shortcutName = intent.getStringExtra(Intent.EXTRA_SHORTCUT_NAME); 1297 1298 if (applicationName != null && applicationName.equals(shortcutName)) { 1299 Intent mainIntent = new Intent(Intent.ACTION_MAIN, null); 1300 mainIntent.addCategory(Intent.CATEGORY_LAUNCHER); 1301 1302 Intent pickIntent = new Intent(Intent.ACTION_PICK_ACTIVITY); 1303 pickIntent.putExtra(Intent.EXTRA_INTENT, mainIntent); 1304 startActivityForResult(pickIntent, REQUEST_PICK_APPLICATION); 1305 } else { 1306 startActivityForResult(intent, REQUEST_CREATE_SHORTCUT); 1307 } 1308 } 1309 1310 void addLiveFolder(Intent intent) { 1311 // Handle case where user selected "Folder" 1312 String folderName = getResources().getString(R.string.group_folder); 1313 String shortcutName = intent.getStringExtra(Intent.EXTRA_SHORTCUT_NAME); 1314 1315 if (folderName != null && folderName.equals(shortcutName)) { 1316 addFolder(); 1317 } else { 1318 startActivityForResult(intent, REQUEST_CREATE_LIVE_FOLDER); 1319 } 1320 } 1321 1322 void addFolder() { 1323 UserFolderInfo folderInfo = new UserFolderInfo(); 1324 folderInfo.title = getText(R.string.folder_name); 1325 1326 CellLayout.CellInfo cellInfo = mAddItemCellInfo; 1327 cellInfo.screen = mWorkspace.getCurrentScreen(); 1328 if (!findSingleSlot(cellInfo)) return; 1329 1330 // Update the model 1331 LauncherModel.addItemToDatabase(this, folderInfo, 1332 LauncherSettings.Favorites.CONTAINER_DESKTOP, 1333 mWorkspace.getCurrentScreen(), cellInfo.cellX, cellInfo.cellY, false); 1334 mFolders.put(folderInfo.id, folderInfo); 1335 1336 // Create the view 1337 FolderIcon newFolder = FolderIcon.fromXml(R.layout.folder_icon, this, 1338 (ViewGroup) mWorkspace.getChildAt(mWorkspace.getCurrentScreen()), folderInfo); 1339 mWorkspace.addInCurrentScreen(newFolder, 1340 cellInfo.cellX, cellInfo.cellY, 1, 1, isWorkspaceLocked()); 1341 } 1342 1343 void removeFolder(FolderInfo folder) { 1344 mFolders.remove(folder.id); 1345 } 1346 1347 private void completeAddLiveFolder(Intent data, CellLayout.CellInfo cellInfo) { 1348 cellInfo.screen = mWorkspace.getCurrentScreen(); 1349 if (!findSingleSlot(cellInfo)) return; 1350 1351 final LiveFolderInfo info = addLiveFolder(this, data, cellInfo, false); 1352 1353 if (!mRestoring) { 1354 final View view = LiveFolderIcon.fromXml(R.layout.live_folder_icon, this, 1355 (ViewGroup) mWorkspace.getChildAt(mWorkspace.getCurrentScreen()), info); 1356 mWorkspace.addInCurrentScreen(view, cellInfo.cellX, cellInfo.cellY, 1, 1, 1357 isWorkspaceLocked()); 1358 } 1359 } 1360 1361 static LiveFolderInfo addLiveFolder(Context context, Intent data, 1362 CellLayout.CellInfo cellInfo, boolean notify) { 1363 1364 Intent baseIntent = data.getParcelableExtra(LiveFolders.EXTRA_LIVE_FOLDER_BASE_INTENT); 1365 String name = data.getStringExtra(LiveFolders.EXTRA_LIVE_FOLDER_NAME); 1366 1367 Drawable icon = null; 1368 Intent.ShortcutIconResource iconResource = null; 1369 1370 Parcelable extra = data.getParcelableExtra(LiveFolders.EXTRA_LIVE_FOLDER_ICON); 1371 if (extra != null && extra instanceof Intent.ShortcutIconResource) { 1372 try { 1373 iconResource = (Intent.ShortcutIconResource) extra; 1374 final PackageManager packageManager = context.getPackageManager(); 1375 Resources resources = packageManager.getResourcesForApplication( 1376 iconResource.packageName); 1377 final int id = resources.getIdentifier(iconResource.resourceName, null, null); 1378 icon = resources.getDrawable(id); 1379 } catch (Exception e) { 1380 Log.w(TAG, "Could not load live folder icon: " + extra); 1381 } 1382 } 1383 1384 if (icon == null) { 1385 icon = context.getResources().getDrawable(R.drawable.ic_launcher_folder); 1386 } 1387 1388 final LiveFolderInfo info = new LiveFolderInfo(); 1389 info.icon = Utilities.createIconBitmap(icon, context); 1390 info.title = name; 1391 info.iconResource = iconResource; 1392 info.uri = data.getData(); 1393 info.baseIntent = baseIntent; 1394 info.displayMode = data.getIntExtra(LiveFolders.EXTRA_LIVE_FOLDER_DISPLAY_MODE, 1395 LiveFolders.DISPLAY_MODE_GRID); 1396 1397 LauncherModel.addItemToDatabase(context, info, LauncherSettings.Favorites.CONTAINER_DESKTOP, 1398 cellInfo.screen, cellInfo.cellX, cellInfo.cellY, notify); 1399 mFolders.put(info.id, info); 1400 1401 return info; 1402 } 1403 1404 private boolean findSingleSlot(CellLayout.CellInfo cellInfo) { 1405 final int[] xy = new int[2]; 1406 if (findSlot(cellInfo, xy, 1, 1)) { 1407 cellInfo.cellX = xy[0]; 1408 cellInfo.cellY = xy[1]; 1409 return true; 1410 } 1411 return false; 1412 } 1413 1414 private boolean findSlot(CellLayout.CellInfo cellInfo, int[] xy, int spanX, int spanY) { 1415 if (!cellInfo.findCellForSpan(xy, spanX, spanY)) { 1416 boolean[] occupied = mSavedState != null ? 1417 mSavedState.getBooleanArray(RUNTIME_STATE_PENDING_ADD_OCCUPIED_CELLS) : null; 1418 cellInfo = mWorkspace.findAllVacantCells(occupied); 1419 if (!cellInfo.findCellForSpan(xy, spanX, spanY)) { 1420 Toast.makeText(this, getString(R.string.out_of_space), Toast.LENGTH_SHORT).show(); 1421 return false; 1422 } 1423 } 1424 return true; 1425 } 1426 1427 private void showNotifications() { 1428 final StatusBarManager statusBar = (StatusBarManager) getSystemService(STATUS_BAR_SERVICE); 1429 if (statusBar != null) { 1430 statusBar.expand(); 1431 } 1432 } 1433 1434 private void startWallpaper() { 1435 closeAllApps(true); 1436 final Intent pickWallpaper = new Intent(Intent.ACTION_SET_WALLPAPER); 1437 Intent chooser = Intent.createChooser(pickWallpaper, 1438 getText(R.string.chooser_wallpaper)); 1439 // NOTE: Adds a configure option to the chooser if the wallpaper supports it 1440 // Removed in Eclair MR1 1441// WallpaperManager wm = (WallpaperManager) 1442// getSystemService(Context.WALLPAPER_SERVICE); 1443// WallpaperInfo wi = wm.getWallpaperInfo(); 1444// if (wi != null && wi.getSettingsActivity() != null) { 1445// LabeledIntent li = new LabeledIntent(getPackageName(), 1446// R.string.configure_wallpaper, 0); 1447// li.setClassName(wi.getPackageName(), wi.getSettingsActivity()); 1448// chooser.putExtra(Intent.EXTRA_INITIAL_INTENTS, new Intent[] { li }); 1449// } 1450 startActivityForResult(chooser, REQUEST_PICK_WALLPAPER); 1451 } 1452 1453 /** 1454 * Registers various content observers. The current implementation registers 1455 * only a favorites observer to keep track of the favorites applications. 1456 */ 1457 private void registerContentObservers() { 1458 ContentResolver resolver = getContentResolver(); 1459 resolver.registerContentObserver(LauncherProvider.CONTENT_APPWIDGET_RESET_URI, 1460 true, mWidgetObserver); 1461 } 1462 1463 @Override 1464 public boolean dispatchKeyEvent(KeyEvent event) { 1465 if (event.getAction() == KeyEvent.ACTION_DOWN) { 1466 switch (event.getKeyCode()) { 1467 case KeyEvent.KEYCODE_HOME: 1468 return true; 1469 case KeyEvent.KEYCODE_VOLUME_DOWN: 1470 if (SystemProperties.getInt("debug.launcher2.dumpstate", 0) != 0) { 1471 dumpState(); 1472 return true; 1473 } 1474 break; 1475 } 1476 } else if (event.getAction() == KeyEvent.ACTION_UP) { 1477 switch (event.getKeyCode()) { 1478 case KeyEvent.KEYCODE_HOME: 1479 return true; 1480 } 1481 } 1482 1483 return super.dispatchKeyEvent(event); 1484 } 1485 1486 @Override 1487 public void onBackPressed() { 1488 if (isAllAppsVisible()) { 1489 closeAllApps(true); 1490 } else { 1491 closeFolder(); 1492 } 1493 // Some launcher layouts don't have a previous and next view 1494 if (mPreviousView != null) { 1495 dismissPreview(mPreviousView); 1496 dismissPreview(mNextView); 1497 } 1498 } 1499 1500 private void closeFolder() { 1501 Folder folder = mWorkspace.getOpenFolder(); 1502 if (folder != null) { 1503 closeFolder(folder); 1504 } 1505 } 1506 1507 void closeFolder(Folder folder) { 1508 folder.getInfo().opened = false; 1509 ViewGroup parent = (ViewGroup) folder.getParent(); 1510 if (parent != null) { 1511 parent.removeView(folder); 1512 if (folder instanceof DropTarget) { 1513 // Live folders aren't DropTargets. 1514 mDragController.removeDropTarget((DropTarget)folder); 1515 } 1516 } 1517 folder.onClose(); 1518 } 1519 1520 /** 1521 * Re-listen when widgets are reset. 1522 */ 1523 private void onAppWidgetReset() { 1524 mAppWidgetHost.startListening(); 1525 } 1526 1527 /** 1528 * Go through the and disconnect any of the callbacks in the drawables and the views or we 1529 * leak the previous Home screen on orientation change. 1530 */ 1531 private void unbindDesktopItems() { 1532 for (ItemInfo item: mDesktopItems) { 1533 item.unbind(); 1534 } 1535 } 1536 1537 /** 1538 * Launches the intent referred by the clicked shortcut. 1539 * 1540 * @param v The view representing the clicked shortcut. 1541 */ 1542 public void onClick(View v) { 1543 Object tag = v.getTag(); 1544 if (tag instanceof ShortcutInfo) { 1545 // Open shortcut 1546 final Intent intent = ((ShortcutInfo) tag).intent; 1547 int[] pos = new int[2]; 1548 v.getLocationOnScreen(pos); 1549 intent.setSourceBounds(new Rect(pos[0], pos[1], 1550 pos[0] + v.getWidth(), pos[1] + v.getHeight())); 1551 startActivitySafely(intent, tag); 1552 } else if (tag instanceof FolderInfo) { 1553 handleFolderClick((FolderInfo) tag); 1554 } else if (v == mHandleView) { 1555 if (isAllAppsVisible()) { 1556 closeAllApps(true); 1557 } else { 1558 showAllApps(true); 1559 } 1560 } 1561 } 1562 1563 private final class SlideDownFinishedListener implements Animation.AnimationListener { 1564 TabHost mHomeCustomizationDrawer; 1565 SlideDownFinishedListener(TabHost homeCustomizationDrawer) { 1566 mHomeCustomizationDrawer = homeCustomizationDrawer; 1567 } 1568 public void onAnimationEnd(Animation animation) { 1569 mHomeCustomizationDrawer.setVisibility(View.GONE); 1570 } 1571 public void onAnimationRepeat(Animation animation) {} 1572 public void onAnimationStart(Animation animation) {} 1573 } 1574 1575 public boolean onTouch(View v, MotionEvent event) { 1576 // this is being forwarded from mWorkspace; 1577 // clicking anywhere on the workspace causes the drawer to slide down 1578 if (mHomeCustomizationDrawer != null && mHomeCustomizationDrawer.getVisibility() == View.VISIBLE) { 1579 Animation slideDownAnimation = AnimationUtils.loadAnimation(this, R.anim.home_customization_drawer_slide_down); 1580 slideDownAnimation.setAnimationListener(new SlideDownFinishedListener(mHomeCustomizationDrawer)); 1581 mHomeCustomizationDrawer.startAnimation(slideDownAnimation); 1582 } 1583 return false; 1584 } 1585 1586 /** 1587 * Event handler for the "plus" button that appears on the home screen, which 1588 * enters home screen customization mode. 1589 * 1590 * @param v The view that was clicked. 1591 */ 1592 public void onClickAddButton(View v) { 1593 1594 // Animate the widget chooser up from the bottom of the screen 1595 if (mHomeCustomizationDrawer != null && mHomeCustomizationDrawer.getVisibility() == View.GONE) { 1596 mHomeCustomizationDrawer.setVisibility(View.VISIBLE); 1597 mHomeCustomizationDrawer.startAnimation(AnimationUtils.loadAnimation(this, R.anim.home_customization_drawer_slide_up)); 1598 } 1599 } 1600 1601 public void onClickAllAppsButton(View w) { 1602 showAllApps(true); 1603 } 1604 1605 void startActivitySafely(Intent intent, Object tag) { 1606 intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK); 1607 try { 1608 startActivity(intent); 1609 } catch (ActivityNotFoundException e) { 1610 Toast.makeText(this, R.string.activity_not_found, Toast.LENGTH_SHORT).show(); 1611 Log.e(TAG, "Unable to launch. tag=" + tag + " intent=" + intent, e); 1612 } catch (SecurityException e) { 1613 Toast.makeText(this, R.string.activity_not_found, Toast.LENGTH_SHORT).show(); 1614 Log.e(TAG, "Launcher does not have the permission to launch " + intent + 1615 ". Make sure to create a MAIN intent-filter for the corresponding activity " + 1616 "or use the exported attribute for this activity. " 1617 + "tag="+ tag + " intent=" + intent, e); 1618 } 1619 } 1620 1621 void startActivityForResultSafely(Intent intent, int requestCode) { 1622 try { 1623 startActivityForResult(intent, requestCode); 1624 } catch (ActivityNotFoundException e) { 1625 Toast.makeText(this, R.string.activity_not_found, Toast.LENGTH_SHORT).show(); 1626 } catch (SecurityException e) { 1627 Toast.makeText(this, R.string.activity_not_found, Toast.LENGTH_SHORT).show(); 1628 Log.e(TAG, "Launcher does not have the permission to launch " + intent + 1629 ". Make sure to create a MAIN intent-filter for the corresponding activity " + 1630 "or use the exported attribute for this activity.", e); 1631 } 1632 } 1633 1634 private void handleFolderClick(FolderInfo folderInfo) { 1635 if (!folderInfo.opened) { 1636 // Close any open folder 1637 closeFolder(); 1638 // Open the requested folder 1639 openFolder(folderInfo); 1640 } else { 1641 // Find the open folder... 1642 Folder openFolder = mWorkspace.getFolderForTag(folderInfo); 1643 int folderScreen; 1644 if (openFolder != null) { 1645 folderScreen = mWorkspace.getScreenForView(openFolder); 1646 // .. and close it 1647 closeFolder(openFolder); 1648 if (folderScreen != mWorkspace.getCurrentScreen()) { 1649 // Close any folder open on the current screen 1650 closeFolder(); 1651 // Pull the folder onto this screen 1652 openFolder(folderInfo); 1653 } 1654 } 1655 } 1656 } 1657 1658 /** 1659 * Opens the user fodler described by the specified tag. The opening of the folder 1660 * is animated relative to the specified View. If the View is null, no animation 1661 * is played. 1662 * 1663 * @param folderInfo The FolderInfo describing the folder to open. 1664 */ 1665 public void openFolder(FolderInfo folderInfo) { 1666 Folder openFolder; 1667 1668 if (folderInfo instanceof UserFolderInfo) { 1669 openFolder = UserFolder.fromXml(this); 1670 } else if (folderInfo instanceof LiveFolderInfo) { 1671 openFolder = com.android.launcher2.LiveFolder.fromXml(this, folderInfo); 1672 } else { 1673 return; 1674 } 1675 1676 openFolder.setDragController(mDragController); 1677 openFolder.setLauncher(this); 1678 1679 openFolder.bind(folderInfo); 1680 folderInfo.opened = true; 1681 1682 mWorkspace.addInFullScreen(openFolder, folderInfo.screen); 1683 1684 openFolder.onOpen(); 1685 } 1686 1687 public boolean onLongClick(View v) { 1688 switch (v.getId()) { 1689 case R.id.previous_screen: 1690 if (!isAllAppsVisible()) { 1691 mWorkspace.performHapticFeedback(HapticFeedbackConstants.LONG_PRESS, 1692 HapticFeedbackConstants.FLAG_IGNORE_VIEW_SETTING); 1693 showPreviews(v); 1694 } 1695 return true; 1696 case R.id.next_screen: 1697 if (!isAllAppsVisible()) { 1698 mWorkspace.performHapticFeedback(HapticFeedbackConstants.LONG_PRESS, 1699 HapticFeedbackConstants.FLAG_IGNORE_VIEW_SETTING); 1700 showPreviews(v); 1701 } 1702 return true; 1703 case R.id.all_apps_button: 1704 if (!isAllAppsVisible()) { 1705 mWorkspace.performHapticFeedback(HapticFeedbackConstants.LONG_PRESS, 1706 HapticFeedbackConstants.FLAG_IGNORE_VIEW_SETTING); 1707 showPreviews(v); 1708 } 1709 return true; 1710 } 1711 1712 if (isWorkspaceLocked()) { 1713 return false; 1714 } 1715 1716 if (!(v instanceof CellLayout)) { 1717 v = (View) v.getParent(); 1718 } 1719 1720 CellLayout.CellInfo cellInfo = (CellLayout.CellInfo) v.getTag(); 1721 1722 // This happens when long clicking an item with the dpad/trackball 1723 if (cellInfo == null) { 1724 return true; 1725 } 1726 1727 if (mWorkspace.allowLongPress()) { 1728 if (cellInfo.cell == null) { 1729 if (cellInfo.valid) { 1730 // User long pressed on empty space 1731 mWorkspace.setAllowLongPress(false); 1732 mWorkspace.performHapticFeedback(HapticFeedbackConstants.LONG_PRESS, 1733 HapticFeedbackConstants.FLAG_IGNORE_VIEW_SETTING); 1734 showAddDialog(cellInfo); 1735 } 1736 } else { 1737 if (!(cellInfo.cell instanceof Folder)) { 1738 // User long pressed on an item 1739 mWorkspace.performHapticFeedback(HapticFeedbackConstants.LONG_PRESS, 1740 HapticFeedbackConstants.FLAG_IGNORE_VIEW_SETTING); 1741 mWorkspace.startDrag(cellInfo); 1742 } 1743 } 1744 } 1745 return true; 1746 } 1747 1748 @SuppressWarnings({"unchecked"}) 1749 private void dismissPreview(final View v) { 1750 final PopupWindow window = (PopupWindow) v.getTag(); 1751 if (window != null) { 1752 window.setOnDismissListener(new PopupWindow.OnDismissListener() { 1753 public void onDismiss() { 1754 ViewGroup group = (ViewGroup) v.getTag(R.id.workspace); 1755 int count = group.getChildCount(); 1756 for (int i = 0; i < count; i++) { 1757 ((ImageView) group.getChildAt(i)).setImageDrawable(null); 1758 } 1759 ArrayList<Bitmap> bitmaps = (ArrayList<Bitmap>) v.getTag(R.id.icon); 1760 for (Bitmap bitmap : bitmaps) bitmap.recycle(); 1761 1762 v.setTag(R.id.workspace, null); 1763 v.setTag(R.id.icon, null); 1764 window.setOnDismissListener(null); 1765 } 1766 }); 1767 window.dismiss(); 1768 } 1769 v.setTag(null); 1770 } 1771 1772 private void showPreviews(View anchor) { 1773 showPreviews(anchor, 0, mWorkspace.getChildCount()); 1774 } 1775 1776 private void showPreviews(final View anchor, int start, int end) { 1777 final Resources resources = getResources(); 1778 final Workspace workspace = mWorkspace; 1779 1780 CellLayout cell = ((CellLayout) workspace.getChildAt(start)); 1781 1782 float max = workspace.getChildCount(); 1783 1784 final Rect r = new Rect(); 1785 resources.getDrawable(R.drawable.preview_background).getPadding(r); 1786 int extraW = (int) ((r.left + r.right) * max); 1787 int extraH = r.top + r.bottom; 1788 1789 int aW = cell.getWidth() - extraW; 1790 float w = aW / max; 1791 1792 int width = cell.getWidth(); 1793 int height = cell.getHeight(); 1794 int x = cell.getLeftPadding(); 1795 int y = cell.getTopPadding(); 1796 width -= (x + cell.getRightPadding()); 1797 height -= (y + cell.getBottomPadding()); 1798 1799 float scale = w / width; 1800 1801 int count = end - start; 1802 1803 final float sWidth = width * scale; 1804 float sHeight = height * scale; 1805 1806 LinearLayout preview = new LinearLayout(this); 1807 1808 PreviewTouchHandler handler = new PreviewTouchHandler(anchor); 1809 ArrayList<Bitmap> bitmaps = new ArrayList<Bitmap>(count); 1810 1811 for (int i = start; i < end; i++) { 1812 ImageView image = new ImageView(this); 1813 cell = (CellLayout) workspace.getChildAt(i); 1814 1815 final Bitmap bitmap = Bitmap.createBitmap((int) sWidth, (int) sHeight, 1816 Bitmap.Config.ARGB_8888); 1817 1818 final Canvas c = new Canvas(bitmap); 1819 c.scale(scale, scale); 1820 c.translate(-cell.getLeftPadding(), -cell.getTopPadding()); 1821 cell.dispatchDraw(c); 1822 1823 image.setBackgroundDrawable(resources.getDrawable(R.drawable.preview_background)); 1824 image.setImageBitmap(bitmap); 1825 image.setTag(i); 1826 image.setOnClickListener(handler); 1827 image.setOnFocusChangeListener(handler); 1828 image.setFocusable(true); 1829 if (i == mWorkspace.getCurrentScreen()) image.requestFocus(); 1830 1831 preview.addView(image, 1832 LinearLayout.LayoutParams.WRAP_CONTENT, LinearLayout.LayoutParams.WRAP_CONTENT); 1833 1834 bitmaps.add(bitmap); 1835 } 1836 1837 final PopupWindow p = new PopupWindow(this); 1838 p.setContentView(preview); 1839 p.setWidth((int) (sWidth * count + extraW)); 1840 p.setHeight((int) (sHeight + extraH)); 1841 p.setAnimationStyle(R.style.AnimationPreview); 1842 p.setOutsideTouchable(true); 1843 p.setFocusable(true); 1844 p.setBackgroundDrawable(new ColorDrawable(0)); 1845 p.showAsDropDown(anchor, 0, 0); 1846 1847 p.setOnDismissListener(new PopupWindow.OnDismissListener() { 1848 public void onDismiss() { 1849 dismissPreview(anchor); 1850 } 1851 }); 1852 1853 anchor.setTag(p); 1854 anchor.setTag(R.id.workspace, preview); 1855 anchor.setTag(R.id.icon, bitmaps); 1856 } 1857 1858 class PreviewTouchHandler implements View.OnClickListener, Runnable, View.OnFocusChangeListener { 1859 private final View mAnchor; 1860 1861 public PreviewTouchHandler(View anchor) { 1862 mAnchor = anchor; 1863 } 1864 1865 public void onClick(View v) { 1866 mWorkspace.snapToScreen((Integer) v.getTag()); 1867 v.post(this); 1868 } 1869 1870 public void run() { 1871 dismissPreview(mAnchor); 1872 } 1873 1874 public void onFocusChange(View v, boolean hasFocus) { 1875 if (hasFocus) { 1876 mWorkspace.snapToScreen((Integer) v.getTag()); 1877 } 1878 } 1879 } 1880 1881 Workspace getWorkspace() { 1882 return mWorkspace; 1883 } 1884 1885 @Override 1886 protected Dialog onCreateDialog(int id) { 1887 switch (id) { 1888 case DIALOG_CREATE_SHORTCUT: 1889 return new CreateShortcut().createDialog(); 1890 case DIALOG_RENAME_FOLDER: 1891 return new RenameFolder().createDialog(); 1892 } 1893 1894 return super.onCreateDialog(id); 1895 } 1896 1897 @Override 1898 protected void onPrepareDialog(int id, Dialog dialog) { 1899 switch (id) { 1900 case DIALOG_CREATE_SHORTCUT: 1901 break; 1902 case DIALOG_RENAME_FOLDER: 1903 if (mFolderInfo != null) { 1904 EditText input = (EditText) dialog.findViewById(R.id.folder_name); 1905 final CharSequence text = mFolderInfo.title; 1906 input.setText(text); 1907 input.setSelection(0, text.length()); 1908 } 1909 break; 1910 } 1911 } 1912 1913 void showRenameDialog(FolderInfo info) { 1914 mFolderInfo = info; 1915 mWaitingForResult = true; 1916 showDialog(DIALOG_RENAME_FOLDER); 1917 } 1918 1919 private void showAddDialog(CellLayout.CellInfo cellInfo) { 1920 mAddItemCellInfo = cellInfo; 1921 mWaitingForResult = true; 1922 showDialog(DIALOG_CREATE_SHORTCUT); 1923 } 1924 1925 private void pickShortcut() { 1926 // Insert extra item to handle picking application 1927 Bundle bundle = new Bundle(); 1928 1929 ArrayList<String> shortcutNames = new ArrayList<String>(); 1930 shortcutNames.add(getString(R.string.group_applications)); 1931 bundle.putStringArrayList(Intent.EXTRA_SHORTCUT_NAME, shortcutNames); 1932 1933 ArrayList<ShortcutIconResource> shortcutIcons = new ArrayList<ShortcutIconResource>(); 1934 shortcutIcons.add(ShortcutIconResource.fromContext(Launcher.this, 1935 R.drawable.ic_launcher_application)); 1936 bundle.putParcelableArrayList(Intent.EXTRA_SHORTCUT_ICON_RESOURCE, shortcutIcons); 1937 1938 Intent pickIntent = new Intent(Intent.ACTION_PICK_ACTIVITY); 1939 pickIntent.putExtra(Intent.EXTRA_INTENT, new Intent(Intent.ACTION_CREATE_SHORTCUT)); 1940 pickIntent.putExtra(Intent.EXTRA_TITLE, getText(R.string.title_select_shortcut)); 1941 pickIntent.putExtras(bundle); 1942 1943 startActivityForResult(pickIntent, REQUEST_PICK_SHORTCUT); 1944 } 1945 1946 private class RenameFolder { 1947 private EditText mInput; 1948 1949 Dialog createDialog() { 1950 final View layout = View.inflate(Launcher.this, R.layout.rename_folder, null); 1951 mInput = (EditText) layout.findViewById(R.id.folder_name); 1952 1953 AlertDialog.Builder builder = new AlertDialog.Builder(Launcher.this); 1954 builder.setIcon(0); 1955 builder.setTitle(getString(R.string.rename_folder_title)); 1956 builder.setCancelable(true); 1957 builder.setOnCancelListener(new Dialog.OnCancelListener() { 1958 public void onCancel(DialogInterface dialog) { 1959 cleanup(); 1960 } 1961 }); 1962 builder.setNegativeButton(getString(R.string.cancel_action), 1963 new Dialog.OnClickListener() { 1964 public void onClick(DialogInterface dialog, int which) { 1965 cleanup(); 1966 } 1967 } 1968 ); 1969 builder.setPositiveButton(getString(R.string.rename_action), 1970 new Dialog.OnClickListener() { 1971 public void onClick(DialogInterface dialog, int which) { 1972 changeFolderName(); 1973 } 1974 } 1975 ); 1976 builder.setView(layout); 1977 1978 final AlertDialog dialog = builder.create(); 1979 dialog.setOnShowListener(new DialogInterface.OnShowListener() { 1980 public void onShow(DialogInterface dialog) { 1981 mWaitingForResult = true; 1982 mInput.requestFocus(); 1983 InputMethodManager inputManager = (InputMethodManager) 1984 getSystemService(Context.INPUT_METHOD_SERVICE); 1985 inputManager.showSoftInput(mInput, 0); 1986 } 1987 }); 1988 1989 return dialog; 1990 } 1991 1992 private void changeFolderName() { 1993 final String name = mInput.getText().toString(); 1994 if (!TextUtils.isEmpty(name)) { 1995 // Make sure we have the right folder info 1996 mFolderInfo = mFolders.get(mFolderInfo.id); 1997 mFolderInfo.title = name; 1998 LauncherModel.updateItemInDatabase(Launcher.this, mFolderInfo); 1999 2000 if (mWorkspaceLoading) { 2001 lockAllApps(); 2002 mModel.startLoader(Launcher.this, false); 2003 } else { 2004 final FolderIcon folderIcon = (FolderIcon) 2005 mWorkspace.getViewForTag(mFolderInfo); 2006 if (folderIcon != null) { 2007 folderIcon.setText(name); 2008 getWorkspace().requestLayout(); 2009 } else { 2010 lockAllApps(); 2011 mWorkspaceLoading = true; 2012 mModel.startLoader(Launcher.this, false); 2013 } 2014 } 2015 } 2016 cleanup(); 2017 } 2018 2019 private void cleanup() { 2020 dismissDialog(DIALOG_RENAME_FOLDER); 2021 mWaitingForResult = false; 2022 mFolderInfo = null; 2023 } 2024 } 2025 2026 // Now a part of LauncherModel.Callbacks. Used to reorder loading steps. 2027 public boolean isAllAppsVisible() { 2028 return (mAllAppsGrid != null) ? mAllAppsGrid.isVisible() : false; 2029 } 2030 2031 // AllAppsView.Watcher 2032 public void zoomed(float zoom) { 2033 if (zoom == 1.0f) { 2034 mWorkspace.setVisibility(View.GONE); 2035 } 2036 } 2037 2038 void showAllApps(boolean animated) { 2039 mAllAppsGrid.zoom(1.0f, animated); 2040 2041 ((View) mAllAppsGrid).setFocusable(true); 2042 ((View) mAllAppsGrid).requestFocus(); 2043 2044 // TODO: fade these two too 2045 mDeleteZone.setVisibility(View.GONE); 2046 } 2047 2048 /** 2049 * Things to test when changing this code. 2050 * - Home from workspace 2051 * - from center screen 2052 * - from other screens 2053 * - Home from all apps 2054 * - from center screen 2055 * - from other screens 2056 * - Back from all apps 2057 * - from center screen 2058 * - from other screens 2059 * - Launch app from workspace and quit 2060 * - with back 2061 * - with home 2062 * - Launch app from all apps and quit 2063 * - with back 2064 * - with home 2065 * - Go to a screen that's not the default, then all 2066 * apps, and launch and app, and go back 2067 * - with back 2068 * -with home 2069 * - On workspace, long press power and go back 2070 * - with back 2071 * - with home 2072 * - On all apps, long press power and go back 2073 * - with back 2074 * - with home 2075 * - On workspace, power off 2076 * - On all apps, power off 2077 * - Launch an app and turn off the screen while in that app 2078 * - Go back with home key 2079 * - Go back with back key TODO: make this not go to workspace 2080 * - From all apps 2081 * - From workspace 2082 * - Enter and exit car mode (becuase it causes an extra configuration changed) 2083 * - From all apps 2084 * - From the center workspace 2085 * - From another workspace 2086 */ 2087 void closeAllApps(boolean animated) { 2088 if (mAllAppsGrid.isVisible()) { 2089 mWorkspace.setVisibility(View.VISIBLE); 2090 mAllAppsGrid.zoom(0.0f, animated); 2091 ((View)mAllAppsGrid).setFocusable(false); 2092 mWorkspace.getChildAt(mWorkspace.getCurrentScreen()).requestFocus(); 2093 } 2094 } 2095 2096 void lockAllApps() { 2097 // TODO 2098 } 2099 2100 void unlockAllApps() { 2101 // TODO 2102 } 2103 2104 /** 2105 * Displays the shortcut creation dialog and launches, if necessary, the 2106 * appropriate activity. 2107 */ 2108 private class CreateShortcut implements DialogInterface.OnClickListener, 2109 DialogInterface.OnCancelListener, DialogInterface.OnDismissListener, 2110 DialogInterface.OnShowListener { 2111 2112 private AddAdapter mAdapter; 2113 2114 Dialog createDialog() { 2115 mAdapter = new AddAdapter(Launcher.this); 2116 2117 final AlertDialog.Builder builder = new AlertDialog.Builder(Launcher.this); 2118 builder.setTitle(getString(R.string.menu_item_add_item)); 2119 builder.setAdapter(mAdapter, this); 2120 2121 builder.setInverseBackgroundForced(true); 2122 2123 AlertDialog dialog = builder.create(); 2124 dialog.setOnCancelListener(this); 2125 dialog.setOnDismissListener(this); 2126 dialog.setOnShowListener(this); 2127 2128 return dialog; 2129 } 2130 2131 public void onCancel(DialogInterface dialog) { 2132 mWaitingForResult = false; 2133 cleanup(); 2134 } 2135 2136 public void onDismiss(DialogInterface dialog) { 2137 } 2138 2139 private void cleanup() { 2140 try { 2141 dismissDialog(DIALOG_CREATE_SHORTCUT); 2142 } catch (Exception e) { 2143 // An exception is thrown if the dialog is not visible, which is fine 2144 } 2145 } 2146 2147 /** 2148 * Handle the action clicked in the "Add to home" dialog. 2149 */ 2150 public void onClick(DialogInterface dialog, int which) { 2151 Resources res = getResources(); 2152 cleanup(); 2153 2154 switch (which) { 2155 case AddAdapter.ITEM_SHORTCUT: { 2156 pickShortcut(); 2157 break; 2158 } 2159 2160 case AddAdapter.ITEM_APPWIDGET: { 2161 int appWidgetId = Launcher.this.mAppWidgetHost.allocateAppWidgetId(); 2162 2163 Intent pickIntent = new Intent(AppWidgetManager.ACTION_APPWIDGET_PICK); 2164 pickIntent.putExtra(AppWidgetManager.EXTRA_APPWIDGET_ID, appWidgetId); 2165 // start the pick activity 2166 startActivityForResult(pickIntent, REQUEST_PICK_APPWIDGET); 2167 break; 2168 } 2169 2170 case AddAdapter.ITEM_LIVE_FOLDER: { 2171 // Insert extra item to handle inserting folder 2172 Bundle bundle = new Bundle(); 2173 2174 ArrayList<String> shortcutNames = new ArrayList<String>(); 2175 shortcutNames.add(res.getString(R.string.group_folder)); 2176 bundle.putStringArrayList(Intent.EXTRA_SHORTCUT_NAME, shortcutNames); 2177 2178 ArrayList<ShortcutIconResource> shortcutIcons = 2179 new ArrayList<ShortcutIconResource>(); 2180 shortcutIcons.add(ShortcutIconResource.fromContext(Launcher.this, 2181 R.drawable.ic_launcher_folder)); 2182 bundle.putParcelableArrayList(Intent.EXTRA_SHORTCUT_ICON_RESOURCE, shortcutIcons); 2183 2184 Intent pickIntent = new Intent(Intent.ACTION_PICK_ACTIVITY); 2185 pickIntent.putExtra(Intent.EXTRA_INTENT, 2186 new Intent(LiveFolders.ACTION_CREATE_LIVE_FOLDER)); 2187 pickIntent.putExtra(Intent.EXTRA_TITLE, 2188 getText(R.string.title_select_live_folder)); 2189 pickIntent.putExtras(bundle); 2190 2191 startActivityForResult(pickIntent, REQUEST_PICK_LIVE_FOLDER); 2192 break; 2193 } 2194 2195 case AddAdapter.ITEM_WALLPAPER: { 2196 startWallpaper(); 2197 break; 2198 } 2199 } 2200 } 2201 2202 public void onShow(DialogInterface dialog) { 2203 mWaitingForResult = true; 2204 } 2205 } 2206 2207 /** 2208 * Receives notifications when applications are added/removed. 2209 */ 2210 private class CloseSystemDialogsIntentReceiver extends BroadcastReceiver { 2211 @Override 2212 public void onReceive(Context context, Intent intent) { 2213 closeSystemDialogs(); 2214 String reason = intent.getStringExtra("reason"); 2215 if (!"homekey".equals(reason)) { 2216 boolean animate = true; 2217 if (mPaused || "lock".equals(reason)) { 2218 animate = false; 2219 } 2220 closeAllApps(animate); 2221 } 2222 } 2223 } 2224 2225 /** 2226 * Receives notifications whenever the appwidgets are reset. 2227 */ 2228 private class AppWidgetResetObserver extends ContentObserver { 2229 public AppWidgetResetObserver() { 2230 super(new Handler()); 2231 } 2232 2233 @Override 2234 public void onChange(boolean selfChange) { 2235 onAppWidgetReset(); 2236 } 2237 } 2238 2239 /** 2240 * Implementation of the method from LauncherModel.Callbacks. 2241 */ 2242 public int getCurrentWorkspaceScreen() { 2243 if (mWorkspace != null) { 2244 return mWorkspace.getCurrentScreen(); 2245 } else { 2246 return SCREEN_COUNT / 2; 2247 } 2248 } 2249 2250 /** 2251 * Refreshes the shortcuts shown on the workspace. 2252 * 2253 * Implementation of the method from LauncherModel.Callbacks. 2254 */ 2255 public void startBinding() { 2256 final Workspace workspace = mWorkspace; 2257 int count = workspace.getChildCount(); 2258 for (int i = 0; i < count; i++) { 2259 // Use removeAllViewsInLayout() to avoid an extra requestLayout() and invalidate(). 2260 ((ViewGroup) workspace.getChildAt(i)).removeAllViewsInLayout(); 2261 } 2262 2263 if (DEBUG_USER_INTERFACE) { 2264 android.widget.Button finishButton = new android.widget.Button(this); 2265 finishButton.setText("Finish"); 2266 workspace.addInScreen(finishButton, 1, 0, 0, 1, 1); 2267 2268 finishButton.setOnClickListener(new android.widget.Button.OnClickListener() { 2269 public void onClick(View v) { 2270 finish(); 2271 } 2272 }); 2273 } 2274 } 2275 2276 /** 2277 * Bind the items start-end from the list. 2278 * 2279 * Implementation of the method from LauncherModel.Callbacks. 2280 */ 2281 public void bindItems(ArrayList<ItemInfo> shortcuts, int start, int end) { 2282 2283 final Workspace workspace = mWorkspace; 2284 2285 for (int i=start; i<end; i++) { 2286 final ItemInfo item = shortcuts.get(i); 2287 mDesktopItems.add(item); 2288 switch (item.itemType) { 2289 case LauncherSettings.Favorites.ITEM_TYPE_APPLICATION: 2290 case LauncherSettings.Favorites.ITEM_TYPE_SHORTCUT: 2291 final View shortcut = createShortcut((ShortcutInfo)item); 2292 workspace.addInScreen(shortcut, item.screen, item.cellX, item.cellY, 1, 1, 2293 false); 2294 break; 2295 case LauncherSettings.Favorites.ITEM_TYPE_USER_FOLDER: 2296 final FolderIcon newFolder = FolderIcon.fromXml(R.layout.folder_icon, this, 2297 (ViewGroup) workspace.getChildAt(workspace.getCurrentScreen()), 2298 (UserFolderInfo) item); 2299 workspace.addInScreen(newFolder, item.screen, item.cellX, item.cellY, 1, 1, 2300 false); 2301 break; 2302 case LauncherSettings.Favorites.ITEM_TYPE_LIVE_FOLDER: 2303 final FolderIcon newLiveFolder = LiveFolderIcon.fromXml( 2304 R.layout.live_folder_icon, this, 2305 (ViewGroup) workspace.getChildAt(workspace.getCurrentScreen()), 2306 (LiveFolderInfo) item); 2307 workspace.addInScreen(newLiveFolder, item.screen, item.cellX, item.cellY, 1, 1, 2308 false); 2309 break; 2310 } 2311 } 2312 2313 workspace.requestLayout(); 2314 } 2315 2316 /** 2317 * Implementation of the method from LauncherModel.Callbacks. 2318 */ 2319 public void bindFolders(HashMap<Long, FolderInfo> folders) { 2320 mFolders.clear(); 2321 mFolders.putAll(folders); 2322 } 2323 2324 /** 2325 * Add the views for a widget to the workspace. 2326 * 2327 * Implementation of the method from LauncherModel.Callbacks. 2328 */ 2329 public void bindAppWidget(LauncherAppWidgetInfo item) { 2330 final long start = DEBUG_WIDGETS ? SystemClock.uptimeMillis() : 0; 2331 if (DEBUG_WIDGETS) { 2332 Log.d(TAG, "bindAppWidget: " + item); 2333 } 2334 final Workspace workspace = mWorkspace; 2335 2336 final int appWidgetId = item.appWidgetId; 2337 final AppWidgetProviderInfo appWidgetInfo = mAppWidgetManager.getAppWidgetInfo(appWidgetId); 2338 if (DEBUG_WIDGETS) { 2339 Log.d(TAG, "bindAppWidget: id=" + item.appWidgetId + " belongs to component " + appWidgetInfo.provider); 2340 } 2341 2342 item.hostView = mAppWidgetHost.createView(this, appWidgetId, appWidgetInfo); 2343 2344 item.hostView.setAppWidget(appWidgetId, appWidgetInfo); 2345 item.hostView.setTag(item); 2346 2347 workspace.addInScreen(item.hostView, item.screen, item.cellX, 2348 item.cellY, item.spanX, item.spanY, false); 2349 2350 workspace.requestLayout(); 2351 2352 mDesktopItems.add(item); 2353 2354 if (DEBUG_WIDGETS) { 2355 Log.d(TAG, "bound widget id="+item.appWidgetId+" in " 2356 + (SystemClock.uptimeMillis()-start) + "ms"); 2357 } 2358 } 2359 2360 /** 2361 * Callback saying that there aren't any more items to bind. 2362 * 2363 * Implementation of the method from LauncherModel.Callbacks. 2364 */ 2365 public void finishBindingItems() { 2366 if (mSavedState != null) { 2367 if (!mWorkspace.hasFocus()) { 2368 mWorkspace.getChildAt(mWorkspace.getCurrentScreen()).requestFocus(); 2369 } 2370 2371 final long[] userFolders = mSavedState.getLongArray(RUNTIME_STATE_USER_FOLDERS); 2372 if (userFolders != null) { 2373 for (long folderId : userFolders) { 2374 final FolderInfo info = mFolders.get(folderId); 2375 if (info != null) { 2376 openFolder(info); 2377 } 2378 } 2379 final Folder openFolder = mWorkspace.getOpenFolder(); 2380 if (openFolder != null) { 2381 openFolder.requestFocus(); 2382 } 2383 } 2384 2385 mSavedState = null; 2386 } 2387 2388 if (mSavedInstanceState != null) { 2389 super.onRestoreInstanceState(mSavedInstanceState); 2390 mSavedInstanceState = null; 2391 } 2392 2393 mWorkspaceLoading = false; 2394 } 2395 2396 /** 2397 * Add the icons for all apps. 2398 * 2399 * Implementation of the method from LauncherModel.Callbacks. 2400 */ 2401 public void bindAllApplications(ArrayList<ApplicationInfo> apps) { 2402 mAllAppsGrid.setApps(apps); 2403 } 2404 2405 /** 2406 * A package was installed. 2407 * 2408 * Implementation of the method from LauncherModel.Callbacks. 2409 */ 2410 public void bindAppsAdded(ArrayList<ApplicationInfo> apps) { 2411 removeDialog(DIALOG_CREATE_SHORTCUT); 2412 mAllAppsGrid.addApps(apps); 2413 } 2414 2415 /** 2416 * A package was updated. 2417 * 2418 * Implementation of the method from LauncherModel.Callbacks. 2419 */ 2420 public void bindAppsUpdated(ArrayList<ApplicationInfo> apps) { 2421 removeDialog(DIALOG_CREATE_SHORTCUT); 2422 mWorkspace.updateShortcuts(apps); 2423 mAllAppsGrid.updateApps(apps); 2424 } 2425 2426 /** 2427 * A package was uninstalled. 2428 * 2429 * Implementation of the method from LauncherModel.Callbacks. 2430 */ 2431 public void bindAppsRemoved(ArrayList<ApplicationInfo> apps, boolean permanent) { 2432 removeDialog(DIALOG_CREATE_SHORTCUT); 2433 if (permanent) { 2434 mWorkspace.removeItems(apps); 2435 } 2436 mAllAppsGrid.removeApps(apps); 2437 } 2438 2439 /** 2440 * Prints out out state for debugging. 2441 */ 2442 public void dumpState() { 2443 Log.d(TAG, "BEGIN launcher2 dump state for launcher " + this); 2444 Log.d(TAG, "mSavedState=" + mSavedState); 2445 Log.d(TAG, "mWorkspaceLoading=" + mWorkspaceLoading); 2446 Log.d(TAG, "mRestoring=" + mRestoring); 2447 Log.d(TAG, "mWaitingForResult=" + mWaitingForResult); 2448 Log.d(TAG, "mSavedInstanceState=" + mSavedInstanceState); 2449 Log.d(TAG, "mDesktopItems.size=" + mDesktopItems.size()); 2450 Log.d(TAG, "mFolders.size=" + mFolders.size()); 2451 mModel.dumpState(); 2452 mAllAppsGrid.dumpState(); 2453 Log.d(TAG, "END launcher2 dump state"); 2454 } 2455} 2456