WebView.java revision 5da9aeb4351ed02b05f15c11e34673ab38103dd8
1/* 2 * Copyright (C) 2006 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 android.webkit; 18 19import android.app.AlertDialog; 20import android.content.Context; 21import android.content.DialogInterface; 22import android.content.Intent; 23import android.content.DialogInterface.OnCancelListener; 24import android.database.DataSetObserver; 25import android.graphics.Bitmap; 26import android.graphics.Canvas; 27import android.graphics.Color; 28import android.graphics.Picture; 29import android.graphics.Point; 30import android.graphics.Rect; 31import android.graphics.Region; 32import android.graphics.drawable.Drawable; 33import android.net.http.SslCertificate; 34import android.net.Uri; 35import android.os.Bundle; 36import android.os.Handler; 37import android.os.Message; 38import android.os.ServiceManager; 39import android.os.SystemClock; 40import android.provider.Checkin; 41import android.text.IClipboard; 42import android.text.Selection; 43import android.text.Spannable; 44import android.util.AttributeSet; 45import android.util.EventLog; 46import android.util.Log; 47import android.util.TypedValue; 48import android.view.Gravity; 49import android.view.KeyEvent; 50import android.view.LayoutInflater; 51import android.view.MotionEvent; 52import android.view.SoundEffectConstants; 53import android.view.VelocityTracker; 54import android.view.View; 55import android.view.ViewConfiguration; 56import android.view.ViewGroup; 57import android.view.ViewParent; 58import android.view.ViewTreeObserver; 59import android.view.animation.AlphaAnimation; 60import android.view.inputmethod.InputMethodManager; 61import android.webkit.WebTextView.AutoCompleteAdapter; 62import android.webkit.WebViewCore.EventHub; 63import android.widget.AbsoluteLayout; 64import android.widget.Adapter; 65import android.widget.AdapterView; 66import android.widget.ArrayAdapter; 67import android.widget.FrameLayout; 68import android.widget.ListView; 69import android.widget.Scroller; 70import android.widget.Toast; 71import android.widget.ZoomButtonsController; 72import android.widget.ZoomControls; 73import android.widget.AdapterView.OnItemClickListener; 74 75import java.io.File; 76import java.io.FileInputStream; 77import java.io.FileNotFoundException; 78import java.io.FileOutputStream; 79import java.io.IOException; 80import java.net.URLDecoder; 81import java.util.ArrayList; 82import java.util.List; 83import java.util.Map; 84 85/** 86 * <p>A View that displays web pages. This class is the basis upon which you 87 * can roll your own web browser or simply display some online content within your Activity. 88 * It uses the WebKit rendering engine to display 89 * web pages and includes methods to navigate forward and backward 90 * through a history, zoom in and out, perform text searches and more.</p> 91 * <p>To enable the built-in zoom, set 92 * {@link #getSettings() WebSettings}.{@link WebSettings#setBuiltInZoomControls(boolean)} 93 * (introduced in API version 3). 94 * <p>Note that, in order for your Activity to access the Internet and load web pages 95 * in a WebView, you must add the <var>INTERNET</var> permissions to your 96 * Android Manifest file:</p> 97 * <pre><uses-permission android:name="android.permission.INTERNET" /></pre> 98 * 99 * <p>This must be a child of the <code><manifest></code> element.</p> 100 * 101 * <h3>Basic usage</h3> 102 * 103 * <p>By default, a WebView provides no browser-like widgets, does not 104 * enable JavaScript and errors will be ignored. If your goal is only 105 * to display some HTML as a part of your UI, this is probably fine; 106 * the user won't need to interact with the web page beyond reading 107 * it, and the web page won't need to interact with the user. If you 108 * actually want a fully blown web browser, then you probably want to 109 * invoke the Browser application with your URL rather than show it 110 * with a WebView. See {@link android.content.Intent} for more information.</p> 111 * 112 * <pre class="prettyprint"> 113 * WebView webview = new WebView(this); 114 * setContentView(webview); 115 * 116 * // Simplest usage: note that an exception will NOT be thrown 117 * // if there is an error loading this page (see below). 118 * webview.loadUrl("http://slashdot.org/"); 119 * 120 * // Of course you can also load from any string: 121 * String summary = "<html><body>You scored <b>192</b> points.</body></html>"; 122 * webview.loadData(summary, "text/html", "utf-8"); 123 * // ... although note that there are restrictions on what this HTML can do. 124 * // See the JavaDocs for loadData and loadDataWithBaseUrl for more info. 125 * </pre> 126 * 127 * <p>A WebView has several customization points where you can add your 128 * own behavior. These are:</p> 129 * 130 * <ul> 131 * <li>Creating and setting a {@link android.webkit.WebChromeClient} subclass. 132 * This class is called when something that might impact a 133 * browser UI happens, for instance, progress updates and 134 * JavaScript alerts are sent here. 135 * </li> 136 * <li>Creating and setting a {@link android.webkit.WebViewClient} subclass. 137 * It will be called when things happen that impact the 138 * rendering of the content, eg, errors or form submissions. You 139 * can also intercept URL loading here.</li> 140 * <li>Via the {@link android.webkit.WebSettings} class, which contains 141 * miscellaneous configuration. </li> 142 * <li>With the {@link android.webkit.WebView#addJavascriptInterface} method. 143 * This lets you bind Java objects into the WebView so they can be 144 * controlled from the web pages JavaScript.</li> 145 * </ul> 146 * 147 * <p>Here's a more complicated example, showing error handling, 148 * settings, and progress notification:</p> 149 * 150 * <pre class="prettyprint"> 151 * // Let's display the progress in the activity title bar, like the 152 * // browser app does. 153 * getWindow().requestFeature(Window.FEATURE_PROGRESS); 154 * 155 * webview.getSettings().setJavaScriptEnabled(true); 156 * 157 * final Activity activity = this; 158 * webview.setWebChromeClient(new WebChromeClient() { 159 * public void onProgressChanged(WebView view, int progress) { 160 * // Activities and WebViews measure progress with different scales. 161 * // The progress meter will automatically disappear when we reach 100% 162 * activity.setProgress(progress * 1000); 163 * } 164 * }); 165 * webview.setWebViewClient(new WebViewClient() { 166 * public void onReceivedError(WebView view, int errorCode, String description, String failingUrl) { 167 * Toast.makeText(activity, "Oh no! " + description, Toast.LENGTH_SHORT).show(); 168 * } 169 * }); 170 * 171 * webview.loadUrl("http://slashdot.org/"); 172 * </pre> 173 * 174 * <h3>Cookie and window management</h3> 175 * 176 * <p>For obvious security reasons, your application has its own 177 * cache, cookie store etc - it does not share the Browser 178 * applications data. Cookies are managed on a separate thread, so 179 * operations like index building don't block the UI 180 * thread. Follow the instructions in {@link android.webkit.CookieSyncManager} 181 * if you want to use cookies in your application. 182 * </p> 183 * 184 * <p>By default, requests by the HTML to open new windows are 185 * ignored. This is true whether they be opened by JavaScript or by 186 * the target attribute on a link. You can customize your 187 * WebChromeClient to provide your own behaviour for opening multiple windows, 188 * and render them in whatever manner you want.</p> 189 * 190 * <p>Standard behavior for an Activity is to be destroyed and 191 * recreated when the devices orientation is changed. This will cause 192 * the WebView to reload the current page. If you don't want that, you 193 * can set your Activity to handle the orientation and keyboardHidden 194 * changes, and then just leave the WebView alone. It'll automatically 195 * re-orient itself as appropriate.</p> 196 */ 197public class WebView extends AbsoluteLayout 198 implements ViewTreeObserver.OnGlobalFocusChangeListener, 199 ViewGroup.OnHierarchyChangeListener { 200 201 // if AUTO_REDRAW_HACK is true, then the CALL key will toggle redrawing 202 // the screen all-the-time. Good for profiling our drawing code 203 static private final boolean AUTO_REDRAW_HACK = false; 204 // true means redraw the screen all-the-time. Only with AUTO_REDRAW_HACK 205 private boolean mAutoRedraw; 206 207 static final String LOGTAG = "webview"; 208 209 private static class ExtendedZoomControls extends FrameLayout { 210 public ExtendedZoomControls(Context context, AttributeSet attrs) { 211 super(context, attrs); 212 LayoutInflater inflater = (LayoutInflater) 213 context.getSystemService(Context.LAYOUT_INFLATER_SERVICE); 214 inflater.inflate(com.android.internal.R.layout.zoom_magnify, this, true); 215 mPlusMinusZoomControls = (ZoomControls) findViewById( 216 com.android.internal.R.id.zoomControls); 217 findViewById(com.android.internal.R.id.zoomMagnify).setVisibility( 218 View.GONE); 219 } 220 221 public void show(boolean showZoom, boolean canZoomOut) { 222 mPlusMinusZoomControls.setVisibility( 223 showZoom ? View.VISIBLE : View.GONE); 224 fade(View.VISIBLE, 0.0f, 1.0f); 225 } 226 227 public void hide() { 228 fade(View.GONE, 1.0f, 0.0f); 229 } 230 231 private void fade(int visibility, float startAlpha, float endAlpha) { 232 AlphaAnimation anim = new AlphaAnimation(startAlpha, endAlpha); 233 anim.setDuration(500); 234 startAnimation(anim); 235 setVisibility(visibility); 236 } 237 238 public boolean hasFocus() { 239 return mPlusMinusZoomControls.hasFocus(); 240 } 241 242 public void setOnZoomInClickListener(OnClickListener listener) { 243 mPlusMinusZoomControls.setOnZoomInClickListener(listener); 244 } 245 246 public void setOnZoomOutClickListener(OnClickListener listener) { 247 mPlusMinusZoomControls.setOnZoomOutClickListener(listener); 248 } 249 250 ZoomControls mPlusMinusZoomControls; 251 } 252 253 /** 254 * Transportation object for returning WebView across thread boundaries. 255 */ 256 public class WebViewTransport { 257 private WebView mWebview; 258 259 /** 260 * Set the WebView to the transportation object. 261 * @param webview The WebView to transport. 262 */ 263 public synchronized void setWebView(WebView webview) { 264 mWebview = webview; 265 } 266 267 /** 268 * Return the WebView object. 269 * @return WebView The transported WebView object. 270 */ 271 public synchronized WebView getWebView() { 272 return mWebview; 273 } 274 } 275 276 // A final CallbackProxy shared by WebViewCore and BrowserFrame. 277 private final CallbackProxy mCallbackProxy; 278 279 private final WebViewDatabase mDatabase; 280 281 // SSL certificate for the main top-level page (if secure) 282 private SslCertificate mCertificate; 283 284 // Native WebView pointer that is 0 until the native object has been 285 // created. 286 private int mNativeClass; 287 // This would be final but it needs to be set to null when the WebView is 288 // destroyed. 289 private WebViewCore mWebViewCore; 290 // Handler for dispatching UI messages. 291 /* package */ final Handler mPrivateHandler = new PrivateHandler(); 292 private WebTextView mWebTextView; 293 // Used to ignore changes to webkit text that arrives to the UI side after 294 // more key events. 295 private int mTextGeneration; 296 297 // Used by WebViewCore to create child views. 298 /* package */ final ViewManager mViewManager; 299 300 /** 301 * Position of the last touch event. 302 */ 303 private float mLastTouchX; 304 private float mLastTouchY; 305 306 /** 307 * Time of the last touch event. 308 */ 309 private long mLastTouchTime; 310 311 /** 312 * Time of the last time sending touch event to WebViewCore 313 */ 314 private long mLastSentTouchTime; 315 316 /** 317 * The minimum elapsed time before sending another ACTION_MOVE event to 318 * WebViewCore. This really should be tuned for each type of the devices. 319 * For example in Google Map api test case, it takes Dream device at least 320 * 150ms to do a full cycle in the WebViewCore by processing a touch event, 321 * triggering the layout and drawing the picture. While the same process 322 * takes 60+ms on the current high speed device. If we make 323 * TOUCH_SENT_INTERVAL too small, there will be multiple touch events sent 324 * to WebViewCore queue and the real layout and draw events will be pushed 325 * to further, which slows down the refresh rate. Choose 50 to favor the 326 * current high speed devices. For Dream like devices, 100 is a better 327 * choice. Maybe make this in the buildspec later. 328 */ 329 private static final int TOUCH_SENT_INTERVAL = 50; 330 331 /** 332 * Helper class to get velocity for fling 333 */ 334 VelocityTracker mVelocityTracker; 335 private int mMaximumFling; 336 private float mLastVelocity; 337 private float mLastVelX; 338 private float mLastVelY; 339 340 /** 341 * Touch mode 342 */ 343 private int mTouchMode = TOUCH_DONE_MODE; 344 private static final int TOUCH_INIT_MODE = 1; 345 private static final int TOUCH_DRAG_START_MODE = 2; 346 private static final int TOUCH_DRAG_MODE = 3; 347 private static final int TOUCH_SHORTPRESS_START_MODE = 4; 348 private static final int TOUCH_SHORTPRESS_MODE = 5; 349 private static final int TOUCH_DOUBLE_TAP_MODE = 6; 350 private static final int TOUCH_DONE_MODE = 7; 351 private static final int TOUCH_SELECT_MODE = 8; 352 353 // Whether to forward the touch events to WebCore 354 private boolean mForwardTouchEvents = false; 355 356 // Whether to prevent drag during touch. The initial value depends on 357 // mForwardTouchEvents. If WebCore wants touch events, we assume it will 358 // take control of touch events unless it says no for touch down event. 359 private static final int PREVENT_DRAG_NO = 0; 360 private static final int PREVENT_DRAG_MAYBE_YES = 1; 361 private static final int PREVENT_DRAG_YES = 2; 362 private int mPreventDrag = PREVENT_DRAG_NO; 363 364 // To keep track of whether the current drag was initiated by a WebTextView, 365 // so that we know not to hide the cursor 366 boolean mDragFromTextInput; 367 368 // Whether or not to draw the cursor ring. 369 private boolean mDrawCursorRing = true; 370 371 // true if onPause has been called (and not onResume) 372 private boolean mIsPaused; 373 374 /** 375 * Customizable constant 376 */ 377 // pre-computed square of ViewConfiguration.getScaledTouchSlop() 378 private int mTouchSlopSquare; 379 // pre-computed square of ViewConfiguration.getScaledDoubleTapSlop() 380 private int mDoubleTapSlopSquare; 381 // pre-computed density adjusted navigation slop 382 private int mNavSlop; 383 // This should be ViewConfiguration.getTapTimeout() 384 // But system time out is 100ms, which is too short for the browser. 385 // In the browser, if it switches out of tap too soon, jump tap won't work. 386 private static final int TAP_TIMEOUT = 200; 387 // This should be ViewConfiguration.getLongPressTimeout() 388 // But system time out is 500ms, which is too short for the browser. 389 // With a short timeout, it's difficult to treat trigger a short press. 390 private static final int LONG_PRESS_TIMEOUT = 1000; 391 // needed to avoid flinging after a pause of no movement 392 private static final int MIN_FLING_TIME = 250; 393 // The time that the Zoom Controls are visible before fading away 394 private static final long ZOOM_CONTROLS_TIMEOUT = 395 ViewConfiguration.getZoomControlsTimeout(); 396 // The amount of content to overlap between two screens when going through 397 // pages with the space bar, in pixels. 398 private static final int PAGE_SCROLL_OVERLAP = 24; 399 400 /** 401 * These prevent calling requestLayout if either dimension is fixed. This 402 * depends on the layout parameters and the measure specs. 403 */ 404 boolean mWidthCanMeasure; 405 boolean mHeightCanMeasure; 406 407 // Remember the last dimensions we sent to the native side so we can avoid 408 // sending the same dimensions more than once. 409 int mLastWidthSent; 410 int mLastHeightSent; 411 412 private int mContentWidth; // cache of value from WebViewCore 413 private int mContentHeight; // cache of value from WebViewCore 414 415 // Need to have the separate control for horizontal and vertical scrollbar 416 // style than the View's single scrollbar style 417 private boolean mOverlayHorizontalScrollbar = true; 418 private boolean mOverlayVerticalScrollbar = false; 419 420 // our standard speed. this way small distances will be traversed in less 421 // time than large distances, but we cap the duration, so that very large 422 // distances won't take too long to get there. 423 private static final int STD_SPEED = 480; // pixels per second 424 // time for the longest scroll animation 425 private static final int MAX_DURATION = 750; // milliseconds 426 private static final int SLIDE_TITLE_DURATION = 500; // milliseconds 427 private Scroller mScroller; 428 429 private boolean mWrapContent; 430 431 /** 432 * Private message ids 433 */ 434 private static final int REMEMBER_PASSWORD = 1; 435 private static final int NEVER_REMEMBER_PASSWORD = 2; 436 private static final int SWITCH_TO_SHORTPRESS = 3; 437 private static final int SWITCH_TO_LONGPRESS = 4; 438 private static final int RELEASE_SINGLE_TAP = 5; 439 private static final int REQUEST_FORM_DATA = 6; 440 private static final int RESUME_WEBCORE_UPDATE = 7; 441 442 //! arg1=x, arg2=y 443 static final int SCROLL_TO_MSG_ID = 10; 444 static final int SCROLL_BY_MSG_ID = 11; 445 //! arg1=x, arg2=y 446 static final int SPAWN_SCROLL_TO_MSG_ID = 12; 447 //! arg1=x, arg2=y 448 static final int SYNC_SCROLL_TO_MSG_ID = 13; 449 static final int NEW_PICTURE_MSG_ID = 14; 450 static final int UPDATE_TEXT_ENTRY_MSG_ID = 15; 451 static final int WEBCORE_INITIALIZED_MSG_ID = 16; 452 static final int UPDATE_TEXTFIELD_TEXT_MSG_ID = 17; 453 static final int MOVE_OUT_OF_PLUGIN = 19; 454 static final int CLEAR_TEXT_ENTRY = 20; 455 static final int UPDATE_TEXT_SELECTION_MSG_ID = 21; 456 static final int UPDATE_CLIPBOARD = 22; 457 static final int LONG_PRESS_CENTER = 23; 458 static final int PREVENT_TOUCH_ID = 24; 459 static final int WEBCORE_NEED_TOUCH_EVENTS = 25; 460 // obj=Rect in doc coordinates 461 static final int INVAL_RECT_MSG_ID = 26; 462 static final int REQUEST_KEYBOARD = 27; 463 464 static final String[] HandlerDebugString = { 465 "REMEMBER_PASSWORD", // = 1; 466 "NEVER_REMEMBER_PASSWORD", // = 2; 467 "SWITCH_TO_SHORTPRESS", // = 3; 468 "SWITCH_TO_LONGPRESS", // = 4; 469 "RELEASE_SINGLE_TAP", // = 5; 470 "REQUEST_FORM_DATA", // = 6; 471 "SWITCH_TO_CLICK", // = 7; 472 "RESUME_WEBCORE_UPDATE", // = 8; 473 "9", 474 "SCROLL_TO_MSG_ID", // = 10; 475 "SCROLL_BY_MSG_ID", // = 11; 476 "SPAWN_SCROLL_TO_MSG_ID", // = 12; 477 "SYNC_SCROLL_TO_MSG_ID", // = 13; 478 "NEW_PICTURE_MSG_ID", // = 14; 479 "UPDATE_TEXT_ENTRY_MSG_ID", // = 15; 480 "WEBCORE_INITIALIZED_MSG_ID", // = 16; 481 "UPDATE_TEXTFIELD_TEXT_MSG_ID", // = 17; 482 "18", // = 18; 483 "MOVE_OUT_OF_PLUGIN", // = 19; 484 "CLEAR_TEXT_ENTRY", // = 20; 485 "UPDATE_TEXT_SELECTION_MSG_ID", // = 21; 486 "UPDATE_CLIPBOARD", // = 22; 487 "LONG_PRESS_CENTER", // = 23; 488 "PREVENT_TOUCH_ID", // = 24; 489 "WEBCORE_NEED_TOUCH_EVENTS", // = 25; 490 "INVAL_RECT_MSG_ID", // = 26; 491 "REQUEST_KEYBOARD" // = 27; 492 }; 493 494 // default scale limit. Depending on the display density 495 private static float DEFAULT_MAX_ZOOM_SCALE; 496 private static float DEFAULT_MIN_ZOOM_SCALE; 497 // scale limit, which can be set through viewport meta tag in the web page 498 private float mMaxZoomScale; 499 private float mMinZoomScale; 500 private boolean mMinZoomScaleFixed = true; 501 502 // initial scale in percent. 0 means using default. 503 private int mInitialScale = 0; 504 505 // while in the zoom overview mode, the page's width is fully fit to the 506 // current window. The page is alive, in another words, you can click to 507 // follow the links. Double tap will toggle between zoom overview mode and 508 // the last zoom scale. 509 boolean mInZoomOverview = false; 510 511 // ideally mZoomOverviewWidth should be mContentWidth. But sites like espn, 512 // engadget always have wider mContentWidth no matter what viewport size is. 513 int mZoomOverviewWidth = WebViewCore.DEFAULT_VIEWPORT_WIDTH; 514 float mLastScale; 515 516 // default scale. Depending on the display density. 517 static int DEFAULT_SCALE_PERCENT; 518 private float mDefaultScale; 519 520 // set to true temporarily while the zoom control is being dragged 521 private boolean mPreviewZoomOnly = false; 522 523 // computed scale and inverse, from mZoomWidth. 524 private float mActualScale; 525 private float mInvActualScale; 526 // if this is non-zero, it is used on drawing rather than mActualScale 527 private float mZoomScale; 528 private float mInvInitialZoomScale; 529 private float mInvFinalZoomScale; 530 private int mInitialScrollX; 531 private int mInitialScrollY; 532 private long mZoomStart; 533 private static final int ZOOM_ANIMATION_LENGTH = 500; 534 535 private boolean mUserScroll = false; 536 537 private int mSnapScrollMode = SNAP_NONE; 538 private static final int SNAP_NONE = 1; 539 private static final int SNAP_X = 2; 540 private static final int SNAP_Y = 3; 541 private static final int SNAP_X_LOCK = 4; 542 private static final int SNAP_Y_LOCK = 5; 543 private boolean mSnapPositive; 544 545 // Used to match key downs and key ups 546 private boolean mGotKeyDown; 547 548 /* package */ static boolean mLogEvent = true; 549 private static final int EVENT_LOG_ZOOM_LEVEL_CHANGE = 70101; 550 private static final int EVENT_LOG_DOUBLE_TAP_DURATION = 70102; 551 552 // for event log 553 private long mLastTouchUpTime = 0; 554 555 /** 556 * URI scheme for telephone number 557 */ 558 public static final String SCHEME_TEL = "tel:"; 559 /** 560 * URI scheme for email address 561 */ 562 public static final String SCHEME_MAILTO = "mailto:"; 563 /** 564 * URI scheme for map address 565 */ 566 public static final String SCHEME_GEO = "geo:0,0?q="; 567 568 private int mBackgroundColor = Color.WHITE; 569 570 // Used to notify listeners of a new picture. 571 private PictureListener mPictureListener; 572 /** 573 * Interface to listen for new pictures as they change. 574 */ 575 public interface PictureListener { 576 /** 577 * Notify the listener that the picture has changed. 578 * @param view The WebView that owns the picture. 579 * @param picture The new picture. 580 */ 581 public void onNewPicture(WebView view, Picture picture); 582 } 583 584 // FIXME: Want to make this public, but need to change the API file. 585 public /*static*/ class HitTestResult { 586 /** 587 * Default HitTestResult, where the target is unknown 588 */ 589 public static final int UNKNOWN_TYPE = 0; 590 /** 591 * HitTestResult for hitting a HTML::a tag 592 */ 593 public static final int ANCHOR_TYPE = 1; 594 /** 595 * HitTestResult for hitting a phone number 596 */ 597 public static final int PHONE_TYPE = 2; 598 /** 599 * HitTestResult for hitting a map address 600 */ 601 public static final int GEO_TYPE = 3; 602 /** 603 * HitTestResult for hitting an email address 604 */ 605 public static final int EMAIL_TYPE = 4; 606 /** 607 * HitTestResult for hitting an HTML::img tag 608 */ 609 public static final int IMAGE_TYPE = 5; 610 /** 611 * HitTestResult for hitting a HTML::a tag which contains HTML::img 612 */ 613 public static final int IMAGE_ANCHOR_TYPE = 6; 614 /** 615 * HitTestResult for hitting a HTML::a tag with src=http 616 */ 617 public static final int SRC_ANCHOR_TYPE = 7; 618 /** 619 * HitTestResult for hitting a HTML::a tag with src=http + HTML::img 620 */ 621 public static final int SRC_IMAGE_ANCHOR_TYPE = 8; 622 /** 623 * HitTestResult for hitting an edit text area 624 */ 625 public static final int EDIT_TEXT_TYPE = 9; 626 627 private int mType; 628 private String mExtra; 629 630 HitTestResult() { 631 mType = UNKNOWN_TYPE; 632 } 633 634 private void setType(int type) { 635 mType = type; 636 } 637 638 private void setExtra(String extra) { 639 mExtra = extra; 640 } 641 642 public int getType() { 643 return mType; 644 } 645 646 public String getExtra() { 647 return mExtra; 648 } 649 } 650 651 // The View containing the zoom controls 652 private ExtendedZoomControls mZoomControls; 653 private Runnable mZoomControlRunnable; 654 655 private ZoomButtonsController mZoomButtonsController; 656 657 // These keep track of the center point of the zoom. They are used to 658 // determine the point around which we should zoom. 659 private float mZoomCenterX; 660 private float mZoomCenterY; 661 662 private ZoomButtonsController.OnZoomListener mZoomListener = 663 new ZoomButtonsController.OnZoomListener() { 664 665 public void onVisibilityChanged(boolean visible) { 666 if (visible) { 667 switchOutDrawHistory(); 668 updateZoomButtonsEnabled(); 669 } 670 } 671 672 public void onZoom(boolean zoomIn) { 673 if (zoomIn) { 674 zoomIn(); 675 } else { 676 zoomOut(); 677 } 678 679 updateZoomButtonsEnabled(); 680 } 681 }; 682 683 /** 684 * Construct a new WebView with a Context object. 685 * @param context A Context object used to access application assets. 686 */ 687 public WebView(Context context) { 688 this(context, null); 689 } 690 691 /** 692 * Construct a new WebView with layout parameters. 693 * @param context A Context object used to access application assets. 694 * @param attrs An AttributeSet passed to our parent. 695 */ 696 public WebView(Context context, AttributeSet attrs) { 697 this(context, attrs, com.android.internal.R.attr.webViewStyle); 698 } 699 700 /** 701 * Construct a new WebView with layout parameters and a default style. 702 * @param context A Context object used to access application assets. 703 * @param attrs An AttributeSet passed to our parent. 704 * @param defStyle The default style resource ID. 705 */ 706 public WebView(Context context, AttributeSet attrs, int defStyle) { 707 this(context, attrs, defStyle, null); 708 } 709 710 /** 711 * Construct a new WebView with layout parameters, a default style and a set 712 * of custom Javscript interfaces to be added to the WebView at initialization 713 * time. This guraratees that these interfaces will be available when the JS 714 * context is initialized. 715 * @param context A Context object used to access application assets. 716 * @param attrs An AttributeSet passed to our parent. 717 * @param defStyle The default style resource ID. 718 * @param javascriptInterfaces is a Map of intareface names, as keys, and 719 * object implementing those interfaces, as values. 720 * @hide pending API council approval. 721 */ 722 protected WebView(Context context, AttributeSet attrs, int defStyle, 723 Map<String, Object> javascriptInterfaces) { 724 super(context, attrs, defStyle); 725 init(); 726 727 mCallbackProxy = new CallbackProxy(context, this); 728 mWebViewCore = new WebViewCore(context, this, mCallbackProxy, javascriptInterfaces); 729 mDatabase = WebViewDatabase.getInstance(context); 730 mScroller = new Scroller(context); 731 732 mViewManager = new ViewManager(this); 733 734 mZoomButtonsController = new ZoomButtonsController(this); 735 mZoomButtonsController.setOnZoomListener(mZoomListener); 736 // ZoomButtonsController positions the buttons at the bottom, but in 737 // the middle. Change their layout parameters so they appear on the 738 // right. 739 View controls = mZoomButtonsController.getZoomControls(); 740 ViewGroup.LayoutParams params = controls.getLayoutParams(); 741 if (params instanceof FrameLayout.LayoutParams) { 742 FrameLayout.LayoutParams frameParams = (FrameLayout.LayoutParams) 743 params; 744 frameParams.gravity = Gravity.RIGHT; 745 } 746 } 747 748 private void updateZoomButtonsEnabled() { 749 boolean canZoomIn = mActualScale < mMaxZoomScale; 750 boolean canZoomOut = mActualScale > mMinZoomScale && !mInZoomOverview; 751 if (!canZoomIn && !canZoomOut) { 752 // Hide the zoom in and out buttons, as well as the fit to page 753 // button, if the page cannot zoom 754 mZoomButtonsController.getZoomControls().setVisibility(View.GONE); 755 } else { 756 // Bring back the hidden zoom controls. 757 mZoomButtonsController.getZoomControls() 758 .setVisibility(View.VISIBLE); 759 // Set each one individually, as a page may be able to zoom in 760 // or out. 761 mZoomButtonsController.setZoomInEnabled(canZoomIn); 762 mZoomButtonsController.setZoomOutEnabled(canZoomOut); 763 } 764 } 765 766 private void init() { 767 setWillNotDraw(false); 768 setFocusable(true); 769 setFocusableInTouchMode(true); 770 setClickable(true); 771 setLongClickable(true); 772 773 final ViewConfiguration configuration = ViewConfiguration.get(getContext()); 774 int slop = configuration.getScaledTouchSlop(); 775 mTouchSlopSquare = slop * slop; 776 mMinLockSnapReverseDistance = slop; 777 slop = configuration.getScaledDoubleTapSlop(); 778 mDoubleTapSlopSquare = slop * slop; 779 final float density = getContext().getResources().getDisplayMetrics().density; 780 // use one line height, 16 based on our current default font, for how 781 // far we allow a touch be away from the edge of a link 782 mNavSlop = (int) (16 * density); 783 // density adjusted scale factors 784 DEFAULT_SCALE_PERCENT = (int) (100 * density); 785 mDefaultScale = density; 786 mActualScale = density; 787 mInvActualScale = 1 / density; 788 DEFAULT_MAX_ZOOM_SCALE = 4.0f * density; 789 DEFAULT_MIN_ZOOM_SCALE = 0.25f * density; 790 mMaxZoomScale = DEFAULT_MAX_ZOOM_SCALE; 791 mMinZoomScale = DEFAULT_MIN_ZOOM_SCALE; 792 mMaximumFling = configuration.getScaledMaximumFlingVelocity(); 793 } 794 795 /* package */void updateDefaultZoomDensity(int zoomDensity) { 796 final float density = getContext().getResources().getDisplayMetrics().density 797 * 100 / zoomDensity; 798 if (Math.abs(density - mDefaultScale) > 0.01) { 799 float scaleFactor = density / mDefaultScale; 800 // adjust the limits 801 mNavSlop = (int) (16 * density); 802 DEFAULT_SCALE_PERCENT = (int) (100 * density); 803 DEFAULT_MAX_ZOOM_SCALE = 4.0f * density; 804 DEFAULT_MIN_ZOOM_SCALE = 0.25f * density; 805 mDefaultScale = density; 806 mMaxZoomScale *= scaleFactor; 807 mMinZoomScale *= scaleFactor; 808 setNewZoomScale(mActualScale * scaleFactor, false); 809 } 810 } 811 812 /* package */ boolean onSavePassword(String schemePlusHost, String username, 813 String password, final Message resumeMsg) { 814 boolean rVal = false; 815 if (resumeMsg == null) { 816 // null resumeMsg implies saving password silently 817 mDatabase.setUsernamePassword(schemePlusHost, username, password); 818 } else { 819 final Message remember = mPrivateHandler.obtainMessage( 820 REMEMBER_PASSWORD); 821 remember.getData().putString("host", schemePlusHost); 822 remember.getData().putString("username", username); 823 remember.getData().putString("password", password); 824 remember.obj = resumeMsg; 825 826 final Message neverRemember = mPrivateHandler.obtainMessage( 827 NEVER_REMEMBER_PASSWORD); 828 neverRemember.getData().putString("host", schemePlusHost); 829 neverRemember.getData().putString("username", username); 830 neverRemember.getData().putString("password", password); 831 neverRemember.obj = resumeMsg; 832 833 new AlertDialog.Builder(getContext()) 834 .setTitle(com.android.internal.R.string.save_password_label) 835 .setMessage(com.android.internal.R.string.save_password_message) 836 .setPositiveButton(com.android.internal.R.string.save_password_notnow, 837 new DialogInterface.OnClickListener() { 838 public void onClick(DialogInterface dialog, int which) { 839 resumeMsg.sendToTarget(); 840 } 841 }) 842 .setNeutralButton(com.android.internal.R.string.save_password_remember, 843 new DialogInterface.OnClickListener() { 844 public void onClick(DialogInterface dialog, int which) { 845 remember.sendToTarget(); 846 } 847 }) 848 .setNegativeButton(com.android.internal.R.string.save_password_never, 849 new DialogInterface.OnClickListener() { 850 public void onClick(DialogInterface dialog, int which) { 851 neverRemember.sendToTarget(); 852 } 853 }) 854 .setOnCancelListener(new OnCancelListener() { 855 public void onCancel(DialogInterface dialog) { 856 resumeMsg.sendToTarget(); 857 } 858 }).show(); 859 // Return true so that WebViewCore will pause while the dialog is 860 // up. 861 rVal = true; 862 } 863 return rVal; 864 } 865 866 @Override 867 public void setScrollBarStyle(int style) { 868 if (style == View.SCROLLBARS_INSIDE_INSET 869 || style == View.SCROLLBARS_OUTSIDE_INSET) { 870 mOverlayHorizontalScrollbar = mOverlayVerticalScrollbar = false; 871 } else { 872 mOverlayHorizontalScrollbar = mOverlayVerticalScrollbar = true; 873 } 874 super.setScrollBarStyle(style); 875 } 876 877 /** 878 * Specify whether the horizontal scrollbar has overlay style. 879 * @param overlay TRUE if horizontal scrollbar should have overlay style. 880 */ 881 public void setHorizontalScrollbarOverlay(boolean overlay) { 882 mOverlayHorizontalScrollbar = overlay; 883 } 884 885 /** 886 * Specify whether the vertical scrollbar has overlay style. 887 * @param overlay TRUE if vertical scrollbar should have overlay style. 888 */ 889 public void setVerticalScrollbarOverlay(boolean overlay) { 890 mOverlayVerticalScrollbar = overlay; 891 } 892 893 /** 894 * Return whether horizontal scrollbar has overlay style 895 * @return TRUE if horizontal scrollbar has overlay style. 896 */ 897 public boolean overlayHorizontalScrollbar() { 898 return mOverlayHorizontalScrollbar; 899 } 900 901 /** 902 * Return whether vertical scrollbar has overlay style 903 * @return TRUE if vertical scrollbar has overlay style. 904 */ 905 public boolean overlayVerticalScrollbar() { 906 return mOverlayVerticalScrollbar; 907 } 908 909 /* 910 * Return the width of the view where the content of WebView should render 911 * to. 912 * Note: this can be called from WebCoreThread. 913 */ 914 /* package */ int getViewWidth() { 915 if (!isVerticalScrollBarEnabled() || mOverlayVerticalScrollbar) { 916 return getWidth(); 917 } else { 918 return getWidth() - getVerticalScrollbarWidth(); 919 } 920 } 921 922 /* 923 * returns the height of the titlebarview (if any). Does not care about 924 * scrolling 925 */ 926 private int getTitleHeight() { 927 return mTitleBar != null ? mTitleBar.getHeight() : 0; 928 } 929 930 /* 931 * Return the amount of the titlebarview (if any) that is visible 932 */ 933 private int getVisibleTitleHeight() { 934 return Math.max(getTitleHeight() - mScrollY, 0); 935 } 936 937 /* 938 * Return the height of the view where the content of WebView should render 939 * to. Note that this excludes mTitleBar, if there is one. 940 * Note: this can be called from WebCoreThread. 941 */ 942 /* package */ int getViewHeight() { 943 return getViewHeightWithTitle() - getVisibleTitleHeight(); 944 } 945 946 private int getViewHeightWithTitle() { 947 int height = getHeight(); 948 if (isHorizontalScrollBarEnabled() && !mOverlayHorizontalScrollbar) { 949 height -= getHorizontalScrollbarHeight(); 950 } 951 return height; 952 } 953 954 /** 955 * @return The SSL certificate for the main top-level page or null if 956 * there is no certificate (the site is not secure). 957 */ 958 public SslCertificate getCertificate() { 959 return mCertificate; 960 } 961 962 /** 963 * Sets the SSL certificate for the main top-level page. 964 */ 965 public void setCertificate(SslCertificate certificate) { 966 // here, the certificate can be null (if the site is not secure) 967 mCertificate = certificate; 968 } 969 970 //------------------------------------------------------------------------- 971 // Methods called by activity 972 //------------------------------------------------------------------------- 973 974 /** 975 * Save the username and password for a particular host in the WebView's 976 * internal database. 977 * @param host The host that required the credentials. 978 * @param username The username for the given host. 979 * @param password The password for the given host. 980 */ 981 public void savePassword(String host, String username, String password) { 982 mDatabase.setUsernamePassword(host, username, password); 983 } 984 985 /** 986 * Set the HTTP authentication credentials for a given host and realm. 987 * 988 * @param host The host for the credentials. 989 * @param realm The realm for the credentials. 990 * @param username The username for the password. If it is null, it means 991 * password can't be saved. 992 * @param password The password 993 */ 994 public void setHttpAuthUsernamePassword(String host, String realm, 995 String username, String password) { 996 mDatabase.setHttpAuthUsernamePassword(host, realm, username, password); 997 } 998 999 /** 1000 * Retrieve the HTTP authentication username and password for a given 1001 * host & realm pair 1002 * 1003 * @param host The host for which the credentials apply. 1004 * @param realm The realm for which the credentials apply. 1005 * @return String[] if found, String[0] is username, which can be null and 1006 * String[1] is password. Return null if it can't find anything. 1007 */ 1008 public String[] getHttpAuthUsernamePassword(String host, String realm) { 1009 return mDatabase.getHttpAuthUsernamePassword(host, realm); 1010 } 1011 1012 /** 1013 * Destroy the internal state of the WebView. This method should be called 1014 * after the WebView has been removed from the view system. No other 1015 * methods may be called on a WebView after destroy. 1016 */ 1017 public void destroy() { 1018 clearTextEntry(); 1019 if (mWebViewCore != null) { 1020 // Set the handlers to null before destroying WebViewCore so no 1021 // more messages will be posted. 1022 mCallbackProxy.setWebViewClient(null); 1023 mCallbackProxy.setWebChromeClient(null); 1024 // Tell WebViewCore to destroy itself 1025 WebViewCore webViewCore = mWebViewCore; 1026 mWebViewCore = null; // prevent using partial webViewCore 1027 webViewCore.destroy(); 1028 // Remove any pending messages that might not be serviced yet. 1029 mPrivateHandler.removeCallbacksAndMessages(null); 1030 mCallbackProxy.removeCallbacksAndMessages(null); 1031 // Wake up the WebCore thread just in case it is waiting for a 1032 // javascript dialog. 1033 synchronized (mCallbackProxy) { 1034 mCallbackProxy.notify(); 1035 } 1036 } 1037 if (mNativeClass != 0) { 1038 nativeDestroy(); 1039 mNativeClass = 0; 1040 } 1041 } 1042 1043 /** 1044 * Enables platform notifications of data state and proxy changes. 1045 */ 1046 public static void enablePlatformNotifications() { 1047 Network.enablePlatformNotifications(); 1048 } 1049 1050 /** 1051 * If platform notifications are enabled, this should be called 1052 * from the Activity's onPause() or onStop(). 1053 */ 1054 public static void disablePlatformNotifications() { 1055 Network.disablePlatformNotifications(); 1056 } 1057 1058 /** 1059 * Sets JavaScript engine flags. 1060 * 1061 * @param flags JS engine flags in a String 1062 * 1063 * @hide pending API solidification 1064 */ 1065 public void setJsFlags(String flags) { 1066 mWebViewCore.sendMessage(EventHub.SET_JS_FLAGS, flags); 1067 } 1068 1069 /** 1070 * Inform WebView of the network state. This is used to set 1071 * the javascript property window.navigator.isOnline and 1072 * generates the online/offline event as specified in HTML5, sec. 5.7.7 1073 * @param networkUp boolean indicating if network is available 1074 */ 1075 public void setNetworkAvailable(boolean networkUp) { 1076 mWebViewCore.sendMessage(EventHub.SET_NETWORK_STATE, 1077 networkUp ? 1 : 0, 0); 1078 } 1079 1080 /** 1081 * Save the state of this WebView used in 1082 * {@link android.app.Activity#onSaveInstanceState}. Please note that this 1083 * method no longer stores the display data for this WebView. The previous 1084 * behavior could potentially leak files if {@link #restoreState} was never 1085 * called. See {@link #savePicture} and {@link #restorePicture} for saving 1086 * and restoring the display data. 1087 * @param outState The Bundle to store the WebView state. 1088 * @return The same copy of the back/forward list used to save the state. If 1089 * saveState fails, the returned list will be null. 1090 * @see #savePicture 1091 * @see #restorePicture 1092 */ 1093 public WebBackForwardList saveState(Bundle outState) { 1094 if (outState == null) { 1095 return null; 1096 } 1097 // We grab a copy of the back/forward list because a client of WebView 1098 // may have invalidated the history list by calling clearHistory. 1099 WebBackForwardList list = copyBackForwardList(); 1100 final int currentIndex = list.getCurrentIndex(); 1101 final int size = list.getSize(); 1102 // We should fail saving the state if the list is empty or the index is 1103 // not in a valid range. 1104 if (currentIndex < 0 || currentIndex >= size || size == 0) { 1105 return null; 1106 } 1107 outState.putInt("index", currentIndex); 1108 // FIXME: This should just be a byte[][] instead of ArrayList but 1109 // Parcel.java does not have the code to handle multi-dimensional 1110 // arrays. 1111 ArrayList<byte[]> history = new ArrayList<byte[]>(size); 1112 for (int i = 0; i < size; i++) { 1113 WebHistoryItem item = list.getItemAtIndex(i); 1114 if (null == item) { 1115 // FIXME: this shouldn't happen 1116 // need to determine how item got set to null 1117 Log.w(LOGTAG, "saveState: Unexpected null history item."); 1118 return null; 1119 } 1120 byte[] data = item.getFlattenedData(); 1121 if (data == null) { 1122 // It would be very odd to not have any data for a given history 1123 // item. And we will fail to rebuild the history list without 1124 // flattened data. 1125 return null; 1126 } 1127 history.add(data); 1128 } 1129 outState.putSerializable("history", history); 1130 if (mCertificate != null) { 1131 outState.putBundle("certificate", 1132 SslCertificate.saveState(mCertificate)); 1133 } 1134 return list; 1135 } 1136 1137 /** 1138 * Save the current display data to the Bundle given. Used in conjunction 1139 * with {@link #saveState}. 1140 * @param b A Bundle to store the display data. 1141 * @param dest The file to store the serialized picture data. Will be 1142 * overwritten with this WebView's picture data. 1143 * @return True if the picture was successfully saved. 1144 */ 1145 public boolean savePicture(Bundle b, File dest) { 1146 if (dest == null || b == null) { 1147 return false; 1148 } 1149 final Picture p = capturePicture(); 1150 try { 1151 final FileOutputStream out = new FileOutputStream(dest); 1152 p.writeToStream(out); 1153 out.close(); 1154 } catch (FileNotFoundException e){ 1155 e.printStackTrace(); 1156 } catch (IOException e) { 1157 e.printStackTrace(); 1158 } catch (RuntimeException e) { 1159 e.printStackTrace(); 1160 } 1161 if (dest.length() > 0) { 1162 b.putInt("scrollX", mScrollX); 1163 b.putInt("scrollY", mScrollY); 1164 b.putFloat("scale", mActualScale); 1165 if (mInZoomOverview) { 1166 b.putFloat("lastScale", mLastScale); 1167 } 1168 return true; 1169 } 1170 return false; 1171 } 1172 1173 /** 1174 * Restore the display data that was save in {@link #savePicture}. Used in 1175 * conjunction with {@link #restoreState}. 1176 * @param b A Bundle containing the saved display data. 1177 * @param src The file where the picture data was stored. 1178 * @return True if the picture was successfully restored. 1179 */ 1180 public boolean restorePicture(Bundle b, File src) { 1181 if (src == null || b == null) { 1182 return false; 1183 } 1184 if (src.exists()) { 1185 Picture p = null; 1186 try { 1187 final FileInputStream in = new FileInputStream(src); 1188 p = Picture.createFromStream(in); 1189 in.close(); 1190 } catch (FileNotFoundException e){ 1191 e.printStackTrace(); 1192 } catch (RuntimeException e) { 1193 e.printStackTrace(); 1194 } catch (IOException e) { 1195 e.printStackTrace(); 1196 } 1197 if (p != null) { 1198 int sx = b.getInt("scrollX", 0); 1199 int sy = b.getInt("scrollY", 0); 1200 float scale = b.getFloat("scale", 1.0f); 1201 mDrawHistory = true; 1202 mHistoryPicture = p; 1203 mScrollX = sx; 1204 mScrollY = sy; 1205 mHistoryWidth = Math.round(p.getWidth() * scale); 1206 mHistoryHeight = Math.round(p.getHeight() * scale); 1207 // as getWidth() / getHeight() of the view are not 1208 // available yet, set up mActualScale, so that when 1209 // onSizeChanged() is called, the rest will be set 1210 // correctly 1211 mActualScale = scale; 1212 float lastScale = b.getFloat("lastScale", -1.0f); 1213 if (lastScale > 0) { 1214 mInZoomOverview = true; 1215 mLastScale = lastScale; 1216 } else { 1217 mInZoomOverview = false; 1218 } 1219 invalidate(); 1220 return true; 1221 } 1222 } 1223 return false; 1224 } 1225 1226 /** 1227 * Restore the state of this WebView from the given map used in 1228 * {@link android.app.Activity#onRestoreInstanceState}. This method should 1229 * be called to restore the state of the WebView before using the object. If 1230 * it is called after the WebView has had a chance to build state (load 1231 * pages, create a back/forward list, etc.) there may be undesirable 1232 * side-effects. Please note that this method no longer restores the 1233 * display data for this WebView. See {@link #savePicture} and {@link 1234 * #restorePicture} for saving and restoring the display data. 1235 * @param inState The incoming Bundle of state. 1236 * @return The restored back/forward list or null if restoreState failed. 1237 * @see #savePicture 1238 * @see #restorePicture 1239 */ 1240 public WebBackForwardList restoreState(Bundle inState) { 1241 WebBackForwardList returnList = null; 1242 if (inState == null) { 1243 return returnList; 1244 } 1245 if (inState.containsKey("index") && inState.containsKey("history")) { 1246 mCertificate = SslCertificate.restoreState( 1247 inState.getBundle("certificate")); 1248 1249 final WebBackForwardList list = mCallbackProxy.getBackForwardList(); 1250 final int index = inState.getInt("index"); 1251 // We can't use a clone of the list because we need to modify the 1252 // shared copy, so synchronize instead to prevent concurrent 1253 // modifications. 1254 synchronized (list) { 1255 final List<byte[]> history = 1256 (List<byte[]>) inState.getSerializable("history"); 1257 final int size = history.size(); 1258 // Check the index bounds so we don't crash in native code while 1259 // restoring the history index. 1260 if (index < 0 || index >= size) { 1261 return null; 1262 } 1263 for (int i = 0; i < size; i++) { 1264 byte[] data = history.remove(0); 1265 if (data == null) { 1266 // If we somehow have null data, we cannot reconstruct 1267 // the item and thus our history list cannot be rebuilt. 1268 return null; 1269 } 1270 WebHistoryItem item = new WebHistoryItem(data); 1271 list.addHistoryItem(item); 1272 } 1273 // Grab the most recent copy to return to the caller. 1274 returnList = copyBackForwardList(); 1275 // Update the copy to have the correct index. 1276 returnList.setCurrentIndex(index); 1277 } 1278 // Remove all pending messages because we are restoring previous 1279 // state. 1280 mWebViewCore.removeMessages(); 1281 // Send a restore state message. 1282 mWebViewCore.sendMessage(EventHub.RESTORE_STATE, index); 1283 } 1284 return returnList; 1285 } 1286 1287 /** 1288 * Load the given url. 1289 * @param url The url of the resource to load. 1290 */ 1291 public void loadUrl(String url) { 1292 if (url == null) { 1293 return; 1294 } 1295 switchOutDrawHistory(); 1296 mWebViewCore.sendMessage(EventHub.LOAD_URL, url); 1297 clearTextEntry(); 1298 } 1299 1300 /** 1301 * Load the url with postData using "POST" method into the WebView. If url 1302 * is not a network url, it will be loaded with {link 1303 * {@link #loadUrl(String)} instead. 1304 * 1305 * @param url The url of the resource to load. 1306 * @param postData The data will be passed to "POST" request. 1307 */ 1308 public void postUrl(String url, byte[] postData) { 1309 if (URLUtil.isNetworkUrl(url)) { 1310 switchOutDrawHistory(); 1311 WebViewCore.PostUrlData arg = new WebViewCore.PostUrlData(); 1312 arg.mUrl = url; 1313 arg.mPostData = postData; 1314 mWebViewCore.sendMessage(EventHub.POST_URL, arg); 1315 clearTextEntry(); 1316 } else { 1317 loadUrl(url); 1318 } 1319 } 1320 1321 /** 1322 * Load the given data into the WebView. This will load the data into 1323 * WebView using the data: scheme. Content loaded through this mechanism 1324 * does not have the ability to load content from the network. 1325 * @param data A String of data in the given encoding. 1326 * @param mimeType The MIMEType of the data. i.e. text/html, image/jpeg 1327 * @param encoding The encoding of the data. i.e. utf-8, base64 1328 */ 1329 public void loadData(String data, String mimeType, String encoding) { 1330 loadUrl("data:" + mimeType + ";" + encoding + "," + data); 1331 } 1332 1333 /** 1334 * Load the given data into the WebView, use the provided URL as the base 1335 * URL for the content. The base URL is the URL that represents the page 1336 * that is loaded through this interface. As such, it is used for the 1337 * history entry and to resolve any relative URLs. The failUrl is used if 1338 * browser fails to load the data provided. If it is empty or null, and the 1339 * load fails, then no history entry is created. 1340 * <p> 1341 * Note for post 1.0. Due to the change in the WebKit, the access to asset 1342 * files through "file:///android_asset/" for the sub resources is more 1343 * restricted. If you provide null or empty string as baseUrl, you won't be 1344 * able to access asset files. If the baseUrl is anything other than 1345 * http(s)/ftp(s)/about/javascript as scheme, you can access asset files for 1346 * sub resources. 1347 * 1348 * @param baseUrl Url to resolve relative paths with, if null defaults to 1349 * "about:blank" 1350 * @param data A String of data in the given encoding. 1351 * @param mimeType The MIMEType of the data. i.e. text/html. If null, 1352 * defaults to "text/html" 1353 * @param encoding The encoding of the data. i.e. utf-8, us-ascii 1354 * @param failUrl URL to use if the content fails to load or null. 1355 */ 1356 public void loadDataWithBaseURL(String baseUrl, String data, 1357 String mimeType, String encoding, String failUrl) { 1358 1359 if (baseUrl != null && baseUrl.toLowerCase().startsWith("data:")) { 1360 loadData(data, mimeType, encoding); 1361 return; 1362 } 1363 switchOutDrawHistory(); 1364 WebViewCore.BaseUrlData arg = new WebViewCore.BaseUrlData(); 1365 arg.mBaseUrl = baseUrl; 1366 arg.mData = data; 1367 arg.mMimeType = mimeType; 1368 arg.mEncoding = encoding; 1369 arg.mFailUrl = failUrl; 1370 mWebViewCore.sendMessage(EventHub.LOAD_DATA, arg); 1371 clearTextEntry(); 1372 } 1373 1374 /** 1375 * Stop the current load. 1376 */ 1377 public void stopLoading() { 1378 // TODO: should we clear all the messages in the queue before sending 1379 // STOP_LOADING? 1380 switchOutDrawHistory(); 1381 mWebViewCore.sendMessage(EventHub.STOP_LOADING); 1382 } 1383 1384 /** 1385 * Reload the current url. 1386 */ 1387 public void reload() { 1388 clearTextEntry(); 1389 switchOutDrawHistory(); 1390 mWebViewCore.sendMessage(EventHub.RELOAD); 1391 } 1392 1393 /** 1394 * Return true if this WebView has a back history item. 1395 * @return True iff this WebView has a back history item. 1396 */ 1397 public boolean canGoBack() { 1398 WebBackForwardList l = mCallbackProxy.getBackForwardList(); 1399 synchronized (l) { 1400 if (l.getClearPending()) { 1401 return false; 1402 } else { 1403 return l.getCurrentIndex() > 0; 1404 } 1405 } 1406 } 1407 1408 /** 1409 * Go back in the history of this WebView. 1410 */ 1411 public void goBack() { 1412 goBackOrForward(-1); 1413 } 1414 1415 /** 1416 * Return true if this WebView has a forward history item. 1417 * @return True iff this Webview has a forward history item. 1418 */ 1419 public boolean canGoForward() { 1420 WebBackForwardList l = mCallbackProxy.getBackForwardList(); 1421 synchronized (l) { 1422 if (l.getClearPending()) { 1423 return false; 1424 } else { 1425 return l.getCurrentIndex() < l.getSize() - 1; 1426 } 1427 } 1428 } 1429 1430 /** 1431 * Go forward in the history of this WebView. 1432 */ 1433 public void goForward() { 1434 goBackOrForward(1); 1435 } 1436 1437 /** 1438 * Return true if the page can go back or forward the given 1439 * number of steps. 1440 * @param steps The negative or positive number of steps to move the 1441 * history. 1442 */ 1443 public boolean canGoBackOrForward(int steps) { 1444 WebBackForwardList l = mCallbackProxy.getBackForwardList(); 1445 synchronized (l) { 1446 if (l.getClearPending()) { 1447 return false; 1448 } else { 1449 int newIndex = l.getCurrentIndex() + steps; 1450 return newIndex >= 0 && newIndex < l.getSize(); 1451 } 1452 } 1453 } 1454 1455 /** 1456 * Go to the history item that is the number of steps away from 1457 * the current item. Steps is negative if backward and positive 1458 * if forward. 1459 * @param steps The number of steps to take back or forward in the back 1460 * forward list. 1461 */ 1462 public void goBackOrForward(int steps) { 1463 goBackOrForward(steps, false); 1464 } 1465 1466 private void goBackOrForward(int steps, boolean ignoreSnapshot) { 1467 // every time we go back or forward, we want to reset the 1468 // WebView certificate: 1469 // if the new site is secure, we will reload it and get a 1470 // new certificate set; 1471 // if the new site is not secure, the certificate must be 1472 // null, and that will be the case 1473 mCertificate = null; 1474 if (steps != 0) { 1475 clearTextEntry(); 1476 mWebViewCore.sendMessage(EventHub.GO_BACK_FORWARD, steps, 1477 ignoreSnapshot ? 1 : 0); 1478 } 1479 } 1480 1481 private boolean extendScroll(int y) { 1482 int finalY = mScroller.getFinalY(); 1483 int newY = pinLocY(finalY + y); 1484 if (newY == finalY) return false; 1485 mScroller.setFinalY(newY); 1486 mScroller.extendDuration(computeDuration(0, y)); 1487 return true; 1488 } 1489 1490 /** 1491 * Scroll the contents of the view up by half the view size 1492 * @param top true to jump to the top of the page 1493 * @return true if the page was scrolled 1494 */ 1495 public boolean pageUp(boolean top) { 1496 if (mNativeClass == 0) { 1497 return false; 1498 } 1499 nativeClearCursor(); // start next trackball movement from page edge 1500 if (top) { 1501 // go to the top of the document 1502 return pinScrollTo(mScrollX, 0, true, 0); 1503 } 1504 // Page up 1505 int h = getHeight(); 1506 int y; 1507 if (h > 2 * PAGE_SCROLL_OVERLAP) { 1508 y = -h + PAGE_SCROLL_OVERLAP; 1509 } else { 1510 y = -h / 2; 1511 } 1512 mUserScroll = true; 1513 return mScroller.isFinished() ? pinScrollBy(0, y, true, 0) 1514 : extendScroll(y); 1515 } 1516 1517 /** 1518 * Scroll the contents of the view down by half the page size 1519 * @param bottom true to jump to bottom of page 1520 * @return true if the page was scrolled 1521 */ 1522 public boolean pageDown(boolean bottom) { 1523 if (mNativeClass == 0) { 1524 return false; 1525 } 1526 nativeClearCursor(); // start next trackball movement from page edge 1527 if (bottom) { 1528 return pinScrollTo(mScrollX, mContentHeight, true, 0); 1529 } 1530 // Page down. 1531 int h = getHeight(); 1532 int y; 1533 if (h > 2 * PAGE_SCROLL_OVERLAP) { 1534 y = h - PAGE_SCROLL_OVERLAP; 1535 } else { 1536 y = h / 2; 1537 } 1538 mUserScroll = true; 1539 return mScroller.isFinished() ? pinScrollBy(0, y, true, 0) 1540 : extendScroll(y); 1541 } 1542 1543 /** 1544 * Clear the view so that onDraw() will draw nothing but white background, 1545 * and onMeasure() will return 0 if MeasureSpec is not MeasureSpec.EXACTLY 1546 */ 1547 public void clearView() { 1548 mContentWidth = 0; 1549 mContentHeight = 0; 1550 mWebViewCore.sendMessage(EventHub.CLEAR_CONTENT); 1551 } 1552 1553 /** 1554 * Return a new picture that captures the current display of the webview. 1555 * This is a copy of the display, and will be unaffected if the webview 1556 * later loads a different URL. 1557 * 1558 * @return a picture containing the current contents of the view. Note this 1559 * picture is of the entire document, and is not restricted to the 1560 * bounds of the view. 1561 */ 1562 public Picture capturePicture() { 1563 if (null == mWebViewCore) return null; // check for out of memory tab 1564 return mWebViewCore.copyContentPicture(); 1565 } 1566 1567 /** 1568 * Return true if the browser is displaying a TextView for text input. 1569 */ 1570 private boolean inEditingMode() { 1571 return mWebTextView != null && mWebTextView.getParent() != null 1572 && mWebTextView.hasFocus(); 1573 } 1574 1575 private void clearTextEntry() { 1576 if (inEditingMode()) { 1577 mWebTextView.remove(); 1578 } 1579 } 1580 1581 /** 1582 * Return the current scale of the WebView 1583 * @return The current scale. 1584 */ 1585 public float getScale() { 1586 return mActualScale; 1587 } 1588 1589 /** 1590 * Set the initial scale for the WebView. 0 means default. If 1591 * {@link WebSettings#getUseWideViewPort()} is true, it zooms out all the 1592 * way. Otherwise it starts with 100%. If initial scale is greater than 0, 1593 * WebView starts will this value as initial scale. 1594 * 1595 * @param scaleInPercent The initial scale in percent. 1596 */ 1597 public void setInitialScale(int scaleInPercent) { 1598 mInitialScale = scaleInPercent; 1599 } 1600 1601 /** 1602 * Invoke the graphical zoom picker widget for this WebView. This will 1603 * result in the zoom widget appearing on the screen to control the zoom 1604 * level of this WebView. 1605 */ 1606 public void invokeZoomPicker() { 1607 if (!getSettings().supportZoom()) { 1608 Log.w(LOGTAG, "This WebView doesn't support zoom."); 1609 return; 1610 } 1611 clearTextEntry(); 1612 if (getSettings().getBuiltInZoomControls()) { 1613 mZoomButtonsController.setVisible(true); 1614 } else { 1615 mPrivateHandler.removeCallbacks(mZoomControlRunnable); 1616 mPrivateHandler.postDelayed(mZoomControlRunnable, 1617 ZOOM_CONTROLS_TIMEOUT); 1618 } 1619 } 1620 1621 /** 1622 * Return a HitTestResult based on the current cursor node. If a HTML::a tag 1623 * is found and the anchor has a non-javascript url, the HitTestResult type 1624 * is set to SRC_ANCHOR_TYPE and the url is set in the "extra" field. If the 1625 * anchor does not have a url or if it is a javascript url, the type will 1626 * be UNKNOWN_TYPE and the url has to be retrieved through 1627 * {@link #requestFocusNodeHref} asynchronously. If a HTML::img tag is 1628 * found, the HitTestResult type is set to IMAGE_TYPE and the url is set in 1629 * the "extra" field. A type of 1630 * SRC_IMAGE_ANCHOR_TYPE indicates an anchor with a url that has an image as 1631 * a child node. If a phone number is found, the HitTestResult type is set 1632 * to PHONE_TYPE and the phone number is set in the "extra" field of 1633 * HitTestResult. If a map address is found, the HitTestResult type is set 1634 * to GEO_TYPE and the address is set in the "extra" field of HitTestResult. 1635 * If an email address is found, the HitTestResult type is set to EMAIL_TYPE 1636 * and the email is set in the "extra" field of HitTestResult. Otherwise, 1637 * HitTestResult type is set to UNKNOWN_TYPE. 1638 */ 1639 public HitTestResult getHitTestResult() { 1640 if (mNativeClass == 0) { 1641 return null; 1642 } 1643 1644 HitTestResult result = new HitTestResult(); 1645 if (nativeHasCursorNode()) { 1646 if (nativeCursorIsTextInput()) { 1647 result.setType(HitTestResult.EDIT_TEXT_TYPE); 1648 } else { 1649 String text = nativeCursorText(); 1650 if (text != null) { 1651 if (text.startsWith(SCHEME_TEL)) { 1652 result.setType(HitTestResult.PHONE_TYPE); 1653 result.setExtra(text.substring(SCHEME_TEL.length())); 1654 } else if (text.startsWith(SCHEME_MAILTO)) { 1655 result.setType(HitTestResult.EMAIL_TYPE); 1656 result.setExtra(text.substring(SCHEME_MAILTO.length())); 1657 } else if (text.startsWith(SCHEME_GEO)) { 1658 result.setType(HitTestResult.GEO_TYPE); 1659 result.setExtra(URLDecoder.decode(text 1660 .substring(SCHEME_GEO.length()))); 1661 } else if (nativeCursorIsAnchor()) { 1662 result.setType(HitTestResult.SRC_ANCHOR_TYPE); 1663 result.setExtra(text); 1664 } 1665 } 1666 } 1667 } 1668 int type = result.getType(); 1669 if (type == HitTestResult.UNKNOWN_TYPE 1670 || type == HitTestResult.SRC_ANCHOR_TYPE) { 1671 // Now check to see if it is an image. 1672 int contentX = viewToContentX((int) mLastTouchX + mScrollX); 1673 int contentY = viewToContentY((int) mLastTouchY + mScrollY); 1674 String text = nativeImageURI(contentX, contentY); 1675 if (text != null) { 1676 result.setType(type == HitTestResult.UNKNOWN_TYPE ? 1677 HitTestResult.IMAGE_TYPE : 1678 HitTestResult.SRC_IMAGE_ANCHOR_TYPE); 1679 result.setExtra(text); 1680 } 1681 } 1682 return result; 1683 } 1684 1685 /** 1686 * Request the href of an anchor element due to getFocusNodePath returning 1687 * "href." If hrefMsg is null, this method returns immediately and does not 1688 * dispatch hrefMsg to its target. 1689 * 1690 * @param hrefMsg This message will be dispatched with the result of the 1691 * request as the data member with "url" as key. The result can 1692 * be null. 1693 */ 1694 // FIXME: API change required to change the name of this function. We now 1695 // look at the cursor node, and not the focus node. Also, what is 1696 // getFocusNodePath? 1697 public void requestFocusNodeHref(Message hrefMsg) { 1698 if (hrefMsg == null || mNativeClass == 0) { 1699 return; 1700 } 1701 if (nativeCursorIsAnchor()) { 1702 mWebViewCore.sendMessage(EventHub.REQUEST_CURSOR_HREF, 1703 nativeCursorFramePointer(), nativeCursorNodePointer(), 1704 hrefMsg); 1705 } 1706 } 1707 1708 /** 1709 * Request the url of the image last touched by the user. msg will be sent 1710 * to its target with a String representing the url as its object. 1711 * 1712 * @param msg This message will be dispatched with the result of the request 1713 * as the data member with "url" as key. The result can be null. 1714 */ 1715 public void requestImageRef(Message msg) { 1716 int contentX = viewToContentX((int) mLastTouchX + mScrollX); 1717 int contentY = viewToContentY((int) mLastTouchY + mScrollY); 1718 String ref = nativeImageURI(contentX, contentY); 1719 Bundle data = msg.getData(); 1720 data.putString("url", ref); 1721 msg.setData(data); 1722 msg.sendToTarget(); 1723 } 1724 1725 private static int pinLoc(int x, int viewMax, int docMax) { 1726// Log.d(LOGTAG, "-- pinLoc " + x + " " + viewMax + " " + docMax); 1727 if (docMax < viewMax) { // the doc has room on the sides for "blank" 1728 // pin the short document to the top/left of the screen 1729 x = 0; 1730// Log.d(LOGTAG, "--- center " + x); 1731 } else if (x < 0) { 1732 x = 0; 1733// Log.d(LOGTAG, "--- zero"); 1734 } else if (x + viewMax > docMax) { 1735 x = docMax - viewMax; 1736// Log.d(LOGTAG, "--- pin " + x); 1737 } 1738 return x; 1739 } 1740 1741 // Expects x in view coordinates 1742 private int pinLocX(int x) { 1743 return pinLoc(x, getViewWidth(), computeHorizontalScrollRange()); 1744 } 1745 1746 // Expects y in view coordinates 1747 private int pinLocY(int y) { 1748 int titleH = getTitleHeight(); 1749 // if the titlebar is still visible, just pin against 0 1750 if (y <= titleH) { 1751 return Math.max(y, 0); 1752 } 1753 // convert to 0-based coordinate (subtract the title height) 1754 // pin(), and then add the title height back in 1755 return pinLoc(y - titleH, getViewHeight(), 1756 computeVerticalScrollRange()) + titleH; 1757 } 1758 1759 /** 1760 * A title bar which is embedded in this WebView, and scrolls along with it 1761 * vertically, but not horizontally. 1762 */ 1763 private View mTitleBar; 1764 1765 /** 1766 * Since we draw the title bar ourselves, we removed the shadow from the 1767 * browser's activity. We do want a shadow at the bottom of the title bar, 1768 * or at the top of the screen if the title bar is not visible. This 1769 * drawable serves that purpose. 1770 */ 1771 private Drawable mTitleShadow; 1772 1773 /** 1774 * Add or remove a title bar to be embedded into the WebView, and scroll 1775 * along with it vertically, while remaining in view horizontally. Pass 1776 * null to remove the title bar from the WebView, and return to drawing 1777 * the WebView normally without translating to account for the title bar. 1778 * @hide 1779 */ 1780 public void setEmbeddedTitleBar(View v) { 1781 if (mTitleBar == v) return; 1782 if (mTitleBar != null) { 1783 removeView(mTitleBar); 1784 } 1785 if (null != v) { 1786 addView(v, new AbsoluteLayout.LayoutParams( 1787 ViewGroup.LayoutParams.FILL_PARENT, 1788 ViewGroup.LayoutParams.WRAP_CONTENT, 0, 0)); 1789 if (mTitleShadow == null) { 1790 mTitleShadow = (Drawable) mContext.getResources().getDrawable( 1791 com.android.internal.R.drawable.title_bar_shadow); 1792 } 1793 } 1794 mTitleBar = v; 1795 } 1796 1797 /** 1798 * Given a distance in view space, convert it to content space. Note: this 1799 * does not reflect translation, just scaling, so this should not be called 1800 * with coordinates, but should be called for dimensions like width or 1801 * height. 1802 */ 1803 private int viewToContentDimension(int d) { 1804 return Math.round(d * mInvActualScale); 1805 } 1806 1807 /** 1808 * Given an x coordinate in view space, convert it to content space. Also 1809 * may be used for absolute heights (such as for the WebTextView's 1810 * textSize, which is unaffected by the height of the title bar). 1811 */ 1812 /*package*/ int viewToContentX(int x) { 1813 return viewToContentDimension(x); 1814 } 1815 1816 /** 1817 * Given a y coordinate in view space, convert it to content space. 1818 * Takes into account the height of the title bar if there is one 1819 * embedded into the WebView. 1820 */ 1821 /*package*/ int viewToContentY(int y) { 1822 return viewToContentDimension(y - getTitleHeight()); 1823 } 1824 1825 /** 1826 * Given a distance in content space, convert it to view space. Note: this 1827 * does not reflect translation, just scaling, so this should not be called 1828 * with coordinates, but should be called for dimensions like width or 1829 * height. 1830 */ 1831 /*package*/ int contentToViewDimension(int d) { 1832 return Math.round(d * mActualScale); 1833 } 1834 1835 /** 1836 * Given an x coordinate in content space, convert it to view 1837 * space. 1838 */ 1839 /*package*/ int contentToViewX(int x) { 1840 return contentToViewDimension(x); 1841 } 1842 1843 /** 1844 * Given a y coordinate in content space, convert it to view 1845 * space. Takes into account the height of the title bar. 1846 */ 1847 /*package*/ int contentToViewY(int y) { 1848 return contentToViewDimension(y) + getTitleHeight(); 1849 } 1850 1851 private Rect contentToViewRect(Rect x) { 1852 return new Rect(contentToViewX(x.left), contentToViewY(x.top), 1853 contentToViewX(x.right), contentToViewY(x.bottom)); 1854 } 1855 1856 /* To invalidate a rectangle in content coordinates, we need to transform 1857 the rect into view coordinates, so we can then call invalidate(...). 1858 1859 Normally, we would just call contentToView[XY](...), which eventually 1860 calls Math.round(coordinate * mActualScale). However, for invalidates, 1861 we need to account for the slop that occurs with antialiasing. To 1862 address that, we are a little more liberal in the size of the rect that 1863 we invalidate. 1864 1865 This liberal calculation calls floor() for the top/left, and ceil() for 1866 the bottom/right coordinates. This catches the possible extra pixels of 1867 antialiasing that we might have missed with just round(). 1868 */ 1869 1870 // Called by JNI to invalidate the View, given rectangle coordinates in 1871 // content space 1872 private void viewInvalidate(int l, int t, int r, int b) { 1873 final float scale = mActualScale; 1874 final int dy = getTitleHeight(); 1875 invalidate((int)Math.floor(l * scale), 1876 (int)Math.floor(t * scale) + dy, 1877 (int)Math.ceil(r * scale), 1878 (int)Math.ceil(b * scale) + dy); 1879 } 1880 1881 // Called by JNI to invalidate the View after a delay, given rectangle 1882 // coordinates in content space 1883 private void viewInvalidateDelayed(long delay, int l, int t, int r, int b) { 1884 final float scale = mActualScale; 1885 final int dy = getTitleHeight(); 1886 postInvalidateDelayed(delay, 1887 (int)Math.floor(l * scale), 1888 (int)Math.floor(t * scale) + dy, 1889 (int)Math.ceil(r * scale), 1890 (int)Math.ceil(b * scale) + dy); 1891 } 1892 1893 private void invalidateContentRect(Rect r) { 1894 viewInvalidate(r.left, r.top, r.right, r.bottom); 1895 } 1896 1897 // stop the scroll animation, and don't let a subsequent fling add 1898 // to the existing velocity 1899 private void abortAnimation() { 1900 mScroller.abortAnimation(); 1901 mLastVelocity = 0; 1902 } 1903 1904 /* call from webcoreview.draw(), so we're still executing in the UI thread 1905 */ 1906 private void recordNewContentSize(int w, int h, boolean updateLayout) { 1907 1908 // premature data from webkit, ignore 1909 if ((w | h) == 0) { 1910 return; 1911 } 1912 1913 // don't abort a scroll animation if we didn't change anything 1914 if (mContentWidth != w || mContentHeight != h) { 1915 // record new dimensions 1916 mContentWidth = w; 1917 mContentHeight = h; 1918 // If history Picture is drawn, don't update scroll. They will be 1919 // updated when we get out of that mode. 1920 if (!mDrawHistory) { 1921 // repin our scroll, taking into account the new content size 1922 int oldX = mScrollX; 1923 int oldY = mScrollY; 1924 mScrollX = pinLocX(mScrollX); 1925 mScrollY = pinLocY(mScrollY); 1926 if (oldX != mScrollX || oldY != mScrollY) { 1927 sendOurVisibleRect(); 1928 } 1929 if (!mScroller.isFinished()) { 1930 // We are in the middle of a scroll. Repin the final scroll 1931 // position. 1932 mScroller.setFinalX(pinLocX(mScroller.getFinalX())); 1933 mScroller.setFinalY(pinLocY(mScroller.getFinalY())); 1934 } 1935 } 1936 } 1937 contentSizeChanged(updateLayout); 1938 } 1939 1940 private void setNewZoomScale(float scale, boolean force) { 1941 if (scale < mMinZoomScale) { 1942 scale = mMinZoomScale; 1943 } else if (scale > mMaxZoomScale) { 1944 scale = mMaxZoomScale; 1945 } 1946 if (scale != mActualScale || force) { 1947 if (mDrawHistory) { 1948 // If history Picture is drawn, don't update scroll. They will 1949 // be updated when we get out of that mode. 1950 if (scale != mActualScale && !mPreviewZoomOnly) { 1951 mCallbackProxy.onScaleChanged(mActualScale, scale); 1952 } 1953 mActualScale = scale; 1954 mInvActualScale = 1 / scale; 1955 if (!mPreviewZoomOnly) { 1956 sendViewSizeZoom(); 1957 } 1958 } else { 1959 // update our scroll so we don't appear to jump 1960 // i.e. keep the center of the doc in the center of the view 1961 1962 int oldX = mScrollX; 1963 int oldY = mScrollY; 1964 float ratio = scale * mInvActualScale; // old inverse 1965 float sx = ratio * oldX + (ratio - 1) * mZoomCenterX; 1966 float sy = ratio * oldY + (ratio - 1) 1967 * (mZoomCenterY - getTitleHeight()); 1968 1969 // now update our new scale and inverse 1970 if (scale != mActualScale && !mPreviewZoomOnly) { 1971 mCallbackProxy.onScaleChanged(mActualScale, scale); 1972 } 1973 mActualScale = scale; 1974 mInvActualScale = 1 / scale; 1975 1976 // Scale all the child views 1977 mViewManager.scaleAll(); 1978 1979 // as we don't have animation for scaling, don't do animation 1980 // for scrolling, as it causes weird intermediate state 1981 // pinScrollTo(Math.round(sx), Math.round(sy)); 1982 mScrollX = pinLocX(Math.round(sx)); 1983 mScrollY = pinLocY(Math.round(sy)); 1984 1985 if (!mPreviewZoomOnly) { 1986 sendViewSizeZoom(); 1987 sendOurVisibleRect(); 1988 } 1989 } 1990 } 1991 } 1992 1993 // Used to avoid sending many visible rect messages. 1994 private Rect mLastVisibleRectSent; 1995 private Rect mLastGlobalRect; 1996 1997 private Rect sendOurVisibleRect() { 1998 Rect rect = new Rect(); 1999 calcOurContentVisibleRect(rect); 2000 // Rect.equals() checks for null input. 2001 if (!rect.equals(mLastVisibleRectSent)) { 2002 Point pos = new Point(rect.left, rect.top); 2003 mWebViewCore.sendMessage(EventHub.SET_SCROLL_OFFSET, 2004 nativeMoveGeneration(), 0, pos); 2005 mLastVisibleRectSent = rect; 2006 } 2007 Rect globalRect = new Rect(); 2008 if (getGlobalVisibleRect(globalRect) 2009 && !globalRect.equals(mLastGlobalRect)) { 2010 if (DebugFlags.WEB_VIEW) { 2011 Log.v(LOGTAG, "sendOurVisibleRect=(" + globalRect.left + "," 2012 + globalRect.top + ",r=" + globalRect.right + ",b=" 2013 + globalRect.bottom); 2014 } 2015 // TODO: the global offset is only used by windowRect() 2016 // in ChromeClientAndroid ; other clients such as touch 2017 // and mouse events could return view + screen relative points. 2018 mWebViewCore.sendMessage(EventHub.SET_GLOBAL_BOUNDS, globalRect); 2019 mLastGlobalRect = globalRect; 2020 } 2021 return rect; 2022 } 2023 2024 // Sets r to be the visible rectangle of our webview in view coordinates 2025 private void calcOurVisibleRect(Rect r) { 2026 Point p = new Point(); 2027 getGlobalVisibleRect(r, p); 2028 r.offset(-p.x, -p.y); 2029 if (mFindIsUp) { 2030 r.bottom -= mFindHeight; 2031 } 2032 } 2033 2034 // Sets r to be our visible rectangle in content coordinates 2035 private void calcOurContentVisibleRect(Rect r) { 2036 calcOurVisibleRect(r); 2037 r.left = viewToContentX(r.left); 2038 // viewToContentY will remove the total height of the title bar. Add 2039 // the visible height back in to account for the fact that if the title 2040 // bar is partially visible, the part of the visible rect which is 2041 // displaying our content is displaced by that amount. 2042 r.top = viewToContentY(r.top + getVisibleTitleHeight()); 2043 r.right = viewToContentX(r.right); 2044 r.bottom = viewToContentY(r.bottom); 2045 } 2046 2047 static class ViewSizeData { 2048 int mWidth; 2049 int mHeight; 2050 int mTextWrapWidth; 2051 float mScale; 2052 boolean mIgnoreHeight; 2053 } 2054 2055 /** 2056 * Compute unzoomed width and height, and if they differ from the last 2057 * values we sent, send them to webkit (to be used has new viewport) 2058 * 2059 * @return true if new values were sent 2060 */ 2061 private boolean sendViewSizeZoom() { 2062 int viewWidth = getViewWidth(); 2063 int newWidth = Math.round(viewWidth * mInvActualScale); 2064 int newHeight = Math.round(getViewHeight() * mInvActualScale); 2065 /* 2066 * Because the native side may have already done a layout before the 2067 * View system was able to measure us, we have to send a height of 0 to 2068 * remove excess whitespace when we grow our width. This will trigger a 2069 * layout and a change in content size. This content size change will 2070 * mean that contentSizeChanged will either call this method directly or 2071 * indirectly from onSizeChanged. 2072 */ 2073 if (newWidth > mLastWidthSent && mWrapContent) { 2074 newHeight = 0; 2075 } 2076 // Avoid sending another message if the dimensions have not changed. 2077 if (newWidth != mLastWidthSent || newHeight != mLastHeightSent) { 2078 ViewSizeData data = new ViewSizeData(); 2079 data.mWidth = newWidth; 2080 data.mHeight = newHeight; 2081 // while in zoom overview mode, the text are wrapped to the screen 2082 // width matching mLastScale. So that we don't trigger re-flow while 2083 // toggling between overview mode and normal mode. 2084 data.mTextWrapWidth = mInZoomOverview ? Math.round(viewWidth 2085 / mLastScale) : newWidth; 2086 data.mScale = mActualScale; 2087 data.mIgnoreHeight = mZoomScale != 0 && !mHeightCanMeasure; 2088 mWebViewCore.sendMessage(EventHub.VIEW_SIZE_CHANGED, data); 2089 mLastWidthSent = newWidth; 2090 mLastHeightSent = newHeight; 2091 return true; 2092 } 2093 return false; 2094 } 2095 2096 @Override 2097 protected int computeHorizontalScrollRange() { 2098 if (mDrawHistory) { 2099 return mHistoryWidth; 2100 } else { 2101 // to avoid rounding error caused unnecessary scrollbar, use floor 2102 return (int) Math.floor(mContentWidth * mActualScale); 2103 } 2104 } 2105 2106 @Override 2107 protected int computeVerticalScrollRange() { 2108 if (mDrawHistory) { 2109 return mHistoryHeight; 2110 } else { 2111 // to avoid rounding error caused unnecessary scrollbar, use floor 2112 return (int) Math.floor(mContentHeight * mActualScale); 2113 } 2114 } 2115 2116 @Override 2117 protected int computeVerticalScrollOffset() { 2118 return Math.max(mScrollY - getTitleHeight(), 0); 2119 } 2120 2121 @Override 2122 protected int computeVerticalScrollExtent() { 2123 return getViewHeight(); 2124 } 2125 2126 /** @hide */ 2127 @Override 2128 protected void onDrawVerticalScrollBar(Canvas canvas, 2129 Drawable scrollBar, 2130 int l, int t, int r, int b) { 2131 scrollBar.setBounds(l, t + getVisibleTitleHeight(), r, b); 2132 scrollBar.draw(canvas); 2133 } 2134 2135 /** 2136 * Get the url for the current page. This is not always the same as the url 2137 * passed to WebViewClient.onPageStarted because although the load for 2138 * that url has begun, the current page may not have changed. 2139 * @return The url for the current page. 2140 */ 2141 public String getUrl() { 2142 WebHistoryItem h = mCallbackProxy.getBackForwardList().getCurrentItem(); 2143 return h != null ? h.getUrl() : null; 2144 } 2145 2146 /** 2147 * Get the original url for the current page. This is not always the same 2148 * as the url passed to WebViewClient.onPageStarted because although the 2149 * load for that url has begun, the current page may not have changed. 2150 * Also, there may have been redirects resulting in a different url to that 2151 * originally requested. 2152 * @return The url that was originally requested for the current page. 2153 */ 2154 public String getOriginalUrl() { 2155 WebHistoryItem h = mCallbackProxy.getBackForwardList().getCurrentItem(); 2156 return h != null ? h.getOriginalUrl() : null; 2157 } 2158 2159 /** 2160 * Get the title for the current page. This is the title of the current page 2161 * until WebViewClient.onReceivedTitle is called. 2162 * @return The title for the current page. 2163 */ 2164 public String getTitle() { 2165 WebHistoryItem h = mCallbackProxy.getBackForwardList().getCurrentItem(); 2166 return h != null ? h.getTitle() : null; 2167 } 2168 2169 /** 2170 * Get the favicon for the current page. This is the favicon of the current 2171 * page until WebViewClient.onReceivedIcon is called. 2172 * @return The favicon for the current page. 2173 */ 2174 public Bitmap getFavicon() { 2175 WebHistoryItem h = mCallbackProxy.getBackForwardList().getCurrentItem(); 2176 return h != null ? h.getFavicon() : null; 2177 } 2178 2179 /** 2180 * Get the touch icon url for the apple-touch-icon <link> element. 2181 * @hide 2182 */ 2183 public String getTouchIconUrl() { 2184 WebHistoryItem h = mCallbackProxy.getBackForwardList().getCurrentItem(); 2185 return h != null ? h.getTouchIconUrl() : null; 2186 } 2187 2188 /** 2189 * Get the progress for the current page. 2190 * @return The progress for the current page between 0 and 100. 2191 */ 2192 public int getProgress() { 2193 return mCallbackProxy.getProgress(); 2194 } 2195 2196 /** 2197 * @return the height of the HTML content. 2198 */ 2199 public int getContentHeight() { 2200 return mContentHeight; 2201 } 2202 2203 /** 2204 * @return the width of the HTML content. 2205 * @hide 2206 */ 2207 public int getContentWidth() { 2208 return mContentWidth; 2209 } 2210 2211 /** 2212 * Pause all layout, parsing, and javascript timers for all webviews. This 2213 * is a global requests, not restricted to just this webview. This can be 2214 * useful if the application has been paused. 2215 */ 2216 public void pauseTimers() { 2217 mWebViewCore.sendMessage(EventHub.PAUSE_TIMERS); 2218 } 2219 2220 /** 2221 * Resume all layout, parsing, and javascript timers for all webviews. 2222 * This will resume dispatching all timers. 2223 */ 2224 public void resumeTimers() { 2225 mWebViewCore.sendMessage(EventHub.RESUME_TIMERS); 2226 } 2227 2228 /** 2229 * Call this to pause any extra processing associated with this view and 2230 * its associated DOM/plugins/javascript/etc. For example, if the view is 2231 * taken offscreen, this could be called to reduce unnecessary CPU and/or 2232 * network traffic. When the view is again "active", call onResume(). 2233 * 2234 * Note that this differs from pauseTimers(), which affects all views/DOMs 2235 * @hide 2236 */ 2237 public void onPause() { 2238 if (!mIsPaused) { 2239 mIsPaused = true; 2240 mWebViewCore.sendMessage(EventHub.ON_PAUSE); 2241 } 2242 } 2243 2244 /** 2245 * Call this to balanace a previous call to onPause() 2246 * @hide 2247 */ 2248 public void onResume() { 2249 if (mIsPaused) { 2250 mIsPaused = false; 2251 mWebViewCore.sendMessage(EventHub.ON_RESUME); 2252 } 2253 } 2254 2255 /** 2256 * Returns true if the view is paused, meaning onPause() was called. Calling 2257 * onResume() sets the paused state back to false. 2258 * @hide 2259 */ 2260 public boolean isPaused() { 2261 return mIsPaused; 2262 } 2263 2264 /** 2265 * Call this to inform the view that memory is low so that it can 2266 * free any available memory. 2267 * @hide 2268 */ 2269 public void freeMemory() { 2270 mWebViewCore.sendMessage(EventHub.FREE_MEMORY); 2271 } 2272 2273 /** 2274 * Clear the resource cache. Note that the cache is per-application, so 2275 * this will clear the cache for all WebViews used. 2276 * 2277 * @param includeDiskFiles If false, only the RAM cache is cleared. 2278 */ 2279 public void clearCache(boolean includeDiskFiles) { 2280 // Note: this really needs to be a static method as it clears cache for all 2281 // WebView. But we need mWebViewCore to send message to WebCore thread, so 2282 // we can't make this static. 2283 mWebViewCore.sendMessage(EventHub.CLEAR_CACHE, 2284 includeDiskFiles ? 1 : 0, 0); 2285 } 2286 2287 /** 2288 * Make sure that clearing the form data removes the adapter from the 2289 * currently focused textfield if there is one. 2290 */ 2291 public void clearFormData() { 2292 if (inEditingMode()) { 2293 AutoCompleteAdapter adapter = null; 2294 mWebTextView.setAdapterCustom(adapter); 2295 } 2296 } 2297 2298 /** 2299 * Tell the WebView to clear its internal back/forward list. 2300 */ 2301 public void clearHistory() { 2302 mCallbackProxy.getBackForwardList().setClearPending(); 2303 mWebViewCore.sendMessage(EventHub.CLEAR_HISTORY); 2304 } 2305 2306 /** 2307 * Clear the SSL preferences table stored in response to proceeding with SSL 2308 * certificate errors. 2309 */ 2310 public void clearSslPreferences() { 2311 mWebViewCore.sendMessage(EventHub.CLEAR_SSL_PREF_TABLE); 2312 } 2313 2314 /** 2315 * Return the WebBackForwardList for this WebView. This contains the 2316 * back/forward list for use in querying each item in the history stack. 2317 * This is a copy of the private WebBackForwardList so it contains only a 2318 * snapshot of the current state. Multiple calls to this method may return 2319 * different objects. The object returned from this method will not be 2320 * updated to reflect any new state. 2321 */ 2322 public WebBackForwardList copyBackForwardList() { 2323 return mCallbackProxy.getBackForwardList().clone(); 2324 } 2325 2326 /* 2327 * Highlight and scroll to the next occurance of String in findAll. 2328 * Wraps the page infinitely, and scrolls. Must be called after 2329 * calling findAll. 2330 * 2331 * @param forward Direction to search. 2332 */ 2333 public void findNext(boolean forward) { 2334 nativeFindNext(forward); 2335 } 2336 2337 /* 2338 * Find all instances of find on the page and highlight them. 2339 * @param find String to find. 2340 * @return int The number of occurances of the String "find" 2341 * that were found. 2342 */ 2343 public int findAll(String find) { 2344 if (mFindIsUp == false) { 2345 recordNewContentSize(mContentWidth, mContentHeight + mFindHeight, 2346 false); 2347 mFindIsUp = true; 2348 } 2349 int result = nativeFindAll(find.toLowerCase(), find.toUpperCase()); 2350 invalidate(); 2351 return result; 2352 } 2353 2354 // Used to know whether the find dialog is open. Affects whether 2355 // or not we draw the highlights for matches. 2356 private boolean mFindIsUp; 2357 private int mFindHeight; 2358 2359 /** 2360 * Return the first substring consisting of the address of a physical 2361 * location. Currently, only addresses in the United States are detected, 2362 * and consist of: 2363 * - a house number 2364 * - a street name 2365 * - a street type (Road, Circle, etc), either spelled out or abbreviated 2366 * - a city name 2367 * - a state or territory, either spelled out or two-letter abbr. 2368 * - an optional 5 digit or 9 digit zip code. 2369 * 2370 * All names must be correctly capitalized, and the zip code, if present, 2371 * must be valid for the state. The street type must be a standard USPS 2372 * spelling or abbreviation. The state or territory must also be spelled 2373 * or abbreviated using USPS standards. The house number may not exceed 2374 * five digits. 2375 * @param addr The string to search for addresses. 2376 * 2377 * @return the address, or if no address is found, return null. 2378 */ 2379 public static String findAddress(String addr) { 2380 return findAddress(addr, false); 2381 } 2382 2383 /** 2384 * @hide 2385 * Return the first substring consisting of the address of a physical 2386 * location. Currently, only addresses in the United States are detected, 2387 * and consist of: 2388 * - a house number 2389 * - a street name 2390 * - a street type (Road, Circle, etc), either spelled out or abbreviated 2391 * - a city name 2392 * - a state or territory, either spelled out or two-letter abbr. 2393 * - an optional 5 digit or 9 digit zip code. 2394 * 2395 * Names are optionally capitalized, and the zip code, if present, 2396 * must be valid for the state. The street type must be a standard USPS 2397 * spelling or abbreviation. The state or territory must also be spelled 2398 * or abbreviated using USPS standards. The house number may not exceed 2399 * five digits. 2400 * @param addr The string to search for addresses. 2401 * @param caseInsensitive addr Set to true to make search ignore case. 2402 * 2403 * @return the address, or if no address is found, return null. 2404 */ 2405 public static String findAddress(String addr, boolean caseInsensitive) { 2406 return WebViewCore.nativeFindAddress(addr, caseInsensitive); 2407 } 2408 2409 /* 2410 * Clear the highlighting surrounding text matches created by findAll. 2411 */ 2412 public void clearMatches() { 2413 if (mFindIsUp) { 2414 recordNewContentSize(mContentWidth, mContentHeight - mFindHeight, 2415 false); 2416 mFindIsUp = false; 2417 } 2418 nativeSetFindIsDown(); 2419 // Now that the dialog has been removed, ensure that we scroll to a 2420 // location that is not beyond the end of the page. 2421 pinScrollTo(mScrollX, mScrollY, false, 0); 2422 invalidate(); 2423 } 2424 2425 /** 2426 * @hide 2427 */ 2428 public void setFindDialogHeight(int height) { 2429 if (DebugFlags.WEB_VIEW) { 2430 Log.v(LOGTAG, "setFindDialogHeight height=" + height); 2431 } 2432 mFindHeight = height; 2433 } 2434 2435 /** 2436 * Query the document to see if it contains any image references. The 2437 * message object will be dispatched with arg1 being set to 1 if images 2438 * were found and 0 if the document does not reference any images. 2439 * @param response The message that will be dispatched with the result. 2440 */ 2441 public void documentHasImages(Message response) { 2442 if (response == null) { 2443 return; 2444 } 2445 mWebViewCore.sendMessage(EventHub.DOC_HAS_IMAGES, response); 2446 } 2447 2448 @Override 2449 public void computeScroll() { 2450 if (mScroller.computeScrollOffset()) { 2451 int oldX = mScrollX; 2452 int oldY = mScrollY; 2453 mScrollX = mScroller.getCurrX(); 2454 mScrollY = mScroller.getCurrY(); 2455 postInvalidate(); // So we draw again 2456 if (oldX != mScrollX || oldY != mScrollY) { 2457 // as onScrollChanged() is not called, sendOurVisibleRect() 2458 // needs to be call explicitly 2459 sendOurVisibleRect(); 2460 } 2461 } else { 2462 super.computeScroll(); 2463 } 2464 } 2465 2466 private static int computeDuration(int dx, int dy) { 2467 int distance = Math.max(Math.abs(dx), Math.abs(dy)); 2468 int duration = distance * 1000 / STD_SPEED; 2469 return Math.min(duration, MAX_DURATION); 2470 } 2471 2472 // helper to pin the scrollBy parameters (already in view coordinates) 2473 // returns true if the scroll was changed 2474 private boolean pinScrollBy(int dx, int dy, boolean animate, int animationDuration) { 2475 return pinScrollTo(mScrollX + dx, mScrollY + dy, animate, animationDuration); 2476 } 2477 // helper to pin the scrollTo parameters (already in view coordinates) 2478 // returns true if the scroll was changed 2479 private boolean pinScrollTo(int x, int y, boolean animate, int animationDuration) { 2480 x = pinLocX(x); 2481 y = pinLocY(y); 2482 int dx = x - mScrollX; 2483 int dy = y - mScrollY; 2484 2485 if ((dx | dy) == 0) { 2486 return false; 2487 } 2488 if (animate) { 2489 // Log.d(LOGTAG, "startScroll: " + dx + " " + dy); 2490 mScroller.startScroll(mScrollX, mScrollY, dx, dy, 2491 animationDuration > 0 ? animationDuration : computeDuration(dx, dy)); 2492 awakenScrollBars(mScroller.getDuration()); 2493 invalidate(); 2494 } else { 2495 abortAnimation(); // just in case 2496 scrollTo(x, y); 2497 } 2498 return true; 2499 } 2500 2501 // Scale from content to view coordinates, and pin. 2502 // Also called by jni webview.cpp 2503 private boolean setContentScrollBy(int cx, int cy, boolean animate) { 2504 if (mDrawHistory) { 2505 // disallow WebView to change the scroll position as History Picture 2506 // is used in the view system. 2507 // TODO: as we switchOutDrawHistory when trackball or navigation 2508 // keys are hit, this should be safe. Right? 2509 return false; 2510 } 2511 cx = contentToViewDimension(cx); 2512 cy = contentToViewDimension(cy); 2513 if (mHeightCanMeasure) { 2514 // move our visible rect according to scroll request 2515 if (cy != 0) { 2516 Rect tempRect = new Rect(); 2517 calcOurVisibleRect(tempRect); 2518 tempRect.offset(cx, cy); 2519 requestRectangleOnScreen(tempRect); 2520 } 2521 // FIXME: We scroll horizontally no matter what because currently 2522 // ScrollView and ListView will not scroll horizontally. 2523 // FIXME: Why do we only scroll horizontally if there is no 2524 // vertical scroll? 2525// Log.d(LOGTAG, "setContentScrollBy cy=" + cy); 2526 return cy == 0 && cx != 0 && pinScrollBy(cx, 0, animate, 0); 2527 } else { 2528 return pinScrollBy(cx, cy, animate, 0); 2529 } 2530 } 2531 2532 // scale from content to view coordinates, and pin 2533 // return true if pin caused the final x/y different than the request cx/cy, 2534 // and a future scroll may reach the request cx/cy after our size has 2535 // changed 2536 // return false if the view scroll to the exact position as it is requested, 2537 // where negative numbers are taken to mean 0 2538 private boolean setContentScrollTo(int cx, int cy) { 2539 if (mDrawHistory) { 2540 // disallow WebView to change the scroll position as History Picture 2541 // is used in the view system. 2542 // One known case where this is called is that WebCore tries to 2543 // restore the scroll position. As history Picture already uses the 2544 // saved scroll position, it is ok to skip this. 2545 return false; 2546 } 2547 int vx; 2548 int vy; 2549 if ((cx | cy) == 0) { 2550 // If the page is being scrolled to (0,0), do not add in the title 2551 // bar's height, and simply scroll to (0,0). (The only other work 2552 // in contentToView_ is to multiply, so this would not change 0.) 2553 vx = 0; 2554 vy = 0; 2555 } else { 2556 vx = contentToViewX(cx); 2557 vy = contentToViewY(cy); 2558 } 2559// Log.d(LOGTAG, "content scrollTo [" + cx + " " + cy + "] view=[" + 2560// vx + " " + vy + "]"); 2561 // Some mobile sites attempt to scroll the title bar off the page by 2562 // scrolling to (0,1). If we are at the top left corner of the 2563 // page, assume this is an attempt to scroll off the title bar, and 2564 // animate the title bar off screen slowly enough that the user can see 2565 // it. 2566 if (cx == 0 && cy == 1 && mScrollX == 0 && mScrollY == 0) { 2567 pinScrollTo(vx, vy, true, SLIDE_TITLE_DURATION); 2568 // Since we are animating, we have not yet reached the desired 2569 // scroll position. Do not return true to request another attempt 2570 return false; 2571 } 2572 pinScrollTo(vx, vy, false, 0); 2573 // If the request was to scroll to a negative coordinate, treat it as if 2574 // it was a request to scroll to 0 2575 if ((mScrollX != vx && cx >= 0) || (mScrollY != vy && cy >= 0)) { 2576 return true; 2577 } else { 2578 return false; 2579 } 2580 } 2581 2582 // scale from content to view coordinates, and pin 2583 private void spawnContentScrollTo(int cx, int cy) { 2584 if (mDrawHistory) { 2585 // disallow WebView to change the scroll position as History Picture 2586 // is used in the view system. 2587 return; 2588 } 2589 int vx = contentToViewX(cx); 2590 int vy = contentToViewY(cy); 2591 pinScrollTo(vx, vy, true, 0); 2592 } 2593 2594 /** 2595 * These are from webkit, and are in content coordinate system (unzoomed) 2596 */ 2597 private void contentSizeChanged(boolean updateLayout) { 2598 // suppress 0,0 since we usually see real dimensions soon after 2599 // this avoids drawing the prev content in a funny place. If we find a 2600 // way to consolidate these notifications, this check may become 2601 // obsolete 2602 if ((mContentWidth | mContentHeight) == 0) { 2603 return; 2604 } 2605 2606 if (mHeightCanMeasure) { 2607 if (getMeasuredHeight() != contentToViewDimension(mContentHeight) 2608 && updateLayout) { 2609 requestLayout(); 2610 } 2611 } else if (mWidthCanMeasure) { 2612 if (getMeasuredWidth() != contentToViewDimension(mContentWidth) 2613 && updateLayout) { 2614 requestLayout(); 2615 } 2616 } else { 2617 // If we don't request a layout, try to send our view size to the 2618 // native side to ensure that WebCore has the correct dimensions. 2619 sendViewSizeZoom(); 2620 } 2621 } 2622 2623 /** 2624 * Set the WebViewClient that will receive various notifications and 2625 * requests. This will replace the current handler. 2626 * @param client An implementation of WebViewClient. 2627 */ 2628 public void setWebViewClient(WebViewClient client) { 2629 mCallbackProxy.setWebViewClient(client); 2630 } 2631 2632 /** 2633 * Register the interface to be used when content can not be handled by 2634 * the rendering engine, and should be downloaded instead. This will replace 2635 * the current handler. 2636 * @param listener An implementation of DownloadListener. 2637 */ 2638 public void setDownloadListener(DownloadListener listener) { 2639 mCallbackProxy.setDownloadListener(listener); 2640 } 2641 2642 /** 2643 * Set the chrome handler. This is an implementation of WebChromeClient for 2644 * use in handling Javascript dialogs, favicons, titles, and the progress. 2645 * This will replace the current handler. 2646 * @param client An implementation of WebChromeClient. 2647 */ 2648 public void setWebChromeClient(WebChromeClient client) { 2649 mCallbackProxy.setWebChromeClient(client); 2650 } 2651 2652 /** 2653 * Gets the chrome handler. 2654 * @return the current WebChromeClient instance. 2655 * 2656 * @hide API council approval. 2657 */ 2658 public WebChromeClient getWebChromeClient() { 2659 return mCallbackProxy.getWebChromeClient(); 2660 } 2661 2662 /** 2663 * Set the Picture listener. This is an interface used to receive 2664 * notifications of a new Picture. 2665 * @param listener An implementation of WebView.PictureListener. 2666 */ 2667 public void setPictureListener(PictureListener listener) { 2668 mPictureListener = listener; 2669 } 2670 2671 /** 2672 * {@hide} 2673 */ 2674 /* FIXME: Debug only! Remove for SDK! */ 2675 public void externalRepresentation(Message callback) { 2676 mWebViewCore.sendMessage(EventHub.REQUEST_EXT_REPRESENTATION, callback); 2677 } 2678 2679 /** 2680 * {@hide} 2681 */ 2682 /* FIXME: Debug only! Remove for SDK! */ 2683 public void documentAsText(Message callback) { 2684 mWebViewCore.sendMessage(EventHub.REQUEST_DOC_AS_TEXT, callback); 2685 } 2686 2687 /** 2688 * Use this function to bind an object to Javascript so that the 2689 * methods can be accessed from Javascript. 2690 * <p><strong>IMPORTANT:</strong> 2691 * <ul> 2692 * <li> Using addJavascriptInterface() allows JavaScript to control your 2693 * application. This can be a very useful feature or a dangerous security 2694 * issue. When the HTML in the WebView is untrustworthy (for example, part 2695 * or all of the HTML is provided by some person or process), then an 2696 * attacker could inject HTML that will execute your code and possibly any 2697 * code of the attacker's choosing.<br> 2698 * Do not use addJavascriptInterface() unless all of the HTML in this 2699 * WebView was written by you.</li> 2700 * <li> The Java object that is bound runs in another thread and not in 2701 * the thread that it was constructed in.</li> 2702 * </ul></p> 2703 * @param obj The class instance to bind to Javascript 2704 * @param interfaceName The name to used to expose the class in Javascript 2705 */ 2706 public void addJavascriptInterface(Object obj, String interfaceName) { 2707 WebViewCore.JSInterfaceData arg = new WebViewCore.JSInterfaceData(); 2708 arg.mObject = obj; 2709 arg.mInterfaceName = interfaceName; 2710 mWebViewCore.sendMessage(EventHub.ADD_JS_INTERFACE, arg); 2711 } 2712 2713 /** 2714 * Return the WebSettings object used to control the settings for this 2715 * WebView. 2716 * @return A WebSettings object that can be used to control this WebView's 2717 * settings. 2718 */ 2719 public WebSettings getSettings() { 2720 return mWebViewCore.getSettings(); 2721 } 2722 2723 /** 2724 * Return the list of currently loaded plugins. 2725 * @return The list of currently loaded plugins. 2726 * 2727 * @deprecated This was used for Gears, which has been deprecated. 2728 */ 2729 @Deprecated 2730 public static synchronized PluginList getPluginList() { 2731 return null; 2732 } 2733 2734 /** 2735 * @deprecated This was used for Gears, which has been deprecated. 2736 */ 2737 @Deprecated 2738 public void refreshPlugins(boolean reloadOpenPages) { } 2739 2740 //------------------------------------------------------------------------- 2741 // Override View methods 2742 //------------------------------------------------------------------------- 2743 2744 @Override 2745 protected void finalize() throws Throwable { 2746 try { 2747 destroy(); 2748 } finally { 2749 super.finalize(); 2750 } 2751 } 2752 2753 @Override 2754 protected boolean drawChild(Canvas canvas, View child, long drawingTime) { 2755 if (child == mTitleBar) { 2756 // When drawing the title bar, move it horizontally to always show 2757 // at the top of the WebView. 2758 mTitleBar.offsetLeftAndRight(mScrollX - mTitleBar.getLeft()); 2759 } 2760 return super.drawChild(canvas, child, drawingTime); 2761 } 2762 2763 @Override 2764 protected void onDraw(Canvas canvas) { 2765 // if mNativeClass is 0, the WebView has been destroyed. Do nothing. 2766 if (mNativeClass == 0) { 2767 return; 2768 } 2769 int saveCount = canvas.save(); 2770 if (mTitleBar != null) { 2771 canvas.translate(0, (int) mTitleBar.getHeight()); 2772 } 2773 // Update the buttons in the picture, so when we draw the picture 2774 // to the screen, they are in the correct state. 2775 // Tell the native side if user is a) touching the screen, 2776 // b) pressing the trackball down, or c) pressing the enter key 2777 // If the cursor is on a button, we need to draw it in the pressed 2778 // state. 2779 // If mNativeClass is 0, we should not reach here, so we do not 2780 // need to check it again. 2781 nativeRecordButtons(hasFocus() && hasWindowFocus(), 2782 mTouchMode == TOUCH_SHORTPRESS_START_MODE 2783 || mTrackballDown || mGotCenterDown, false); 2784 drawCoreAndCursorRing(canvas, mBackgroundColor, mDrawCursorRing); 2785 canvas.restoreToCount(saveCount); 2786 2787 // Now draw the shadow. 2788 if (mTitleBar != null) { 2789 int y = mScrollY + getVisibleTitleHeight(); 2790 int height = (int) (5f * getContext().getResources() 2791 .getDisplayMetrics().density); 2792 mTitleShadow.setBounds(mScrollX, y, mScrollX + getWidth(), 2793 y + height); 2794 mTitleShadow.draw(canvas); 2795 } 2796 if (AUTO_REDRAW_HACK && mAutoRedraw) { 2797 invalidate(); 2798 } 2799 } 2800 2801 @Override 2802 public void setLayoutParams(ViewGroup.LayoutParams params) { 2803 if (params.height == LayoutParams.WRAP_CONTENT) { 2804 mWrapContent = true; 2805 } 2806 super.setLayoutParams(params); 2807 } 2808 2809 @Override 2810 public boolean performLongClick() { 2811 if (mNativeClass != 0 && nativeCursorIsTextInput()) { 2812 // Send the click so that the textfield is in focus 2813 // FIXME: When we start respecting changes to the native textfield's 2814 // selection, need to make sure that this does not change it. 2815 mWebViewCore.sendMessage(EventHub.CLICK, nativeCursorFramePointer(), 2816 nativeCursorNodePointer()); 2817 rebuildWebTextView(); 2818 } 2819 if (inEditingMode()) { 2820 return mWebTextView.performLongClick(); 2821 } else { 2822 return super.performLongClick(); 2823 } 2824 } 2825 2826 boolean inAnimateZoom() { 2827 return mZoomScale != 0; 2828 } 2829 2830 /** 2831 * Need to adjust the WebTextView after a change in zoom, since mActualScale 2832 * has changed. This is especially important for password fields, which are 2833 * drawn by the WebTextView, since it conveys more information than what 2834 * webkit draws. Thus we need to reposition it to show in the correct 2835 * place. 2836 */ 2837 private boolean mNeedToAdjustWebTextView; 2838 2839 private boolean didUpdateTextViewBounds(boolean allowIntersect) { 2840 Rect contentBounds = nativeFocusCandidateNodeBounds(); 2841 Rect vBox = contentToViewRect(contentBounds); 2842 Rect visibleRect = new Rect(); 2843 calcOurVisibleRect(visibleRect); 2844 if (allowIntersect ? Rect.intersects(visibleRect, vBox) : 2845 visibleRect.contains(vBox)) { 2846 mWebTextView.setRect(vBox.left, vBox.top, vBox.width(), 2847 vBox.height()); 2848 return true; 2849 } else { 2850 return false; 2851 } 2852 } 2853 2854 private void drawCoreAndCursorRing(Canvas canvas, int color, 2855 boolean drawCursorRing) { 2856 if (mDrawHistory) { 2857 canvas.scale(mActualScale, mActualScale); 2858 canvas.drawPicture(mHistoryPicture); 2859 return; 2860 } 2861 2862 boolean animateZoom = mZoomScale != 0; 2863 boolean animateScroll = !mScroller.isFinished() 2864 || mVelocityTracker != null; 2865 if (animateZoom) { 2866 float zoomScale; 2867 int interval = (int) (SystemClock.uptimeMillis() - mZoomStart); 2868 if (interval < ZOOM_ANIMATION_LENGTH) { 2869 float ratio = (float) interval / ZOOM_ANIMATION_LENGTH; 2870 zoomScale = 1.0f / (mInvInitialZoomScale 2871 + (mInvFinalZoomScale - mInvInitialZoomScale) * ratio); 2872 invalidate(); 2873 } else { 2874 zoomScale = mZoomScale; 2875 // set mZoomScale to be 0 as we have done animation 2876 mZoomScale = 0; 2877 // call invalidate() again to draw with the final filters 2878 invalidate(); 2879 if (mNeedToAdjustWebTextView) { 2880 mNeedToAdjustWebTextView = false; 2881 // As a result of the zoom, the textfield is now on 2882 // screen. Place the WebTextView in its new place, 2883 // accounting for our new scroll/zoom values. 2884 if (didUpdateTextViewBounds(false)) { 2885 mWebTextView.setTextSize(TypedValue.COMPLEX_UNIT_PX, 2886 contentToViewDimension( 2887 nativeFocusCandidateTextSize())); 2888 // If it is a password field, start drawing the 2889 // WebTextView once again. 2890 if (nativeFocusCandidateIsPassword()) { 2891 mWebTextView.setInPassword(true); 2892 } 2893 } else { 2894 // The textfield is now off screen. The user probably 2895 // was not zooming to see the textfield better. Remove 2896 // the WebTextView. If the user types a key, and the 2897 // textfield is still in focus, we will reconstruct 2898 // the WebTextView and scroll it back on screen. 2899 mWebTextView.remove(); 2900 } 2901 } 2902 } 2903 // calculate the intermediate scroll position. As we need to use 2904 // zoomScale, we can't use pinLocX/Y directly. Copy the logic here. 2905 float scale = zoomScale * mInvInitialZoomScale; 2906 int tx = Math.round(scale * (mInitialScrollX + mZoomCenterX) 2907 - mZoomCenterX); 2908 tx = -pinLoc(tx, getViewWidth(), Math.round(mContentWidth 2909 * zoomScale)) + mScrollX; 2910 int titleHeight = getTitleHeight(); 2911 int ty = Math.round(scale 2912 * (mInitialScrollY + mZoomCenterY - titleHeight) 2913 - (mZoomCenterY - titleHeight)); 2914 ty = -(ty <= titleHeight ? Math.max(ty, 0) : pinLoc(ty 2915 - titleHeight, getViewHeight(), Math.round(mContentHeight 2916 * zoomScale)) + titleHeight) + mScrollY; 2917 canvas.translate(tx, ty); 2918 canvas.scale(zoomScale, zoomScale); 2919 if (inEditingMode() && !mNeedToAdjustWebTextView 2920 && mZoomScale != 0) { 2921 // The WebTextView is up. Keep track of this so we can adjust 2922 // its size and placement when we finish zooming 2923 mNeedToAdjustWebTextView = true; 2924 // If it is in password mode, turn it off so it does not draw 2925 // misplaced. 2926 if (nativeFocusCandidateIsPassword()) { 2927 mWebTextView.setInPassword(false); 2928 } 2929 } 2930 } else { 2931 canvas.scale(mActualScale, mActualScale); 2932 } 2933 2934 mWebViewCore.drawContentPicture(canvas, color, animateZoom, 2935 animateScroll); 2936 2937 if (mNativeClass == 0) return; 2938 if (mShiftIsPressed) { 2939 if (mTouchSelection) { 2940 nativeDrawSelectionRegion(canvas); 2941 } else { 2942 nativeDrawSelection(canvas, mSelectX, mSelectY, 2943 mExtendSelection); 2944 } 2945 } else if (drawCursorRing) { 2946 if (mTouchMode == TOUCH_SHORTPRESS_START_MODE) { 2947 mTouchMode = TOUCH_SHORTPRESS_MODE; 2948 HitTestResult hitTest = getHitTestResult(); 2949 if (hitTest != null && 2950 hitTest.mType != HitTestResult.UNKNOWN_TYPE) { 2951 mPrivateHandler.sendMessageDelayed(mPrivateHandler 2952 .obtainMessage(SWITCH_TO_LONGPRESS), 2953 LONG_PRESS_TIMEOUT); 2954 } 2955 } 2956 nativeDrawCursorRing(canvas); 2957 } 2958 // When the FindDialog is up, only draw the matches if we are not in 2959 // the process of scrolling them into view. 2960 if (mFindIsUp && !animateScroll) { 2961 nativeDrawMatches(canvas); 2962 } 2963 if (mFocusSizeChanged) { 2964 mFocusSizeChanged = false; 2965 didUpdateTextViewBounds(true); 2966 } 2967 } 2968 2969 // draw history 2970 private boolean mDrawHistory = false; 2971 private Picture mHistoryPicture = null; 2972 private int mHistoryWidth = 0; 2973 private int mHistoryHeight = 0; 2974 2975 // Only check the flag, can be called from WebCore thread 2976 boolean drawHistory() { 2977 return mDrawHistory; 2978 } 2979 2980 // Should only be called in UI thread 2981 void switchOutDrawHistory() { 2982 if (null == mWebViewCore) return; // CallbackProxy may trigger this 2983 if (mDrawHistory && mWebViewCore.pictureReady()) { 2984 mDrawHistory = false; 2985 invalidate(); 2986 int oldScrollX = mScrollX; 2987 int oldScrollY = mScrollY; 2988 mScrollX = pinLocX(mScrollX); 2989 mScrollY = pinLocY(mScrollY); 2990 if (oldScrollX != mScrollX || oldScrollY != mScrollY) { 2991 mUserScroll = false; 2992 mWebViewCore.sendMessage(EventHub.SYNC_SCROLL, oldScrollX, 2993 oldScrollY); 2994 } 2995 sendOurVisibleRect(); 2996 } 2997 } 2998 2999 WebViewCore.CursorData cursorData() { 3000 WebViewCore.CursorData result = new WebViewCore.CursorData(); 3001 result.mMoveGeneration = nativeMoveGeneration(); 3002 result.mFrame = nativeCursorFramePointer(); 3003 Point position = nativeCursorPosition(); 3004 result.mX = position.x; 3005 result.mY = position.y; 3006 return result; 3007 } 3008 3009 /** 3010 * Delete text from start to end in the focused textfield. If there is no 3011 * focus, or if start == end, silently fail. If start and end are out of 3012 * order, swap them. 3013 * @param start Beginning of selection to delete. 3014 * @param end End of selection to delete. 3015 */ 3016 /* package */ void deleteSelection(int start, int end) { 3017 mTextGeneration++; 3018 WebViewCore.TextSelectionData data 3019 = new WebViewCore.TextSelectionData(start, end); 3020 mWebViewCore.sendMessage(EventHub.DELETE_SELECTION, mTextGeneration, 0, 3021 data); 3022 } 3023 3024 /** 3025 * Set the selection to (start, end) in the focused textfield. If start and 3026 * end are out of order, swap them. 3027 * @param start Beginning of selection. 3028 * @param end End of selection. 3029 */ 3030 /* package */ void setSelection(int start, int end) { 3031 mWebViewCore.sendMessage(EventHub.SET_SELECTION, start, end); 3032 } 3033 3034 // Called by JNI when a touch event puts a textfield into focus. 3035 private void displaySoftKeyboard(boolean isTextView) { 3036 InputMethodManager imm = (InputMethodManager) 3037 getContext().getSystemService(Context.INPUT_METHOD_SERVICE); 3038 3039 if (isTextView) { 3040 if (mWebTextView == null) return; 3041 3042 imm.showSoftInput(mWebTextView, 0); 3043 if (mInZoomOverview) { 3044 // if in zoom overview mode, call doDoubleTap() to bring it back 3045 // to normal mode so that user can enter text. 3046 doDoubleTap(); 3047 } 3048 } 3049 else { // used by plugins 3050 imm.showSoftInput(this, 0); 3051 } 3052 } 3053 3054 // Called by WebKit to instruct the UI to hide the keyboard 3055 private void hideSoftKeyboard() { 3056 InputMethodManager imm = (InputMethodManager) 3057 getContext().getSystemService(Context.INPUT_METHOD_SERVICE); 3058 3059 imm.hideSoftInputFromWindow(this.getWindowToken(), 0); 3060 } 3061 3062 /* 3063 * This method checks the current focus and cursor and potentially rebuilds 3064 * mWebTextView to have the appropriate properties, such as password, 3065 * multiline, and what text it contains. It also removes it if necessary. 3066 */ 3067 /* package */ void rebuildWebTextView() { 3068 // If the WebView does not have focus, do nothing until it gains focus. 3069 if (!hasFocus() && (null == mWebTextView || !mWebTextView.hasFocus())) { 3070 return; 3071 } 3072 boolean alreadyThere = inEditingMode(); 3073 // inEditingMode can only return true if mWebTextView is non-null, 3074 // so we can safely call remove() if (alreadyThere) 3075 if (0 == mNativeClass || !nativeFocusCandidateIsTextInput()) { 3076 if (alreadyThere) { 3077 mWebTextView.remove(); 3078 } 3079 return; 3080 } 3081 // At this point, we know we have found an input field, so go ahead 3082 // and create the WebTextView if necessary. 3083 if (mWebTextView == null) { 3084 mWebTextView = new WebTextView(mContext, WebView.this); 3085 // Initialize our generation number. 3086 mTextGeneration = 0; 3087 } 3088 mWebTextView.setTextSize(TypedValue.COMPLEX_UNIT_PX, 3089 contentToViewDimension(nativeFocusCandidateTextSize())); 3090 Rect visibleRect = new Rect(); 3091 calcOurContentVisibleRect(visibleRect); 3092 // Note that sendOurVisibleRect calls viewToContent, so the coordinates 3093 // should be in content coordinates. 3094 Rect bounds = nativeFocusCandidateNodeBounds(); 3095 if (!Rect.intersects(bounds, visibleRect)) { 3096 mWebTextView.bringIntoView(); 3097 } 3098 String text = nativeFocusCandidateText(); 3099 int nodePointer = nativeFocusCandidatePointer(); 3100 if (alreadyThere && mWebTextView.isSameTextField(nodePointer)) { 3101 // It is possible that we have the same textfield, but it has moved, 3102 // i.e. In the case of opening/closing the screen. 3103 // In that case, we need to set the dimensions, but not the other 3104 // aspects. 3105 // We also need to restore the selection, which gets wrecked by 3106 // calling setTextEntryRect. 3107 Spannable spannable = (Spannable) mWebTextView.getText(); 3108 int start = Selection.getSelectionStart(spannable); 3109 int end = Selection.getSelectionEnd(spannable); 3110 // If the text has been changed by webkit, update it. However, if 3111 // there has been more UI text input, ignore it. We will receive 3112 // another update when that text is recognized. 3113 if (text != null && !text.equals(spannable.toString()) 3114 && nativeTextGeneration() == mTextGeneration) { 3115 mWebTextView.setTextAndKeepSelection(text); 3116 } else { 3117 Selection.setSelection(spannable, start, end); 3118 } 3119 } else { 3120 Rect vBox = contentToViewRect(bounds); 3121 mWebTextView.setRect(vBox.left, vBox.top, vBox.width(), 3122 vBox.height()); 3123 mWebTextView.setGravity(nativeFocusCandidateIsRtlText() ? 3124 Gravity.RIGHT : Gravity.NO_GRAVITY); 3125 // this needs to be called before update adapter thread starts to 3126 // ensure the mWebTextView has the same node pointer 3127 mWebTextView.setNodePointer(nodePointer); 3128 int maxLength = -1; 3129 boolean isTextField = nativeFocusCandidateIsTextField(); 3130 if (isTextField) { 3131 maxLength = nativeFocusCandidateMaxLength(); 3132 String name = nativeFocusCandidateName(); 3133 if (mWebViewCore.getSettings().getSaveFormData() 3134 && name != null) { 3135 Message update = mPrivateHandler.obtainMessage( 3136 REQUEST_FORM_DATA, nodePointer); 3137 RequestFormData updater = new RequestFormData(name, 3138 getUrl(), update); 3139 Thread t = new Thread(updater); 3140 t.start(); 3141 } 3142 } 3143 mWebTextView.setMaxLength(maxLength); 3144 AutoCompleteAdapter adapter = null; 3145 mWebTextView.setAdapterCustom(adapter); 3146 mWebTextView.setSingleLine(isTextField); 3147 mWebTextView.setInPassword(nativeFocusCandidateIsPassword()); 3148 if (null == text) { 3149 mWebTextView.setText("", 0, 0); 3150 if (DebugFlags.WEB_VIEW) { 3151 Log.v(LOGTAG, "rebuildWebTextView null == text"); 3152 } 3153 } else { 3154 // Change to true to enable the old style behavior, where 3155 // entering a textfield/textarea always set the selection to the 3156 // whole field. This was desirable for the case where the user 3157 // intends to scroll past the field using the trackball. 3158 // However, it causes a problem when replying to emails - the 3159 // user expects the cursor to be at the beginning of the 3160 // textarea. Testing out a new behavior, where textfields set 3161 // selection at the end, and textareas at the beginning. 3162 if (false) { 3163 mWebTextView.setText(text, 0, text.length()); 3164 } else if (isTextField) { 3165 int length = text.length(); 3166 mWebTextView.setText(text, length, length); 3167 if (DebugFlags.WEB_VIEW) { 3168 Log.v(LOGTAG, "rebuildWebTextView length=" + length); 3169 } 3170 } else { 3171 mWebTextView.setText(text, 0, 0); 3172 if (DebugFlags.WEB_VIEW) { 3173 Log.v(LOGTAG, "rebuildWebTextView !isTextField"); 3174 } 3175 } 3176 } 3177 mWebTextView.requestFocus(); 3178 } 3179 } 3180 3181 /* 3182 * This class requests an Adapter for the WebTextView which shows past 3183 * entries stored in the database. It is a Runnable so that it can be done 3184 * in its own thread, without slowing down the UI. 3185 */ 3186 private class RequestFormData implements Runnable { 3187 private String mName; 3188 private String mUrl; 3189 private Message mUpdateMessage; 3190 3191 public RequestFormData(String name, String url, Message msg) { 3192 mName = name; 3193 mUrl = url; 3194 mUpdateMessage = msg; 3195 } 3196 3197 public void run() { 3198 ArrayList<String> pastEntries = mDatabase.getFormData(mUrl, mName); 3199 if (pastEntries.size() > 0) { 3200 AutoCompleteAdapter adapter = new 3201 AutoCompleteAdapter(mContext, pastEntries); 3202 mUpdateMessage.obj = adapter; 3203 mUpdateMessage.sendToTarget(); 3204 } 3205 } 3206 } 3207 3208 // This is used to determine long press with the center key. Does not 3209 // affect long press with the trackball/touch. 3210 private boolean mGotCenterDown = false; 3211 3212 @Override 3213 public boolean onKeyDown(int keyCode, KeyEvent event) { 3214 if (DebugFlags.WEB_VIEW) { 3215 Log.v(LOGTAG, "keyDown at " + System.currentTimeMillis() 3216 + ", " + event + ", unicode=" + event.getUnicodeChar()); 3217 } 3218 3219 if (mNativeClass == 0) { 3220 return false; 3221 } 3222 3223 // do this hack up front, so it always works, regardless of touch-mode 3224 if (AUTO_REDRAW_HACK && (keyCode == KeyEvent.KEYCODE_CALL)) { 3225 mAutoRedraw = !mAutoRedraw; 3226 if (mAutoRedraw) { 3227 invalidate(); 3228 } 3229 return true; 3230 } 3231 3232 // Bubble up the key event if 3233 // 1. it is a system key; or 3234 // 2. the host application wants to handle it; 3235 if (event.isSystem() 3236 || mCallbackProxy.uiOverrideKeyEvent(event)) { 3237 return false; 3238 } 3239 3240 if (mShiftIsPressed == false && nativeCursorWantsKeyEvents() == false 3241 && (keyCode == KeyEvent.KEYCODE_SHIFT_LEFT 3242 || keyCode == KeyEvent.KEYCODE_SHIFT_RIGHT)) { 3243 mExtendSelection = false; 3244 mShiftIsPressed = true; 3245 if (nativeHasCursorNode()) { 3246 Rect rect = nativeCursorNodeBounds(); 3247 mSelectX = contentToViewX(rect.left); 3248 mSelectY = contentToViewY(rect.top); 3249 } else { 3250 mSelectX = mScrollX + (int) mLastTouchX; 3251 mSelectY = mScrollY + (int) mLastTouchY; 3252 } 3253 nativeHideCursor(); 3254 } 3255 3256 if (keyCode >= KeyEvent.KEYCODE_DPAD_UP 3257 && keyCode <= KeyEvent.KEYCODE_DPAD_RIGHT) { 3258 // always handle the navigation keys in the UI thread 3259 switchOutDrawHistory(); 3260 if (navHandledKey(keyCode, 1, false, event.getEventTime(), false)) { 3261 playSoundEffect(keyCodeToSoundsEffect(keyCode)); 3262 return true; 3263 } 3264 // Bubble up the key event as WebView doesn't handle it 3265 return false; 3266 } 3267 3268 if (keyCode == KeyEvent.KEYCODE_DPAD_CENTER) { 3269 switchOutDrawHistory(); 3270 if (event.getRepeatCount() == 0) { 3271 mGotCenterDown = true; 3272 mPrivateHandler.sendMessageDelayed(mPrivateHandler 3273 .obtainMessage(LONG_PRESS_CENTER), LONG_PRESS_TIMEOUT); 3274 // Already checked mNativeClass, so we do not need to check it 3275 // again. 3276 nativeRecordButtons(hasFocus() && hasWindowFocus(), true, true); 3277 return true; 3278 } 3279 // Bubble up the key event as WebView doesn't handle it 3280 return false; 3281 } 3282 3283 if (keyCode != KeyEvent.KEYCODE_SHIFT_LEFT 3284 && keyCode != KeyEvent.KEYCODE_SHIFT_RIGHT) { 3285 // turn off copy select if a shift-key combo is pressed 3286 mExtendSelection = mShiftIsPressed = false; 3287 if (mTouchMode == TOUCH_SELECT_MODE) { 3288 mTouchMode = TOUCH_INIT_MODE; 3289 } 3290 } 3291 3292 if (getSettings().getNavDump()) { 3293 switch (keyCode) { 3294 case KeyEvent.KEYCODE_4: 3295 // "/data/data/com.android.browser/displayTree.txt" 3296 nativeDumpDisplayTree(getUrl()); 3297 break; 3298 case KeyEvent.KEYCODE_5: 3299 case KeyEvent.KEYCODE_6: 3300 // 5: dump the dom tree to the file 3301 // "/data/data/com.android.browser/domTree.txt" 3302 // 6: dump the dom tree to the adb log 3303 mWebViewCore.sendMessage(EventHub.DUMP_DOMTREE, 3304 (keyCode == KeyEvent.KEYCODE_5) ? 1 : 0, 0); 3305 break; 3306 case KeyEvent.KEYCODE_7: 3307 case KeyEvent.KEYCODE_8: 3308 // 7: dump the render tree to the file 3309 // "/data/data/com.android.browser/renderTree.txt" 3310 // 8: dump the render tree to the adb log 3311 mWebViewCore.sendMessage(EventHub.DUMP_RENDERTREE, 3312 (keyCode == KeyEvent.KEYCODE_7) ? 1 : 0, 0); 3313 break; 3314 case KeyEvent.KEYCODE_9: 3315 nativeInstrumentReport(); 3316 return true; 3317 } 3318 } 3319 3320 if (nativeCursorIsPlugin()) { 3321 nativeUpdatePluginReceivesEvents(); 3322 invalidate(); 3323 } else if (nativeCursorIsTextInput()) { 3324 // This message will put the node in focus, for the DOM's notion 3325 // of focus, and make the focuscontroller active 3326 mWebViewCore.sendMessage(EventHub.CLICK, nativeCursorFramePointer(), 3327 nativeCursorNodePointer()); 3328 // This will bring up the WebTextView and put it in focus, for 3329 // our view system's notion of focus 3330 rebuildWebTextView(); 3331 // Now we need to pass the event to it 3332 if (inEditingMode()) { 3333 return mWebTextView.onKeyDown(keyCode, event); 3334 } 3335 } else if (nativeHasFocusNode()) { 3336 // In this case, the cursor is not on a text input, but the focus 3337 // might be. Check it, and if so, hand over to the WebTextView. 3338 rebuildWebTextView(); 3339 if (inEditingMode()) { 3340 return mWebTextView.onKeyDown(keyCode, event); 3341 } 3342 } 3343 3344 // TODO: should we pass all the keys to DOM or check the meta tag 3345 if (nativeCursorWantsKeyEvents() || true) { 3346 // pass the key to DOM 3347 mWebViewCore.sendMessage(EventHub.KEY_DOWN, event); 3348 // return true as DOM handles the key 3349 return true; 3350 } 3351 3352 // Bubble up the key event as WebView doesn't handle it 3353 return false; 3354 } 3355 3356 @Override 3357 public boolean onKeyUp(int keyCode, KeyEvent event) { 3358 if (DebugFlags.WEB_VIEW) { 3359 Log.v(LOGTAG, "keyUp at " + System.currentTimeMillis() 3360 + ", " + event + ", unicode=" + event.getUnicodeChar()); 3361 } 3362 3363 if (mNativeClass == 0) { 3364 return false; 3365 } 3366 3367 // special CALL handling when cursor node's href is "tel:XXX" 3368 if (keyCode == KeyEvent.KEYCODE_CALL && nativeHasCursorNode()) { 3369 String text = nativeCursorText(); 3370 if (!nativeCursorIsTextInput() && text != null 3371 && text.startsWith(SCHEME_TEL)) { 3372 Intent intent = new Intent(Intent.ACTION_DIAL, Uri.parse(text)); 3373 getContext().startActivity(intent); 3374 return true; 3375 } 3376 } 3377 3378 // Bubble up the key event if 3379 // 1. it is a system key; or 3380 // 2. the host application wants to handle it; 3381 if (event.isSystem() || mCallbackProxy.uiOverrideKeyEvent(event)) { 3382 return false; 3383 } 3384 3385 if (keyCode == KeyEvent.KEYCODE_SHIFT_LEFT 3386 || keyCode == KeyEvent.KEYCODE_SHIFT_RIGHT) { 3387 if (commitCopy()) { 3388 return true; 3389 } 3390 } 3391 3392 if (keyCode >= KeyEvent.KEYCODE_DPAD_UP 3393 && keyCode <= KeyEvent.KEYCODE_DPAD_RIGHT) { 3394 // always handle the navigation keys in the UI thread 3395 // Bubble up the key event as WebView doesn't handle it 3396 return false; 3397 } 3398 3399 if (keyCode == KeyEvent.KEYCODE_DPAD_CENTER) { 3400 // remove the long press message first 3401 mPrivateHandler.removeMessages(LONG_PRESS_CENTER); 3402 mGotCenterDown = false; 3403 3404 if (mShiftIsPressed) { 3405 return false; 3406 } 3407 3408 // perform the single click 3409 Rect visibleRect = sendOurVisibleRect(); 3410 // Note that sendOurVisibleRect calls viewToContent, so the 3411 // coordinates should be in content coordinates. 3412 if (!nativeCursorIntersects(visibleRect)) { 3413 return false; 3414 } 3415 nativeSetFollowedLink(true); 3416 nativeUpdatePluginReceivesEvents(); 3417 WebViewCore.CursorData data = cursorData(); 3418 mWebViewCore.sendMessage(EventHub.SET_MOVE_MOUSE, data); 3419 playSoundEffect(SoundEffectConstants.CLICK); 3420 boolean isTextInput = nativeCursorIsTextInput(); 3421 if (isTextInput || !mCallbackProxy.uiOverrideUrlLoading( 3422 nativeCursorText())) { 3423 mWebViewCore.sendMessage(EventHub.CLICK, data.mFrame, 3424 nativeCursorNodePointer()); 3425 } 3426 if (isTextInput) { 3427 rebuildWebTextView(); 3428 } 3429 return true; 3430 } 3431 3432 // TODO: should we pass all the keys to DOM or check the meta tag 3433 if (nativeCursorWantsKeyEvents() || true) { 3434 // pass the key to DOM 3435 mWebViewCore.sendMessage(EventHub.KEY_UP, event); 3436 // return true as DOM handles the key 3437 return true; 3438 } 3439 3440 // Bubble up the key event as WebView doesn't handle it 3441 return false; 3442 } 3443 3444 /** 3445 * @hide 3446 */ 3447 public void emulateShiftHeld() { 3448 mExtendSelection = false; 3449 mShiftIsPressed = true; 3450 nativeHideCursor(); 3451 } 3452 3453 private boolean commitCopy() { 3454 boolean copiedSomething = false; 3455 if (mExtendSelection) { 3456 // copy region so core operates on copy without touching orig. 3457 Region selection = new Region(nativeGetSelection()); 3458 if (selection.isEmpty() == false) { 3459 Toast.makeText(mContext 3460 , com.android.internal.R.string.text_copied 3461 , Toast.LENGTH_SHORT).show(); 3462 mWebViewCore.sendMessage(EventHub.GET_SELECTION, selection); 3463 copiedSomething = true; 3464 } 3465 mExtendSelection = false; 3466 } 3467 mShiftIsPressed = false; 3468 if (mTouchMode == TOUCH_SELECT_MODE) { 3469 mTouchMode = TOUCH_INIT_MODE; 3470 } 3471 return copiedSomething; 3472 } 3473 3474 // Set this as a hierarchy change listener so we can know when this view 3475 // is removed and still have access to our parent. 3476 @Override 3477 protected void onAttachedToWindow() { 3478 super.onAttachedToWindow(); 3479 ViewParent parent = getParent(); 3480 if (parent instanceof ViewGroup) { 3481 ViewGroup p = (ViewGroup) parent; 3482 p.setOnHierarchyChangeListener(this); 3483 } 3484 } 3485 3486 @Override 3487 protected void onDetachedFromWindow() { 3488 super.onDetachedFromWindow(); 3489 ViewParent parent = getParent(); 3490 if (parent instanceof ViewGroup) { 3491 ViewGroup p = (ViewGroup) parent; 3492 p.setOnHierarchyChangeListener(null); 3493 } 3494 3495 // Clean up the zoom controller 3496 mZoomButtonsController.setVisible(false); 3497 } 3498 3499 // Implementation for OnHierarchyChangeListener 3500 public void onChildViewAdded(View parent, View child) {} 3501 3502 public void onChildViewRemoved(View p, View child) { 3503 if (child == this) { 3504 clearTextEntry(); 3505 } 3506 } 3507 3508 /** 3509 * @deprecated WebView should not have implemented 3510 * ViewTreeObserver.OnGlobalFocusChangeListener. This method 3511 * does nothing now. 3512 */ 3513 @Deprecated 3514 public void onGlobalFocusChanged(View oldFocus, View newFocus) { 3515 } 3516 3517 // To avoid drawing the cursor ring, and remove the TextView when our window 3518 // loses focus. 3519 @Override 3520 public void onWindowFocusChanged(boolean hasWindowFocus) { 3521 if (hasWindowFocus) { 3522 if (hasFocus()) { 3523 // If our window regained focus, and we have focus, then begin 3524 // drawing the cursor ring 3525 mDrawCursorRing = true; 3526 if (mNativeClass != 0) { 3527 nativeRecordButtons(true, false, true); 3528 if (inEditingMode()) { 3529 mWebViewCore.sendMessage(EventHub.SET_ACTIVE, 1, 0); 3530 } 3531 } 3532 } else { 3533 // If our window gained focus, but we do not have it, do not 3534 // draw the cursor ring. 3535 mDrawCursorRing = false; 3536 // We do not call nativeRecordButtons here because we assume 3537 // that when we lost focus, or window focus, it got called with 3538 // false for the first parameter 3539 } 3540 } else { 3541 if (getSettings().getBuiltInZoomControls() && !mZoomButtonsController.isVisible()) { 3542 /* 3543 * The zoom controls come in their own window, so our window 3544 * loses focus. Our policy is to not draw the cursor ring if 3545 * our window is not focused, but this is an exception since 3546 * the user can still navigate the web page with the zoom 3547 * controls showing. 3548 */ 3549 // If our window has lost focus, stop drawing the cursor ring 3550 mDrawCursorRing = false; 3551 } 3552 mGotKeyDown = false; 3553 mShiftIsPressed = false; 3554 if (mNativeClass != 0) { 3555 nativeRecordButtons(false, false, true); 3556 } 3557 setFocusControllerInactive(); 3558 } 3559 invalidate(); 3560 super.onWindowFocusChanged(hasWindowFocus); 3561 } 3562 3563 /* 3564 * Pass a message to WebCore Thread, telling the WebCore::Page's 3565 * FocusController to be "inactive" so that it will 3566 * not draw the blinking cursor. It gets set to "active" to draw the cursor 3567 * in WebViewCore.cpp, when the WebCore thread receives key events/clicks. 3568 */ 3569 /* package */ void setFocusControllerInactive() { 3570 // Do not need to also check whether mWebViewCore is null, because 3571 // mNativeClass is only set if mWebViewCore is non null 3572 if (mNativeClass == 0) return; 3573 mWebViewCore.sendMessage(EventHub.SET_ACTIVE, 0, 0); 3574 } 3575 3576 @Override 3577 protected void onFocusChanged(boolean focused, int direction, 3578 Rect previouslyFocusedRect) { 3579 if (DebugFlags.WEB_VIEW) { 3580 Log.v(LOGTAG, "MT focusChanged " + focused + ", " + direction); 3581 } 3582 if (focused) { 3583 // When we regain focus, if we have window focus, resume drawing 3584 // the cursor ring 3585 if (hasWindowFocus()) { 3586 mDrawCursorRing = true; 3587 if (mNativeClass != 0) { 3588 nativeRecordButtons(true, false, true); 3589 } 3590 //} else { 3591 // The WebView has gained focus while we do not have 3592 // windowfocus. When our window lost focus, we should have 3593 // called nativeRecordButtons(false...) 3594 } 3595 } else { 3596 // When we lost focus, unless focus went to the TextView (which is 3597 // true if we are in editing mode), stop drawing the cursor ring. 3598 if (!inEditingMode()) { 3599 mDrawCursorRing = false; 3600 if (mNativeClass != 0) { 3601 nativeRecordButtons(false, false, true); 3602 } 3603 setFocusControllerInactive(); 3604 } 3605 mGotKeyDown = false; 3606 } 3607 3608 super.onFocusChanged(focused, direction, previouslyFocusedRect); 3609 } 3610 3611 @Override 3612 protected void onSizeChanged(int w, int h, int ow, int oh) { 3613 super.onSizeChanged(w, h, ow, oh); 3614 // Center zooming to the center of the screen. 3615 if (mZoomScale == 0) { // unless we're already zooming 3616 mZoomCenterX = getViewWidth() * .5f; 3617 mZoomCenterY = getViewHeight() * .5f; 3618 } 3619 3620 // update mMinZoomScale if the minimum zoom scale is not fixed 3621 if (!mMinZoomScaleFixed) { 3622 // when change from narrow screen to wide screen, the new viewWidth 3623 // can be wider than the old content width. We limit the minimum 3624 // scale to 1.0f. The proper minimum scale will be calculated when 3625 // the new picture shows up. 3626 mMinZoomScale = Math.min(1.0f, (float) getViewWidth() 3627 / (mDrawHistory ? mHistoryPicture.getWidth() 3628 : mZoomOverviewWidth)); 3629 } 3630 3631 // we always force, in case our height changed, in which case we still 3632 // want to send the notification over to webkit 3633 setNewZoomScale(mActualScale, true); 3634 } 3635 3636 @Override 3637 protected void onScrollChanged(int l, int t, int oldl, int oldt) { 3638 super.onScrollChanged(l, t, oldl, oldt); 3639 3640 sendOurVisibleRect(); 3641 } 3642 3643 3644 @Override 3645 public boolean dispatchKeyEvent(KeyEvent event) { 3646 boolean dispatch = true; 3647 3648 if (!inEditingMode()) { 3649 if (event.getAction() == KeyEvent.ACTION_DOWN) { 3650 mGotKeyDown = true; 3651 } else { 3652 if (!mGotKeyDown) { 3653 /* 3654 * We got a key up for which we were not the recipient of 3655 * the original key down. Don't give it to the view. 3656 */ 3657 dispatch = false; 3658 } 3659 mGotKeyDown = false; 3660 } 3661 } 3662 3663 if (dispatch) { 3664 return super.dispatchKeyEvent(event); 3665 } else { 3666 // We didn't dispatch, so let something else handle the key 3667 return false; 3668 } 3669 } 3670 3671 // Here are the snap align logic: 3672 // 1. If it starts nearly horizontally or vertically, snap align; 3673 // 2. If there is a dramitic direction change, let it go; 3674 // 3. If there is a same direction back and forth, lock it. 3675 3676 // adjustable parameters 3677 private int mMinLockSnapReverseDistance; 3678 private static final float MAX_SLOPE_FOR_DIAG = 1.5f; 3679 private static final int MIN_BREAK_SNAP_CROSS_DISTANCE = 80; 3680 3681 @Override 3682 public boolean onTouchEvent(MotionEvent ev) { 3683 if (mNativeClass == 0 || !isClickable() || !isLongClickable()) { 3684 return false; 3685 } 3686 3687 if (DebugFlags.WEB_VIEW) { 3688 Log.v(LOGTAG, ev + " at " + ev.getEventTime() + " mTouchMode=" 3689 + mTouchMode); 3690 } 3691 3692 int action = ev.getAction(); 3693 float x = ev.getX(); 3694 float y = ev.getY(); 3695 long eventTime = ev.getEventTime(); 3696 3697 // Due to the touch screen edge effect, a touch closer to the edge 3698 // always snapped to the edge. As getViewWidth() can be different from 3699 // getWidth() due to the scrollbar, adjusting the point to match 3700 // getViewWidth(). Same applied to the height. 3701 if (x > getViewWidth() - 1) { 3702 x = getViewWidth() - 1; 3703 } 3704 if (y > getViewHeightWithTitle() - 1) { 3705 y = getViewHeightWithTitle() - 1; 3706 } 3707 3708 // pass the touch events from UI thread to WebCore thread 3709 if (mForwardTouchEvents && (action != MotionEvent.ACTION_MOVE 3710 || eventTime - mLastSentTouchTime > TOUCH_SENT_INTERVAL)) { 3711 WebViewCore.TouchEventData ted = new WebViewCore.TouchEventData(); 3712 ted.mAction = action; 3713 ted.mX = viewToContentX((int) x + mScrollX); 3714 ted.mY = viewToContentY((int) y + mScrollY); 3715 mWebViewCore.sendMessage(EventHub.TOUCH_EVENT, ted); 3716 mLastSentTouchTime = eventTime; 3717 } 3718 3719 int deltaX = (int) (mLastTouchX - x); 3720 int deltaY = (int) (mLastTouchY - y); 3721 3722 switch (action) { 3723 case MotionEvent.ACTION_DOWN: { 3724 mPreventDrag = PREVENT_DRAG_NO; 3725 if (!mScroller.isFinished()) { 3726 // stop the current scroll animation, but if this is 3727 // the start of a fling, allow it to add to the current 3728 // fling's velocity 3729 mScroller.abortAnimation(); 3730 mTouchMode = TOUCH_DRAG_START_MODE; 3731 mPrivateHandler.removeMessages(RESUME_WEBCORE_UPDATE); 3732 } else if (mShiftIsPressed) { 3733 mSelectX = mScrollX + (int) x; 3734 mSelectY = mScrollY + (int) y; 3735 mTouchMode = TOUCH_SELECT_MODE; 3736 if (DebugFlags.WEB_VIEW) { 3737 Log.v(LOGTAG, "select=" + mSelectX + "," + mSelectY); 3738 } 3739 nativeMoveSelection(viewToContentX(mSelectX), 3740 viewToContentY(mSelectY), false); 3741 mTouchSelection = mExtendSelection = true; 3742 } else if (mPrivateHandler.hasMessages(RELEASE_SINGLE_TAP)) { 3743 mPrivateHandler.removeMessages(RELEASE_SINGLE_TAP); 3744 if (deltaX * deltaX + deltaY * deltaY < mDoubleTapSlopSquare) { 3745 mTouchMode = TOUCH_DOUBLE_TAP_MODE; 3746 } else { 3747 // commit the short press action for the previous tap 3748 doShortPress(); 3749 // continue, mTouchMode should be still TOUCH_INIT_MODE 3750 } 3751 } else { 3752 mTouchMode = TOUCH_INIT_MODE; 3753 mPreventDrag = mForwardTouchEvents ? PREVENT_DRAG_MAYBE_YES 3754 : PREVENT_DRAG_NO; 3755 mWebViewCore.sendMessage( 3756 EventHub.UPDATE_FRAME_CACHE_IF_LOADING); 3757 if (mLogEvent && eventTime - mLastTouchUpTime < 1000) { 3758 EventLog.writeEvent(EVENT_LOG_DOUBLE_TAP_DURATION, 3759 (eventTime - mLastTouchUpTime), eventTime); 3760 } 3761 } 3762 // Trigger the link 3763 if (mTouchMode == TOUCH_INIT_MODE 3764 || mTouchMode == TOUCH_DOUBLE_TAP_MODE) { 3765 mPrivateHandler.sendMessageDelayed(mPrivateHandler 3766 .obtainMessage(SWITCH_TO_SHORTPRESS), TAP_TIMEOUT); 3767 } 3768 // Remember where the motion event started 3769 mLastTouchX = x; 3770 mLastTouchY = y; 3771 mLastTouchTime = eventTime; 3772 mVelocityTracker = VelocityTracker.obtain(); 3773 mSnapScrollMode = SNAP_NONE; 3774 break; 3775 } 3776 case MotionEvent.ACTION_MOVE: { 3777 if (mTouchMode == TOUCH_DONE_MODE) { 3778 // no dragging during scroll zoom animation 3779 break; 3780 } 3781 mVelocityTracker.addMovement(ev); 3782 3783 if (mTouchMode != TOUCH_DRAG_MODE) { 3784 if (mTouchMode == TOUCH_SELECT_MODE) { 3785 mSelectX = mScrollX + (int) x; 3786 mSelectY = mScrollY + (int) y; 3787 if (DebugFlags.WEB_VIEW) { 3788 Log.v(LOGTAG, "xtend=" + mSelectX + "," + mSelectY); 3789 } 3790 nativeMoveSelection(viewToContentX(mSelectX), 3791 viewToContentY(mSelectY), true); 3792 invalidate(); 3793 break; 3794 } 3795 if ((deltaX * deltaX + deltaY * deltaY) < mTouchSlopSquare) { 3796 break; 3797 } 3798 if (mPreventDrag == PREVENT_DRAG_MAYBE_YES) { 3799 // track mLastTouchTime as we may need to do fling at 3800 // ACTION_UP 3801 mLastTouchTime = eventTime; 3802 break; 3803 } 3804 if (mTouchMode == TOUCH_SHORTPRESS_MODE 3805 || mTouchMode == TOUCH_SHORTPRESS_START_MODE) { 3806 mPrivateHandler.removeMessages(SWITCH_TO_LONGPRESS); 3807 } else if (mTouchMode == TOUCH_INIT_MODE 3808 || mTouchMode == TOUCH_DOUBLE_TAP_MODE) { 3809 mPrivateHandler.removeMessages(SWITCH_TO_SHORTPRESS); 3810 } 3811 3812 // if it starts nearly horizontal or vertical, enforce it 3813 int ax = Math.abs(deltaX); 3814 int ay = Math.abs(deltaY); 3815 if (ax > MAX_SLOPE_FOR_DIAG * ay) { 3816 mSnapScrollMode = SNAP_X; 3817 mSnapPositive = deltaX > 0; 3818 } else if (ay > MAX_SLOPE_FOR_DIAG * ax) { 3819 mSnapScrollMode = SNAP_Y; 3820 mSnapPositive = deltaY > 0; 3821 } 3822 3823 mTouchMode = TOUCH_DRAG_MODE; 3824 WebViewCore.pauseUpdate(mWebViewCore); 3825 if (!mDragFromTextInput) { 3826 nativeHideCursor(); 3827 } 3828 WebSettings settings = getSettings(); 3829 if (settings.supportZoom() 3830 && settings.getBuiltInZoomControls() 3831 && !mZoomButtonsController.isVisible() 3832 && mMinZoomScale < mMaxZoomScale) { 3833 mZoomButtonsController.setVisible(true); 3834 int count = settings.getDoubleTapToastCount(); 3835 if (mInZoomOverview && count > 0) { 3836 settings.setDoubleTapToastCount(--count); 3837 Toast.makeText(mContext, 3838 com.android.internal.R.string.double_tap_toast, 3839 Toast.LENGTH_LONG).show(); 3840 } 3841 } 3842 } 3843 3844 // do pan 3845 int newScrollX = pinLocX(mScrollX + deltaX); 3846 deltaX = newScrollX - mScrollX; 3847 int newScrollY = pinLocY(mScrollY + deltaY); 3848 deltaY = newScrollY - mScrollY; 3849 boolean done = false; 3850 if (deltaX == 0 && deltaY == 0) { 3851 done = true; 3852 } else { 3853 if (mSnapScrollMode == SNAP_X || mSnapScrollMode == SNAP_Y) { 3854 int ax = Math.abs(deltaX); 3855 int ay = Math.abs(deltaY); 3856 if (mSnapScrollMode == SNAP_X) { 3857 // radical change means getting out of snap mode 3858 if (ay > MAX_SLOPE_FOR_DIAG * ax 3859 && ay > MIN_BREAK_SNAP_CROSS_DISTANCE) { 3860 mSnapScrollMode = SNAP_NONE; 3861 } 3862 // reverse direction means lock in the snap mode 3863 if ((ax > MAX_SLOPE_FOR_DIAG * ay) && 3864 ((mSnapPositive && 3865 deltaX < -mMinLockSnapReverseDistance) 3866 || (!mSnapPositive && 3867 deltaX > mMinLockSnapReverseDistance))) { 3868 mSnapScrollMode = SNAP_X_LOCK; 3869 } 3870 } else { 3871 // radical change means getting out of snap mode 3872 if ((ax > MAX_SLOPE_FOR_DIAG * ay) 3873 && ax > MIN_BREAK_SNAP_CROSS_DISTANCE) { 3874 mSnapScrollMode = SNAP_NONE; 3875 } 3876 // reverse direction means lock in the snap mode 3877 if ((ay > MAX_SLOPE_FOR_DIAG * ax) && 3878 ((mSnapPositive && 3879 deltaY < -mMinLockSnapReverseDistance) 3880 || (!mSnapPositive && 3881 deltaY > mMinLockSnapReverseDistance))) { 3882 mSnapScrollMode = SNAP_Y_LOCK; 3883 } 3884 } 3885 } 3886 3887 if (mSnapScrollMode == SNAP_X 3888 || mSnapScrollMode == SNAP_X_LOCK) { 3889 if (deltaX == 0) { 3890 // keep the scrollbar on the screen even there is no 3891 // scroll 3892 awakenScrollBars(ViewConfiguration 3893 .getScrollDefaultDelay(), false); 3894 } else { 3895 scrollBy(deltaX, 0); 3896 } 3897 mLastTouchX = x; 3898 } else if (mSnapScrollMode == SNAP_Y 3899 || mSnapScrollMode == SNAP_Y_LOCK) { 3900 if (deltaY == 0) { 3901 // keep the scrollbar on the screen even there is no 3902 // scroll 3903 awakenScrollBars(ViewConfiguration 3904 .getScrollDefaultDelay(), false); 3905 } else { 3906 scrollBy(0, deltaY); 3907 } 3908 mLastTouchY = y; 3909 } else { 3910 scrollBy(deltaX, deltaY); 3911 mLastTouchX = x; 3912 mLastTouchY = y; 3913 } 3914 mLastTouchTime = eventTime; 3915 mUserScroll = true; 3916 } 3917 3918 if (!getSettings().getBuiltInZoomControls()) { 3919 boolean showPlusMinus = mMinZoomScale < mMaxZoomScale; 3920 if (mZoomControls != null && showPlusMinus) { 3921 if (mZoomControls.getVisibility() == View.VISIBLE) { 3922 mPrivateHandler.removeCallbacks(mZoomControlRunnable); 3923 } else { 3924 mZoomControls.show(showPlusMinus, false); 3925 } 3926 mPrivateHandler.postDelayed(mZoomControlRunnable, 3927 ZOOM_CONTROLS_TIMEOUT); 3928 } 3929 } 3930 3931 if (done) { 3932 // keep the scrollbar on the screen even there is no scroll 3933 awakenScrollBars(ViewConfiguration.getScrollDefaultDelay(), 3934 false); 3935 // return false to indicate that we can't pan out of the 3936 // view space 3937 return false; 3938 } 3939 break; 3940 } 3941 case MotionEvent.ACTION_UP: { 3942 mLastTouchUpTime = eventTime; 3943 switch (mTouchMode) { 3944 case TOUCH_DOUBLE_TAP_MODE: // double tap 3945 mPrivateHandler.removeMessages(SWITCH_TO_SHORTPRESS); 3946 mTouchMode = TOUCH_DONE_MODE; 3947 doDoubleTap(); 3948 break; 3949 case TOUCH_SELECT_MODE: 3950 commitCopy(); 3951 mTouchSelection = false; 3952 break; 3953 case TOUCH_INIT_MODE: // tap 3954 case TOUCH_SHORTPRESS_START_MODE: 3955 case TOUCH_SHORTPRESS_MODE: 3956 mPrivateHandler.removeMessages(SWITCH_TO_SHORTPRESS); 3957 mPrivateHandler.removeMessages(SWITCH_TO_LONGPRESS); 3958 if ((deltaX * deltaX + deltaY * deltaY) > mTouchSlopSquare) { 3959 Log.w(LOGTAG, "Miss a drag as we are waiting for" + 3960 " WebCore's response for touch down."); 3961 if (computeHorizontalScrollExtent() < computeHorizontalScrollRange() 3962 || computeVerticalScrollExtent() < computeVerticalScrollRange()) { 3963 // we will not rewrite drag code here, but we 3964 // will try fling if it applies. 3965 WebViewCore.pauseUpdate(mWebViewCore); 3966 // fall through to TOUCH_DRAG_MODE 3967 } else { 3968 break; 3969 } 3970 } else { 3971 if (mPreventDrag == PREVENT_DRAG_MAYBE_YES) { 3972 // if mPreventDrag is not confirmed, treat it as 3973 // no so that it won't block tap or double tap. 3974 mPreventDrag = PREVENT_DRAG_NO; 3975 } 3976 if (mPreventDrag == PREVENT_DRAG_NO) { 3977 if (mTouchMode == TOUCH_INIT_MODE) { 3978 mPrivateHandler.sendMessageDelayed( 3979 mPrivateHandler.obtainMessage( 3980 RELEASE_SINGLE_TAP), 3981 ViewConfiguration.getDoubleTapTimeout()); 3982 } else { 3983 mTouchMode = TOUCH_DONE_MODE; 3984 doShortPress(); 3985 } 3986 } 3987 break; 3988 } 3989 case TOUCH_DRAG_MODE: 3990 // redraw in high-quality, as we're done dragging 3991 invalidate(); 3992 // if the user waits a while w/o moving before the 3993 // up, we don't want to do a fling 3994 if (eventTime - mLastTouchTime <= MIN_FLING_TIME) { 3995 mVelocityTracker.addMovement(ev); 3996 doFling(); 3997 break; 3998 } 3999 mLastVelocity = 0; 4000 WebViewCore.resumeUpdate(mWebViewCore); 4001 break; 4002 case TOUCH_DRAG_START_MODE: 4003 case TOUCH_DONE_MODE: 4004 // do nothing 4005 break; 4006 } 4007 // we also use mVelocityTracker == null to tell us that we are 4008 // not "moving around", so we can take the slower/prettier 4009 // mode in the drawing code 4010 if (mVelocityTracker != null) { 4011 mVelocityTracker.recycle(); 4012 mVelocityTracker = null; 4013 } 4014 break; 4015 } 4016 case MotionEvent.ACTION_CANCEL: { 4017 // we also use mVelocityTracker == null to tell us that we are 4018 // not "moving around", so we can take the slower/prettier 4019 // mode in the drawing code 4020 if (mVelocityTracker != null) { 4021 mVelocityTracker.recycle(); 4022 mVelocityTracker = null; 4023 } 4024 if (mTouchMode == TOUCH_DRAG_MODE) { 4025 WebViewCore.resumeUpdate(mWebViewCore); 4026 } 4027 mPrivateHandler.removeMessages(SWITCH_TO_SHORTPRESS); 4028 mPrivateHandler.removeMessages(SWITCH_TO_LONGPRESS); 4029 mTouchMode = TOUCH_DONE_MODE; 4030 nativeHideCursor(); 4031 break; 4032 } 4033 } 4034 return true; 4035 } 4036 4037 private long mTrackballFirstTime = 0; 4038 private long mTrackballLastTime = 0; 4039 private float mTrackballRemainsX = 0.0f; 4040 private float mTrackballRemainsY = 0.0f; 4041 private int mTrackballXMove = 0; 4042 private int mTrackballYMove = 0; 4043 private boolean mExtendSelection = false; 4044 private boolean mTouchSelection = false; 4045 private static final int TRACKBALL_KEY_TIMEOUT = 1000; 4046 private static final int TRACKBALL_TIMEOUT = 200; 4047 private static final int TRACKBALL_WAIT = 100; 4048 private static final int TRACKBALL_SCALE = 400; 4049 private static final int TRACKBALL_SCROLL_COUNT = 5; 4050 private static final int TRACKBALL_MOVE_COUNT = 10; 4051 private static final int TRACKBALL_MULTIPLIER = 3; 4052 private static final int SELECT_CURSOR_OFFSET = 16; 4053 private int mSelectX = 0; 4054 private int mSelectY = 0; 4055 private boolean mFocusSizeChanged = false; 4056 private boolean mShiftIsPressed = false; 4057 private boolean mTrackballDown = false; 4058 private long mTrackballUpTime = 0; 4059 private long mLastCursorTime = 0; 4060 private Rect mLastCursorBounds; 4061 4062 // Set by default; BrowserActivity clears to interpret trackball data 4063 // directly for movement. Currently, the framework only passes 4064 // arrow key events, not trackball events, from one child to the next 4065 private boolean mMapTrackballToArrowKeys = true; 4066 4067 public void setMapTrackballToArrowKeys(boolean setMap) { 4068 mMapTrackballToArrowKeys = setMap; 4069 } 4070 4071 void resetTrackballTime() { 4072 mTrackballLastTime = 0; 4073 } 4074 4075 @Override 4076 public boolean onTrackballEvent(MotionEvent ev) { 4077 long time = ev.getEventTime(); 4078 if ((ev.getMetaState() & KeyEvent.META_ALT_ON) != 0) { 4079 if (ev.getY() > 0) pageDown(true); 4080 if (ev.getY() < 0) pageUp(true); 4081 return true; 4082 } 4083 if (ev.getAction() == MotionEvent.ACTION_DOWN) { 4084 mTrackballDown = true; 4085 if (mNativeClass == 0) { 4086 return false; 4087 } 4088 nativeRecordButtons(hasFocus() && hasWindowFocus(), true, true); 4089 if (time - mLastCursorTime <= TRACKBALL_TIMEOUT 4090 && !mLastCursorBounds.equals(nativeGetCursorRingBounds())) { 4091 nativeSelectBestAt(mLastCursorBounds); 4092 } 4093 if (DebugFlags.WEB_VIEW) { 4094 Log.v(LOGTAG, "onTrackballEvent down ev=" + ev 4095 + " time=" + time 4096 + " mLastCursorTime=" + mLastCursorTime); 4097 } 4098 if (isInTouchMode()) requestFocusFromTouch(); 4099 return false; // let common code in onKeyDown at it 4100 } 4101 if (ev.getAction() == MotionEvent.ACTION_UP) { 4102 // LONG_PRESS_CENTER is set in common onKeyDown 4103 mPrivateHandler.removeMessages(LONG_PRESS_CENTER); 4104 mTrackballDown = false; 4105 mTrackballUpTime = time; 4106 if (mShiftIsPressed) { 4107 if (mExtendSelection) { 4108 commitCopy(); 4109 } else { 4110 mExtendSelection = true; 4111 } 4112 } 4113 if (DebugFlags.WEB_VIEW) { 4114 Log.v(LOGTAG, "onTrackballEvent up ev=" + ev 4115 + " time=" + time 4116 ); 4117 } 4118 return false; // let common code in onKeyUp at it 4119 } 4120 if (mMapTrackballToArrowKeys && mShiftIsPressed == false) { 4121 if (DebugFlags.WEB_VIEW) Log.v(LOGTAG, "onTrackballEvent gmail quit"); 4122 return false; 4123 } 4124 if (mTrackballDown) { 4125 if (DebugFlags.WEB_VIEW) Log.v(LOGTAG, "onTrackballEvent down quit"); 4126 return true; // discard move if trackball is down 4127 } 4128 if (time - mTrackballUpTime < TRACKBALL_TIMEOUT) { 4129 if (DebugFlags.WEB_VIEW) Log.v(LOGTAG, "onTrackballEvent up timeout quit"); 4130 return true; 4131 } 4132 // TODO: alternatively we can do panning as touch does 4133 switchOutDrawHistory(); 4134 if (time - mTrackballLastTime > TRACKBALL_TIMEOUT) { 4135 if (DebugFlags.WEB_VIEW) { 4136 Log.v(LOGTAG, "onTrackballEvent time=" 4137 + time + " last=" + mTrackballLastTime); 4138 } 4139 mTrackballFirstTime = time; 4140 mTrackballXMove = mTrackballYMove = 0; 4141 } 4142 mTrackballLastTime = time; 4143 if (DebugFlags.WEB_VIEW) { 4144 Log.v(LOGTAG, "onTrackballEvent ev=" + ev + " time=" + time); 4145 } 4146 mTrackballRemainsX += ev.getX(); 4147 mTrackballRemainsY += ev.getY(); 4148 doTrackball(time); 4149 return true; 4150 } 4151 4152 void moveSelection(float xRate, float yRate) { 4153 if (mNativeClass == 0) 4154 return; 4155 int width = getViewWidth(); 4156 int height = getViewHeight(); 4157 mSelectX += scaleTrackballX(xRate, width); 4158 mSelectY += scaleTrackballY(yRate, height); 4159 int maxX = width + mScrollX; 4160 int maxY = height + mScrollY; 4161 mSelectX = Math.min(maxX, Math.max(mScrollX - SELECT_CURSOR_OFFSET 4162 , mSelectX)); 4163 mSelectY = Math.min(maxY, Math.max(mScrollY - SELECT_CURSOR_OFFSET 4164 , mSelectY)); 4165 if (DebugFlags.WEB_VIEW) { 4166 Log.v(LOGTAG, "moveSelection" 4167 + " mSelectX=" + mSelectX 4168 + " mSelectY=" + mSelectY 4169 + " mScrollX=" + mScrollX 4170 + " mScrollY=" + mScrollY 4171 + " xRate=" + xRate 4172 + " yRate=" + yRate 4173 ); 4174 } 4175 nativeMoveSelection(viewToContentX(mSelectX), 4176 viewToContentY(mSelectY), mExtendSelection); 4177 int scrollX = mSelectX < mScrollX ? -SELECT_CURSOR_OFFSET 4178 : mSelectX > maxX - SELECT_CURSOR_OFFSET ? SELECT_CURSOR_OFFSET 4179 : 0; 4180 int scrollY = mSelectY < mScrollY ? -SELECT_CURSOR_OFFSET 4181 : mSelectY > maxY - SELECT_CURSOR_OFFSET ? SELECT_CURSOR_OFFSET 4182 : 0; 4183 pinScrollBy(scrollX, scrollY, true, 0); 4184 Rect select = new Rect(mSelectX, mSelectY, mSelectX + 1, mSelectY + 1); 4185 requestRectangleOnScreen(select); 4186 invalidate(); 4187 } 4188 4189 private int scaleTrackballX(float xRate, int width) { 4190 int xMove = (int) (xRate / TRACKBALL_SCALE * width); 4191 int nextXMove = xMove; 4192 if (xMove > 0) { 4193 if (xMove > mTrackballXMove) { 4194 xMove -= mTrackballXMove; 4195 } 4196 } else if (xMove < mTrackballXMove) { 4197 xMove -= mTrackballXMove; 4198 } 4199 mTrackballXMove = nextXMove; 4200 return xMove; 4201 } 4202 4203 private int scaleTrackballY(float yRate, int height) { 4204 int yMove = (int) (yRate / TRACKBALL_SCALE * height); 4205 int nextYMove = yMove; 4206 if (yMove > 0) { 4207 if (yMove > mTrackballYMove) { 4208 yMove -= mTrackballYMove; 4209 } 4210 } else if (yMove < mTrackballYMove) { 4211 yMove -= mTrackballYMove; 4212 } 4213 mTrackballYMove = nextYMove; 4214 return yMove; 4215 } 4216 4217 private int keyCodeToSoundsEffect(int keyCode) { 4218 switch(keyCode) { 4219 case KeyEvent.KEYCODE_DPAD_UP: 4220 return SoundEffectConstants.NAVIGATION_UP; 4221 case KeyEvent.KEYCODE_DPAD_RIGHT: 4222 return SoundEffectConstants.NAVIGATION_RIGHT; 4223 case KeyEvent.KEYCODE_DPAD_DOWN: 4224 return SoundEffectConstants.NAVIGATION_DOWN; 4225 case KeyEvent.KEYCODE_DPAD_LEFT: 4226 return SoundEffectConstants.NAVIGATION_LEFT; 4227 } 4228 throw new IllegalArgumentException("keyCode must be one of " + 4229 "{KEYCODE_DPAD_UP, KEYCODE_DPAD_RIGHT, KEYCODE_DPAD_DOWN, " + 4230 "KEYCODE_DPAD_LEFT}."); 4231 } 4232 4233 private void doTrackball(long time) { 4234 int elapsed = (int) (mTrackballLastTime - mTrackballFirstTime); 4235 if (elapsed == 0) { 4236 elapsed = TRACKBALL_TIMEOUT; 4237 } 4238 float xRate = mTrackballRemainsX * 1000 / elapsed; 4239 float yRate = mTrackballRemainsY * 1000 / elapsed; 4240 if (mShiftIsPressed) { 4241 moveSelection(xRate, yRate); 4242 mTrackballRemainsX = mTrackballRemainsY = 0; 4243 return; 4244 } 4245 float ax = Math.abs(xRate); 4246 float ay = Math.abs(yRate); 4247 float maxA = Math.max(ax, ay); 4248 if (DebugFlags.WEB_VIEW) { 4249 Log.v(LOGTAG, "doTrackball elapsed=" + elapsed 4250 + " xRate=" + xRate 4251 + " yRate=" + yRate 4252 + " mTrackballRemainsX=" + mTrackballRemainsX 4253 + " mTrackballRemainsY=" + mTrackballRemainsY); 4254 } 4255 int width = mContentWidth - getViewWidth(); 4256 int height = mContentHeight - getViewHeight(); 4257 if (width < 0) width = 0; 4258 if (height < 0) height = 0; 4259 ax = Math.abs(mTrackballRemainsX * TRACKBALL_MULTIPLIER); 4260 ay = Math.abs(mTrackballRemainsY * TRACKBALL_MULTIPLIER); 4261 maxA = Math.max(ax, ay); 4262 int count = Math.max(0, (int) maxA); 4263 int oldScrollX = mScrollX; 4264 int oldScrollY = mScrollY; 4265 if (count > 0) { 4266 int selectKeyCode = ax < ay ? mTrackballRemainsY < 0 ? 4267 KeyEvent.KEYCODE_DPAD_UP : KeyEvent.KEYCODE_DPAD_DOWN : 4268 mTrackballRemainsX < 0 ? KeyEvent.KEYCODE_DPAD_LEFT : 4269 KeyEvent.KEYCODE_DPAD_RIGHT; 4270 count = Math.min(count, TRACKBALL_MOVE_COUNT); 4271 if (DebugFlags.WEB_VIEW) { 4272 Log.v(LOGTAG, "doTrackball keyCode=" + selectKeyCode 4273 + " count=" + count 4274 + " mTrackballRemainsX=" + mTrackballRemainsX 4275 + " mTrackballRemainsY=" + mTrackballRemainsY); 4276 } 4277 if (navHandledKey(selectKeyCode, count, false, time, false)) { 4278 playSoundEffect(keyCodeToSoundsEffect(selectKeyCode)); 4279 } 4280 mTrackballRemainsX = mTrackballRemainsY = 0; 4281 } 4282 if (count >= TRACKBALL_SCROLL_COUNT) { 4283 int xMove = scaleTrackballX(xRate, width); 4284 int yMove = scaleTrackballY(yRate, height); 4285 if (DebugFlags.WEB_VIEW) { 4286 Log.v(LOGTAG, "doTrackball pinScrollBy" 4287 + " count=" + count 4288 + " xMove=" + xMove + " yMove=" + yMove 4289 + " mScrollX-oldScrollX=" + (mScrollX-oldScrollX) 4290 + " mScrollY-oldScrollY=" + (mScrollY-oldScrollY) 4291 ); 4292 } 4293 if (Math.abs(mScrollX - oldScrollX) > Math.abs(xMove)) { 4294 xMove = 0; 4295 } 4296 if (Math.abs(mScrollY - oldScrollY) > Math.abs(yMove)) { 4297 yMove = 0; 4298 } 4299 if (xMove != 0 || yMove != 0) { 4300 pinScrollBy(xMove, yMove, true, 0); 4301 } 4302 mUserScroll = true; 4303 } 4304 } 4305 4306 private int computeMaxScrollY() { 4307 int maxContentH = computeVerticalScrollRange() + getTitleHeight(); 4308 return Math.max(maxContentH - getHeight(), getTitleHeight()); 4309 } 4310 4311 public void flingScroll(int vx, int vy) { 4312 int maxX = Math.max(computeHorizontalScrollRange() - getViewWidth(), 0); 4313 int maxY = computeMaxScrollY(); 4314 4315 mScroller.fling(mScrollX, mScrollY, vx, vy, 0, maxX, 0, maxY); 4316 invalidate(); 4317 } 4318 4319 private void doFling() { 4320 if (mVelocityTracker == null) { 4321 return; 4322 } 4323 int maxX = Math.max(computeHorizontalScrollRange() - getViewWidth(), 0); 4324 int maxY = computeMaxScrollY(); 4325 4326 mVelocityTracker.computeCurrentVelocity(1000, mMaximumFling); 4327 int vx = (int) mVelocityTracker.getXVelocity(); 4328 int vy = (int) mVelocityTracker.getYVelocity(); 4329 4330 if (mSnapScrollMode != SNAP_NONE) { 4331 if (mSnapScrollMode == SNAP_X || mSnapScrollMode == SNAP_X_LOCK) { 4332 vy = 0; 4333 } else { 4334 vx = 0; 4335 } 4336 } 4337 4338 if (true /* EMG release: make our fling more like Maps' */) { 4339 // maps cuts their velocity in half 4340 vx = vx * 3 / 4; 4341 vy = vy * 3 / 4; 4342 } 4343 if ((maxX == 0 && vy == 0) || (maxY == 0 && vx == 0)) { 4344 WebViewCore.resumeUpdate(mWebViewCore); 4345 return; 4346 } 4347 float currentVelocity = mScroller.getCurrVelocity(); 4348 if (mLastVelocity > 0 && currentVelocity > 0) { 4349 float deltaR = (float) (Math.abs(Math.atan2(mLastVelY, mLastVelX) 4350 - Math.atan2(vy, vx))); 4351 final float circle = (float) (Math.PI) * 2.0f; 4352 if (deltaR > circle * 0.9f || deltaR < circle * 0.1f) { 4353 vx += currentVelocity * mLastVelX / mLastVelocity; 4354 vy += currentVelocity * mLastVelY / mLastVelocity; 4355 if (DebugFlags.WEB_VIEW) { 4356 Log.v(LOGTAG, "doFling vx= " + vx + " vy=" + vy); 4357 } 4358 } else if (DebugFlags.WEB_VIEW) { 4359 Log.v(LOGTAG, "doFling missed " + deltaR / circle); 4360 } 4361 } else if (DebugFlags.WEB_VIEW) { 4362 Log.v(LOGTAG, "doFling start last=" + mLastVelocity 4363 + " current=" + currentVelocity 4364 + " vx=" + vx + " vy=" + vy 4365 + " maxX=" + maxX + " maxY=" + maxY 4366 + " mScrollX=" + mScrollX + " mScrollY=" + mScrollY); 4367 } 4368 mLastVelX = vx; 4369 mLastVelY = vy; 4370 mLastVelocity = (float) Math.hypot(vx, vy); 4371 4372 mScroller.fling(mScrollX, mScrollY, -vx, -vy, 0, maxX, 0, maxY); 4373 // TODO: duration is calculated based on velocity, if the range is 4374 // small, the animation will stop before duration is up. We may 4375 // want to calculate how long the animation is going to run to precisely 4376 // resume the webcore update. 4377 final int time = mScroller.getDuration(); 4378 mPrivateHandler.sendEmptyMessageDelayed(RESUME_WEBCORE_UPDATE, time); 4379 awakenScrollBars(time); 4380 invalidate(); 4381 } 4382 4383 private boolean zoomWithPreview(float scale) { 4384 float oldScale = mActualScale; 4385 mInitialScrollX = mScrollX; 4386 mInitialScrollY = mScrollY; 4387 4388 // snap to DEFAULT_SCALE if it is close 4389 if (scale > (mDefaultScale - 0.05) && scale < (mDefaultScale + 0.05)) { 4390 scale = mDefaultScale; 4391 } 4392 4393 setNewZoomScale(scale, false); 4394 4395 if (oldScale != mActualScale) { 4396 // use mZoomPickerScale to see zoom preview first 4397 mZoomStart = SystemClock.uptimeMillis(); 4398 mInvInitialZoomScale = 1.0f / oldScale; 4399 mInvFinalZoomScale = 1.0f / mActualScale; 4400 mZoomScale = mActualScale; 4401 if (!mInZoomOverview) { 4402 mLastScale = scale; 4403 } 4404 invalidate(); 4405 return true; 4406 } else { 4407 return false; 4408 } 4409 } 4410 4411 /** 4412 * Returns a view containing zoom controls i.e. +/- buttons. The caller is 4413 * in charge of installing this view to the view hierarchy. This view will 4414 * become visible when the user starts scrolling via touch and fade away if 4415 * the user does not interact with it. 4416 * <p/> 4417 * API version 3 introduces a built-in zoom mechanism that is shown 4418 * automatically by the MapView. This is the preferred approach for 4419 * showing the zoom UI. 4420 * 4421 * @deprecated The built-in zoom mechanism is preferred, see 4422 * {@link WebSettings#setBuiltInZoomControls(boolean)}. 4423 */ 4424 @Deprecated 4425 public View getZoomControls() { 4426 if (!getSettings().supportZoom()) { 4427 Log.w(LOGTAG, "This WebView doesn't support zoom."); 4428 return null; 4429 } 4430 if (mZoomControls == null) { 4431 mZoomControls = createZoomControls(); 4432 4433 /* 4434 * need to be set to VISIBLE first so that getMeasuredHeight() in 4435 * {@link #onSizeChanged()} can return the measured value for proper 4436 * layout. 4437 */ 4438 mZoomControls.setVisibility(View.VISIBLE); 4439 mZoomControlRunnable = new Runnable() { 4440 public void run() { 4441 4442 /* Don't dismiss the controls if the user has 4443 * focus on them. Wait and check again later. 4444 */ 4445 if (!mZoomControls.hasFocus()) { 4446 mZoomControls.hide(); 4447 } else { 4448 mPrivateHandler.removeCallbacks(mZoomControlRunnable); 4449 mPrivateHandler.postDelayed(mZoomControlRunnable, 4450 ZOOM_CONTROLS_TIMEOUT); 4451 } 4452 } 4453 }; 4454 } 4455 return mZoomControls; 4456 } 4457 4458 private ExtendedZoomControls createZoomControls() { 4459 ExtendedZoomControls zoomControls = new ExtendedZoomControls(mContext 4460 , null); 4461 zoomControls.setOnZoomInClickListener(new OnClickListener() { 4462 public void onClick(View v) { 4463 // reset time out 4464 mPrivateHandler.removeCallbacks(mZoomControlRunnable); 4465 mPrivateHandler.postDelayed(mZoomControlRunnable, 4466 ZOOM_CONTROLS_TIMEOUT); 4467 zoomIn(); 4468 } 4469 }); 4470 zoomControls.setOnZoomOutClickListener(new OnClickListener() { 4471 public void onClick(View v) { 4472 // reset time out 4473 mPrivateHandler.removeCallbacks(mZoomControlRunnable); 4474 mPrivateHandler.postDelayed(mZoomControlRunnable, 4475 ZOOM_CONTROLS_TIMEOUT); 4476 zoomOut(); 4477 } 4478 }); 4479 return zoomControls; 4480 } 4481 4482 /** 4483 * Gets the {@link ZoomButtonsController} which can be used to add 4484 * additional buttons to the zoom controls window. 4485 * 4486 * @return The instance of {@link ZoomButtonsController} used by this class, 4487 * or null if it is unavailable. 4488 * @hide 4489 */ 4490 public ZoomButtonsController getZoomButtonsController() { 4491 return mZoomButtonsController; 4492 } 4493 4494 /** 4495 * Perform zoom in in the webview 4496 * @return TRUE if zoom in succeeds. FALSE if no zoom changes. 4497 */ 4498 public boolean zoomIn() { 4499 // TODO: alternatively we can disallow this during draw history mode 4500 switchOutDrawHistory(); 4501 // Center zooming to the center of the screen. 4502 if (mInZoomOverview) { 4503 // if in overview mode, bring it back to normal mode 4504 mLastTouchX = getViewWidth() * .5f; 4505 mLastTouchY = getViewHeight() * .5f; 4506 doDoubleTap(); 4507 return true; 4508 } else { 4509 mZoomCenterX = getViewWidth() * .5f; 4510 mZoomCenterY = getViewHeight() * .5f; 4511 return zoomWithPreview(mActualScale * 1.25f); 4512 } 4513 } 4514 4515 /** 4516 * Perform zoom out in the webview 4517 * @return TRUE if zoom out succeeds. FALSE if no zoom changes. 4518 */ 4519 public boolean zoomOut() { 4520 // TODO: alternatively we can disallow this during draw history mode 4521 switchOutDrawHistory(); 4522 float scale = mActualScale * 0.8f; 4523 if (scale < (mMinZoomScale + 0.1f) 4524 && mWebViewCore.getSettings().getUseWideViewPort()) { 4525 // when zoom out to min scale, switch to overview mode 4526 doDoubleTap(); 4527 return true; 4528 } else { 4529 // Center zooming to the center of the screen. 4530 mZoomCenterX = getViewWidth() * .5f; 4531 mZoomCenterY = getViewHeight() * .5f; 4532 return zoomWithPreview(scale); 4533 } 4534 } 4535 4536 private void updateSelection() { 4537 if (mNativeClass == 0) { 4538 return; 4539 } 4540 // mLastTouchX and mLastTouchY are the point in the current viewport 4541 int contentX = viewToContentX((int) mLastTouchX + mScrollX); 4542 int contentY = viewToContentY((int) mLastTouchY + mScrollY); 4543 Rect rect = new Rect(contentX - mNavSlop, contentY - mNavSlop, 4544 contentX + mNavSlop, contentY + mNavSlop); 4545 nativeSelectBestAt(rect); 4546 } 4547 4548 /** 4549 * Scroll the focused text field/area to match the WebTextView 4550 * @param xPercent New x position of the WebTextView from 0 to 1. 4551 * @param y New y position of the WebTextView in view coordinates 4552 */ 4553 /*package*/ void scrollFocusedTextInput(float xPercent, int y) { 4554 if (!inEditingMode() || mWebViewCore == null) { 4555 return; 4556 } 4557 mWebViewCore.sendMessage(EventHub.SCROLL_TEXT_INPUT, 4558 // Since this position is relative to the top of the text input 4559 // field, we do not need to take the title bar's height into 4560 // consideration. 4561 viewToContentDimension(y), 4562 new Float(xPercent)); 4563 } 4564 4565 /** 4566 * Set our starting point and time for a drag from the WebTextView. 4567 */ 4568 /*package*/ void initiateTextFieldDrag(float x, float y, long eventTime) { 4569 if (!inEditingMode()) { 4570 return; 4571 } 4572 mLastTouchX = x + (float) (mWebTextView.getLeft() - mScrollX); 4573 mLastTouchY = y + (float) (mWebTextView.getTop() - mScrollY); 4574 mLastTouchTime = eventTime; 4575 if (!mScroller.isFinished()) { 4576 abortAnimation(); 4577 mPrivateHandler.removeMessages(RESUME_WEBCORE_UPDATE); 4578 } 4579 mSnapScrollMode = SNAP_NONE; 4580 mVelocityTracker = VelocityTracker.obtain(); 4581 mTouchMode = TOUCH_DRAG_START_MODE; 4582 } 4583 4584 /** 4585 * Given a motion event from the WebTextView, set its location to our 4586 * coordinates, and handle the event. 4587 */ 4588 /*package*/ boolean textFieldDrag(MotionEvent event) { 4589 if (!inEditingMode()) { 4590 return false; 4591 } 4592 mDragFromTextInput = true; 4593 event.offsetLocation((float) (mWebTextView.getLeft() - mScrollX), 4594 (float) (mWebTextView.getTop() - mScrollY)); 4595 boolean result = onTouchEvent(event); 4596 mDragFromTextInput = false; 4597 return result; 4598 } 4599 4600 /** 4601 * Do a touch up from a WebTextView. This will be handled by webkit to 4602 * change the selection. 4603 * @param event MotionEvent in the WebTextView's coordinates. 4604 */ 4605 /*package*/ void touchUpOnTextField(MotionEvent event) { 4606 if (!inEditingMode()) { 4607 return; 4608 } 4609 int x = viewToContentX((int) event.getX() + mWebTextView.getLeft()); 4610 int y = viewToContentY((int) event.getY() + mWebTextView.getTop()); 4611 // In case the soft keyboard has been dismissed, bring it back up. 4612 InputMethodManager.getInstance(getContext()).showSoftInput(mWebTextView, 4613 0); 4614 if (nativeFocusNodePointer() != nativeCursorNodePointer()) { 4615 nativeMotionUp(x, y, mNavSlop); 4616 } 4617 nativeTextInputMotionUp(x, y); 4618 } 4619 4620 /*package*/ void shortPressOnTextField() { 4621 if (inEditingMode()) { 4622 View v = mWebTextView; 4623 int x = viewToContentX((v.getLeft() + v.getRight()) >> 1); 4624 int y = viewToContentY((v.getTop() + v.getBottom()) >> 1); 4625 nativeTextInputMotionUp(x, y); 4626 } 4627 } 4628 4629 private void doShortPress() { 4630 if (mNativeClass == 0) { 4631 return; 4632 } 4633 switchOutDrawHistory(); 4634 // mLastTouchX and mLastTouchY are the point in the current viewport 4635 int contentX = viewToContentX((int) mLastTouchX + mScrollX); 4636 int contentY = viewToContentY((int) mLastTouchY + mScrollY); 4637 if (nativeMotionUp(contentX, contentY, mNavSlop)) { 4638 if (mLogEvent) { 4639 Checkin.updateStats(mContext.getContentResolver(), 4640 Checkin.Stats.Tag.BROWSER_SNAP_CENTER, 1, 0.0); 4641 } 4642 } 4643 if (nativeHasCursorNode() && !nativeCursorIsTextInput()) { 4644 playSoundEffect(SoundEffectConstants.CLICK); 4645 } 4646 } 4647 4648 private void doDoubleTap() { 4649 if (mWebViewCore.getSettings().getUseWideViewPort() == false) { 4650 return; 4651 } 4652 mZoomCenterX = mLastTouchX; 4653 mZoomCenterY = mLastTouchY; 4654 mInZoomOverview = !mInZoomOverview; 4655 // remove the zoom control after double tap 4656 WebSettings settings = getSettings(); 4657 if (settings.getBuiltInZoomControls()) { 4658 if (mZoomButtonsController.isVisible()) { 4659 mZoomButtonsController.setVisible(false); 4660 } 4661 } else { 4662 if (mZoomControlRunnable != null) { 4663 mPrivateHandler.removeCallbacks(mZoomControlRunnable); 4664 } 4665 if (mZoomControls != null) { 4666 mZoomControls.hide(); 4667 } 4668 } 4669 settings.setDoubleTapToastCount(0); 4670 if (mInZoomOverview) { 4671 // Force the titlebar fully reveal in overview mode 4672 if (mScrollY < getTitleHeight()) mScrollY = 0; 4673 zoomWithPreview((float) getViewWidth() / mZoomOverviewWidth); 4674 } else { 4675 // mLastTouchX and mLastTouchY are the point in the current viewport 4676 int contentX = viewToContentX((int) mLastTouchX + mScrollX); 4677 int contentY = viewToContentY((int) mLastTouchY + mScrollY); 4678 int left = nativeGetBlockLeftEdge(contentX, contentY, mActualScale); 4679 if (left != NO_LEFTEDGE) { 4680 // add a 5pt padding to the left edge. Re-calculate the zoom 4681 // center so that the new scroll x will be on the left edge. 4682 mZoomCenterX = left < 5 ? 0 : (left - 5) * mLastScale 4683 * mActualScale / (mLastScale - mActualScale); 4684 } 4685 zoomWithPreview(mLastScale); 4686 } 4687 } 4688 4689 // Called by JNI to handle a touch on a node representing an email address, 4690 // address, or phone number 4691 private void overrideLoading(String url) { 4692 mCallbackProxy.uiOverrideUrlLoading(url); 4693 } 4694 4695 // called by JNI 4696 private void sendPluginState(int state) { 4697 WebViewCore.PluginStateData psd = new WebViewCore.PluginStateData(); 4698 psd.mFrame = nativeCursorFramePointer(); 4699 psd.mNode = nativeCursorNodePointer(); 4700 psd.mState = state; 4701 mWebViewCore.sendMessage(EventHub.PLUGIN_STATE, psd); 4702 } 4703 4704 @Override 4705 public boolean requestFocus(int direction, Rect previouslyFocusedRect) { 4706 boolean result = false; 4707 if (inEditingMode()) { 4708 result = mWebTextView.requestFocus(direction, 4709 previouslyFocusedRect); 4710 } else { 4711 result = super.requestFocus(direction, previouslyFocusedRect); 4712 if (mWebViewCore.getSettings().getNeedInitialFocus()) { 4713 // For cases such as GMail, where we gain focus from a direction, 4714 // we want to move to the first available link. 4715 // FIXME: If there are no visible links, we may not want to 4716 int fakeKeyDirection = 0; 4717 switch(direction) { 4718 case View.FOCUS_UP: 4719 fakeKeyDirection = KeyEvent.KEYCODE_DPAD_UP; 4720 break; 4721 case View.FOCUS_DOWN: 4722 fakeKeyDirection = KeyEvent.KEYCODE_DPAD_DOWN; 4723 break; 4724 case View.FOCUS_LEFT: 4725 fakeKeyDirection = KeyEvent.KEYCODE_DPAD_LEFT; 4726 break; 4727 case View.FOCUS_RIGHT: 4728 fakeKeyDirection = KeyEvent.KEYCODE_DPAD_RIGHT; 4729 break; 4730 default: 4731 return result; 4732 } 4733 if (mNativeClass != 0 && !nativeHasCursorNode()) { 4734 navHandledKey(fakeKeyDirection, 1, true, 0, true); 4735 } 4736 } 4737 } 4738 return result; 4739 } 4740 4741 @Override 4742 protected void onMeasure(int widthMeasureSpec, int heightMeasureSpec) { 4743 super.onMeasure(widthMeasureSpec, heightMeasureSpec); 4744 4745 int heightMode = MeasureSpec.getMode(heightMeasureSpec); 4746 int heightSize = MeasureSpec.getSize(heightMeasureSpec); 4747 int widthMode = MeasureSpec.getMode(widthMeasureSpec); 4748 int widthSize = MeasureSpec.getSize(widthMeasureSpec); 4749 4750 int measuredHeight = heightSize; 4751 int measuredWidth = widthSize; 4752 4753 // Grab the content size from WebViewCore. 4754 int contentHeight = contentToViewDimension(mContentHeight); 4755 int contentWidth = contentToViewDimension(mContentWidth); 4756 4757// Log.d(LOGTAG, "------- measure " + heightMode); 4758 4759 if (heightMode != MeasureSpec.EXACTLY) { 4760 mHeightCanMeasure = true; 4761 measuredHeight = contentHeight; 4762 if (heightMode == MeasureSpec.AT_MOST) { 4763 // If we are larger than the AT_MOST height, then our height can 4764 // no longer be measured and we should scroll internally. 4765 if (measuredHeight > heightSize) { 4766 measuredHeight = heightSize; 4767 mHeightCanMeasure = false; 4768 } 4769 } 4770 } else { 4771 mHeightCanMeasure = false; 4772 } 4773 if (mNativeClass != 0) { 4774 nativeSetHeightCanMeasure(mHeightCanMeasure); 4775 } 4776 // For the width, always use the given size unless unspecified. 4777 if (widthMode == MeasureSpec.UNSPECIFIED) { 4778 mWidthCanMeasure = true; 4779 measuredWidth = contentWidth; 4780 } else { 4781 mWidthCanMeasure = false; 4782 } 4783 4784 synchronized (this) { 4785 setMeasuredDimension(measuredWidth, measuredHeight); 4786 } 4787 } 4788 4789 @Override 4790 public boolean requestChildRectangleOnScreen(View child, 4791 Rect rect, 4792 boolean immediate) { 4793 rect.offset(child.getLeft() - child.getScrollX(), 4794 child.getTop() - child.getScrollY()); 4795 4796 int height = getViewHeightWithTitle(); 4797 int screenTop = mScrollY; 4798 int screenBottom = screenTop + height; 4799 4800 int scrollYDelta = 0; 4801 4802 if (rect.bottom > screenBottom) { 4803 int oneThirdOfScreenHeight = height / 3; 4804 if (rect.height() > 2 * oneThirdOfScreenHeight) { 4805 // If the rectangle is too tall to fit in the bottom two thirds 4806 // of the screen, place it at the top. 4807 scrollYDelta = rect.top - screenTop; 4808 } else { 4809 // If the rectangle will still fit on screen, we want its 4810 // top to be in the top third of the screen. 4811 scrollYDelta = rect.top - (screenTop + oneThirdOfScreenHeight); 4812 } 4813 } else if (rect.top < screenTop) { 4814 scrollYDelta = rect.top - screenTop; 4815 } 4816 4817 int width = getWidth() - getVerticalScrollbarWidth(); 4818 int screenLeft = mScrollX; 4819 int screenRight = screenLeft + width; 4820 4821 int scrollXDelta = 0; 4822 4823 if (rect.right > screenRight && rect.left > screenLeft) { 4824 if (rect.width() > width) { 4825 scrollXDelta += (rect.left - screenLeft); 4826 } else { 4827 scrollXDelta += (rect.right - screenRight); 4828 } 4829 } else if (rect.left < screenLeft) { 4830 scrollXDelta -= (screenLeft - rect.left); 4831 } 4832 4833 if ((scrollYDelta | scrollXDelta) != 0) { 4834 return pinScrollBy(scrollXDelta, scrollYDelta, !immediate, 0); 4835 } 4836 4837 return false; 4838 } 4839 4840 /* package */ void replaceTextfieldText(int oldStart, int oldEnd, 4841 String replace, int newStart, int newEnd) { 4842 WebViewCore.ReplaceTextData arg = new WebViewCore.ReplaceTextData(); 4843 arg.mReplace = replace; 4844 arg.mNewStart = newStart; 4845 arg.mNewEnd = newEnd; 4846 mTextGeneration++; 4847 arg.mTextGeneration = mTextGeneration; 4848 mWebViewCore.sendMessage(EventHub.REPLACE_TEXT, oldStart, oldEnd, arg); 4849 } 4850 4851 /* package */ void passToJavaScript(String currentText, KeyEvent event) { 4852 if (nativeCursorWantsKeyEvents() && !nativeCursorMatchesFocus()) { 4853 mWebViewCore.sendMessage(EventHub.CLICK); 4854 if (mWebTextView.mOkayForFocusNotToMatch) { 4855 int select = nativeFocusCandidateIsTextField() ? 4856 nativeFocusCandidateMaxLength() : 0; 4857 setSelection(select, select); 4858 } 4859 } 4860 WebViewCore.JSKeyData arg = new WebViewCore.JSKeyData(); 4861 arg.mEvent = event; 4862 arg.mCurrentText = currentText; 4863 // Increase our text generation number, and pass it to webcore thread 4864 mTextGeneration++; 4865 mWebViewCore.sendMessage(EventHub.PASS_TO_JS, mTextGeneration, 0, arg); 4866 // WebKit's document state is not saved until about to leave the page. 4867 // To make sure the host application, like Browser, has the up to date 4868 // document state when it goes to background, we force to save the 4869 // document state. 4870 mWebViewCore.removeMessages(EventHub.SAVE_DOCUMENT_STATE); 4871 mWebViewCore.sendMessageDelayed(EventHub.SAVE_DOCUMENT_STATE, 4872 cursorData(), 1000); 4873 } 4874 4875 /* package */ WebViewCore getWebViewCore() { 4876 return mWebViewCore; 4877 } 4878 4879 //------------------------------------------------------------------------- 4880 // Methods can be called from a separate thread, like WebViewCore 4881 // If it needs to call the View system, it has to send message. 4882 //------------------------------------------------------------------------- 4883 4884 /** 4885 * General handler to receive message coming from webkit thread 4886 */ 4887 class PrivateHandler extends Handler { 4888 @Override 4889 public void handleMessage(Message msg) { 4890 if (DebugFlags.WEB_VIEW) { 4891 Log.v(LOGTAG, msg.what < REMEMBER_PASSWORD || msg.what 4892 > INVAL_RECT_MSG_ID ? Integer.toString(msg.what) 4893 : HandlerDebugString[msg.what - REMEMBER_PASSWORD]); 4894 } 4895 if (mWebViewCore == null) { 4896 // after WebView's destroy() is called, skip handling messages. 4897 return; 4898 } 4899 switch (msg.what) { 4900 case REMEMBER_PASSWORD: { 4901 mDatabase.setUsernamePassword( 4902 msg.getData().getString("host"), 4903 msg.getData().getString("username"), 4904 msg.getData().getString("password")); 4905 ((Message) msg.obj).sendToTarget(); 4906 break; 4907 } 4908 case NEVER_REMEMBER_PASSWORD: { 4909 mDatabase.setUsernamePassword( 4910 msg.getData().getString("host"), null, null); 4911 ((Message) msg.obj).sendToTarget(); 4912 break; 4913 } 4914 case SWITCH_TO_SHORTPRESS: { 4915 // if mPreventDrag is not confirmed, treat it as no so that 4916 // it won't block panning the page. 4917 if (mPreventDrag == PREVENT_DRAG_MAYBE_YES) { 4918 mPreventDrag = PREVENT_DRAG_NO; 4919 } 4920 if (mTouchMode == TOUCH_INIT_MODE) { 4921 mTouchMode = TOUCH_SHORTPRESS_START_MODE; 4922 updateSelection(); 4923 } else if (mTouchMode == TOUCH_DOUBLE_TAP_MODE) { 4924 mTouchMode = TOUCH_DONE_MODE; 4925 } 4926 break; 4927 } 4928 case SWITCH_TO_LONGPRESS: { 4929 if (mPreventDrag == PREVENT_DRAG_NO) { 4930 mTouchMode = TOUCH_DONE_MODE; 4931 performLongClick(); 4932 rebuildWebTextView(); 4933 } 4934 break; 4935 } 4936 case RELEASE_SINGLE_TAP: { 4937 if (mPreventDrag == PREVENT_DRAG_NO) { 4938 mTouchMode = TOUCH_DONE_MODE; 4939 doShortPress(); 4940 } 4941 break; 4942 } 4943 case SCROLL_BY_MSG_ID: 4944 setContentScrollBy(msg.arg1, msg.arg2, (Boolean) msg.obj); 4945 break; 4946 case SYNC_SCROLL_TO_MSG_ID: 4947 if (mUserScroll) { 4948 // if user has scrolled explicitly, don't sync the 4949 // scroll position any more 4950 mUserScroll = false; 4951 break; 4952 } 4953 // fall through 4954 case SCROLL_TO_MSG_ID: 4955 if (setContentScrollTo(msg.arg1, msg.arg2)) { 4956 // if we can't scroll to the exact position due to pin, 4957 // send a message to WebCore to re-scroll when we get a 4958 // new picture 4959 mUserScroll = false; 4960 mWebViewCore.sendMessage(EventHub.SYNC_SCROLL, 4961 msg.arg1, msg.arg2); 4962 } 4963 break; 4964 case SPAWN_SCROLL_TO_MSG_ID: 4965 spawnContentScrollTo(msg.arg1, msg.arg2); 4966 break; 4967 case NEW_PICTURE_MSG_ID: { 4968 WebSettings settings = mWebViewCore.getSettings(); 4969 // called for new content 4970 final int viewWidth = getViewWidth(); 4971 final WebViewCore.DrawData draw = 4972 (WebViewCore.DrawData) msg.obj; 4973 final Point viewSize = draw.mViewPoint; 4974 boolean useWideViewport = settings.getUseWideViewPort(); 4975 WebViewCore.RestoreState restoreState = draw.mRestoreState; 4976 if (restoreState != null) { 4977 mInZoomOverview = false; 4978 mLastScale = restoreState.mTextWrapScale; 4979 if (restoreState.mMinScale == 0) { 4980 if (restoreState.mMobileSite) { 4981 if (draw.mMinPrefWidth > 4982 Math.max(0, draw.mViewPoint.x)) { 4983 mMinZoomScale = (float) viewWidth 4984 / draw.mMinPrefWidth; 4985 mMinZoomScaleFixed = false; 4986 } else { 4987 mMinZoomScale = restoreState.mDefaultScale; 4988 mMinZoomScaleFixed = true; 4989 } 4990 } else { 4991 mMinZoomScale = DEFAULT_MIN_ZOOM_SCALE; 4992 mMinZoomScaleFixed = false; 4993 } 4994 } else { 4995 mMinZoomScale = restoreState.mMinScale; 4996 mMinZoomScaleFixed = true; 4997 } 4998 if (restoreState.mMaxScale == 0) { 4999 mMaxZoomScale = DEFAULT_MAX_ZOOM_SCALE; 5000 } else { 5001 mMaxZoomScale = restoreState.mMaxScale; 5002 } 5003 setNewZoomScale(mLastScale, false); 5004 setContentScrollTo(restoreState.mScrollX, 5005 restoreState.mScrollY); 5006 if (useWideViewport 5007 && settings.getLoadWithOverviewMode()) { 5008 if (restoreState.mViewScale == 0 5009 || (restoreState.mMobileSite 5010 && mMinZoomScale < restoreState.mDefaultScale)) { 5011 mInZoomOverview = true; 5012 } 5013 } 5014 // As we are on a new page, remove the WebTextView. This 5015 // is necessary for page loads driven by webkit, and in 5016 // particular when the user was on a password field, so 5017 // the WebTextView was visible. 5018 clearTextEntry(); 5019 } 5020 // We update the layout (i.e. request a layout from the 5021 // view system) if the last view size that we sent to 5022 // WebCore matches the view size of the picture we just 5023 // received in the fixed dimension. 5024 final boolean updateLayout = viewSize.x == mLastWidthSent 5025 && viewSize.y == mLastHeightSent; 5026 recordNewContentSize(draw.mWidthHeight.x, 5027 draw.mWidthHeight.y 5028 + (mFindIsUp ? mFindHeight : 0), updateLayout); 5029 if (DebugFlags.WEB_VIEW) { 5030 Rect b = draw.mInvalRegion.getBounds(); 5031 Log.v(LOGTAG, "NEW_PICTURE_MSG_ID {" + 5032 b.left+","+b.top+","+b.right+","+b.bottom+"}"); 5033 } 5034 invalidateContentRect(draw.mInvalRegion.getBounds()); 5035 if (mPictureListener != null) { 5036 mPictureListener.onNewPicture(WebView.this, capturePicture()); 5037 } 5038 if (useWideViewport) { 5039 mZoomOverviewWidth = Math.max(draw.mMinPrefWidth, 5040 draw.mViewPoint.x); 5041 } 5042 if (!mMinZoomScaleFixed) { 5043 mMinZoomScale = (float) viewWidth / mZoomOverviewWidth; 5044 } 5045 if (!mDrawHistory && mInZoomOverview) { 5046 // fit the content width to the current view. Ignore 5047 // the rounding error case. 5048 if (Math.abs((viewWidth * mInvActualScale) 5049 - mZoomOverviewWidth) > 1) { 5050 setNewZoomScale((float) viewWidth 5051 / mZoomOverviewWidth, false); 5052 } 5053 } 5054 if (draw.mFocusSizeChanged && inEditingMode()) { 5055 mFocusSizeChanged = true; 5056 } 5057 break; 5058 } 5059 case WEBCORE_INITIALIZED_MSG_ID: 5060 // nativeCreate sets mNativeClass to a non-zero value 5061 nativeCreate(msg.arg1); 5062 break; 5063 case UPDATE_TEXTFIELD_TEXT_MSG_ID: 5064 // Make sure that the textfield is currently focused 5065 // and representing the same node as the pointer. 5066 if (inEditingMode() && 5067 mWebTextView.isSameTextField(msg.arg1)) { 5068 if (msg.getData().getBoolean("password")) { 5069 Spannable text = (Spannable) mWebTextView.getText(); 5070 int start = Selection.getSelectionStart(text); 5071 int end = Selection.getSelectionEnd(text); 5072 mWebTextView.setInPassword(true); 5073 // Restore the selection, which may have been 5074 // ruined by setInPassword. 5075 Spannable pword = 5076 (Spannable) mWebTextView.getText(); 5077 Selection.setSelection(pword, start, end); 5078 // If the text entry has created more events, ignore 5079 // this one. 5080 } else if (msg.arg2 == mTextGeneration) { 5081 mWebTextView.setTextAndKeepSelection( 5082 (String) msg.obj); 5083 } 5084 } 5085 break; 5086 case UPDATE_TEXT_SELECTION_MSG_ID: 5087 if (inEditingMode() 5088 && mWebTextView.isSameTextField(msg.arg1) 5089 && msg.arg2 == mTextGeneration) { 5090 WebViewCore.TextSelectionData tData 5091 = (WebViewCore.TextSelectionData) msg.obj; 5092 mWebTextView.setSelectionFromWebKit(tData.mStart, 5093 tData.mEnd); 5094 } 5095 break; 5096 case MOVE_OUT_OF_PLUGIN: 5097 if (nativePluginEatsNavKey()) { 5098 navHandledKey(msg.arg1, 1, false, 0, true); 5099 } 5100 break; 5101 case UPDATE_TEXT_ENTRY_MSG_ID: 5102 // this is sent after finishing resize in WebViewCore. Make 5103 // sure the text edit box is still on the screen. 5104 if (inEditingMode() && nativeCursorIsTextInput()) { 5105 mWebTextView.bringIntoView(); 5106 rebuildWebTextView(); 5107 } 5108 break; 5109 case CLEAR_TEXT_ENTRY: 5110 clearTextEntry(); 5111 break; 5112 case INVAL_RECT_MSG_ID: { 5113 Rect r = (Rect)msg.obj; 5114 if (r == null) { 5115 invalidate(); 5116 } else { 5117 // we need to scale r from content into view coords, 5118 // which viewInvalidate() does for us 5119 viewInvalidate(r.left, r.top, r.right, r.bottom); 5120 } 5121 break; 5122 } 5123 case REQUEST_FORM_DATA: 5124 AutoCompleteAdapter adapter = (AutoCompleteAdapter) msg.obj; 5125 if (mWebTextView.isSameTextField(msg.arg1)) { 5126 mWebTextView.setAdapterCustom(adapter); 5127 } 5128 break; 5129 case UPDATE_CLIPBOARD: 5130 String str = (String) msg.obj; 5131 if (DebugFlags.WEB_VIEW) { 5132 Log.v(LOGTAG, "UPDATE_CLIPBOARD " + str); 5133 } 5134 try { 5135 IClipboard clip = IClipboard.Stub.asInterface( 5136 ServiceManager.getService("clipboard")); 5137 clip.setClipboardText(str); 5138 } catch (android.os.RemoteException e) { 5139 Log.e(LOGTAG, "Clipboard failed", e); 5140 } 5141 break; 5142 case RESUME_WEBCORE_UPDATE: 5143 WebViewCore.resumeUpdate(mWebViewCore); 5144 break; 5145 5146 case LONG_PRESS_CENTER: 5147 // as this is shared by keydown and trackballdown, reset all 5148 // the states 5149 mGotCenterDown = false; 5150 mTrackballDown = false; 5151 // LONG_PRESS_CENTER is sent as a delayed message. If we 5152 // switch to windows overview, the WebView will be 5153 // temporarily removed from the view system. In that case, 5154 // do nothing. 5155 if (getParent() != null) { 5156 performLongClick(); 5157 } 5158 break; 5159 5160 case WEBCORE_NEED_TOUCH_EVENTS: 5161 mForwardTouchEvents = (msg.arg1 != 0); 5162 break; 5163 5164 case PREVENT_TOUCH_ID: 5165 if (msg.arg1 == MotionEvent.ACTION_DOWN) { 5166 // dont override if mPreventDrag has been set to no due 5167 // to time out 5168 if (mPreventDrag == PREVENT_DRAG_MAYBE_YES) { 5169 mPreventDrag = msg.arg2 == 1 ? PREVENT_DRAG_YES 5170 : PREVENT_DRAG_NO; 5171 if (mPreventDrag == PREVENT_DRAG_YES) { 5172 mTouchMode = TOUCH_DONE_MODE; 5173 } 5174 } 5175 } 5176 break; 5177 5178 case REQUEST_KEYBOARD: 5179 if (msg.arg1 == 0) { 5180 hideSoftKeyboard(); 5181 } else { 5182 displaySoftKeyboard(false); 5183 } 5184 break; 5185 5186 default: 5187 super.handleMessage(msg); 5188 break; 5189 } 5190 } 5191 } 5192 5193 // Class used to use a dropdown for a <select> element 5194 private class InvokeListBox implements Runnable { 5195 // Whether the listbox allows multiple selection. 5196 private boolean mMultiple; 5197 // Passed in to a list with multiple selection to tell 5198 // which items are selected. 5199 private int[] mSelectedArray; 5200 // Passed in to a list with single selection to tell 5201 // where the initial selection is. 5202 private int mSelection; 5203 5204 private Container[] mContainers; 5205 5206 // Need these to provide stable ids to my ArrayAdapter, 5207 // which normally does not have stable ids. (Bug 1250098) 5208 private class Container extends Object { 5209 String mString; 5210 boolean mEnabled; 5211 int mId; 5212 5213 public String toString() { 5214 return mString; 5215 } 5216 } 5217 5218 /** 5219 * Subclass ArrayAdapter so we can disable OptionGroupLabels, 5220 * and allow filtering. 5221 */ 5222 private class MyArrayListAdapter extends ArrayAdapter<Container> { 5223 public MyArrayListAdapter(Context context, Container[] objects, boolean multiple) { 5224 super(context, 5225 multiple ? com.android.internal.R.layout.select_dialog_multichoice : 5226 com.android.internal.R.layout.select_dialog_singlechoice, 5227 objects); 5228 } 5229 5230 @Override 5231 public boolean hasStableIds() { 5232 // AdapterView's onChanged method uses this to determine whether 5233 // to restore the old state. Return false so that the old (out 5234 // of date) state does not replace the new, valid state. 5235 return false; 5236 } 5237 5238 private Container item(int position) { 5239 if (position < 0 || position >= getCount()) { 5240 return null; 5241 } 5242 return (Container) getItem(position); 5243 } 5244 5245 @Override 5246 public long getItemId(int position) { 5247 Container item = item(position); 5248 if (item == null) { 5249 return -1; 5250 } 5251 return item.mId; 5252 } 5253 5254 @Override 5255 public boolean areAllItemsEnabled() { 5256 return false; 5257 } 5258 5259 @Override 5260 public boolean isEnabled(int position) { 5261 Container item = item(position); 5262 if (item == null) { 5263 return false; 5264 } 5265 return item.mEnabled; 5266 } 5267 } 5268 5269 private InvokeListBox(String[] array, 5270 boolean[] enabled, int[] selected) { 5271 mMultiple = true; 5272 mSelectedArray = selected; 5273 5274 int length = array.length; 5275 mContainers = new Container[length]; 5276 for (int i = 0; i < length; i++) { 5277 mContainers[i] = new Container(); 5278 mContainers[i].mString = array[i]; 5279 mContainers[i].mEnabled = enabled[i]; 5280 mContainers[i].mId = i; 5281 } 5282 } 5283 5284 private InvokeListBox(String[] array, boolean[] enabled, int 5285 selection) { 5286 mSelection = selection; 5287 mMultiple = false; 5288 5289 int length = array.length; 5290 mContainers = new Container[length]; 5291 for (int i = 0; i < length; i++) { 5292 mContainers[i] = new Container(); 5293 mContainers[i].mString = array[i]; 5294 mContainers[i].mEnabled = enabled[i]; 5295 mContainers[i].mId = i; 5296 } 5297 } 5298 5299 /* 5300 * Whenever the data set changes due to filtering, this class ensures 5301 * that the checked item remains checked. 5302 */ 5303 private class SingleDataSetObserver extends DataSetObserver { 5304 private long mCheckedId; 5305 private ListView mListView; 5306 private Adapter mAdapter; 5307 5308 /* 5309 * Create a new observer. 5310 * @param id The ID of the item to keep checked. 5311 * @param l ListView for getting and clearing the checked states 5312 * @param a Adapter for getting the IDs 5313 */ 5314 public SingleDataSetObserver(long id, ListView l, Adapter a) { 5315 mCheckedId = id; 5316 mListView = l; 5317 mAdapter = a; 5318 } 5319 5320 public void onChanged() { 5321 // The filter may have changed which item is checked. Find the 5322 // item that the ListView thinks is checked. 5323 int position = mListView.getCheckedItemPosition(); 5324 long id = mAdapter.getItemId(position); 5325 if (mCheckedId != id) { 5326 // Clear the ListView's idea of the checked item, since 5327 // it is incorrect 5328 mListView.clearChoices(); 5329 // Search for mCheckedId. If it is in the filtered list, 5330 // mark it as checked 5331 int count = mAdapter.getCount(); 5332 for (int i = 0; i < count; i++) { 5333 if (mAdapter.getItemId(i) == mCheckedId) { 5334 mListView.setItemChecked(i, true); 5335 break; 5336 } 5337 } 5338 } 5339 } 5340 5341 public void onInvalidate() {} 5342 } 5343 5344 public void run() { 5345 final ListView listView = (ListView) LayoutInflater.from(mContext) 5346 .inflate(com.android.internal.R.layout.select_dialog, null); 5347 final MyArrayListAdapter adapter = new 5348 MyArrayListAdapter(mContext, mContainers, mMultiple); 5349 AlertDialog.Builder b = new AlertDialog.Builder(mContext) 5350 .setView(listView).setCancelable(true) 5351 .setInverseBackgroundForced(true); 5352 5353 if (mMultiple) { 5354 b.setPositiveButton(android.R.string.ok, new DialogInterface.OnClickListener() { 5355 public void onClick(DialogInterface dialog, int which) { 5356 mWebViewCore.sendMessage( 5357 EventHub.LISTBOX_CHOICES, 5358 adapter.getCount(), 0, 5359 listView.getCheckedItemPositions()); 5360 }}); 5361 b.setNegativeButton(android.R.string.cancel, 5362 new DialogInterface.OnClickListener() { 5363 public void onClick(DialogInterface dialog, int which) { 5364 mWebViewCore.sendMessage( 5365 EventHub.SINGLE_LISTBOX_CHOICE, -2, 0); 5366 }}); 5367 } 5368 final AlertDialog dialog = b.create(); 5369 listView.setAdapter(adapter); 5370 listView.setFocusableInTouchMode(true); 5371 // There is a bug (1250103) where the checks in a ListView with 5372 // multiple items selected are associated with the positions, not 5373 // the ids, so the items do not properly retain their checks when 5374 // filtered. Do not allow filtering on multiple lists until 5375 // that bug is fixed. 5376 5377 listView.setTextFilterEnabled(!mMultiple); 5378 if (mMultiple) { 5379 listView.setChoiceMode(ListView.CHOICE_MODE_MULTIPLE); 5380 int length = mSelectedArray.length; 5381 for (int i = 0; i < length; i++) { 5382 listView.setItemChecked(mSelectedArray[i], true); 5383 } 5384 } else { 5385 listView.setOnItemClickListener(new OnItemClickListener() { 5386 public void onItemClick(AdapterView parent, View v, 5387 int position, long id) { 5388 mWebViewCore.sendMessage( 5389 EventHub.SINGLE_LISTBOX_CHOICE, (int)id, 0); 5390 dialog.dismiss(); 5391 } 5392 }); 5393 if (mSelection != -1) { 5394 listView.setSelection(mSelection); 5395 listView.setChoiceMode(ListView.CHOICE_MODE_SINGLE); 5396 listView.setItemChecked(mSelection, true); 5397 DataSetObserver observer = new SingleDataSetObserver( 5398 adapter.getItemId(mSelection), listView, adapter); 5399 adapter.registerDataSetObserver(observer); 5400 } 5401 } 5402 dialog.setOnCancelListener(new DialogInterface.OnCancelListener() { 5403 public void onCancel(DialogInterface dialog) { 5404 mWebViewCore.sendMessage( 5405 EventHub.SINGLE_LISTBOX_CHOICE, -2, 0); 5406 } 5407 }); 5408 dialog.show(); 5409 } 5410 } 5411 5412 /* 5413 * Request a dropdown menu for a listbox with multiple selection. 5414 * 5415 * @param array Labels for the listbox. 5416 * @param enabledArray Which positions are enabled. 5417 * @param selectedArray Which positions are initally selected. 5418 */ 5419 void requestListBox(String[] array, boolean[]enabledArray, int[] 5420 selectedArray) { 5421 mPrivateHandler.post( 5422 new InvokeListBox(array, enabledArray, selectedArray)); 5423 } 5424 5425 /* 5426 * Request a dropdown menu for a listbox with single selection or a single 5427 * <select> element. 5428 * 5429 * @param array Labels for the listbox. 5430 * @param enabledArray Which positions are enabled. 5431 * @param selection Which position is initally selected. 5432 */ 5433 void requestListBox(String[] array, boolean[]enabledArray, int selection) { 5434 mPrivateHandler.post( 5435 new InvokeListBox(array, enabledArray, selection)); 5436 } 5437 5438 // called by JNI 5439 private void sendMoveMouse(int frame, int node, int x, int y) { 5440 mWebViewCore.sendMessage(EventHub.SET_MOVE_MOUSE, 5441 new WebViewCore.CursorData(frame, node, x, y)); 5442 } 5443 5444 /* 5445 * Send a mouse move event to the webcore thread. 5446 * 5447 * @param removeFocus Pass true if the "mouse" cursor is now over a node 5448 * which wants key events, but it is not the focus. This 5449 * will make the visual appear as though nothing is in 5450 * focus. Remove the WebTextView, if present, and stop 5451 * drawing the blinking caret. 5452 * called by JNI 5453 */ 5454 private void sendMoveMouseIfLatest(boolean removeFocus) { 5455 if (removeFocus) { 5456 clearTextEntry(); 5457 setFocusControllerInactive(); 5458 } 5459 mWebViewCore.sendMessage(EventHub.SET_MOVE_MOUSE_IF_LATEST, 5460 cursorData()); 5461 } 5462 5463 // called by JNI 5464 private void sendMotionUp(int touchGeneration, 5465 int frame, int node, int x, int y) { 5466 WebViewCore.TouchUpData touchUpData = new WebViewCore.TouchUpData(); 5467 touchUpData.mMoveGeneration = touchGeneration; 5468 touchUpData.mFrame = frame; 5469 touchUpData.mNode = node; 5470 touchUpData.mX = x; 5471 touchUpData.mY = y; 5472 mWebViewCore.sendMessage(EventHub.TOUCH_UP, touchUpData); 5473 } 5474 5475 5476 private int getScaledMaxXScroll() { 5477 int width; 5478 if (mHeightCanMeasure == false) { 5479 width = getViewWidth() / 4; 5480 } else { 5481 Rect visRect = new Rect(); 5482 calcOurVisibleRect(visRect); 5483 width = visRect.width() / 2; 5484 } 5485 // FIXME the divisor should be retrieved from somewhere 5486 return viewToContentX(width); 5487 } 5488 5489 private int getScaledMaxYScroll() { 5490 int height; 5491 if (mHeightCanMeasure == false) { 5492 height = getViewHeight() / 4; 5493 } else { 5494 Rect visRect = new Rect(); 5495 calcOurVisibleRect(visRect); 5496 height = visRect.height() / 2; 5497 } 5498 // FIXME the divisor should be retrieved from somewhere 5499 // the closest thing today is hard-coded into ScrollView.java 5500 // (from ScrollView.java, line 363) int maxJump = height/2; 5501 return Math.round(height * mInvActualScale); 5502 } 5503 5504 /** 5505 * Called by JNI to invalidate view 5506 */ 5507 private void viewInvalidate() { 5508 invalidate(); 5509 } 5510 5511 // return true if the key was handled 5512 private boolean navHandledKey(int keyCode, int count, boolean noScroll, 5513 long time, boolean ignorePlugin) { 5514 if (mNativeClass == 0) { 5515 return false; 5516 } 5517 if (ignorePlugin == false && nativePluginEatsNavKey()) { 5518 KeyEvent event = new KeyEvent(time, time, KeyEvent.ACTION_DOWN 5519 , keyCode, count, (mShiftIsPressed ? KeyEvent.META_SHIFT_ON : 0) 5520 | (false ? KeyEvent.META_ALT_ON : 0) // FIXME 5521 | (false ? KeyEvent.META_SYM_ON : 0) // FIXME 5522 , 0, 0, 0); 5523 mWebViewCore.sendMessage(EventHub.KEY_DOWN, event); 5524 mWebViewCore.sendMessage(EventHub.KEY_UP, event); 5525 return true; 5526 } 5527 mLastCursorTime = time; 5528 mLastCursorBounds = nativeGetCursorRingBounds(); 5529 boolean keyHandled 5530 = nativeMoveCursor(keyCode, count, noScroll) == false; 5531 if (DebugFlags.WEB_VIEW) { 5532 Log.v(LOGTAG, "navHandledKey mLastCursorBounds=" + mLastCursorBounds 5533 + " mLastCursorTime=" + mLastCursorTime 5534 + " handled=" + keyHandled); 5535 } 5536 if (keyHandled == false || mHeightCanMeasure == false) { 5537 return keyHandled; 5538 } 5539 Rect contentCursorRingBounds = nativeGetCursorRingBounds(); 5540 if (contentCursorRingBounds.isEmpty()) return keyHandled; 5541 Rect viewCursorRingBounds = contentToViewRect(contentCursorRingBounds); 5542 Rect visRect = new Rect(); 5543 calcOurVisibleRect(visRect); 5544 Rect outset = new Rect(visRect); 5545 int maxXScroll = visRect.width() / 2; 5546 int maxYScroll = visRect.height() / 2; 5547 outset.inset(-maxXScroll, -maxYScroll); 5548 if (Rect.intersects(outset, viewCursorRingBounds) == false) { 5549 return keyHandled; 5550 } 5551 // FIXME: Necessary because ScrollView/ListView do not scroll left/right 5552 int maxH = Math.min(viewCursorRingBounds.right - visRect.right, 5553 maxXScroll); 5554 if (maxH > 0) { 5555 pinScrollBy(maxH, 0, true, 0); 5556 } else { 5557 maxH = Math.max(viewCursorRingBounds.left - visRect.left, 5558 -maxXScroll); 5559 if (maxH < 0) { 5560 pinScrollBy(maxH, 0, true, 0); 5561 } 5562 } 5563 if (mLastCursorBounds.isEmpty()) return keyHandled; 5564 if (mLastCursorBounds.equals(contentCursorRingBounds)) { 5565 return keyHandled; 5566 } 5567 if (DebugFlags.WEB_VIEW) { 5568 Log.v(LOGTAG, "navHandledKey contentCursorRingBounds=" 5569 + contentCursorRingBounds); 5570 } 5571 requestRectangleOnScreen(viewCursorRingBounds); 5572 mUserScroll = true; 5573 return keyHandled; 5574 } 5575 5576 /** 5577 * Set the background color. It's white by default. Pass 5578 * zero to make the view transparent. 5579 * @param color the ARGB color described by Color.java 5580 */ 5581 public void setBackgroundColor(int color) { 5582 mBackgroundColor = color; 5583 mWebViewCore.sendMessage(EventHub.SET_BACKGROUND_COLOR, color); 5584 } 5585 5586 public void debugDump() { 5587 nativeDebugDump(); 5588 mWebViewCore.sendMessage(EventHub.DUMP_NAVTREE); 5589 } 5590 5591 /** 5592 * Update our cache with updatedText. 5593 * @param updatedText The new text to put in our cache. 5594 */ 5595 /* package */ void updateCachedTextfield(String updatedText) { 5596 // Also place our generation number so that when we look at the cache 5597 // we recognize that it is up to date. 5598 nativeUpdateCachedTextfield(updatedText, mTextGeneration); 5599 } 5600 5601 /* package */ native void nativeClearCursor(); 5602 private native void nativeCreate(int ptr); 5603 private native int nativeCursorFramePointer(); 5604 private native Rect nativeCursorNodeBounds(); 5605 /* package */ native int nativeCursorNodePointer(); 5606 /* package */ native boolean nativeCursorMatchesFocus(); 5607 private native boolean nativeCursorIntersects(Rect visibleRect); 5608 private native boolean nativeCursorIsAnchor(); 5609 private native boolean nativeCursorIsPlugin(); 5610 private native boolean nativeCursorIsTextInput(); 5611 private native Point nativeCursorPosition(); 5612 private native String nativeCursorText(); 5613 /** 5614 * Returns true if the native cursor node says it wants to handle key events 5615 * (ala plugins). This can only be called if mNativeClass is non-zero! 5616 */ 5617 private native boolean nativeCursorWantsKeyEvents(); 5618 private native void nativeDebugDump(); 5619 private native void nativeDestroy(); 5620 private native void nativeDrawCursorRing(Canvas content); 5621 private native void nativeDrawMatches(Canvas canvas); 5622 private native void nativeDrawSelection(Canvas content 5623 , int x, int y, boolean extendSelection); 5624 private native void nativeDrawSelectionRegion(Canvas content); 5625 private native void nativeDumpDisplayTree(String urlOrNull); 5626 private native int nativeFindAll(String findLower, String findUpper); 5627 private native void nativeFindNext(boolean forward); 5628 private native boolean nativeFocusCandidateIsPassword(); 5629 private native boolean nativeFocusCandidateIsRtlText(); 5630 private native boolean nativeFocusCandidateIsTextField(); 5631 private native boolean nativeFocusCandidateIsTextInput(); 5632 private native int nativeFocusCandidateMaxLength(); 5633 /* package */ native String nativeFocusCandidateName(); 5634 private native Rect nativeFocusCandidateNodeBounds(); 5635 /* package */ native int nativeFocusCandidatePointer(); 5636 private native String nativeFocusCandidateText(); 5637 private native int nativeFocusCandidateTextSize(); 5638 /* package */ native int nativeFocusNodePointer(); 5639 private native Rect nativeGetCursorRingBounds(); 5640 private native Region nativeGetSelection(); 5641 private native boolean nativeHasCursorNode(); 5642 private native boolean nativeHasFocusNode(); 5643 private native void nativeHideCursor(); 5644 private native String nativeImageURI(int x, int y); 5645 private native void nativeInstrumentReport(); 5646 /* package */ native void nativeMoveCursorToNextTextInput(); 5647 // return true if the page has been scrolled 5648 private native boolean nativeMotionUp(int x, int y, int slop); 5649 // returns false if it handled the key 5650 private native boolean nativeMoveCursor(int keyCode, int count, 5651 boolean noScroll); 5652 private native int nativeMoveGeneration(); 5653 private native void nativeMoveSelection(int x, int y, 5654 boolean extendSelection); 5655 private native boolean nativePluginEatsNavKey(); 5656 // Like many other of our native methods, you must make sure that 5657 // mNativeClass is not null before calling this method. 5658 private native void nativeRecordButtons(boolean focused, 5659 boolean pressed, boolean invalidate); 5660 private native void nativeSelectBestAt(Rect rect); 5661 private native void nativeSetFindIsDown(); 5662 private native void nativeSetFollowedLink(boolean followed); 5663 private native void nativeSetHeightCanMeasure(boolean measure); 5664 // Returns a value corresponding to CachedFrame::ImeAction 5665 /* package */ native int nativeTextFieldAction(); 5666 /** 5667 * Perform a click on a currently focused text input. Since it is already 5668 * focused, there is no need to go through the nativeMotionUp code, which 5669 * may change the Cursor. 5670 */ 5671 private native void nativeTextInputMotionUp(int x, int y); 5672 private native int nativeTextGeneration(); 5673 // Never call this version except by updateCachedTextfield(String) - 5674 // we always want to pass in our generation number. 5675 private native void nativeUpdateCachedTextfield(String updatedText, 5676 int generation); 5677 private native void nativeUpdatePluginReceivesEvents(); 5678 // return NO_LEFTEDGE means failure. 5679 private static final int NO_LEFTEDGE = -1; 5680 private native int nativeGetBlockLeftEdge(int x, int y, float scale); 5681} 5682