View.java revision 88b2b90e7d79292229ca92b6bf416bfe61092fb1
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.view;
18
19import android.content.ClipData;
20import android.content.Context;
21import android.content.res.Configuration;
22import android.content.res.Resources;
23import android.content.res.TypedArray;
24import android.graphics.Bitmap;
25import android.graphics.Camera;
26import android.graphics.Canvas;
27import android.graphics.Insets;
28import android.graphics.Interpolator;
29import android.graphics.LinearGradient;
30import android.graphics.Matrix;
31import android.graphics.Paint;
32import android.graphics.PixelFormat;
33import android.graphics.Point;
34import android.graphics.PorterDuff;
35import android.graphics.PorterDuffXfermode;
36import android.graphics.Rect;
37import android.graphics.RectF;
38import android.graphics.Region;
39import android.graphics.Shader;
40import android.graphics.drawable.ColorDrawable;
41import android.graphics.drawable.Drawable;
42import android.os.Bundle;
43import android.os.Handler;
44import android.os.IBinder;
45import android.os.Parcel;
46import android.os.Parcelable;
47import android.os.RemoteException;
48import android.os.SystemClock;
49import android.os.SystemProperties;
50import android.util.AttributeSet;
51import android.util.FloatProperty;
52import android.util.LocaleUtil;
53import android.util.Log;
54import android.util.Pool;
55import android.util.Poolable;
56import android.util.PoolableManager;
57import android.util.Pools;
58import android.util.Property;
59import android.util.SparseArray;
60import android.util.TypedValue;
61import android.view.ContextMenu.ContextMenuInfo;
62import android.view.AccessibilityIterators.TextSegmentIterator;
63import android.view.AccessibilityIterators.CharacterTextSegmentIterator;
64import android.view.AccessibilityIterators.WordTextSegmentIterator;
65import android.view.AccessibilityIterators.ParagraphTextSegmentIterator;
66import android.view.accessibility.AccessibilityEvent;
67import android.view.accessibility.AccessibilityEventSource;
68import android.view.accessibility.AccessibilityManager;
69import android.view.accessibility.AccessibilityNodeInfo;
70import android.view.accessibility.AccessibilityNodeProvider;
71import android.view.animation.Animation;
72import android.view.animation.AnimationUtils;
73import android.view.animation.Transformation;
74import android.view.inputmethod.EditorInfo;
75import android.view.inputmethod.InputConnection;
76import android.view.inputmethod.InputMethodManager;
77import android.widget.ScrollBarDrawable;
78
79import static android.os.Build.VERSION_CODES.*;
80import static java.lang.Math.max;
81
82import com.android.internal.R;
83import com.android.internal.util.Predicate;
84import com.android.internal.view.menu.MenuBuilder;
85
86import java.lang.ref.WeakReference;
87import java.lang.reflect.InvocationTargetException;
88import java.lang.reflect.Method;
89import java.util.ArrayList;
90import java.util.Arrays;
91import java.util.Locale;
92import java.util.concurrent.CopyOnWriteArrayList;
93
94/**
95 * <p>
96 * This class represents the basic building block for user interface components. A View
97 * occupies a rectangular area on the screen and is responsible for drawing and
98 * event handling. View is the base class for <em>widgets</em>, which are
99 * used to create interactive UI components (buttons, text fields, etc.). The
100 * {@link android.view.ViewGroup} subclass is the base class for <em>layouts</em>, which
101 * are invisible containers that hold other Views (or other ViewGroups) and define
102 * their layout properties.
103 * </p>
104 *
105 * <div class="special reference">
106 * <h3>Developer Guides</h3>
107 * <p>For information about using this class to develop your application's user interface,
108 * read the <a href="{@docRoot}guide/topics/ui/index.html">User Interface</a> developer guide.
109 * </div>
110 *
111 * <a name="Using"></a>
112 * <h3>Using Views</h3>
113 * <p>
114 * All of the views in a window are arranged in a single tree. You can add views
115 * either from code or by specifying a tree of views in one or more XML layout
116 * files. There are many specialized subclasses of views that act as controls or
117 * are capable of displaying text, images, or other content.
118 * </p>
119 * <p>
120 * Once you have created a tree of views, there are typically a few types of
121 * common operations you may wish to perform:
122 * <ul>
123 * <li><strong>Set properties:</strong> for example setting the text of a
124 * {@link android.widget.TextView}. The available properties and the methods
125 * that set them will vary among the different subclasses of views. Note that
126 * properties that are known at build time can be set in the XML layout
127 * files.</li>
128 * <li><strong>Set focus:</strong> The framework will handled moving focus in
129 * response to user input. To force focus to a specific view, call
130 * {@link #requestFocus}.</li>
131 * <li><strong>Set up listeners:</strong> Views allow clients to set listeners
132 * that will be notified when something interesting happens to the view. For
133 * example, all views will let you set a listener to be notified when the view
134 * gains or loses focus. You can register such a listener using
135 * {@link #setOnFocusChangeListener(android.view.View.OnFocusChangeListener)}.
136 * Other view subclasses offer more specialized listeners. For example, a Button
137 * exposes a listener to notify clients when the button is clicked.</li>
138 * <li><strong>Set visibility:</strong> You can hide or show views using
139 * {@link #setVisibility(int)}.</li>
140 * </ul>
141 * </p>
142 * <p><em>
143 * Note: The Android framework is responsible for measuring, laying out and
144 * drawing views. You should not call methods that perform these actions on
145 * views yourself unless you are actually implementing a
146 * {@link android.view.ViewGroup}.
147 * </em></p>
148 *
149 * <a name="Lifecycle"></a>
150 * <h3>Implementing a Custom View</h3>
151 *
152 * <p>
153 * To implement a custom view, you will usually begin by providing overrides for
154 * some of the standard methods that the framework calls on all views. You do
155 * not need to override all of these methods. In fact, you can start by just
156 * overriding {@link #onDraw(android.graphics.Canvas)}.
157 * <table border="2" width="85%" align="center" cellpadding="5">
158 *     <thead>
159 *         <tr><th>Category</th> <th>Methods</th> <th>Description</th></tr>
160 *     </thead>
161 *
162 *     <tbody>
163 *     <tr>
164 *         <td rowspan="2">Creation</td>
165 *         <td>Constructors</td>
166 *         <td>There is a form of the constructor that are called when the view
167 *         is created from code and a form that is called when the view is
168 *         inflated from a layout file. The second form should parse and apply
169 *         any attributes defined in the layout file.
170 *         </td>
171 *     </tr>
172 *     <tr>
173 *         <td><code>{@link #onFinishInflate()}</code></td>
174 *         <td>Called after a view and all of its children has been inflated
175 *         from XML.</td>
176 *     </tr>
177 *
178 *     <tr>
179 *         <td rowspan="3">Layout</td>
180 *         <td><code>{@link #onMeasure(int, int)}</code></td>
181 *         <td>Called to determine the size requirements for this view and all
182 *         of its children.
183 *         </td>
184 *     </tr>
185 *     <tr>
186 *         <td><code>{@link #onLayout(boolean, int, int, int, int)}</code></td>
187 *         <td>Called when this view should assign a size and position to all
188 *         of its children.
189 *         </td>
190 *     </tr>
191 *     <tr>
192 *         <td><code>{@link #onSizeChanged(int, int, int, int)}</code></td>
193 *         <td>Called when the size of this view has changed.
194 *         </td>
195 *     </tr>
196 *
197 *     <tr>
198 *         <td>Drawing</td>
199 *         <td><code>{@link #onDraw(android.graphics.Canvas)}</code></td>
200 *         <td>Called when the view should render its content.
201 *         </td>
202 *     </tr>
203 *
204 *     <tr>
205 *         <td rowspan="4">Event processing</td>
206 *         <td><code>{@link #onKeyDown(int, KeyEvent)}</code></td>
207 *         <td>Called when a new key event occurs.
208 *         </td>
209 *     </tr>
210 *     <tr>
211 *         <td><code>{@link #onKeyUp(int, KeyEvent)}</code></td>
212 *         <td>Called when a key up event occurs.
213 *         </td>
214 *     </tr>
215 *     <tr>
216 *         <td><code>{@link #onTrackballEvent(MotionEvent)}</code></td>
217 *         <td>Called when a trackball motion event occurs.
218 *         </td>
219 *     </tr>
220 *     <tr>
221 *         <td><code>{@link #onTouchEvent(MotionEvent)}</code></td>
222 *         <td>Called when a touch screen motion event occurs.
223 *         </td>
224 *     </tr>
225 *
226 *     <tr>
227 *         <td rowspan="2">Focus</td>
228 *         <td><code>{@link #onFocusChanged(boolean, int, android.graphics.Rect)}</code></td>
229 *         <td>Called when the view gains or loses focus.
230 *         </td>
231 *     </tr>
232 *
233 *     <tr>
234 *         <td><code>{@link #onWindowFocusChanged(boolean)}</code></td>
235 *         <td>Called when the window containing the view gains or loses focus.
236 *         </td>
237 *     </tr>
238 *
239 *     <tr>
240 *         <td rowspan="3">Attaching</td>
241 *         <td><code>{@link #onAttachedToWindow()}</code></td>
242 *         <td>Called when the view is attached to a window.
243 *         </td>
244 *     </tr>
245 *
246 *     <tr>
247 *         <td><code>{@link #onDetachedFromWindow}</code></td>
248 *         <td>Called when the view is detached from its window.
249 *         </td>
250 *     </tr>
251 *
252 *     <tr>
253 *         <td><code>{@link #onWindowVisibilityChanged(int)}</code></td>
254 *         <td>Called when the visibility of the window containing the view
255 *         has changed.
256 *         </td>
257 *     </tr>
258 *     </tbody>
259 *
260 * </table>
261 * </p>
262 *
263 * <a name="IDs"></a>
264 * <h3>IDs</h3>
265 * Views may have an integer id associated with them. These ids are typically
266 * assigned in the layout XML files, and are used to find specific views within
267 * the view tree. A common pattern is to:
268 * <ul>
269 * <li>Define a Button in the layout file and assign it a unique ID.
270 * <pre>
271 * &lt;Button
272 *     android:id="@+id/my_button"
273 *     android:layout_width="wrap_content"
274 *     android:layout_height="wrap_content"
275 *     android:text="@string/my_button_text"/&gt;
276 * </pre></li>
277 * <li>From the onCreate method of an Activity, find the Button
278 * <pre class="prettyprint">
279 *      Button myButton = (Button) findViewById(R.id.my_button);
280 * </pre></li>
281 * </ul>
282 * <p>
283 * View IDs need not be unique throughout the tree, but it is good practice to
284 * ensure that they are at least unique within the part of the tree you are
285 * searching.
286 * </p>
287 *
288 * <a name="Position"></a>
289 * <h3>Position</h3>
290 * <p>
291 * The geometry of a view is that of a rectangle. A view has a location,
292 * expressed as a pair of <em>left</em> and <em>top</em> coordinates, and
293 * two dimensions, expressed as a width and a height. The unit for location
294 * and dimensions is the pixel.
295 * </p>
296 *
297 * <p>
298 * It is possible to retrieve the location of a view by invoking the methods
299 * {@link #getLeft()} and {@link #getTop()}. The former returns the left, or X,
300 * coordinate of the rectangle representing the view. The latter returns the
301 * top, or Y, coordinate of the rectangle representing the view. These methods
302 * both return the location of the view relative to its parent. For instance,
303 * when getLeft() returns 20, that means the view is located 20 pixels to the
304 * right of the left edge of its direct parent.
305 * </p>
306 *
307 * <p>
308 * In addition, several convenience methods are offered to avoid unnecessary
309 * computations, namely {@link #getRight()} and {@link #getBottom()}.
310 * These methods return the coordinates of the right and bottom edges of the
311 * rectangle representing the view. For instance, calling {@link #getRight()}
312 * is similar to the following computation: <code>getLeft() + getWidth()</code>
313 * (see <a href="#SizePaddingMargins">Size</a> for more information about the width.)
314 * </p>
315 *
316 * <a name="SizePaddingMargins"></a>
317 * <h3>Size, padding and margins</h3>
318 * <p>
319 * The size of a view is expressed with a width and a height. A view actually
320 * possess two pairs of width and height values.
321 * </p>
322 *
323 * <p>
324 * The first pair is known as <em>measured width</em> and
325 * <em>measured height</em>. These dimensions define how big a view wants to be
326 * within its parent (see <a href="#Layout">Layout</a> for more details.) The
327 * measured dimensions can be obtained by calling {@link #getMeasuredWidth()}
328 * and {@link #getMeasuredHeight()}.
329 * </p>
330 *
331 * <p>
332 * The second pair is simply known as <em>width</em> and <em>height</em>, or
333 * sometimes <em>drawing width</em> and <em>drawing height</em>. These
334 * dimensions define the actual size of the view on screen, at drawing time and
335 * after layout. These values may, but do not have to, be different from the
336 * measured width and height. The width and height can be obtained by calling
337 * {@link #getWidth()} and {@link #getHeight()}.
338 * </p>
339 *
340 * <p>
341 * To measure its dimensions, a view takes into account its padding. The padding
342 * is expressed in pixels for the left, top, right and bottom parts of the view.
343 * Padding can be used to offset the content of the view by a specific amount of
344 * pixels. For instance, a left padding of 2 will push the view's content by
345 * 2 pixels to the right of the left edge. Padding can be set using the
346 * {@link #setPadding(int, int, int, int)} or {@link #setPaddingRelative(int, int, int, int)}
347 * method and queried by calling {@link #getPaddingLeft()}, {@link #getPaddingTop()},
348 * {@link #getPaddingRight()}, {@link #getPaddingBottom()}, {@link #getPaddingStart()},
349 * {@link #getPaddingEnd()}.
350 * </p>
351 *
352 * <p>
353 * Even though a view can define a padding, it does not provide any support for
354 * margins. However, view groups provide such a support. Refer to
355 * {@link android.view.ViewGroup} and
356 * {@link android.view.ViewGroup.MarginLayoutParams} for further information.
357 * </p>
358 *
359 * <a name="Layout"></a>
360 * <h3>Layout</h3>
361 * <p>
362 * Layout is a two pass process: a measure pass and a layout pass. The measuring
363 * pass is implemented in {@link #measure(int, int)} and is a top-down traversal
364 * of the view tree. Each view pushes dimension specifications down the tree
365 * during the recursion. At the end of the measure pass, every view has stored
366 * its measurements. The second pass happens in
367 * {@link #layout(int,int,int,int)} and is also top-down. During
368 * this pass each parent is responsible for positioning all of its children
369 * using the sizes computed in the measure pass.
370 * </p>
371 *
372 * <p>
373 * When a view's measure() method returns, its {@link #getMeasuredWidth()} and
374 * {@link #getMeasuredHeight()} values must be set, along with those for all of
375 * that view's descendants. A view's measured width and measured height values
376 * must respect the constraints imposed by the view's parents. This guarantees
377 * that at the end of the measure pass, all parents accept all of their
378 * children's measurements. A parent view may call measure() more than once on
379 * its children. For example, the parent may measure each child once with
380 * unspecified dimensions to find out how big they want to be, then call
381 * measure() on them again with actual numbers if the sum of all the children's
382 * unconstrained sizes is too big or too small.
383 * </p>
384 *
385 * <p>
386 * The measure pass uses two classes to communicate dimensions. The
387 * {@link MeasureSpec} class is used by views to tell their parents how they
388 * want to be measured and positioned. The base LayoutParams class just
389 * describes how big the view wants to be for both width and height. For each
390 * dimension, it can specify one of:
391 * <ul>
392 * <li> an exact number
393 * <li>MATCH_PARENT, which means the view wants to be as big as its parent
394 * (minus padding)
395 * <li> WRAP_CONTENT, which means that the view wants to be just big enough to
396 * enclose its content (plus padding).
397 * </ul>
398 * There are subclasses of LayoutParams for different subclasses of ViewGroup.
399 * For example, AbsoluteLayout has its own subclass of LayoutParams which adds
400 * an X and Y value.
401 * </p>
402 *
403 * <p>
404 * MeasureSpecs are used to push requirements down the tree from parent to
405 * child. A MeasureSpec can be in one of three modes:
406 * <ul>
407 * <li>UNSPECIFIED: This is used by a parent to determine the desired dimension
408 * of a child view. For example, a LinearLayout may call measure() on its child
409 * with the height set to UNSPECIFIED and a width of EXACTLY 240 to find out how
410 * tall the child view wants to be given a width of 240 pixels.
411 * <li>EXACTLY: This is used by the parent to impose an exact size on the
412 * child. The child must use this size, and guarantee that all of its
413 * descendants will fit within this size.
414 * <li>AT_MOST: This is used by the parent to impose a maximum size on the
415 * child. The child must gurantee that it and all of its descendants will fit
416 * within this size.
417 * </ul>
418 * </p>
419 *
420 * <p>
421 * To intiate a layout, call {@link #requestLayout}. This method is typically
422 * called by a view on itself when it believes that is can no longer fit within
423 * its current bounds.
424 * </p>
425 *
426 * <a name="Drawing"></a>
427 * <h3>Drawing</h3>
428 * <p>
429 * Drawing is handled by walking the tree and rendering each view that
430 * intersects the invalid region. Because the tree is traversed in-order,
431 * this means that parents will draw before (i.e., behind) their children, with
432 * siblings drawn in the order they appear in the tree.
433 * If you set a background drawable for a View, then the View will draw it for you
434 * before calling back to its <code>onDraw()</code> method.
435 * </p>
436 *
437 * <p>
438 * Note that the framework will not draw views that are not in the invalid region.
439 * </p>
440 *
441 * <p>
442 * To force a view to draw, call {@link #invalidate()}.
443 * </p>
444 *
445 * <a name="EventHandlingThreading"></a>
446 * <h3>Event Handling and Threading</h3>
447 * <p>
448 * The basic cycle of a view is as follows:
449 * <ol>
450 * <li>An event comes in and is dispatched to the appropriate view. The view
451 * handles the event and notifies any listeners.</li>
452 * <li>If in the course of processing the event, the view's bounds may need
453 * to be changed, the view will call {@link #requestLayout()}.</li>
454 * <li>Similarly, if in the course of processing the event the view's appearance
455 * may need to be changed, the view will call {@link #invalidate()}.</li>
456 * <li>If either {@link #requestLayout()} or {@link #invalidate()} were called,
457 * the framework will take care of measuring, laying out, and drawing the tree
458 * as appropriate.</li>
459 * </ol>
460 * </p>
461 *
462 * <p><em>Note: The entire view tree is single threaded. You must always be on
463 * the UI thread when calling any method on any view.</em>
464 * If you are doing work on other threads and want to update the state of a view
465 * from that thread, you should use a {@link Handler}.
466 * </p>
467 *
468 * <a name="FocusHandling"></a>
469 * <h3>Focus Handling</h3>
470 * <p>
471 * The framework will handle routine focus movement in response to user input.
472 * This includes changing the focus as views are removed or hidden, or as new
473 * views become available. Views indicate their willingness to take focus
474 * through the {@link #isFocusable} method. To change whether a view can take
475 * focus, call {@link #setFocusable(boolean)}.  When in touch mode (see notes below)
476 * views indicate whether they still would like focus via {@link #isFocusableInTouchMode}
477 * and can change this via {@link #setFocusableInTouchMode(boolean)}.
478 * </p>
479 * <p>
480 * Focus movement is based on an algorithm which finds the nearest neighbor in a
481 * given direction. In rare cases, the default algorithm may not match the
482 * intended behavior of the developer. In these situations, you can provide
483 * explicit overrides by using these XML attributes in the layout file:
484 * <pre>
485 * nextFocusDown
486 * nextFocusLeft
487 * nextFocusRight
488 * nextFocusUp
489 * </pre>
490 * </p>
491 *
492 *
493 * <p>
494 * To get a particular view to take focus, call {@link #requestFocus()}.
495 * </p>
496 *
497 * <a name="TouchMode"></a>
498 * <h3>Touch Mode</h3>
499 * <p>
500 * When a user is navigating a user interface via directional keys such as a D-pad, it is
501 * necessary to give focus to actionable items such as buttons so the user can see
502 * what will take input.  If the device has touch capabilities, however, and the user
503 * begins interacting with the interface by touching it, it is no longer necessary to
504 * always highlight, or give focus to, a particular view.  This motivates a mode
505 * for interaction named 'touch mode'.
506 * </p>
507 * <p>
508 * For a touch capable device, once the user touches the screen, the device
509 * will enter touch mode.  From this point onward, only views for which
510 * {@link #isFocusableInTouchMode} is true will be focusable, such as text editing widgets.
511 * Other views that are touchable, like buttons, will not take focus when touched; they will
512 * only fire the on click listeners.
513 * </p>
514 * <p>
515 * Any time a user hits a directional key, such as a D-pad direction, the view device will
516 * exit touch mode, and find a view to take focus, so that the user may resume interacting
517 * with the user interface without touching the screen again.
518 * </p>
519 * <p>
520 * The touch mode state is maintained across {@link android.app.Activity}s.  Call
521 * {@link #isInTouchMode} to see whether the device is currently in touch mode.
522 * </p>
523 *
524 * <a name="Scrolling"></a>
525 * <h3>Scrolling</h3>
526 * <p>
527 * The framework provides basic support for views that wish to internally
528 * scroll their content. This includes keeping track of the X and Y scroll
529 * offset as well as mechanisms for drawing scrollbars. See
530 * {@link #scrollBy(int, int)}, {@link #scrollTo(int, int)}, and
531 * {@link #awakenScrollBars()} for more details.
532 * </p>
533 *
534 * <a name="Tags"></a>
535 * <h3>Tags</h3>
536 * <p>
537 * Unlike IDs, tags are not used to identify views. Tags are essentially an
538 * extra piece of information that can be associated with a view. They are most
539 * often used as a convenience to store data related to views in the views
540 * themselves rather than by putting them in a separate structure.
541 * </p>
542 *
543 * <a name="Properties"></a>
544 * <h3>Properties</h3>
545 * <p>
546 * The View class exposes an {@link #ALPHA} property, as well as several transform-related
547 * properties, such as {@link #TRANSLATION_X} and {@link #TRANSLATION_Y}. These properties are
548 * available both in the {@link Property} form as well as in similarly-named setter/getter
549 * methods (such as {@link #setAlpha(float)} for {@link #ALPHA}). These properties can
550 * be used to set persistent state associated with these rendering-related properties on the view.
551 * The properties and methods can also be used in conjunction with
552 * {@link android.animation.Animator Animator}-based animations, described more in the
553 * <a href="#Animation">Animation</a> section.
554 * </p>
555 *
556 * <a name="Animation"></a>
557 * <h3>Animation</h3>
558 * <p>
559 * Starting with Android 3.0, the preferred way of animating views is to use the
560 * {@link android.animation} package APIs. These {@link android.animation.Animator Animator}-based
561 * classes change actual properties of the View object, such as {@link #setAlpha(float) alpha} and
562 * {@link #setTranslationX(float) translationX}. This behavior is contrasted to that of the pre-3.0
563 * {@link android.view.animation.Animation Animation}-based classes, which instead animate only
564 * how the view is drawn on the display. In particular, the {@link ViewPropertyAnimator} class
565 * makes animating these View properties particularly easy and efficient.
566 * </p>
567 * <p>
568 * Alternatively, you can use the pre-3.0 animation classes to animate how Views are rendered.
569 * You can attach an {@link Animation} object to a view using
570 * {@link #setAnimation(Animation)} or
571 * {@link #startAnimation(Animation)}. The animation can alter the scale,
572 * rotation, translation and alpha of a view over time. If the animation is
573 * attached to a view that has children, the animation will affect the entire
574 * subtree rooted by that node. When an animation is started, the framework will
575 * take care of redrawing the appropriate views until the animation completes.
576 * </p>
577 *
578 * <a name="Security"></a>
579 * <h3>Security</h3>
580 * <p>
581 * Sometimes it is essential that an application be able to verify that an action
582 * is being performed with the full knowledge and consent of the user, such as
583 * granting a permission request, making a purchase or clicking on an advertisement.
584 * Unfortunately, a malicious application could try to spoof the user into
585 * performing these actions, unaware, by concealing the intended purpose of the view.
586 * As a remedy, the framework offers a touch filtering mechanism that can be used to
587 * improve the security of views that provide access to sensitive functionality.
588 * </p><p>
589 * To enable touch filtering, call {@link #setFilterTouchesWhenObscured(boolean)} or set the
590 * android:filterTouchesWhenObscured layout attribute to true.  When enabled, the framework
591 * will discard touches that are received whenever the view's window is obscured by
592 * another visible window.  As a result, the view will not receive touches whenever a
593 * toast, dialog or other window appears above the view's window.
594 * </p><p>
595 * For more fine-grained control over security, consider overriding the
596 * {@link #onFilterTouchEventForSecurity(MotionEvent)} method to implement your own
597 * security policy. See also {@link MotionEvent#FLAG_WINDOW_IS_OBSCURED}.
598 * </p>
599 *
600 * @attr ref android.R.styleable#View_alpha
601 * @attr ref android.R.styleable#View_background
602 * @attr ref android.R.styleable#View_clickable
603 * @attr ref android.R.styleable#View_contentDescription
604 * @attr ref android.R.styleable#View_drawingCacheQuality
605 * @attr ref android.R.styleable#View_duplicateParentState
606 * @attr ref android.R.styleable#View_id
607 * @attr ref android.R.styleable#View_requiresFadingEdge
608 * @attr ref android.R.styleable#View_fadeScrollbars
609 * @attr ref android.R.styleable#View_fadingEdgeLength
610 * @attr ref android.R.styleable#View_filterTouchesWhenObscured
611 * @attr ref android.R.styleable#View_fitsSystemWindows
612 * @attr ref android.R.styleable#View_isScrollContainer
613 * @attr ref android.R.styleable#View_focusable
614 * @attr ref android.R.styleable#View_focusableInTouchMode
615 * @attr ref android.R.styleable#View_hapticFeedbackEnabled
616 * @attr ref android.R.styleable#View_keepScreenOn
617 * @attr ref android.R.styleable#View_layerType
618 * @attr ref android.R.styleable#View_longClickable
619 * @attr ref android.R.styleable#View_minHeight
620 * @attr ref android.R.styleable#View_minWidth
621 * @attr ref android.R.styleable#View_nextFocusDown
622 * @attr ref android.R.styleable#View_nextFocusLeft
623 * @attr ref android.R.styleable#View_nextFocusRight
624 * @attr ref android.R.styleable#View_nextFocusUp
625 * @attr ref android.R.styleable#View_onClick
626 * @attr ref android.R.styleable#View_padding
627 * @attr ref android.R.styleable#View_paddingBottom
628 * @attr ref android.R.styleable#View_paddingLeft
629 * @attr ref android.R.styleable#View_paddingRight
630 * @attr ref android.R.styleable#View_paddingTop
631 * @attr ref android.R.styleable#View_paddingStart
632 * @attr ref android.R.styleable#View_paddingEnd
633 * @attr ref android.R.styleable#View_saveEnabled
634 * @attr ref android.R.styleable#View_rotation
635 * @attr ref android.R.styleable#View_rotationX
636 * @attr ref android.R.styleable#View_rotationY
637 * @attr ref android.R.styleable#View_scaleX
638 * @attr ref android.R.styleable#View_scaleY
639 * @attr ref android.R.styleable#View_scrollX
640 * @attr ref android.R.styleable#View_scrollY
641 * @attr ref android.R.styleable#View_scrollbarSize
642 * @attr ref android.R.styleable#View_scrollbarStyle
643 * @attr ref android.R.styleable#View_scrollbars
644 * @attr ref android.R.styleable#View_scrollbarDefaultDelayBeforeFade
645 * @attr ref android.R.styleable#View_scrollbarFadeDuration
646 * @attr ref android.R.styleable#View_scrollbarTrackHorizontal
647 * @attr ref android.R.styleable#View_scrollbarThumbHorizontal
648 * @attr ref android.R.styleable#View_scrollbarThumbVertical
649 * @attr ref android.R.styleable#View_scrollbarTrackVertical
650 * @attr ref android.R.styleable#View_scrollbarAlwaysDrawHorizontalTrack
651 * @attr ref android.R.styleable#View_scrollbarAlwaysDrawVerticalTrack
652 * @attr ref android.R.styleable#View_soundEffectsEnabled
653 * @attr ref android.R.styleable#View_tag
654 * @attr ref android.R.styleable#View_textAlignment
655 * @attr ref android.R.styleable#View_transformPivotX
656 * @attr ref android.R.styleable#View_transformPivotY
657 * @attr ref android.R.styleable#View_translationX
658 * @attr ref android.R.styleable#View_translationY
659 * @attr ref android.R.styleable#View_visibility
660 *
661 * @see android.view.ViewGroup
662 */
663public class View implements Drawable.Callback, Drawable.Callback2, KeyEvent.Callback,
664        AccessibilityEventSource {
665    private static final boolean DBG = false;
666
667    /**
668     * The logging tag used by this class with android.util.Log.
669     */
670    protected static final String VIEW_LOG_TAG = "View";
671
672    /**
673     * When set to true, apps will draw debugging information about their layouts.
674     *
675     * @hide
676     */
677    public static final String DEBUG_LAYOUT_PROPERTY = "debug.layout";
678
679    /**
680     * Used to mark a View that has no ID.
681     */
682    public static final int NO_ID = -1;
683
684    /**
685     * This view does not want keystrokes. Use with TAKES_FOCUS_MASK when
686     * calling setFlags.
687     */
688    private static final int NOT_FOCUSABLE = 0x00000000;
689
690    /**
691     * This view wants keystrokes. Use with TAKES_FOCUS_MASK when calling
692     * setFlags.
693     */
694    private static final int FOCUSABLE = 0x00000001;
695
696    /**
697     * Mask for use with setFlags indicating bits used for focus.
698     */
699    private static final int FOCUSABLE_MASK = 0x00000001;
700
701    /**
702     * This view will adjust its padding to fit sytem windows (e.g. status bar)
703     */
704    private static final int FITS_SYSTEM_WINDOWS = 0x00000002;
705
706    /**
707     * This view is visible.
708     * Use with {@link #setVisibility} and <a href="#attr_android:visibility">{@code
709     * android:visibility}.
710     */
711    public static final int VISIBLE = 0x00000000;
712
713    /**
714     * This view is invisible, but it still takes up space for layout purposes.
715     * Use with {@link #setVisibility} and <a href="#attr_android:visibility">{@code
716     * android:visibility}.
717     */
718    public static final int INVISIBLE = 0x00000004;
719
720    /**
721     * This view is invisible, and it doesn't take any space for layout
722     * purposes. Use with {@link #setVisibility} and <a href="#attr_android:visibility">{@code
723     * android:visibility}.
724     */
725    public static final int GONE = 0x00000008;
726
727    /**
728     * Mask for use with setFlags indicating bits used for visibility.
729     * {@hide}
730     */
731    static final int VISIBILITY_MASK = 0x0000000C;
732
733    private static final int[] VISIBILITY_FLAGS = {VISIBLE, INVISIBLE, GONE};
734
735    /**
736     * This view is enabled. Interpretation varies by subclass.
737     * Use with ENABLED_MASK when calling setFlags.
738     * {@hide}
739     */
740    static final int ENABLED = 0x00000000;
741
742    /**
743     * This view is disabled. Interpretation varies by subclass.
744     * Use with ENABLED_MASK when calling setFlags.
745     * {@hide}
746     */
747    static final int DISABLED = 0x00000020;
748
749   /**
750    * Mask for use with setFlags indicating bits used for indicating whether
751    * this view is enabled
752    * {@hide}
753    */
754    static final int ENABLED_MASK = 0x00000020;
755
756    /**
757     * This view won't draw. {@link #onDraw(android.graphics.Canvas)} won't be
758     * called and further optimizations will be performed. It is okay to have
759     * this flag set and a background. Use with DRAW_MASK when calling setFlags.
760     * {@hide}
761     */
762    static final int WILL_NOT_DRAW = 0x00000080;
763
764    /**
765     * Mask for use with setFlags indicating bits used for indicating whether
766     * this view is will draw
767     * {@hide}
768     */
769    static final int DRAW_MASK = 0x00000080;
770
771    /**
772     * <p>This view doesn't show scrollbars.</p>
773     * {@hide}
774     */
775    static final int SCROLLBARS_NONE = 0x00000000;
776
777    /**
778     * <p>This view shows horizontal scrollbars.</p>
779     * {@hide}
780     */
781    static final int SCROLLBARS_HORIZONTAL = 0x00000100;
782
783    /**
784     * <p>This view shows vertical scrollbars.</p>
785     * {@hide}
786     */
787    static final int SCROLLBARS_VERTICAL = 0x00000200;
788
789    /**
790     * <p>Mask for use with setFlags indicating bits used for indicating which
791     * scrollbars are enabled.</p>
792     * {@hide}
793     */
794    static final int SCROLLBARS_MASK = 0x00000300;
795
796    /**
797     * Indicates that the view should filter touches when its window is obscured.
798     * Refer to the class comments for more information about this security feature.
799     * {@hide}
800     */
801    static final int FILTER_TOUCHES_WHEN_OBSCURED = 0x00000400;
802
803    /**
804     * Set for framework elements that use FITS_SYSTEM_WINDOWS, to indicate
805     * that they are optional and should be skipped if the window has
806     * requested system UI flags that ignore those insets for layout.
807     */
808    static final int OPTIONAL_FITS_SYSTEM_WINDOWS = 0x00000800;
809
810    /**
811     * <p>This view doesn't show fading edges.</p>
812     * {@hide}
813     */
814    static final int FADING_EDGE_NONE = 0x00000000;
815
816    /**
817     * <p>This view shows horizontal fading edges.</p>
818     * {@hide}
819     */
820    static final int FADING_EDGE_HORIZONTAL = 0x00001000;
821
822    /**
823     * <p>This view shows vertical fading edges.</p>
824     * {@hide}
825     */
826    static final int FADING_EDGE_VERTICAL = 0x00002000;
827
828    /**
829     * <p>Mask for use with setFlags indicating bits used for indicating which
830     * fading edges are enabled.</p>
831     * {@hide}
832     */
833    static final int FADING_EDGE_MASK = 0x00003000;
834
835    /**
836     * <p>Indicates this view can be clicked. When clickable, a View reacts
837     * to clicks by notifying the OnClickListener.<p>
838     * {@hide}
839     */
840    static final int CLICKABLE = 0x00004000;
841
842    /**
843     * <p>Indicates this view is caching its drawing into a bitmap.</p>
844     * {@hide}
845     */
846    static final int DRAWING_CACHE_ENABLED = 0x00008000;
847
848    /**
849     * <p>Indicates that no icicle should be saved for this view.<p>
850     * {@hide}
851     */
852    static final int SAVE_DISABLED = 0x000010000;
853
854    /**
855     * <p>Mask for use with setFlags indicating bits used for the saveEnabled
856     * property.</p>
857     * {@hide}
858     */
859    static final int SAVE_DISABLED_MASK = 0x000010000;
860
861    /**
862     * <p>Indicates that no drawing cache should ever be created for this view.<p>
863     * {@hide}
864     */
865    static final int WILL_NOT_CACHE_DRAWING = 0x000020000;
866
867    /**
868     * <p>Indicates this view can take / keep focus when int touch mode.</p>
869     * {@hide}
870     */
871    static final int FOCUSABLE_IN_TOUCH_MODE = 0x00040000;
872
873    /**
874     * <p>Enables low quality mode for the drawing cache.</p>
875     */
876    public static final int DRAWING_CACHE_QUALITY_LOW = 0x00080000;
877
878    /**
879     * <p>Enables high quality mode for the drawing cache.</p>
880     */
881    public static final int DRAWING_CACHE_QUALITY_HIGH = 0x00100000;
882
883    /**
884     * <p>Enables automatic quality mode for the drawing cache.</p>
885     */
886    public static final int DRAWING_CACHE_QUALITY_AUTO = 0x00000000;
887
888    private static final int[] DRAWING_CACHE_QUALITY_FLAGS = {
889            DRAWING_CACHE_QUALITY_AUTO, DRAWING_CACHE_QUALITY_LOW, DRAWING_CACHE_QUALITY_HIGH
890    };
891
892    /**
893     * <p>Mask for use with setFlags indicating bits used for the cache
894     * quality property.</p>
895     * {@hide}
896     */
897    static final int DRAWING_CACHE_QUALITY_MASK = 0x00180000;
898
899    /**
900     * <p>
901     * Indicates this view can be long clicked. When long clickable, a View
902     * reacts to long clicks by notifying the OnLongClickListener or showing a
903     * context menu.
904     * </p>
905     * {@hide}
906     */
907    static final int LONG_CLICKABLE = 0x00200000;
908
909    /**
910     * <p>Indicates that this view gets its drawable states from its direct parent
911     * and ignores its original internal states.</p>
912     *
913     * @hide
914     */
915    static final int DUPLICATE_PARENT_STATE = 0x00400000;
916
917    /**
918     * The scrollbar style to display the scrollbars inside the content area,
919     * without increasing the padding. The scrollbars will be overlaid with
920     * translucency on the view's content.
921     */
922    public static final int SCROLLBARS_INSIDE_OVERLAY = 0;
923
924    /**
925     * The scrollbar style to display the scrollbars inside the padded area,
926     * increasing the padding of the view. The scrollbars will not overlap the
927     * content area of the view.
928     */
929    public static final int SCROLLBARS_INSIDE_INSET = 0x01000000;
930
931    /**
932     * The scrollbar style to display the scrollbars at the edge of the view,
933     * without increasing the padding. The scrollbars will be overlaid with
934     * translucency.
935     */
936    public static final int SCROLLBARS_OUTSIDE_OVERLAY = 0x02000000;
937
938    /**
939     * The scrollbar style to display the scrollbars at the edge of the view,
940     * increasing the padding of the view. The scrollbars will only overlap the
941     * background, if any.
942     */
943    public static final int SCROLLBARS_OUTSIDE_INSET = 0x03000000;
944
945    /**
946     * Mask to check if the scrollbar style is overlay or inset.
947     * {@hide}
948     */
949    static final int SCROLLBARS_INSET_MASK = 0x01000000;
950
951    /**
952     * Mask to check if the scrollbar style is inside or outside.
953     * {@hide}
954     */
955    static final int SCROLLBARS_OUTSIDE_MASK = 0x02000000;
956
957    /**
958     * Mask for scrollbar style.
959     * {@hide}
960     */
961    static final int SCROLLBARS_STYLE_MASK = 0x03000000;
962
963    /**
964     * View flag indicating that the screen should remain on while the
965     * window containing this view is visible to the user.  This effectively
966     * takes care of automatically setting the WindowManager's
967     * {@link WindowManager.LayoutParams#FLAG_KEEP_SCREEN_ON}.
968     */
969    public static final int KEEP_SCREEN_ON = 0x04000000;
970
971    /**
972     * View flag indicating whether this view should have sound effects enabled
973     * for events such as clicking and touching.
974     */
975    public static final int SOUND_EFFECTS_ENABLED = 0x08000000;
976
977    /**
978     * View flag indicating whether this view should have haptic feedback
979     * enabled for events such as long presses.
980     */
981    public static final int HAPTIC_FEEDBACK_ENABLED = 0x10000000;
982
983    /**
984     * <p>Indicates that the view hierarchy should stop saving state when
985     * it reaches this view.  If state saving is initiated immediately at
986     * the view, it will be allowed.
987     * {@hide}
988     */
989    static final int PARENT_SAVE_DISABLED = 0x20000000;
990
991    /**
992     * <p>Mask for use with setFlags indicating bits used for PARENT_SAVE_DISABLED.</p>
993     * {@hide}
994     */
995    static final int PARENT_SAVE_DISABLED_MASK = 0x20000000;
996
997    /**
998     * View flag indicating whether {@link #addFocusables(ArrayList, int, int)}
999     * should add all focusable Views regardless if they are focusable in touch mode.
1000     */
1001    public static final int FOCUSABLES_ALL = 0x00000000;
1002
1003    /**
1004     * View flag indicating whether {@link #addFocusables(ArrayList, int, int)}
1005     * should add only Views focusable in touch mode.
1006     */
1007    public static final int FOCUSABLES_TOUCH_MODE = 0x00000001;
1008
1009    /**
1010     * View flag indicating whether {@link #addFocusables(ArrayList, int, int)}
1011     * should add only accessibility focusable Views.
1012     *
1013     * @hide
1014     */
1015    public static final int FOCUSABLES_ACCESSIBILITY = 0x00000002;
1016
1017    /**
1018     * Use with {@link #focusSearch(int)}. Move focus to the previous selectable
1019     * item.
1020     */
1021    public static final int FOCUS_BACKWARD = 0x00000001;
1022
1023    /**
1024     * Use with {@link #focusSearch(int)}. Move focus to the next selectable
1025     * item.
1026     */
1027    public static final int FOCUS_FORWARD = 0x00000002;
1028
1029    /**
1030     * Use with {@link #focusSearch(int)}. Move focus to the left.
1031     */
1032    public static final int FOCUS_LEFT = 0x00000011;
1033
1034    /**
1035     * Use with {@link #focusSearch(int)}. Move focus up.
1036     */
1037    public static final int FOCUS_UP = 0x00000021;
1038
1039    /**
1040     * Use with {@link #focusSearch(int)}. Move focus to the right.
1041     */
1042    public static final int FOCUS_RIGHT = 0x00000042;
1043
1044    /**
1045     * Use with {@link #focusSearch(int)}. Move focus down.
1046     */
1047    public static final int FOCUS_DOWN = 0x00000082;
1048
1049    // Accessibility focus directions.
1050
1051    /**
1052     * The accessibility focus which is the current user position when
1053     * interacting with the accessibility framework.
1054     */
1055    public static final int FOCUS_ACCESSIBILITY =  0x00001000;
1056
1057    /**
1058     * Use with {@link #focusSearch(int)}. Move acessibility focus left.
1059     */
1060    public static final int ACCESSIBILITY_FOCUS_LEFT = FOCUS_LEFT | FOCUS_ACCESSIBILITY;
1061
1062    /**
1063     * Use with {@link #focusSearch(int)}. Move acessibility focus up.
1064     */
1065    public static final int ACCESSIBILITY_FOCUS_UP = FOCUS_UP | FOCUS_ACCESSIBILITY;
1066
1067    /**
1068     * Use with {@link #focusSearch(int)}. Move acessibility focus right.
1069     */
1070    public static final int ACCESSIBILITY_FOCUS_RIGHT = FOCUS_RIGHT | FOCUS_ACCESSIBILITY;
1071
1072    /**
1073     * Use with {@link #focusSearch(int)}. Move acessibility focus down.
1074     */
1075    public static final int ACCESSIBILITY_FOCUS_DOWN = FOCUS_DOWN | FOCUS_ACCESSIBILITY;
1076
1077    /**
1078     * Use with {@link #focusSearch(int)}. Move acessibility focus forward.
1079     */
1080    public static final int ACCESSIBILITY_FOCUS_FORWARD = FOCUS_FORWARD | FOCUS_ACCESSIBILITY;
1081
1082    /**
1083     * Use with {@link #focusSearch(int)}. Move acessibility focus backward.
1084     */
1085    public static final int ACCESSIBILITY_FOCUS_BACKWARD = FOCUS_BACKWARD | FOCUS_ACCESSIBILITY;
1086
1087    /**
1088     * Bits of {@link #getMeasuredWidthAndState()} and
1089     * {@link #getMeasuredWidthAndState()} that provide the actual measured size.
1090     */
1091    public static final int MEASURED_SIZE_MASK = 0x00ffffff;
1092
1093    /**
1094     * Bits of {@link #getMeasuredWidthAndState()} and
1095     * {@link #getMeasuredWidthAndState()} that provide the additional state bits.
1096     */
1097    public static final int MEASURED_STATE_MASK = 0xff000000;
1098
1099    /**
1100     * Bit shift of {@link #MEASURED_STATE_MASK} to get to the height bits
1101     * for functions that combine both width and height into a single int,
1102     * such as {@link #getMeasuredState()} and the childState argument of
1103     * {@link #resolveSizeAndState(int, int, int)}.
1104     */
1105    public static final int MEASURED_HEIGHT_STATE_SHIFT = 16;
1106
1107    /**
1108     * Bit of {@link #getMeasuredWidthAndState()} and
1109     * {@link #getMeasuredWidthAndState()} that indicates the measured size
1110     * is smaller that the space the view would like to have.
1111     */
1112    public static final int MEASURED_STATE_TOO_SMALL = 0x01000000;
1113
1114    /**
1115     * Base View state sets
1116     */
1117    // Singles
1118    /**
1119     * Indicates the view has no states set. States are used with
1120     * {@link android.graphics.drawable.Drawable} to change the drawing of the
1121     * view depending on its state.
1122     *
1123     * @see android.graphics.drawable.Drawable
1124     * @see #getDrawableState()
1125     */
1126    protected static final int[] EMPTY_STATE_SET;
1127    /**
1128     * Indicates the view is enabled. States are used with
1129     * {@link android.graphics.drawable.Drawable} to change the drawing of the
1130     * view depending on its state.
1131     *
1132     * @see android.graphics.drawable.Drawable
1133     * @see #getDrawableState()
1134     */
1135    protected static final int[] ENABLED_STATE_SET;
1136    /**
1137     * Indicates the view is focused. States are used with
1138     * {@link android.graphics.drawable.Drawable} to change the drawing of the
1139     * view depending on its state.
1140     *
1141     * @see android.graphics.drawable.Drawable
1142     * @see #getDrawableState()
1143     */
1144    protected static final int[] FOCUSED_STATE_SET;
1145    /**
1146     * Indicates the view is selected. States are used with
1147     * {@link android.graphics.drawable.Drawable} to change the drawing of the
1148     * view depending on its state.
1149     *
1150     * @see android.graphics.drawable.Drawable
1151     * @see #getDrawableState()
1152     */
1153    protected static final int[] SELECTED_STATE_SET;
1154    /**
1155     * Indicates the view is pressed. States are used with
1156     * {@link android.graphics.drawable.Drawable} to change the drawing of the
1157     * view depending on its state.
1158     *
1159     * @see android.graphics.drawable.Drawable
1160     * @see #getDrawableState()
1161     * @hide
1162     */
1163    protected static final int[] PRESSED_STATE_SET;
1164    /**
1165     * Indicates the view's window has focus. States are used with
1166     * {@link android.graphics.drawable.Drawable} to change the drawing of the
1167     * view depending on its state.
1168     *
1169     * @see android.graphics.drawable.Drawable
1170     * @see #getDrawableState()
1171     */
1172    protected static final int[] WINDOW_FOCUSED_STATE_SET;
1173    // Doubles
1174    /**
1175     * Indicates the view is enabled and has the focus.
1176     *
1177     * @see #ENABLED_STATE_SET
1178     * @see #FOCUSED_STATE_SET
1179     */
1180    protected static final int[] ENABLED_FOCUSED_STATE_SET;
1181    /**
1182     * Indicates the view is enabled and selected.
1183     *
1184     * @see #ENABLED_STATE_SET
1185     * @see #SELECTED_STATE_SET
1186     */
1187    protected static final int[] ENABLED_SELECTED_STATE_SET;
1188    /**
1189     * Indicates the view is enabled and that its window has focus.
1190     *
1191     * @see #ENABLED_STATE_SET
1192     * @see #WINDOW_FOCUSED_STATE_SET
1193     */
1194    protected static final int[] ENABLED_WINDOW_FOCUSED_STATE_SET;
1195    /**
1196     * Indicates the view is focused and selected.
1197     *
1198     * @see #FOCUSED_STATE_SET
1199     * @see #SELECTED_STATE_SET
1200     */
1201    protected static final int[] FOCUSED_SELECTED_STATE_SET;
1202    /**
1203     * Indicates the view has the focus and that its window has the focus.
1204     *
1205     * @see #FOCUSED_STATE_SET
1206     * @see #WINDOW_FOCUSED_STATE_SET
1207     */
1208    protected static final int[] FOCUSED_WINDOW_FOCUSED_STATE_SET;
1209    /**
1210     * Indicates the view is selected and that its window has the focus.
1211     *
1212     * @see #SELECTED_STATE_SET
1213     * @see #WINDOW_FOCUSED_STATE_SET
1214     */
1215    protected static final int[] SELECTED_WINDOW_FOCUSED_STATE_SET;
1216    // Triples
1217    /**
1218     * Indicates the view is enabled, focused and selected.
1219     *
1220     * @see #ENABLED_STATE_SET
1221     * @see #FOCUSED_STATE_SET
1222     * @see #SELECTED_STATE_SET
1223     */
1224    protected static final int[] ENABLED_FOCUSED_SELECTED_STATE_SET;
1225    /**
1226     * Indicates the view is enabled, focused and its window has the focus.
1227     *
1228     * @see #ENABLED_STATE_SET
1229     * @see #FOCUSED_STATE_SET
1230     * @see #WINDOW_FOCUSED_STATE_SET
1231     */
1232    protected static final int[] ENABLED_FOCUSED_WINDOW_FOCUSED_STATE_SET;
1233    /**
1234     * Indicates the view is enabled, selected and its window has the focus.
1235     *
1236     * @see #ENABLED_STATE_SET
1237     * @see #SELECTED_STATE_SET
1238     * @see #WINDOW_FOCUSED_STATE_SET
1239     */
1240    protected static final int[] ENABLED_SELECTED_WINDOW_FOCUSED_STATE_SET;
1241    /**
1242     * Indicates the view is focused, selected and its window has the focus.
1243     *
1244     * @see #FOCUSED_STATE_SET
1245     * @see #SELECTED_STATE_SET
1246     * @see #WINDOW_FOCUSED_STATE_SET
1247     */
1248    protected static final int[] FOCUSED_SELECTED_WINDOW_FOCUSED_STATE_SET;
1249    /**
1250     * Indicates the view is enabled, focused, selected and its window
1251     * has the focus.
1252     *
1253     * @see #ENABLED_STATE_SET
1254     * @see #FOCUSED_STATE_SET
1255     * @see #SELECTED_STATE_SET
1256     * @see #WINDOW_FOCUSED_STATE_SET
1257     */
1258    protected static final int[] ENABLED_FOCUSED_SELECTED_WINDOW_FOCUSED_STATE_SET;
1259    /**
1260     * Indicates the view is pressed and its window has the focus.
1261     *
1262     * @see #PRESSED_STATE_SET
1263     * @see #WINDOW_FOCUSED_STATE_SET
1264     */
1265    protected static final int[] PRESSED_WINDOW_FOCUSED_STATE_SET;
1266    /**
1267     * Indicates the view is pressed and selected.
1268     *
1269     * @see #PRESSED_STATE_SET
1270     * @see #SELECTED_STATE_SET
1271     */
1272    protected static final int[] PRESSED_SELECTED_STATE_SET;
1273    /**
1274     * Indicates the view is pressed, selected and its window has the focus.
1275     *
1276     * @see #PRESSED_STATE_SET
1277     * @see #SELECTED_STATE_SET
1278     * @see #WINDOW_FOCUSED_STATE_SET
1279     */
1280    protected static final int[] PRESSED_SELECTED_WINDOW_FOCUSED_STATE_SET;
1281    /**
1282     * Indicates the view is pressed and focused.
1283     *
1284     * @see #PRESSED_STATE_SET
1285     * @see #FOCUSED_STATE_SET
1286     */
1287    protected static final int[] PRESSED_FOCUSED_STATE_SET;
1288    /**
1289     * Indicates the view is pressed, focused and its window has the focus.
1290     *
1291     * @see #PRESSED_STATE_SET
1292     * @see #FOCUSED_STATE_SET
1293     * @see #WINDOW_FOCUSED_STATE_SET
1294     */
1295    protected static final int[] PRESSED_FOCUSED_WINDOW_FOCUSED_STATE_SET;
1296    /**
1297     * Indicates the view is pressed, focused and selected.
1298     *
1299     * @see #PRESSED_STATE_SET
1300     * @see #SELECTED_STATE_SET
1301     * @see #FOCUSED_STATE_SET
1302     */
1303    protected static final int[] PRESSED_FOCUSED_SELECTED_STATE_SET;
1304    /**
1305     * Indicates the view is pressed, focused, selected and its window has the focus.
1306     *
1307     * @see #PRESSED_STATE_SET
1308     * @see #FOCUSED_STATE_SET
1309     * @see #SELECTED_STATE_SET
1310     * @see #WINDOW_FOCUSED_STATE_SET
1311     */
1312    protected static final int[] PRESSED_FOCUSED_SELECTED_WINDOW_FOCUSED_STATE_SET;
1313    /**
1314     * Indicates the view is pressed and enabled.
1315     *
1316     * @see #PRESSED_STATE_SET
1317     * @see #ENABLED_STATE_SET
1318     */
1319    protected static final int[] PRESSED_ENABLED_STATE_SET;
1320    /**
1321     * Indicates the view is pressed, enabled and its window has the focus.
1322     *
1323     * @see #PRESSED_STATE_SET
1324     * @see #ENABLED_STATE_SET
1325     * @see #WINDOW_FOCUSED_STATE_SET
1326     */
1327    protected static final int[] PRESSED_ENABLED_WINDOW_FOCUSED_STATE_SET;
1328    /**
1329     * Indicates the view is pressed, enabled and selected.
1330     *
1331     * @see #PRESSED_STATE_SET
1332     * @see #ENABLED_STATE_SET
1333     * @see #SELECTED_STATE_SET
1334     */
1335    protected static final int[] PRESSED_ENABLED_SELECTED_STATE_SET;
1336    /**
1337     * Indicates the view is pressed, enabled, selected and its window has the
1338     * focus.
1339     *
1340     * @see #PRESSED_STATE_SET
1341     * @see #ENABLED_STATE_SET
1342     * @see #SELECTED_STATE_SET
1343     * @see #WINDOW_FOCUSED_STATE_SET
1344     */
1345    protected static final int[] PRESSED_ENABLED_SELECTED_WINDOW_FOCUSED_STATE_SET;
1346    /**
1347     * Indicates the view is pressed, enabled and focused.
1348     *
1349     * @see #PRESSED_STATE_SET
1350     * @see #ENABLED_STATE_SET
1351     * @see #FOCUSED_STATE_SET
1352     */
1353    protected static final int[] PRESSED_ENABLED_FOCUSED_STATE_SET;
1354    /**
1355     * Indicates the view is pressed, enabled, focused and its window has the
1356     * focus.
1357     *
1358     * @see #PRESSED_STATE_SET
1359     * @see #ENABLED_STATE_SET
1360     * @see #FOCUSED_STATE_SET
1361     * @see #WINDOW_FOCUSED_STATE_SET
1362     */
1363    protected static final int[] PRESSED_ENABLED_FOCUSED_WINDOW_FOCUSED_STATE_SET;
1364    /**
1365     * Indicates the view is pressed, enabled, focused and selected.
1366     *
1367     * @see #PRESSED_STATE_SET
1368     * @see #ENABLED_STATE_SET
1369     * @see #SELECTED_STATE_SET
1370     * @see #FOCUSED_STATE_SET
1371     */
1372    protected static final int[] PRESSED_ENABLED_FOCUSED_SELECTED_STATE_SET;
1373    /**
1374     * Indicates the view is pressed, enabled, focused, selected and its window
1375     * has the focus.
1376     *
1377     * @see #PRESSED_STATE_SET
1378     * @see #ENABLED_STATE_SET
1379     * @see #SELECTED_STATE_SET
1380     * @see #FOCUSED_STATE_SET
1381     * @see #WINDOW_FOCUSED_STATE_SET
1382     */
1383    protected static final int[] PRESSED_ENABLED_FOCUSED_SELECTED_WINDOW_FOCUSED_STATE_SET;
1384
1385    /**
1386     * The order here is very important to {@link #getDrawableState()}
1387     */
1388    private static final int[][] VIEW_STATE_SETS;
1389
1390    static final int VIEW_STATE_WINDOW_FOCUSED = 1;
1391    static final int VIEW_STATE_SELECTED = 1 << 1;
1392    static final int VIEW_STATE_FOCUSED = 1 << 2;
1393    static final int VIEW_STATE_ENABLED = 1 << 3;
1394    static final int VIEW_STATE_PRESSED = 1 << 4;
1395    static final int VIEW_STATE_ACTIVATED = 1 << 5;
1396    static final int VIEW_STATE_ACCELERATED = 1 << 6;
1397    static final int VIEW_STATE_HOVERED = 1 << 7;
1398    static final int VIEW_STATE_DRAG_CAN_ACCEPT = 1 << 8;
1399    static final int VIEW_STATE_DRAG_HOVERED = 1 << 9;
1400
1401    static final int[] VIEW_STATE_IDS = new int[] {
1402        R.attr.state_window_focused,    VIEW_STATE_WINDOW_FOCUSED,
1403        R.attr.state_selected,          VIEW_STATE_SELECTED,
1404        R.attr.state_focused,           VIEW_STATE_FOCUSED,
1405        R.attr.state_enabled,           VIEW_STATE_ENABLED,
1406        R.attr.state_pressed,           VIEW_STATE_PRESSED,
1407        R.attr.state_activated,         VIEW_STATE_ACTIVATED,
1408        R.attr.state_accelerated,       VIEW_STATE_ACCELERATED,
1409        R.attr.state_hovered,           VIEW_STATE_HOVERED,
1410        R.attr.state_drag_can_accept,   VIEW_STATE_DRAG_CAN_ACCEPT,
1411        R.attr.state_drag_hovered,      VIEW_STATE_DRAG_HOVERED
1412    };
1413
1414    static {
1415        if ((VIEW_STATE_IDS.length/2) != R.styleable.ViewDrawableStates.length) {
1416            throw new IllegalStateException(
1417                    "VIEW_STATE_IDs array length does not match ViewDrawableStates style array");
1418        }
1419        int[] orderedIds = new int[VIEW_STATE_IDS.length];
1420        for (int i = 0; i < R.styleable.ViewDrawableStates.length; i++) {
1421            int viewState = R.styleable.ViewDrawableStates[i];
1422            for (int j = 0; j<VIEW_STATE_IDS.length; j += 2) {
1423                if (VIEW_STATE_IDS[j] == viewState) {
1424                    orderedIds[i * 2] = viewState;
1425                    orderedIds[i * 2 + 1] = VIEW_STATE_IDS[j + 1];
1426                }
1427            }
1428        }
1429        final int NUM_BITS = VIEW_STATE_IDS.length / 2;
1430        VIEW_STATE_SETS = new int[1 << NUM_BITS][];
1431        for (int i = 0; i < VIEW_STATE_SETS.length; i++) {
1432            int numBits = Integer.bitCount(i);
1433            int[] set = new int[numBits];
1434            int pos = 0;
1435            for (int j = 0; j < orderedIds.length; j += 2) {
1436                if ((i & orderedIds[j+1]) != 0) {
1437                    set[pos++] = orderedIds[j];
1438                }
1439            }
1440            VIEW_STATE_SETS[i] = set;
1441        }
1442
1443        EMPTY_STATE_SET = VIEW_STATE_SETS[0];
1444        WINDOW_FOCUSED_STATE_SET = VIEW_STATE_SETS[VIEW_STATE_WINDOW_FOCUSED];
1445        SELECTED_STATE_SET = VIEW_STATE_SETS[VIEW_STATE_SELECTED];
1446        SELECTED_WINDOW_FOCUSED_STATE_SET = VIEW_STATE_SETS[
1447                VIEW_STATE_WINDOW_FOCUSED | VIEW_STATE_SELECTED];
1448        FOCUSED_STATE_SET = VIEW_STATE_SETS[VIEW_STATE_FOCUSED];
1449        FOCUSED_WINDOW_FOCUSED_STATE_SET = VIEW_STATE_SETS[
1450                VIEW_STATE_WINDOW_FOCUSED | VIEW_STATE_FOCUSED];
1451        FOCUSED_SELECTED_STATE_SET = VIEW_STATE_SETS[
1452                VIEW_STATE_SELECTED | VIEW_STATE_FOCUSED];
1453        FOCUSED_SELECTED_WINDOW_FOCUSED_STATE_SET = VIEW_STATE_SETS[
1454                VIEW_STATE_WINDOW_FOCUSED | VIEW_STATE_SELECTED
1455                | VIEW_STATE_FOCUSED];
1456        ENABLED_STATE_SET = VIEW_STATE_SETS[VIEW_STATE_ENABLED];
1457        ENABLED_WINDOW_FOCUSED_STATE_SET = VIEW_STATE_SETS[
1458                VIEW_STATE_WINDOW_FOCUSED | VIEW_STATE_ENABLED];
1459        ENABLED_SELECTED_STATE_SET = VIEW_STATE_SETS[
1460                VIEW_STATE_SELECTED | VIEW_STATE_ENABLED];
1461        ENABLED_SELECTED_WINDOW_FOCUSED_STATE_SET = VIEW_STATE_SETS[
1462                VIEW_STATE_WINDOW_FOCUSED | VIEW_STATE_SELECTED
1463                | VIEW_STATE_ENABLED];
1464        ENABLED_FOCUSED_STATE_SET = VIEW_STATE_SETS[
1465                VIEW_STATE_FOCUSED | VIEW_STATE_ENABLED];
1466        ENABLED_FOCUSED_WINDOW_FOCUSED_STATE_SET = VIEW_STATE_SETS[
1467                VIEW_STATE_WINDOW_FOCUSED | VIEW_STATE_FOCUSED
1468                | VIEW_STATE_ENABLED];
1469        ENABLED_FOCUSED_SELECTED_STATE_SET = VIEW_STATE_SETS[
1470                VIEW_STATE_SELECTED | VIEW_STATE_FOCUSED
1471                | VIEW_STATE_ENABLED];
1472        ENABLED_FOCUSED_SELECTED_WINDOW_FOCUSED_STATE_SET = VIEW_STATE_SETS[
1473                VIEW_STATE_WINDOW_FOCUSED | VIEW_STATE_SELECTED
1474                | VIEW_STATE_FOCUSED| VIEW_STATE_ENABLED];
1475
1476        PRESSED_STATE_SET = VIEW_STATE_SETS[VIEW_STATE_PRESSED];
1477        PRESSED_WINDOW_FOCUSED_STATE_SET = VIEW_STATE_SETS[
1478                VIEW_STATE_WINDOW_FOCUSED | VIEW_STATE_PRESSED];
1479        PRESSED_SELECTED_STATE_SET = VIEW_STATE_SETS[
1480                VIEW_STATE_SELECTED | VIEW_STATE_PRESSED];
1481        PRESSED_SELECTED_WINDOW_FOCUSED_STATE_SET = VIEW_STATE_SETS[
1482                VIEW_STATE_WINDOW_FOCUSED | VIEW_STATE_SELECTED
1483                | VIEW_STATE_PRESSED];
1484        PRESSED_FOCUSED_STATE_SET = VIEW_STATE_SETS[
1485                VIEW_STATE_FOCUSED | VIEW_STATE_PRESSED];
1486        PRESSED_FOCUSED_WINDOW_FOCUSED_STATE_SET = VIEW_STATE_SETS[
1487                VIEW_STATE_WINDOW_FOCUSED | VIEW_STATE_FOCUSED
1488                | VIEW_STATE_PRESSED];
1489        PRESSED_FOCUSED_SELECTED_STATE_SET = VIEW_STATE_SETS[
1490                VIEW_STATE_SELECTED | VIEW_STATE_FOCUSED
1491                | VIEW_STATE_PRESSED];
1492        PRESSED_FOCUSED_SELECTED_WINDOW_FOCUSED_STATE_SET = VIEW_STATE_SETS[
1493                VIEW_STATE_WINDOW_FOCUSED | VIEW_STATE_SELECTED
1494                | VIEW_STATE_FOCUSED | VIEW_STATE_PRESSED];
1495        PRESSED_ENABLED_STATE_SET = VIEW_STATE_SETS[
1496                VIEW_STATE_ENABLED | VIEW_STATE_PRESSED];
1497        PRESSED_ENABLED_WINDOW_FOCUSED_STATE_SET = VIEW_STATE_SETS[
1498                VIEW_STATE_WINDOW_FOCUSED | VIEW_STATE_ENABLED
1499                | VIEW_STATE_PRESSED];
1500        PRESSED_ENABLED_SELECTED_STATE_SET = VIEW_STATE_SETS[
1501                VIEW_STATE_SELECTED | VIEW_STATE_ENABLED
1502                | VIEW_STATE_PRESSED];
1503        PRESSED_ENABLED_SELECTED_WINDOW_FOCUSED_STATE_SET = VIEW_STATE_SETS[
1504                VIEW_STATE_WINDOW_FOCUSED | VIEW_STATE_SELECTED
1505                | VIEW_STATE_ENABLED | VIEW_STATE_PRESSED];
1506        PRESSED_ENABLED_FOCUSED_STATE_SET = VIEW_STATE_SETS[
1507                VIEW_STATE_FOCUSED | VIEW_STATE_ENABLED
1508                | VIEW_STATE_PRESSED];
1509        PRESSED_ENABLED_FOCUSED_WINDOW_FOCUSED_STATE_SET = VIEW_STATE_SETS[
1510                VIEW_STATE_WINDOW_FOCUSED | VIEW_STATE_FOCUSED
1511                | VIEW_STATE_ENABLED | VIEW_STATE_PRESSED];
1512        PRESSED_ENABLED_FOCUSED_SELECTED_STATE_SET = VIEW_STATE_SETS[
1513                VIEW_STATE_SELECTED | VIEW_STATE_FOCUSED
1514                | VIEW_STATE_ENABLED | VIEW_STATE_PRESSED];
1515        PRESSED_ENABLED_FOCUSED_SELECTED_WINDOW_FOCUSED_STATE_SET = VIEW_STATE_SETS[
1516                VIEW_STATE_WINDOW_FOCUSED | VIEW_STATE_SELECTED
1517                | VIEW_STATE_FOCUSED| VIEW_STATE_ENABLED
1518                | VIEW_STATE_PRESSED];
1519    }
1520
1521    /**
1522     * Accessibility event types that are dispatched for text population.
1523     */
1524    private static final int POPULATING_ACCESSIBILITY_EVENT_TYPES =
1525            AccessibilityEvent.TYPE_VIEW_CLICKED
1526            | AccessibilityEvent.TYPE_VIEW_LONG_CLICKED
1527            | AccessibilityEvent.TYPE_VIEW_SELECTED
1528            | AccessibilityEvent.TYPE_VIEW_FOCUSED
1529            | AccessibilityEvent.TYPE_WINDOW_STATE_CHANGED
1530            | AccessibilityEvent.TYPE_VIEW_HOVER_ENTER
1531            | AccessibilityEvent.TYPE_VIEW_HOVER_EXIT
1532            | AccessibilityEvent.TYPE_VIEW_TEXT_CHANGED
1533            | AccessibilityEvent.TYPE_VIEW_TEXT_SELECTION_CHANGED
1534            | AccessibilityEvent.TYPE_VIEW_ACCESSIBILITY_FOCUSED
1535            | AccessibilityEvent.TYPE_VIEW_TEXT_TRAVERSED_AT_MOVEMENT_GRANULARITY;
1536
1537    /**
1538     * Temporary Rect currently for use in setBackground().  This will probably
1539     * be extended in the future to hold our own class with more than just
1540     * a Rect. :)
1541     */
1542    static final ThreadLocal<Rect> sThreadLocal = new ThreadLocal<Rect>();
1543
1544    /**
1545     * Map used to store views' tags.
1546     */
1547    private SparseArray<Object> mKeyedTags;
1548
1549    /**
1550     * The next available accessiiblity id.
1551     */
1552    private static int sNextAccessibilityViewId;
1553
1554    /**
1555     * The animation currently associated with this view.
1556     * @hide
1557     */
1558    protected Animation mCurrentAnimation = null;
1559
1560    /**
1561     * Width as measured during measure pass.
1562     * {@hide}
1563     */
1564    @ViewDebug.ExportedProperty(category = "measurement")
1565    int mMeasuredWidth;
1566
1567    /**
1568     * Height as measured during measure pass.
1569     * {@hide}
1570     */
1571    @ViewDebug.ExportedProperty(category = "measurement")
1572    int mMeasuredHeight;
1573
1574    /**
1575     * Flag to indicate that this view was marked INVALIDATED, or had its display list
1576     * invalidated, prior to the current drawing iteration. If true, the view must re-draw
1577     * its display list. This flag, used only when hw accelerated, allows us to clear the
1578     * flag while retaining this information until it's needed (at getDisplayList() time and
1579     * in drawChild(), when we decide to draw a view's children's display lists into our own).
1580     *
1581     * {@hide}
1582     */
1583    boolean mRecreateDisplayList = false;
1584
1585    /**
1586     * The view's identifier.
1587     * {@hide}
1588     *
1589     * @see #setId(int)
1590     * @see #getId()
1591     */
1592    @ViewDebug.ExportedProperty(resolveId = true)
1593    int mID = NO_ID;
1594
1595    /**
1596     * The stable ID of this view for accessibility purposes.
1597     */
1598    int mAccessibilityViewId = NO_ID;
1599
1600    /**
1601     * @hide
1602     */
1603    private int mAccessibilityCursorPosition = -1;
1604
1605    /**
1606     * The view's tag.
1607     * {@hide}
1608     *
1609     * @see #setTag(Object)
1610     * @see #getTag()
1611     */
1612    protected Object mTag;
1613
1614    // for mPrivateFlags:
1615    /** {@hide} */
1616    static final int WANTS_FOCUS                    = 0x00000001;
1617    /** {@hide} */
1618    static final int FOCUSED                        = 0x00000002;
1619    /** {@hide} */
1620    static final int SELECTED                       = 0x00000004;
1621    /** {@hide} */
1622    static final int IS_ROOT_NAMESPACE              = 0x00000008;
1623    /** {@hide} */
1624    static final int HAS_BOUNDS                     = 0x00000010;
1625    /** {@hide} */
1626    static final int DRAWN                          = 0x00000020;
1627    /**
1628     * When this flag is set, this view is running an animation on behalf of its
1629     * children and should therefore not cancel invalidate requests, even if they
1630     * lie outside of this view's bounds.
1631     *
1632     * {@hide}
1633     */
1634    static final int DRAW_ANIMATION                 = 0x00000040;
1635    /** {@hide} */
1636    static final int SKIP_DRAW                      = 0x00000080;
1637    /** {@hide} */
1638    static final int ONLY_DRAWS_BACKGROUND          = 0x00000100;
1639    /** {@hide} */
1640    static final int REQUEST_TRANSPARENT_REGIONS    = 0x00000200;
1641    /** {@hide} */
1642    static final int DRAWABLE_STATE_DIRTY           = 0x00000400;
1643    /** {@hide} */
1644    static final int MEASURED_DIMENSION_SET         = 0x00000800;
1645    /** {@hide} */
1646    static final int FORCE_LAYOUT                   = 0x00001000;
1647    /** {@hide} */
1648    static final int LAYOUT_REQUIRED                = 0x00002000;
1649
1650    private static final int PRESSED                = 0x00004000;
1651
1652    /** {@hide} */
1653    static final int DRAWING_CACHE_VALID            = 0x00008000;
1654    /**
1655     * Flag used to indicate that this view should be drawn once more (and only once
1656     * more) after its animation has completed.
1657     * {@hide}
1658     */
1659    static final int ANIMATION_STARTED              = 0x00010000;
1660
1661    private static final int SAVE_STATE_CALLED      = 0x00020000;
1662
1663    /**
1664     * Indicates that the View returned true when onSetAlpha() was called and that
1665     * the alpha must be restored.
1666     * {@hide}
1667     */
1668    static final int ALPHA_SET                      = 0x00040000;
1669
1670    /**
1671     * Set by {@link #setScrollContainer(boolean)}.
1672     */
1673    static final int SCROLL_CONTAINER               = 0x00080000;
1674
1675    /**
1676     * Set by {@link #setScrollContainer(boolean)}.
1677     */
1678    static final int SCROLL_CONTAINER_ADDED         = 0x00100000;
1679
1680    /**
1681     * View flag indicating whether this view was invalidated (fully or partially.)
1682     *
1683     * @hide
1684     */
1685    static final int DIRTY                          = 0x00200000;
1686
1687    /**
1688     * View flag indicating whether this view was invalidated by an opaque
1689     * invalidate request.
1690     *
1691     * @hide
1692     */
1693    static final int DIRTY_OPAQUE                   = 0x00400000;
1694
1695    /**
1696     * Mask for {@link #DIRTY} and {@link #DIRTY_OPAQUE}.
1697     *
1698     * @hide
1699     */
1700    static final int DIRTY_MASK                     = 0x00600000;
1701
1702    /**
1703     * Indicates whether the background is opaque.
1704     *
1705     * @hide
1706     */
1707    static final int OPAQUE_BACKGROUND              = 0x00800000;
1708
1709    /**
1710     * Indicates whether the scrollbars are opaque.
1711     *
1712     * @hide
1713     */
1714    static final int OPAQUE_SCROLLBARS              = 0x01000000;
1715
1716    /**
1717     * Indicates whether the view is opaque.
1718     *
1719     * @hide
1720     */
1721    static final int OPAQUE_MASK                    = 0x01800000;
1722
1723    /**
1724     * Indicates a prepressed state;
1725     * the short time between ACTION_DOWN and recognizing
1726     * a 'real' press. Prepressed is used to recognize quick taps
1727     * even when they are shorter than ViewConfiguration.getTapTimeout().
1728     *
1729     * @hide
1730     */
1731    private static final int PREPRESSED             = 0x02000000;
1732
1733    /**
1734     * Indicates whether the view is temporarily detached.
1735     *
1736     * @hide
1737     */
1738    static final int CANCEL_NEXT_UP_EVENT = 0x04000000;
1739
1740    /**
1741     * Indicates that we should awaken scroll bars once attached
1742     *
1743     * @hide
1744     */
1745    private static final int AWAKEN_SCROLL_BARS_ON_ATTACH = 0x08000000;
1746
1747    /**
1748     * Indicates that the view has received HOVER_ENTER.  Cleared on HOVER_EXIT.
1749     * @hide
1750     */
1751    private static final int HOVERED              = 0x10000000;
1752
1753    /**
1754     * Indicates that pivotX or pivotY were explicitly set and we should not assume the center
1755     * for transform operations
1756     *
1757     * @hide
1758     */
1759    private static final int PIVOT_EXPLICITLY_SET = 0x20000000;
1760
1761    /** {@hide} */
1762    static final int ACTIVATED                    = 0x40000000;
1763
1764    /**
1765     * Indicates that this view was specifically invalidated, not just dirtied because some
1766     * child view was invalidated. The flag is used to determine when we need to recreate
1767     * a view's display list (as opposed to just returning a reference to its existing
1768     * display list).
1769     *
1770     * @hide
1771     */
1772    static final int INVALIDATED                  = 0x80000000;
1773
1774    /* Masks for mPrivateFlags2 */
1775
1776    /**
1777     * Indicates that this view has reported that it can accept the current drag's content.
1778     * Cleared when the drag operation concludes.
1779     * @hide
1780     */
1781    static final int DRAG_CAN_ACCEPT              = 0x00000001;
1782
1783    /**
1784     * Indicates that this view is currently directly under the drag location in a
1785     * drag-and-drop operation involving content that it can accept.  Cleared when
1786     * the drag exits the view, or when the drag operation concludes.
1787     * @hide
1788     */
1789    static final int DRAG_HOVERED                 = 0x00000002;
1790
1791    /**
1792     * Horizontal layout direction of this view is from Left to Right.
1793     * Use with {@link #setLayoutDirection}.
1794     */
1795    public static final int LAYOUT_DIRECTION_LTR = 0;
1796
1797    /**
1798     * Horizontal layout direction of this view is from Right to Left.
1799     * Use with {@link #setLayoutDirection}.
1800     */
1801    public static final int LAYOUT_DIRECTION_RTL = 1;
1802
1803    /**
1804     * Horizontal layout direction of this view is inherited from its parent.
1805     * Use with {@link #setLayoutDirection}.
1806     */
1807    public static final int LAYOUT_DIRECTION_INHERIT = 2;
1808
1809    /**
1810     * Horizontal layout direction of this view is from deduced from the default language
1811     * script for the locale. Use with {@link #setLayoutDirection}.
1812     */
1813    public static final int LAYOUT_DIRECTION_LOCALE = 3;
1814
1815    /**
1816     * Bit shift to get the horizontal layout direction. (bits after DRAG_HOVERED)
1817     * @hide
1818     */
1819    static final int LAYOUT_DIRECTION_MASK_SHIFT = 2;
1820
1821    /**
1822     * Mask for use with private flags indicating bits used for horizontal layout direction.
1823     * @hide
1824     */
1825    static final int LAYOUT_DIRECTION_MASK = 0x00000003 << LAYOUT_DIRECTION_MASK_SHIFT;
1826
1827    /**
1828     * Indicates whether the view horizontal layout direction has been resolved and drawn to the
1829     * right-to-left direction.
1830     * @hide
1831     */
1832    static final int LAYOUT_DIRECTION_RESOLVED_RTL = 4 << LAYOUT_DIRECTION_MASK_SHIFT;
1833
1834    /**
1835     * Indicates whether the view horizontal layout direction has been resolved.
1836     * @hide
1837     */
1838    static final int LAYOUT_DIRECTION_RESOLVED = 8 << LAYOUT_DIRECTION_MASK_SHIFT;
1839
1840    /**
1841     * Mask for use with private flags indicating bits used for resolved horizontal layout direction.
1842     * @hide
1843     */
1844    static final int LAYOUT_DIRECTION_RESOLVED_MASK = 0x0000000C << LAYOUT_DIRECTION_MASK_SHIFT;
1845
1846    /*
1847     * Array of horizontal layout direction flags for mapping attribute "layoutDirection" to correct
1848     * flag value.
1849     * @hide
1850     */
1851    private static final int[] LAYOUT_DIRECTION_FLAGS = {
1852            LAYOUT_DIRECTION_LTR,
1853            LAYOUT_DIRECTION_RTL,
1854            LAYOUT_DIRECTION_INHERIT,
1855            LAYOUT_DIRECTION_LOCALE
1856    };
1857
1858    /**
1859     * Default horizontal layout direction.
1860     * @hide
1861     */
1862    private static final int LAYOUT_DIRECTION_DEFAULT = LAYOUT_DIRECTION_INHERIT;
1863
1864    /**
1865     * Indicates that the view is tracking some sort of transient state
1866     * that the app should not need to be aware of, but that the framework
1867     * should take special care to preserve.
1868     *
1869     * @hide
1870     */
1871    static final int HAS_TRANSIENT_STATE = 0x00000100;
1872
1873
1874    /**
1875     * Text direction is inherited thru {@link ViewGroup}
1876     */
1877    public static final int TEXT_DIRECTION_INHERIT = 0;
1878
1879    /**
1880     * Text direction is using "first strong algorithm". The first strong directional character
1881     * determines the paragraph direction. If there is no strong directional character, the
1882     * paragraph direction is the view's resolved layout direction.
1883     */
1884    public static final int TEXT_DIRECTION_FIRST_STRONG = 1;
1885
1886    /**
1887     * Text direction is using "any-RTL" algorithm. The paragraph direction is RTL if it contains
1888     * any strong RTL character, otherwise it is LTR if it contains any strong LTR characters.
1889     * If there are neither, the paragraph direction is the view's resolved layout direction.
1890     */
1891    public static final int TEXT_DIRECTION_ANY_RTL = 2;
1892
1893    /**
1894     * Text direction is forced to LTR.
1895     */
1896    public static final int TEXT_DIRECTION_LTR = 3;
1897
1898    /**
1899     * Text direction is forced to RTL.
1900     */
1901    public static final int TEXT_DIRECTION_RTL = 4;
1902
1903    /**
1904     * Text direction is coming from the system Locale.
1905     */
1906    public static final int TEXT_DIRECTION_LOCALE = 5;
1907
1908    /**
1909     * Default text direction is inherited
1910     */
1911    protected static int TEXT_DIRECTION_DEFAULT = TEXT_DIRECTION_INHERIT;
1912
1913    /**
1914     * Bit shift to get the horizontal layout direction. (bits after LAYOUT_DIRECTION_RESOLVED)
1915     * @hide
1916     */
1917    static final int TEXT_DIRECTION_MASK_SHIFT = 6;
1918
1919    /**
1920     * Mask for use with private flags indicating bits used for text direction.
1921     * @hide
1922     */
1923    static final int TEXT_DIRECTION_MASK = 0x00000007 << TEXT_DIRECTION_MASK_SHIFT;
1924
1925    /**
1926     * Array of text direction flags for mapping attribute "textDirection" to correct
1927     * flag value.
1928     * @hide
1929     */
1930    private static final int[] TEXT_DIRECTION_FLAGS = {
1931            TEXT_DIRECTION_INHERIT << TEXT_DIRECTION_MASK_SHIFT,
1932            TEXT_DIRECTION_FIRST_STRONG << TEXT_DIRECTION_MASK_SHIFT,
1933            TEXT_DIRECTION_ANY_RTL << TEXT_DIRECTION_MASK_SHIFT,
1934            TEXT_DIRECTION_LTR << TEXT_DIRECTION_MASK_SHIFT,
1935            TEXT_DIRECTION_RTL << TEXT_DIRECTION_MASK_SHIFT,
1936            TEXT_DIRECTION_LOCALE << TEXT_DIRECTION_MASK_SHIFT
1937    };
1938
1939    /**
1940     * Indicates whether the view text direction has been resolved.
1941     * @hide
1942     */
1943    static final int TEXT_DIRECTION_RESOLVED = 0x00000008 << TEXT_DIRECTION_MASK_SHIFT;
1944
1945    /**
1946     * Bit shift to get the horizontal layout direction. (bits after DRAG_HOVERED)
1947     * @hide
1948     */
1949    static final int TEXT_DIRECTION_RESOLVED_MASK_SHIFT = 10;
1950
1951    /**
1952     * Mask for use with private flags indicating bits used for resolved text direction.
1953     * @hide
1954     */
1955    static final int TEXT_DIRECTION_RESOLVED_MASK = 0x00000007 << TEXT_DIRECTION_RESOLVED_MASK_SHIFT;
1956
1957    /**
1958     * Indicates whether the view text direction has been resolved to the "first strong" heuristic.
1959     * @hide
1960     */
1961    static final int TEXT_DIRECTION_RESOLVED_DEFAULT =
1962            TEXT_DIRECTION_FIRST_STRONG << TEXT_DIRECTION_RESOLVED_MASK_SHIFT;
1963
1964    /*
1965     * Default text alignment. The text alignment of this View is inherited from its parent.
1966     * Use with {@link #setTextAlignment(int)}
1967     */
1968    public static final int TEXT_ALIGNMENT_INHERIT = 0;
1969
1970    /**
1971     * Default for the root view. The gravity determines the text alignment, ALIGN_NORMAL,
1972     * ALIGN_CENTER, or ALIGN_OPPOSITE, which are relative to each paragraph’s text direction.
1973     *
1974     * Use with {@link #setTextAlignment(int)}
1975     */
1976    public static final int TEXT_ALIGNMENT_GRAVITY = 1;
1977
1978    /**
1979     * Align to the start of the paragraph, e.g. ALIGN_NORMAL.
1980     *
1981     * Use with {@link #setTextAlignment(int)}
1982     */
1983    public static final int TEXT_ALIGNMENT_TEXT_START = 2;
1984
1985    /**
1986     * Align to the end of the paragraph, e.g. ALIGN_OPPOSITE.
1987     *
1988     * Use with {@link #setTextAlignment(int)}
1989     */
1990    public static final int TEXT_ALIGNMENT_TEXT_END = 3;
1991
1992    /**
1993     * Center the paragraph, e.g. ALIGN_CENTER.
1994     *
1995     * Use with {@link #setTextAlignment(int)}
1996     */
1997    public static final int TEXT_ALIGNMENT_CENTER = 4;
1998
1999    /**
2000     * Align to the start of the view, which is ALIGN_LEFT if the view’s resolved
2001     * layoutDirection is LTR, and ALIGN_RIGHT otherwise.
2002     *
2003     * Use with {@link #setTextAlignment(int)}
2004     */
2005    public static final int TEXT_ALIGNMENT_VIEW_START = 5;
2006
2007    /**
2008     * Align to the end of the view, which is ALIGN_RIGHT if the view’s resolved
2009     * layoutDirection is LTR, and ALIGN_LEFT otherwise.
2010     *
2011     * Use with {@link #setTextAlignment(int)}
2012     */
2013    public static final int TEXT_ALIGNMENT_VIEW_END = 6;
2014
2015    /**
2016     * Default text alignment is inherited
2017     */
2018    protected static int TEXT_ALIGNMENT_DEFAULT = TEXT_ALIGNMENT_GRAVITY;
2019
2020    /**
2021      * Bit shift to get the horizontal layout direction. (bits after DRAG_HOVERED)
2022      * @hide
2023      */
2024    static final int TEXT_ALIGNMENT_MASK_SHIFT = 13;
2025
2026    /**
2027      * Mask for use with private flags indicating bits used for text alignment.
2028      * @hide
2029      */
2030    static final int TEXT_ALIGNMENT_MASK = 0x00000007 << TEXT_ALIGNMENT_MASK_SHIFT;
2031
2032    /**
2033     * Array of text direction flags for mapping attribute "textAlignment" to correct
2034     * flag value.
2035     * @hide
2036     */
2037    private static final int[] TEXT_ALIGNMENT_FLAGS = {
2038            TEXT_ALIGNMENT_INHERIT << TEXT_ALIGNMENT_MASK_SHIFT,
2039            TEXT_ALIGNMENT_GRAVITY << TEXT_ALIGNMENT_MASK_SHIFT,
2040            TEXT_ALIGNMENT_TEXT_START << TEXT_ALIGNMENT_MASK_SHIFT,
2041            TEXT_ALIGNMENT_TEXT_END << TEXT_ALIGNMENT_MASK_SHIFT,
2042            TEXT_ALIGNMENT_CENTER << TEXT_ALIGNMENT_MASK_SHIFT,
2043            TEXT_ALIGNMENT_VIEW_START << TEXT_ALIGNMENT_MASK_SHIFT,
2044            TEXT_ALIGNMENT_VIEW_END << TEXT_ALIGNMENT_MASK_SHIFT
2045    };
2046
2047    /**
2048     * Indicates whether the view text alignment has been resolved.
2049     * @hide
2050     */
2051    static final int TEXT_ALIGNMENT_RESOLVED = 0x00000008 << TEXT_ALIGNMENT_MASK_SHIFT;
2052
2053    /**
2054     * Bit shift to get the resolved text alignment.
2055     * @hide
2056     */
2057    static final int TEXT_ALIGNMENT_RESOLVED_MASK_SHIFT = 17;
2058
2059    /**
2060     * Mask for use with private flags indicating bits used for text alignment.
2061     * @hide
2062     */
2063    static final int TEXT_ALIGNMENT_RESOLVED_MASK = 0x00000007 << TEXT_ALIGNMENT_RESOLVED_MASK_SHIFT;
2064
2065    /**
2066     * Indicates whether if the view text alignment has been resolved to gravity
2067     */
2068    public static final int TEXT_ALIGNMENT_RESOLVED_DEFAULT =
2069            TEXT_ALIGNMENT_GRAVITY << TEXT_ALIGNMENT_RESOLVED_MASK_SHIFT;
2070
2071    // Accessiblity constants for mPrivateFlags2
2072
2073    /**
2074     * Shift for accessibility related bits in {@link #mPrivateFlags2}.
2075     */
2076    static final int IMPORTANT_FOR_ACCESSIBILITY_SHIFT = 20;
2077
2078    /**
2079     * Automatically determine whether a view is important for accessibility.
2080     */
2081    public static final int IMPORTANT_FOR_ACCESSIBILITY_AUTO = 0x00000000;
2082
2083    /**
2084     * The view is important for accessibility.
2085     */
2086    public static final int IMPORTANT_FOR_ACCESSIBILITY_YES = 0x00000001;
2087
2088    /**
2089     * The view is not important for accessibility.
2090     */
2091    public static final int IMPORTANT_FOR_ACCESSIBILITY_NO = 0x00000002;
2092
2093    /**
2094     * The default whether the view is important for accessiblity.
2095     */
2096    static final int IMPORTANT_FOR_ACCESSIBILITY_DEFAULT = IMPORTANT_FOR_ACCESSIBILITY_AUTO;
2097
2098    /**
2099     * Mask for obtainig the bits which specify how to determine
2100     * whether a view is important for accessibility.
2101     */
2102    static final int IMPORTANT_FOR_ACCESSIBILITY_MASK = (IMPORTANT_FOR_ACCESSIBILITY_AUTO
2103        | IMPORTANT_FOR_ACCESSIBILITY_YES | IMPORTANT_FOR_ACCESSIBILITY_NO)
2104        << IMPORTANT_FOR_ACCESSIBILITY_SHIFT;
2105
2106    /**
2107     * Flag indicating whether a view has accessibility focus.
2108     */
2109    static final int ACCESSIBILITY_FOCUSED = 0x00000040 << IMPORTANT_FOR_ACCESSIBILITY_SHIFT;
2110
2111    /**
2112     * Flag indicating whether a view state for accessibility has changed.
2113     */
2114    static final int ACCESSIBILITY_STATE_CHANGED = 0x00000080 << IMPORTANT_FOR_ACCESSIBILITY_SHIFT;
2115
2116    /**
2117     * Flag indicating that view has an animation set on it. This is used to track whether an
2118     * animation is cleared between successive frames, in order to tell the associated
2119     * DisplayList to clear its animation matrix.
2120     */
2121    static final int VIEW_IS_ANIMATING_TRANSFORM = 0x10000000;
2122
2123    /**
2124     * Flag indicating whether a view failed the quickReject() check in draw(). This condition
2125     * is used to check whether later changes to the view's transform should invalidate the
2126     * view to force the quickReject test to run again.
2127     */
2128    static final int VIEW_QUICK_REJECTED = 0x20000000;
2129
2130    /* End of masks for mPrivateFlags2 */
2131
2132    static final int DRAG_MASK = DRAG_CAN_ACCEPT | DRAG_HOVERED;
2133
2134    /**
2135     * Always allow a user to over-scroll this view, provided it is a
2136     * view that can scroll.
2137     *
2138     * @see #getOverScrollMode()
2139     * @see #setOverScrollMode(int)
2140     */
2141    public static final int OVER_SCROLL_ALWAYS = 0;
2142
2143    /**
2144     * Allow a user to over-scroll this view only if the content is large
2145     * enough to meaningfully scroll, provided it is a view that can scroll.
2146     *
2147     * @see #getOverScrollMode()
2148     * @see #setOverScrollMode(int)
2149     */
2150    public static final int OVER_SCROLL_IF_CONTENT_SCROLLS = 1;
2151
2152    /**
2153     * Never allow a user to over-scroll this view.
2154     *
2155     * @see #getOverScrollMode()
2156     * @see #setOverScrollMode(int)
2157     */
2158    public static final int OVER_SCROLL_NEVER = 2;
2159
2160    /**
2161     * Special constant for {@link #setSystemUiVisibility(int)}: View has
2162     * requested the system UI (status bar) to be visible (the default).
2163     *
2164     * @see #setSystemUiVisibility(int)
2165     */
2166    public static final int SYSTEM_UI_FLAG_VISIBLE = 0;
2167
2168    /**
2169     * Flag for {@link #setSystemUiVisibility(int)}: View has requested the
2170     * system UI to enter an unobtrusive "low profile" mode.
2171     *
2172     * <p>This is for use in games, book readers, video players, or any other
2173     * "immersive" application where the usual system chrome is deemed too distracting.
2174     *
2175     * <p>In low profile mode, the status bar and/or navigation icons may dim.
2176     *
2177     * @see #setSystemUiVisibility(int)
2178     */
2179    public static final int SYSTEM_UI_FLAG_LOW_PROFILE = 0x00000001;
2180
2181    /**
2182     * Flag for {@link #setSystemUiVisibility(int)}: View has requested that the
2183     * system navigation be temporarily hidden.
2184     *
2185     * <p>This is an even less obtrusive state than that called for by
2186     * {@link #SYSTEM_UI_FLAG_LOW_PROFILE}; on devices that draw essential navigation controls
2187     * (Home, Back, and the like) on screen, <code>SYSTEM_UI_FLAG_HIDE_NAVIGATION</code> will cause
2188     * those to disappear. This is useful (in conjunction with the
2189     * {@link android.view.WindowManager.LayoutParams#FLAG_FULLSCREEN FLAG_FULLSCREEN} and
2190     * {@link android.view.WindowManager.LayoutParams#FLAG_LAYOUT_IN_SCREEN FLAG_LAYOUT_IN_SCREEN}
2191     * window flags) for displaying content using every last pixel on the display.
2192     *
2193     * <p>There is a limitation: because navigation controls are so important, the least user
2194     * interaction will cause them to reappear immediately.  When this happens, both
2195     * this flag and {@link #SYSTEM_UI_FLAG_FULLSCREEN} will be cleared automatically,
2196     * so that both elements reappear at the same time.
2197     *
2198     * @see #setSystemUiVisibility(int)
2199     */
2200    public static final int SYSTEM_UI_FLAG_HIDE_NAVIGATION = 0x00000002;
2201
2202    /**
2203     * Flag for {@link #setSystemUiVisibility(int)}: View has requested to go
2204     * into the normal fullscreen mode so that its content can take over the screen
2205     * while still allowing the user to interact with the application.
2206     *
2207     * <p>This has the same visual effect as
2208     * {@link android.view.WindowManager.LayoutParams#FLAG_FULLSCREEN
2209     * WindowManager.LayoutParams.FLAG_FULLSCREEN},
2210     * meaning that non-critical screen decorations (such as the status bar) will be
2211     * hidden while the user is in the View's window, focusing the experience on
2212     * that content.  Unlike the window flag, if you are using ActionBar in
2213     * overlay mode with {@link Window#FEATURE_ACTION_BAR_OVERLAY
2214     * Window.FEATURE_ACTION_BAR_OVERLAY}, then enabling this flag will also
2215     * hide the action bar.
2216     *
2217     * <p>This approach to going fullscreen is best used over the window flag when
2218     * it is a transient state -- that is, the application does this at certain
2219     * points in its user interaction where it wants to allow the user to focus
2220     * on content, but not as a continuous state.  For situations where the application
2221     * would like to simply stay full screen the entire time (such as a game that
2222     * wants to take over the screen), the
2223     * {@link android.view.WindowManager.LayoutParams#FLAG_FULLSCREEN window flag}
2224     * is usually a better approach.  The state set here will be removed by the system
2225     * in various situations (such as the user moving to another application) like
2226     * the other system UI states.
2227     *
2228     * <p>When using this flag, the application should provide some easy facility
2229     * for the user to go out of it.  A common example would be in an e-book
2230     * reader, where tapping on the screen brings back whatever screen and UI
2231     * decorations that had been hidden while the user was immersed in reading
2232     * the book.
2233     *
2234     * @see #setSystemUiVisibility(int)
2235     */
2236    public static final int SYSTEM_UI_FLAG_FULLSCREEN = 0x00000004;
2237
2238    /**
2239     * Flag for {@link #setSystemUiVisibility(int)}: When using other layout
2240     * flags, we would like a stable view of the content insets given to
2241     * {@link #fitSystemWindows(Rect)}.  This means that the insets seen there
2242     * will always represent the worst case that the application can expect
2243     * as a continue state.  In practice this means with any of system bar,
2244     * nav bar, and status bar shown, but not the space that would be needed
2245     * for an input method.
2246     *
2247     * <p>If you are using ActionBar in
2248     * overlay mode with {@link Window#FEATURE_ACTION_BAR_OVERLAY
2249     * Window.FEATURE_ACTION_BAR_OVERLAY}, this flag will also impact the
2250     * insets it adds to those given to the application.
2251     */
2252    public static final int SYSTEM_UI_FLAG_LAYOUT_STABLE = 0x00000100;
2253
2254    /**
2255     * Flag for {@link #setSystemUiVisibility(int)}: View would like its window
2256     * to be layed out as if it has requested
2257     * {@link #SYSTEM_UI_FLAG_HIDE_NAVIGATION}, even if it currently hasn't.  This
2258     * allows it to avoid artifacts when switching in and out of that mode, at
2259     * the expense that some of its user interface may be covered by screen
2260     * decorations when they are shown.  You can perform layout of your inner
2261     * UI elements to account for the navagation system UI through the
2262     * {@link #fitSystemWindows(Rect)} method.
2263     */
2264    public static final int SYSTEM_UI_FLAG_LAYOUT_HIDE_NAVIGATION = 0x00000200;
2265
2266    /**
2267     * Flag for {@link #setSystemUiVisibility(int)}: View would like its window
2268     * to be layed out as if it has requested
2269     * {@link #SYSTEM_UI_FLAG_FULLSCREEN}, even if it currently hasn't.  This
2270     * allows it to avoid artifacts when switching in and out of that mode, at
2271     * the expense that some of its user interface may be covered by screen
2272     * decorations when they are shown.  You can perform layout of your inner
2273     * UI elements to account for non-fullscreen system UI through the
2274     * {@link #fitSystemWindows(Rect)} method.
2275     */
2276    public static final int SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN = 0x00000400;
2277
2278    /**
2279     * @deprecated Use {@link #SYSTEM_UI_FLAG_LOW_PROFILE} instead.
2280     */
2281    public static final int STATUS_BAR_HIDDEN = SYSTEM_UI_FLAG_LOW_PROFILE;
2282
2283    /**
2284     * @deprecated Use {@link #SYSTEM_UI_FLAG_VISIBLE} instead.
2285     */
2286    public static final int STATUS_BAR_VISIBLE = SYSTEM_UI_FLAG_VISIBLE;
2287
2288    /**
2289     * @hide
2290     *
2291     * NOTE: This flag may only be used in subtreeSystemUiVisibility. It is masked
2292     * out of the public fields to keep the undefined bits out of the developer's way.
2293     *
2294     * Flag to make the status bar not expandable.  Unless you also
2295     * set {@link #STATUS_BAR_DISABLE_NOTIFICATION_ICONS}, new notifications will continue to show.
2296     */
2297    public static final int STATUS_BAR_DISABLE_EXPAND = 0x00010000;
2298
2299    /**
2300     * @hide
2301     *
2302     * NOTE: This flag may only be used in subtreeSystemUiVisibility. It is masked
2303     * out of the public fields to keep the undefined bits out of the developer's way.
2304     *
2305     * Flag to hide notification icons and scrolling ticker text.
2306     */
2307    public static final int STATUS_BAR_DISABLE_NOTIFICATION_ICONS = 0x00020000;
2308
2309    /**
2310     * @hide
2311     *
2312     * NOTE: This flag may only be used in subtreeSystemUiVisibility. It is masked
2313     * out of the public fields to keep the undefined bits out of the developer's way.
2314     *
2315     * Flag to disable incoming notification alerts.  This will not block
2316     * icons, but it will block sound, vibrating and other visual or aural notifications.
2317     */
2318    public static final int STATUS_BAR_DISABLE_NOTIFICATION_ALERTS = 0x00040000;
2319
2320    /**
2321     * @hide
2322     *
2323     * NOTE: This flag may only be used in subtreeSystemUiVisibility. It is masked
2324     * out of the public fields to keep the undefined bits out of the developer's way.
2325     *
2326     * Flag to hide only the scrolling ticker.  Note that
2327     * {@link #STATUS_BAR_DISABLE_NOTIFICATION_ICONS} implies
2328     * {@link #STATUS_BAR_DISABLE_NOTIFICATION_TICKER}.
2329     */
2330    public static final int STATUS_BAR_DISABLE_NOTIFICATION_TICKER = 0x00080000;
2331
2332    /**
2333     * @hide
2334     *
2335     * NOTE: This flag may only be used in subtreeSystemUiVisibility. It is masked
2336     * out of the public fields to keep the undefined bits out of the developer's way.
2337     *
2338     * Flag to hide the center system info area.
2339     */
2340    public static final int STATUS_BAR_DISABLE_SYSTEM_INFO = 0x00100000;
2341
2342    /**
2343     * @hide
2344     *
2345     * NOTE: This flag may only be used in subtreeSystemUiVisibility. It is masked
2346     * out of the public fields to keep the undefined bits out of the developer's way.
2347     *
2348     * Flag to hide only the home button.  Don't use this
2349     * unless you're a special part of the system UI (i.e., setup wizard, keyguard).
2350     */
2351    public static final int STATUS_BAR_DISABLE_HOME = 0x00200000;
2352
2353    /**
2354     * @hide
2355     *
2356     * NOTE: This flag may only be used in subtreeSystemUiVisibility. It is masked
2357     * out of the public fields to keep the undefined bits out of the developer's way.
2358     *
2359     * Flag to hide only the back button. Don't use this
2360     * unless you're a special part of the system UI (i.e., setup wizard, keyguard).
2361     */
2362    public static final int STATUS_BAR_DISABLE_BACK = 0x00400000;
2363
2364    /**
2365     * @hide
2366     *
2367     * NOTE: This flag may only be used in subtreeSystemUiVisibility. It is masked
2368     * out of the public fields to keep the undefined bits out of the developer's way.
2369     *
2370     * Flag to hide only the clock.  You might use this if your activity has
2371     * its own clock making the status bar's clock redundant.
2372     */
2373    public static final int STATUS_BAR_DISABLE_CLOCK = 0x00800000;
2374
2375    /**
2376     * @hide
2377     *
2378     * NOTE: This flag may only be used in subtreeSystemUiVisibility. It is masked
2379     * out of the public fields to keep the undefined bits out of the developer's way.
2380     *
2381     * Flag to hide only the recent apps button. Don't use this
2382     * unless you're a special part of the system UI (i.e., setup wizard, keyguard).
2383     */
2384    public static final int STATUS_BAR_DISABLE_RECENT = 0x01000000;
2385
2386    /**
2387     * @hide
2388     */
2389    public static final int PUBLIC_STATUS_BAR_VISIBILITY_MASK = 0x0000FFFF;
2390
2391    /**
2392     * These are the system UI flags that can be cleared by events outside
2393     * of an application.  Currently this is just the ability to tap on the
2394     * screen while hiding the navigation bar to have it return.
2395     * @hide
2396     */
2397    public static final int SYSTEM_UI_CLEARABLE_FLAGS =
2398            SYSTEM_UI_FLAG_LOW_PROFILE | SYSTEM_UI_FLAG_HIDE_NAVIGATION
2399            | SYSTEM_UI_FLAG_FULLSCREEN;
2400
2401    /**
2402     * Flags that can impact the layout in relation to system UI.
2403     */
2404    public static final int SYSTEM_UI_LAYOUT_FLAGS =
2405            SYSTEM_UI_FLAG_LAYOUT_HIDE_NAVIGATION
2406            | SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN;
2407
2408    /**
2409     * Find views that render the specified text.
2410     *
2411     * @see #findViewsWithText(ArrayList, CharSequence, int)
2412     */
2413    public static final int FIND_VIEWS_WITH_TEXT = 0x00000001;
2414
2415    /**
2416     * Find find views that contain the specified content description.
2417     *
2418     * @see #findViewsWithText(ArrayList, CharSequence, int)
2419     */
2420    public static final int FIND_VIEWS_WITH_CONTENT_DESCRIPTION = 0x00000002;
2421
2422    /**
2423     * Find views that contain {@link AccessibilityNodeProvider}. Such
2424     * a View is a root of virtual view hierarchy and may contain the searched
2425     * text. If this flag is set Views with providers are automatically
2426     * added and it is a responsibility of the client to call the APIs of
2427     * the provider to determine whether the virtual tree rooted at this View
2428     * contains the text, i.e. getting the list of {@link AccessibilityNodeInfo}s
2429     * represeting the virtual views with this text.
2430     *
2431     * @see #findViewsWithText(ArrayList, CharSequence, int)
2432     *
2433     * @hide
2434     */
2435    public static final int FIND_VIEWS_WITH_ACCESSIBILITY_NODE_PROVIDERS = 0x00000004;
2436
2437    /**
2438     * Indicates that the screen has changed state and is now off.
2439     *
2440     * @see #onScreenStateChanged(int)
2441     */
2442    public static final int SCREEN_STATE_OFF = 0x0;
2443
2444    /**
2445     * Indicates that the screen has changed state and is now on.
2446     *
2447     * @see #onScreenStateChanged(int)
2448     */
2449    public static final int SCREEN_STATE_ON = 0x1;
2450
2451    /**
2452     * Controls the over-scroll mode for this view.
2453     * See {@link #overScrollBy(int, int, int, int, int, int, int, int, boolean)},
2454     * {@link #OVER_SCROLL_ALWAYS}, {@link #OVER_SCROLL_IF_CONTENT_SCROLLS},
2455     * and {@link #OVER_SCROLL_NEVER}.
2456     */
2457    private int mOverScrollMode;
2458
2459    /**
2460     * The parent this view is attached to.
2461     * {@hide}
2462     *
2463     * @see #getParent()
2464     */
2465    protected ViewParent mParent;
2466
2467    /**
2468     * {@hide}
2469     */
2470    AttachInfo mAttachInfo;
2471
2472    /**
2473     * {@hide}
2474     */
2475    @ViewDebug.ExportedProperty(flagMapping = {
2476        @ViewDebug.FlagToString(mask = FORCE_LAYOUT, equals = FORCE_LAYOUT,
2477                name = "FORCE_LAYOUT"),
2478        @ViewDebug.FlagToString(mask = LAYOUT_REQUIRED, equals = LAYOUT_REQUIRED,
2479                name = "LAYOUT_REQUIRED"),
2480        @ViewDebug.FlagToString(mask = DRAWING_CACHE_VALID, equals = DRAWING_CACHE_VALID,
2481            name = "DRAWING_CACHE_INVALID", outputIf = false),
2482        @ViewDebug.FlagToString(mask = DRAWN, equals = DRAWN, name = "DRAWN", outputIf = true),
2483        @ViewDebug.FlagToString(mask = DRAWN, equals = DRAWN, name = "NOT_DRAWN", outputIf = false),
2484        @ViewDebug.FlagToString(mask = DIRTY_MASK, equals = DIRTY_OPAQUE, name = "DIRTY_OPAQUE"),
2485        @ViewDebug.FlagToString(mask = DIRTY_MASK, equals = DIRTY, name = "DIRTY")
2486    })
2487    int mPrivateFlags;
2488    int mPrivateFlags2;
2489
2490    /**
2491     * This view's request for the visibility of the status bar.
2492     * @hide
2493     */
2494    @ViewDebug.ExportedProperty(flagMapping = {
2495        @ViewDebug.FlagToString(mask = SYSTEM_UI_FLAG_LOW_PROFILE,
2496                                equals = SYSTEM_UI_FLAG_LOW_PROFILE,
2497                                name = "SYSTEM_UI_FLAG_LOW_PROFILE", outputIf = true),
2498        @ViewDebug.FlagToString(mask = SYSTEM_UI_FLAG_HIDE_NAVIGATION,
2499                                equals = SYSTEM_UI_FLAG_HIDE_NAVIGATION,
2500                                name = "SYSTEM_UI_FLAG_HIDE_NAVIGATION", outputIf = true),
2501        @ViewDebug.FlagToString(mask = PUBLIC_STATUS_BAR_VISIBILITY_MASK,
2502                                equals = SYSTEM_UI_FLAG_VISIBLE,
2503                                name = "SYSTEM_UI_FLAG_VISIBLE", outputIf = true)
2504    })
2505    int mSystemUiVisibility;
2506
2507    /**
2508     * Reference count for transient state.
2509     * @see #setHasTransientState(boolean)
2510     */
2511    int mTransientStateCount = 0;
2512
2513    /**
2514     * Count of how many windows this view has been attached to.
2515     */
2516    int mWindowAttachCount;
2517
2518    /**
2519     * The layout parameters associated with this view and used by the parent
2520     * {@link android.view.ViewGroup} to determine how this view should be
2521     * laid out.
2522     * {@hide}
2523     */
2524    protected ViewGroup.LayoutParams mLayoutParams;
2525
2526    /**
2527     * The view flags hold various views states.
2528     * {@hide}
2529     */
2530    @ViewDebug.ExportedProperty
2531    int mViewFlags;
2532
2533    static class TransformationInfo {
2534        /**
2535         * The transform matrix for the View. This transform is calculated internally
2536         * based on the rotation, scaleX, and scaleY properties. The identity matrix
2537         * is used by default. Do *not* use this variable directly; instead call
2538         * getMatrix(), which will automatically recalculate the matrix if necessary
2539         * to get the correct matrix based on the latest rotation and scale properties.
2540         */
2541        private final Matrix mMatrix = new Matrix();
2542
2543        /**
2544         * The transform matrix for the View. This transform is calculated internally
2545         * based on the rotation, scaleX, and scaleY properties. The identity matrix
2546         * is used by default. Do *not* use this variable directly; instead call
2547         * getInverseMatrix(), which will automatically recalculate the matrix if necessary
2548         * to get the correct matrix based on the latest rotation and scale properties.
2549         */
2550        private Matrix mInverseMatrix;
2551
2552        /**
2553         * An internal variable that tracks whether we need to recalculate the
2554         * transform matrix, based on whether the rotation or scaleX/Y properties
2555         * have changed since the matrix was last calculated.
2556         */
2557        boolean mMatrixDirty = false;
2558
2559        /**
2560         * An internal variable that tracks whether we need to recalculate the
2561         * transform matrix, based on whether the rotation or scaleX/Y properties
2562         * have changed since the matrix was last calculated.
2563         */
2564        private boolean mInverseMatrixDirty = true;
2565
2566        /**
2567         * A variable that tracks whether we need to recalculate the
2568         * transform matrix, based on whether the rotation or scaleX/Y properties
2569         * have changed since the matrix was last calculated. This variable
2570         * is only valid after a call to updateMatrix() or to a function that
2571         * calls it such as getMatrix(), hasIdentityMatrix() and getInverseMatrix().
2572         */
2573        private boolean mMatrixIsIdentity = true;
2574
2575        /**
2576         * The Camera object is used to compute a 3D matrix when rotationX or rotationY are set.
2577         */
2578        private Camera mCamera = null;
2579
2580        /**
2581         * This matrix is used when computing the matrix for 3D rotations.
2582         */
2583        private Matrix matrix3D = null;
2584
2585        /**
2586         * These prev values are used to recalculate a centered pivot point when necessary. The
2587         * pivot point is only used in matrix operations (when rotation, scale, or translation are
2588         * set), so thes values are only used then as well.
2589         */
2590        private int mPrevWidth = -1;
2591        private int mPrevHeight = -1;
2592
2593        /**
2594         * The degrees rotation around the vertical axis through the pivot point.
2595         */
2596        @ViewDebug.ExportedProperty
2597        float mRotationY = 0f;
2598
2599        /**
2600         * The degrees rotation around the horizontal axis through the pivot point.
2601         */
2602        @ViewDebug.ExportedProperty
2603        float mRotationX = 0f;
2604
2605        /**
2606         * The degrees rotation around the pivot point.
2607         */
2608        @ViewDebug.ExportedProperty
2609        float mRotation = 0f;
2610
2611        /**
2612         * The amount of translation of the object away from its left property (post-layout).
2613         */
2614        @ViewDebug.ExportedProperty
2615        float mTranslationX = 0f;
2616
2617        /**
2618         * The amount of translation of the object away from its top property (post-layout).
2619         */
2620        @ViewDebug.ExportedProperty
2621        float mTranslationY = 0f;
2622
2623        /**
2624         * The amount of scale in the x direction around the pivot point. A
2625         * value of 1 means no scaling is applied.
2626         */
2627        @ViewDebug.ExportedProperty
2628        float mScaleX = 1f;
2629
2630        /**
2631         * The amount of scale in the y direction around the pivot point. A
2632         * value of 1 means no scaling is applied.
2633         */
2634        @ViewDebug.ExportedProperty
2635        float mScaleY = 1f;
2636
2637        /**
2638         * The x location of the point around which the view is rotated and scaled.
2639         */
2640        @ViewDebug.ExportedProperty
2641        float mPivotX = 0f;
2642
2643        /**
2644         * The y location of the point around which the view is rotated and scaled.
2645         */
2646        @ViewDebug.ExportedProperty
2647        float mPivotY = 0f;
2648
2649        /**
2650         * The opacity of the View. This is a value from 0 to 1, where 0 means
2651         * completely transparent and 1 means completely opaque.
2652         */
2653        @ViewDebug.ExportedProperty
2654        float mAlpha = 1f;
2655    }
2656
2657    TransformationInfo mTransformationInfo;
2658
2659    private boolean mLastIsOpaque;
2660
2661    /**
2662     * Convenience value to check for float values that are close enough to zero to be considered
2663     * zero.
2664     */
2665    private static final float NONZERO_EPSILON = .001f;
2666
2667    /**
2668     * The distance in pixels from the left edge of this view's parent
2669     * to the left edge of this view.
2670     * {@hide}
2671     */
2672    @ViewDebug.ExportedProperty(category = "layout")
2673    protected int mLeft;
2674    /**
2675     * The distance in pixels from the left edge of this view's parent
2676     * to the right edge of this view.
2677     * {@hide}
2678     */
2679    @ViewDebug.ExportedProperty(category = "layout")
2680    protected int mRight;
2681    /**
2682     * The distance in pixels from the top edge of this view's parent
2683     * to the top edge of this view.
2684     * {@hide}
2685     */
2686    @ViewDebug.ExportedProperty(category = "layout")
2687    protected int mTop;
2688    /**
2689     * The distance in pixels from the top edge of this view's parent
2690     * to the bottom edge of this view.
2691     * {@hide}
2692     */
2693    @ViewDebug.ExportedProperty(category = "layout")
2694    protected int mBottom;
2695
2696    /**
2697     * The offset, in pixels, by which the content of this view is scrolled
2698     * horizontally.
2699     * {@hide}
2700     */
2701    @ViewDebug.ExportedProperty(category = "scrolling")
2702    protected int mScrollX;
2703    /**
2704     * The offset, in pixels, by which the content of this view is scrolled
2705     * vertically.
2706     * {@hide}
2707     */
2708    @ViewDebug.ExportedProperty(category = "scrolling")
2709    protected int mScrollY;
2710
2711    /**
2712     * The left padding in pixels, that is the distance in pixels between the
2713     * left edge of this view and the left edge of its content.
2714     * {@hide}
2715     */
2716    @ViewDebug.ExportedProperty(category = "padding")
2717    protected int mPaddingLeft;
2718    /**
2719     * The right padding in pixels, that is the distance in pixels between the
2720     * right edge of this view and the right edge of its content.
2721     * {@hide}
2722     */
2723    @ViewDebug.ExportedProperty(category = "padding")
2724    protected int mPaddingRight;
2725    /**
2726     * The top padding in pixels, that is the distance in pixels between the
2727     * top edge of this view and the top edge of its content.
2728     * {@hide}
2729     */
2730    @ViewDebug.ExportedProperty(category = "padding")
2731    protected int mPaddingTop;
2732    /**
2733     * The bottom padding in pixels, that is the distance in pixels between the
2734     * bottom edge of this view and the bottom edge of its content.
2735     * {@hide}
2736     */
2737    @ViewDebug.ExportedProperty(category = "padding")
2738    protected int mPaddingBottom;
2739
2740    /**
2741     * The layout insets in pixels, that is the distance in pixels between the
2742     * visible edges of this view its bounds.
2743     */
2744    private Insets mLayoutInsets;
2745
2746    /**
2747     * Briefly describes the view and is primarily used for accessibility support.
2748     */
2749    private CharSequence mContentDescription;
2750
2751    /**
2752     * Cache the paddingRight set by the user to append to the scrollbar's size.
2753     *
2754     * @hide
2755     */
2756    @ViewDebug.ExportedProperty(category = "padding")
2757    protected int mUserPaddingRight;
2758
2759    /**
2760     * Cache the paddingBottom set by the user to append to the scrollbar's size.
2761     *
2762     * @hide
2763     */
2764    @ViewDebug.ExportedProperty(category = "padding")
2765    protected int mUserPaddingBottom;
2766
2767    /**
2768     * Cache the paddingLeft set by the user to append to the scrollbar's size.
2769     *
2770     * @hide
2771     */
2772    @ViewDebug.ExportedProperty(category = "padding")
2773    protected int mUserPaddingLeft;
2774
2775    /**
2776     * Cache if the user padding is relative.
2777     *
2778     */
2779    @ViewDebug.ExportedProperty(category = "padding")
2780    boolean mUserPaddingRelative;
2781
2782    /**
2783     * Cache the paddingStart set by the user to append to the scrollbar's size.
2784     *
2785     */
2786    @ViewDebug.ExportedProperty(category = "padding")
2787    int mUserPaddingStart;
2788
2789    /**
2790     * Cache the paddingEnd set by the user to append to the scrollbar's size.
2791     *
2792     */
2793    @ViewDebug.ExportedProperty(category = "padding")
2794    int mUserPaddingEnd;
2795
2796    /**
2797     * @hide
2798     */
2799    int mOldWidthMeasureSpec = Integer.MIN_VALUE;
2800    /**
2801     * @hide
2802     */
2803    int mOldHeightMeasureSpec = Integer.MIN_VALUE;
2804
2805    private Drawable mBackground;
2806
2807    private int mBackgroundResource;
2808    private boolean mBackgroundSizeChanged;
2809
2810    static class ListenerInfo {
2811        /**
2812         * Listener used to dispatch focus change events.
2813         * This field should be made private, so it is hidden from the SDK.
2814         * {@hide}
2815         */
2816        protected OnFocusChangeListener mOnFocusChangeListener;
2817
2818        /**
2819         * Listeners for layout change events.
2820         */
2821        private ArrayList<OnLayoutChangeListener> mOnLayoutChangeListeners;
2822
2823        /**
2824         * Listeners for attach events.
2825         */
2826        private CopyOnWriteArrayList<OnAttachStateChangeListener> mOnAttachStateChangeListeners;
2827
2828        /**
2829         * Listener used to dispatch click events.
2830         * This field should be made private, so it is hidden from the SDK.
2831         * {@hide}
2832         */
2833        public OnClickListener mOnClickListener;
2834
2835        /**
2836         * Listener used to dispatch long click events.
2837         * This field should be made private, so it is hidden from the SDK.
2838         * {@hide}
2839         */
2840        protected OnLongClickListener mOnLongClickListener;
2841
2842        /**
2843         * Listener used to build the context menu.
2844         * This field should be made private, so it is hidden from the SDK.
2845         * {@hide}
2846         */
2847        protected OnCreateContextMenuListener mOnCreateContextMenuListener;
2848
2849        private OnKeyListener mOnKeyListener;
2850
2851        private OnTouchListener mOnTouchListener;
2852
2853        private OnHoverListener mOnHoverListener;
2854
2855        private OnGenericMotionListener mOnGenericMotionListener;
2856
2857        private OnDragListener mOnDragListener;
2858
2859        private OnSystemUiVisibilityChangeListener mOnSystemUiVisibilityChangeListener;
2860    }
2861
2862    ListenerInfo mListenerInfo;
2863
2864    /**
2865     * The application environment this view lives in.
2866     * This field should be made private, so it is hidden from the SDK.
2867     * {@hide}
2868     */
2869    protected Context mContext;
2870
2871    private final Resources mResources;
2872
2873    private ScrollabilityCache mScrollCache;
2874
2875    private int[] mDrawableState = null;
2876
2877    /**
2878     * Set to true when drawing cache is enabled and cannot be created.
2879     *
2880     * @hide
2881     */
2882    public boolean mCachingFailed;
2883
2884    private Bitmap mDrawingCache;
2885    private Bitmap mUnscaledDrawingCache;
2886    private HardwareLayer mHardwareLayer;
2887    DisplayList mDisplayList;
2888
2889    /**
2890     * When this view has focus and the next focus is {@link #FOCUS_LEFT},
2891     * the user may specify which view to go to next.
2892     */
2893    private int mNextFocusLeftId = View.NO_ID;
2894
2895    /**
2896     * When this view has focus and the next focus is {@link #FOCUS_RIGHT},
2897     * the user may specify which view to go to next.
2898     */
2899    private int mNextFocusRightId = View.NO_ID;
2900
2901    /**
2902     * When this view has focus and the next focus is {@link #FOCUS_UP},
2903     * the user may specify which view to go to next.
2904     */
2905    private int mNextFocusUpId = View.NO_ID;
2906
2907    /**
2908     * When this view has focus and the next focus is {@link #FOCUS_DOWN},
2909     * the user may specify which view to go to next.
2910     */
2911    private int mNextFocusDownId = View.NO_ID;
2912
2913    /**
2914     * When this view has focus and the next focus is {@link #FOCUS_FORWARD},
2915     * the user may specify which view to go to next.
2916     */
2917    int mNextFocusForwardId = View.NO_ID;
2918
2919    private CheckForLongPress mPendingCheckForLongPress;
2920    private CheckForTap mPendingCheckForTap = null;
2921    private PerformClick mPerformClick;
2922    private SendViewScrolledAccessibilityEvent mSendViewScrolledAccessibilityEvent;
2923
2924    private UnsetPressedState mUnsetPressedState;
2925
2926    /**
2927     * Whether the long press's action has been invoked.  The tap's action is invoked on the
2928     * up event while a long press is invoked as soon as the long press duration is reached, so
2929     * a long press could be performed before the tap is checked, in which case the tap's action
2930     * should not be invoked.
2931     */
2932    private boolean mHasPerformedLongPress;
2933
2934    /**
2935     * The minimum height of the view. We'll try our best to have the height
2936     * of this view to at least this amount.
2937     */
2938    @ViewDebug.ExportedProperty(category = "measurement")
2939    private int mMinHeight;
2940
2941    /**
2942     * The minimum width of the view. We'll try our best to have the width
2943     * of this view to at least this amount.
2944     */
2945    @ViewDebug.ExportedProperty(category = "measurement")
2946    private int mMinWidth;
2947
2948    /**
2949     * The delegate to handle touch events that are physically in this view
2950     * but should be handled by another view.
2951     */
2952    private TouchDelegate mTouchDelegate = null;
2953
2954    /**
2955     * Solid color to use as a background when creating the drawing cache. Enables
2956     * the cache to use 16 bit bitmaps instead of 32 bit.
2957     */
2958    private int mDrawingCacheBackgroundColor = 0;
2959
2960    /**
2961     * Special tree observer used when mAttachInfo is null.
2962     */
2963    private ViewTreeObserver mFloatingTreeObserver;
2964
2965    /**
2966     * Cache the touch slop from the context that created the view.
2967     */
2968    private int mTouchSlop;
2969
2970    /**
2971     * Object that handles automatic animation of view properties.
2972     */
2973    private ViewPropertyAnimator mAnimator = null;
2974
2975    /**
2976     * Flag indicating that a drag can cross window boundaries.  When
2977     * {@link #startDrag(ClipData, DragShadowBuilder, Object, int)} is called
2978     * with this flag set, all visible applications will be able to participate
2979     * in the drag operation and receive the dragged content.
2980     *
2981     * @hide
2982     */
2983    public static final int DRAG_FLAG_GLOBAL = 1;
2984
2985    /**
2986     * Vertical scroll factor cached by {@link #getVerticalScrollFactor}.
2987     */
2988    private float mVerticalScrollFactor;
2989
2990    /**
2991     * Position of the vertical scroll bar.
2992     */
2993    private int mVerticalScrollbarPosition;
2994
2995    /**
2996     * Position the scroll bar at the default position as determined by the system.
2997     */
2998    public static final int SCROLLBAR_POSITION_DEFAULT = 0;
2999
3000    /**
3001     * Position the scroll bar along the left edge.
3002     */
3003    public static final int SCROLLBAR_POSITION_LEFT = 1;
3004
3005    /**
3006     * Position the scroll bar along the right edge.
3007     */
3008    public static final int SCROLLBAR_POSITION_RIGHT = 2;
3009
3010    /**
3011     * Indicates that the view does not have a layer.
3012     *
3013     * @see #getLayerType()
3014     * @see #setLayerType(int, android.graphics.Paint)
3015     * @see #LAYER_TYPE_SOFTWARE
3016     * @see #LAYER_TYPE_HARDWARE
3017     */
3018    public static final int LAYER_TYPE_NONE = 0;
3019
3020    /**
3021     * <p>Indicates that the view has a software layer. A software layer is backed
3022     * by a bitmap and causes the view to be rendered using Android's software
3023     * rendering pipeline, even if hardware acceleration is enabled.</p>
3024     *
3025     * <p>Software layers have various usages:</p>
3026     * <p>When the application is not using hardware acceleration, a software layer
3027     * is useful to apply a specific color filter and/or blending mode and/or
3028     * translucency to a view and all its children.</p>
3029     * <p>When the application is using hardware acceleration, a software layer
3030     * is useful to render drawing primitives not supported by the hardware
3031     * accelerated pipeline. It can also be used to cache a complex view tree
3032     * into a texture and reduce the complexity of drawing operations. For instance,
3033     * when animating a complex view tree with a translation, a software layer can
3034     * be used to render the view tree only once.</p>
3035     * <p>Software layers should be avoided when the affected view tree updates
3036     * often. Every update will require to re-render the software layer, which can
3037     * potentially be slow (particularly when hardware acceleration is turned on
3038     * since the layer will have to be uploaded into a hardware texture after every
3039     * update.)</p>
3040     *
3041     * @see #getLayerType()
3042     * @see #setLayerType(int, android.graphics.Paint)
3043     * @see #LAYER_TYPE_NONE
3044     * @see #LAYER_TYPE_HARDWARE
3045     */
3046    public static final int LAYER_TYPE_SOFTWARE = 1;
3047
3048    /**
3049     * <p>Indicates that the view has a hardware layer. A hardware layer is backed
3050     * by a hardware specific texture (generally Frame Buffer Objects or FBO on
3051     * OpenGL hardware) and causes the view to be rendered using Android's hardware
3052     * rendering pipeline, but only if hardware acceleration is turned on for the
3053     * view hierarchy. When hardware acceleration is turned off, hardware layers
3054     * behave exactly as {@link #LAYER_TYPE_SOFTWARE software layers}.</p>
3055     *
3056     * <p>A hardware layer is useful to apply a specific color filter and/or
3057     * blending mode and/or translucency to a view and all its children.</p>
3058     * <p>A hardware layer can be used to cache a complex view tree into a
3059     * texture and reduce the complexity of drawing operations. For instance,
3060     * when animating a complex view tree with a translation, a hardware layer can
3061     * be used to render the view tree only once.</p>
3062     * <p>A hardware layer can also be used to increase the rendering quality when
3063     * rotation transformations are applied on a view. It can also be used to
3064     * prevent potential clipping issues when applying 3D transforms on a view.</p>
3065     *
3066     * @see #getLayerType()
3067     * @see #setLayerType(int, android.graphics.Paint)
3068     * @see #LAYER_TYPE_NONE
3069     * @see #LAYER_TYPE_SOFTWARE
3070     */
3071    public static final int LAYER_TYPE_HARDWARE = 2;
3072
3073    @ViewDebug.ExportedProperty(category = "drawing", mapping = {
3074            @ViewDebug.IntToString(from = LAYER_TYPE_NONE, to = "NONE"),
3075            @ViewDebug.IntToString(from = LAYER_TYPE_SOFTWARE, to = "SOFTWARE"),
3076            @ViewDebug.IntToString(from = LAYER_TYPE_HARDWARE, to = "HARDWARE")
3077    })
3078    int mLayerType = LAYER_TYPE_NONE;
3079    Paint mLayerPaint;
3080    Rect mLocalDirtyRect;
3081
3082    /**
3083     * Set to true when the view is sending hover accessibility events because it
3084     * is the innermost hovered view.
3085     */
3086    private boolean mSendingHoverAccessibilityEvents;
3087
3088    /**
3089     * Simple constructor to use when creating a view from code.
3090     *
3091     * @param context The Context the view is running in, through which it can
3092     *        access the current theme, resources, etc.
3093     */
3094    public View(Context context) {
3095        mContext = context;
3096        mResources = context != null ? context.getResources() : null;
3097        mViewFlags = SOUND_EFFECTS_ENABLED | HAPTIC_FEEDBACK_ENABLED;
3098        // Set layout and text direction defaults
3099        mPrivateFlags2 = (LAYOUT_DIRECTION_DEFAULT << LAYOUT_DIRECTION_MASK_SHIFT) |
3100                (TEXT_DIRECTION_DEFAULT << TEXT_DIRECTION_MASK_SHIFT) |
3101                (TEXT_ALIGNMENT_DEFAULT << TEXT_ALIGNMENT_MASK_SHIFT) |
3102                (IMPORTANT_FOR_ACCESSIBILITY_DEFAULT << IMPORTANT_FOR_ACCESSIBILITY_SHIFT);
3103        mTouchSlop = ViewConfiguration.get(context).getScaledTouchSlop();
3104        setOverScrollMode(OVER_SCROLL_IF_CONTENT_SCROLLS);
3105        mUserPaddingStart = -1;
3106        mUserPaddingEnd = -1;
3107        mUserPaddingRelative = false;
3108    }
3109
3110    /**
3111     * Delegate for injecting accessiblity functionality.
3112     */
3113    AccessibilityDelegate mAccessibilityDelegate;
3114
3115    /**
3116     * Consistency verifier for debugging purposes.
3117     * @hide
3118     */
3119    protected final InputEventConsistencyVerifier mInputEventConsistencyVerifier =
3120            InputEventConsistencyVerifier.isInstrumentationEnabled() ?
3121                    new InputEventConsistencyVerifier(this, 0) : null;
3122
3123    /**
3124     * Constructor that is called when inflating a view from XML. This is called
3125     * when a view is being constructed from an XML file, supplying attributes
3126     * that were specified in the XML file. This version uses a default style of
3127     * 0, so the only attribute values applied are those in the Context's Theme
3128     * and the given AttributeSet.
3129     *
3130     * <p>
3131     * The method onFinishInflate() will be called after all children have been
3132     * added.
3133     *
3134     * @param context The Context the view is running in, through which it can
3135     *        access the current theme, resources, etc.
3136     * @param attrs The attributes of the XML tag that is inflating the view.
3137     * @see #View(Context, AttributeSet, int)
3138     */
3139    public View(Context context, AttributeSet attrs) {
3140        this(context, attrs, 0);
3141    }
3142
3143    /**
3144     * Perform inflation from XML and apply a class-specific base style. This
3145     * constructor of View allows subclasses to use their own base style when
3146     * they are inflating. For example, a Button class's constructor would call
3147     * this version of the super class constructor and supply
3148     * <code>R.attr.buttonStyle</code> for <var>defStyle</var>; this allows
3149     * the theme's button style to modify all of the base view attributes (in
3150     * particular its background) as well as the Button class's attributes.
3151     *
3152     * @param context The Context the view is running in, through which it can
3153     *        access the current theme, resources, etc.
3154     * @param attrs The attributes of the XML tag that is inflating the view.
3155     * @param defStyle The default style to apply to this view. If 0, no style
3156     *        will be applied (beyond what is included in the theme). This may
3157     *        either be an attribute resource, whose value will be retrieved
3158     *        from the current theme, or an explicit style resource.
3159     * @see #View(Context, AttributeSet)
3160     */
3161    public View(Context context, AttributeSet attrs, int defStyle) {
3162        this(context);
3163
3164        TypedArray a = context.obtainStyledAttributes(attrs, com.android.internal.R.styleable.View,
3165                defStyle, 0);
3166
3167        Drawable background = null;
3168
3169        int leftPadding = -1;
3170        int topPadding = -1;
3171        int rightPadding = -1;
3172        int bottomPadding = -1;
3173        int startPadding = -1;
3174        int endPadding = -1;
3175
3176        int padding = -1;
3177
3178        int viewFlagValues = 0;
3179        int viewFlagMasks = 0;
3180
3181        boolean setScrollContainer = false;
3182
3183        int x = 0;
3184        int y = 0;
3185
3186        float tx = 0;
3187        float ty = 0;
3188        float rotation = 0;
3189        float rotationX = 0;
3190        float rotationY = 0;
3191        float sx = 1f;
3192        float sy = 1f;
3193        boolean transformSet = false;
3194
3195        int scrollbarStyle = SCROLLBARS_INSIDE_OVERLAY;
3196
3197        int overScrollMode = mOverScrollMode;
3198        final int N = a.getIndexCount();
3199        for (int i = 0; i < N; i++) {
3200            int attr = a.getIndex(i);
3201            switch (attr) {
3202                case com.android.internal.R.styleable.View_background:
3203                    background = a.getDrawable(attr);
3204                    break;
3205                case com.android.internal.R.styleable.View_padding:
3206                    padding = a.getDimensionPixelSize(attr, -1);
3207                    break;
3208                 case com.android.internal.R.styleable.View_paddingLeft:
3209                    leftPadding = a.getDimensionPixelSize(attr, -1);
3210                    break;
3211                case com.android.internal.R.styleable.View_paddingTop:
3212                    topPadding = a.getDimensionPixelSize(attr, -1);
3213                    break;
3214                case com.android.internal.R.styleable.View_paddingRight:
3215                    rightPadding = a.getDimensionPixelSize(attr, -1);
3216                    break;
3217                case com.android.internal.R.styleable.View_paddingBottom:
3218                    bottomPadding = a.getDimensionPixelSize(attr, -1);
3219                    break;
3220                case com.android.internal.R.styleable.View_paddingStart:
3221                    startPadding = a.getDimensionPixelSize(attr, -1);
3222                    break;
3223                case com.android.internal.R.styleable.View_paddingEnd:
3224                    endPadding = a.getDimensionPixelSize(attr, -1);
3225                    break;
3226                case com.android.internal.R.styleable.View_scrollX:
3227                    x = a.getDimensionPixelOffset(attr, 0);
3228                    break;
3229                case com.android.internal.R.styleable.View_scrollY:
3230                    y = a.getDimensionPixelOffset(attr, 0);
3231                    break;
3232                case com.android.internal.R.styleable.View_alpha:
3233                    setAlpha(a.getFloat(attr, 1f));
3234                    break;
3235                case com.android.internal.R.styleable.View_transformPivotX:
3236                    setPivotX(a.getDimensionPixelOffset(attr, 0));
3237                    break;
3238                case com.android.internal.R.styleable.View_transformPivotY:
3239                    setPivotY(a.getDimensionPixelOffset(attr, 0));
3240                    break;
3241                case com.android.internal.R.styleable.View_translationX:
3242                    tx = a.getDimensionPixelOffset(attr, 0);
3243                    transformSet = true;
3244                    break;
3245                case com.android.internal.R.styleable.View_translationY:
3246                    ty = a.getDimensionPixelOffset(attr, 0);
3247                    transformSet = true;
3248                    break;
3249                case com.android.internal.R.styleable.View_rotation:
3250                    rotation = a.getFloat(attr, 0);
3251                    transformSet = true;
3252                    break;
3253                case com.android.internal.R.styleable.View_rotationX:
3254                    rotationX = a.getFloat(attr, 0);
3255                    transformSet = true;
3256                    break;
3257                case com.android.internal.R.styleable.View_rotationY:
3258                    rotationY = a.getFloat(attr, 0);
3259                    transformSet = true;
3260                    break;
3261                case com.android.internal.R.styleable.View_scaleX:
3262                    sx = a.getFloat(attr, 1f);
3263                    transformSet = true;
3264                    break;
3265                case com.android.internal.R.styleable.View_scaleY:
3266                    sy = a.getFloat(attr, 1f);
3267                    transformSet = true;
3268                    break;
3269                case com.android.internal.R.styleable.View_id:
3270                    mID = a.getResourceId(attr, NO_ID);
3271                    break;
3272                case com.android.internal.R.styleable.View_tag:
3273                    mTag = a.getText(attr);
3274                    break;
3275                case com.android.internal.R.styleable.View_fitsSystemWindows:
3276                    if (a.getBoolean(attr, false)) {
3277                        viewFlagValues |= FITS_SYSTEM_WINDOWS;
3278                        viewFlagMasks |= FITS_SYSTEM_WINDOWS;
3279                    }
3280                    break;
3281                case com.android.internal.R.styleable.View_focusable:
3282                    if (a.getBoolean(attr, false)) {
3283                        viewFlagValues |= FOCUSABLE;
3284                        viewFlagMasks |= FOCUSABLE_MASK;
3285                    }
3286                    break;
3287                case com.android.internal.R.styleable.View_focusableInTouchMode:
3288                    if (a.getBoolean(attr, false)) {
3289                        viewFlagValues |= FOCUSABLE_IN_TOUCH_MODE | FOCUSABLE;
3290                        viewFlagMasks |= FOCUSABLE_IN_TOUCH_MODE | FOCUSABLE_MASK;
3291                    }
3292                    break;
3293                case com.android.internal.R.styleable.View_clickable:
3294                    if (a.getBoolean(attr, false)) {
3295                        viewFlagValues |= CLICKABLE;
3296                        viewFlagMasks |= CLICKABLE;
3297                    }
3298                    break;
3299                case com.android.internal.R.styleable.View_longClickable:
3300                    if (a.getBoolean(attr, false)) {
3301                        viewFlagValues |= LONG_CLICKABLE;
3302                        viewFlagMasks |= LONG_CLICKABLE;
3303                    }
3304                    break;
3305                case com.android.internal.R.styleable.View_saveEnabled:
3306                    if (!a.getBoolean(attr, true)) {
3307                        viewFlagValues |= SAVE_DISABLED;
3308                        viewFlagMasks |= SAVE_DISABLED_MASK;
3309                    }
3310                    break;
3311                case com.android.internal.R.styleable.View_duplicateParentState:
3312                    if (a.getBoolean(attr, false)) {
3313                        viewFlagValues |= DUPLICATE_PARENT_STATE;
3314                        viewFlagMasks |= DUPLICATE_PARENT_STATE;
3315                    }
3316                    break;
3317                case com.android.internal.R.styleable.View_visibility:
3318                    final int visibility = a.getInt(attr, 0);
3319                    if (visibility != 0) {
3320                        viewFlagValues |= VISIBILITY_FLAGS[visibility];
3321                        viewFlagMasks |= VISIBILITY_MASK;
3322                    }
3323                    break;
3324                case com.android.internal.R.styleable.View_layoutDirection:
3325                    // Clear any layout direction flags (included resolved bits) already set
3326                    mPrivateFlags2 &= ~(LAYOUT_DIRECTION_MASK | LAYOUT_DIRECTION_RESOLVED_MASK);
3327                    // Set the layout direction flags depending on the value of the attribute
3328                    final int layoutDirection = a.getInt(attr, -1);
3329                    final int value = (layoutDirection != -1) ?
3330                            LAYOUT_DIRECTION_FLAGS[layoutDirection] : LAYOUT_DIRECTION_DEFAULT;
3331                    mPrivateFlags2 |= (value << LAYOUT_DIRECTION_MASK_SHIFT);
3332                    break;
3333                case com.android.internal.R.styleable.View_drawingCacheQuality:
3334                    final int cacheQuality = a.getInt(attr, 0);
3335                    if (cacheQuality != 0) {
3336                        viewFlagValues |= DRAWING_CACHE_QUALITY_FLAGS[cacheQuality];
3337                        viewFlagMasks |= DRAWING_CACHE_QUALITY_MASK;
3338                    }
3339                    break;
3340                case com.android.internal.R.styleable.View_contentDescription:
3341                    mContentDescription = a.getString(attr);
3342                    break;
3343                case com.android.internal.R.styleable.View_soundEffectsEnabled:
3344                    if (!a.getBoolean(attr, true)) {
3345                        viewFlagValues &= ~SOUND_EFFECTS_ENABLED;
3346                        viewFlagMasks |= SOUND_EFFECTS_ENABLED;
3347                    }
3348                    break;
3349                case com.android.internal.R.styleable.View_hapticFeedbackEnabled:
3350                    if (!a.getBoolean(attr, true)) {
3351                        viewFlagValues &= ~HAPTIC_FEEDBACK_ENABLED;
3352                        viewFlagMasks |= HAPTIC_FEEDBACK_ENABLED;
3353                    }
3354                    break;
3355                case R.styleable.View_scrollbars:
3356                    final int scrollbars = a.getInt(attr, SCROLLBARS_NONE);
3357                    if (scrollbars != SCROLLBARS_NONE) {
3358                        viewFlagValues |= scrollbars;
3359                        viewFlagMasks |= SCROLLBARS_MASK;
3360                        initializeScrollbars(a);
3361                    }
3362                    break;
3363                //noinspection deprecation
3364                case R.styleable.View_fadingEdge:
3365                    if (context.getApplicationInfo().targetSdkVersion >= ICE_CREAM_SANDWICH) {
3366                        // Ignore the attribute starting with ICS
3367                        break;
3368                    }
3369                    // With builds < ICS, fall through and apply fading edges
3370                case R.styleable.View_requiresFadingEdge:
3371                    final int fadingEdge = a.getInt(attr, FADING_EDGE_NONE);
3372                    if (fadingEdge != FADING_EDGE_NONE) {
3373                        viewFlagValues |= fadingEdge;
3374                        viewFlagMasks |= FADING_EDGE_MASK;
3375                        initializeFadingEdge(a);
3376                    }
3377                    break;
3378                case R.styleable.View_scrollbarStyle:
3379                    scrollbarStyle = a.getInt(attr, SCROLLBARS_INSIDE_OVERLAY);
3380                    if (scrollbarStyle != SCROLLBARS_INSIDE_OVERLAY) {
3381                        viewFlagValues |= scrollbarStyle & SCROLLBARS_STYLE_MASK;
3382                        viewFlagMasks |= SCROLLBARS_STYLE_MASK;
3383                    }
3384                    break;
3385                case R.styleable.View_isScrollContainer:
3386                    setScrollContainer = true;
3387                    if (a.getBoolean(attr, false)) {
3388                        setScrollContainer(true);
3389                    }
3390                    break;
3391                case com.android.internal.R.styleable.View_keepScreenOn:
3392                    if (a.getBoolean(attr, false)) {
3393                        viewFlagValues |= KEEP_SCREEN_ON;
3394                        viewFlagMasks |= KEEP_SCREEN_ON;
3395                    }
3396                    break;
3397                case R.styleable.View_filterTouchesWhenObscured:
3398                    if (a.getBoolean(attr, false)) {
3399                        viewFlagValues |= FILTER_TOUCHES_WHEN_OBSCURED;
3400                        viewFlagMasks |= FILTER_TOUCHES_WHEN_OBSCURED;
3401                    }
3402                    break;
3403                case R.styleable.View_nextFocusLeft:
3404                    mNextFocusLeftId = a.getResourceId(attr, View.NO_ID);
3405                    break;
3406                case R.styleable.View_nextFocusRight:
3407                    mNextFocusRightId = a.getResourceId(attr, View.NO_ID);
3408                    break;
3409                case R.styleable.View_nextFocusUp:
3410                    mNextFocusUpId = a.getResourceId(attr, View.NO_ID);
3411                    break;
3412                case R.styleable.View_nextFocusDown:
3413                    mNextFocusDownId = a.getResourceId(attr, View.NO_ID);
3414                    break;
3415                case R.styleable.View_nextFocusForward:
3416                    mNextFocusForwardId = a.getResourceId(attr, View.NO_ID);
3417                    break;
3418                case R.styleable.View_minWidth:
3419                    mMinWidth = a.getDimensionPixelSize(attr, 0);
3420                    break;
3421                case R.styleable.View_minHeight:
3422                    mMinHeight = a.getDimensionPixelSize(attr, 0);
3423                    break;
3424                case R.styleable.View_onClick:
3425                    if (context.isRestricted()) {
3426                        throw new IllegalStateException("The android:onClick attribute cannot "
3427                                + "be used within a restricted context");
3428                    }
3429
3430                    final String handlerName = a.getString(attr);
3431                    if (handlerName != null) {
3432                        setOnClickListener(new OnClickListener() {
3433                            private Method mHandler;
3434
3435                            public void onClick(View v) {
3436                                if (mHandler == null) {
3437                                    try {
3438                                        mHandler = getContext().getClass().getMethod(handlerName,
3439                                                View.class);
3440                                    } catch (NoSuchMethodException e) {
3441                                        int id = getId();
3442                                        String idText = id == NO_ID ? "" : " with id '"
3443                                                + getContext().getResources().getResourceEntryName(
3444                                                    id) + "'";
3445                                        throw new IllegalStateException("Could not find a method " +
3446                                                handlerName + "(View) in the activity "
3447                                                + getContext().getClass() + " for onClick handler"
3448                                                + " on view " + View.this.getClass() + idText, e);
3449                                    }
3450                                }
3451
3452                                try {
3453                                    mHandler.invoke(getContext(), View.this);
3454                                } catch (IllegalAccessException e) {
3455                                    throw new IllegalStateException("Could not execute non "
3456                                            + "public method of the activity", e);
3457                                } catch (InvocationTargetException e) {
3458                                    throw new IllegalStateException("Could not execute "
3459                                            + "method of the activity", e);
3460                                }
3461                            }
3462                        });
3463                    }
3464                    break;
3465                case R.styleable.View_overScrollMode:
3466                    overScrollMode = a.getInt(attr, OVER_SCROLL_IF_CONTENT_SCROLLS);
3467                    break;
3468                case R.styleable.View_verticalScrollbarPosition:
3469                    mVerticalScrollbarPosition = a.getInt(attr, SCROLLBAR_POSITION_DEFAULT);
3470                    break;
3471                case R.styleable.View_layerType:
3472                    setLayerType(a.getInt(attr, LAYER_TYPE_NONE), null);
3473                    break;
3474                case R.styleable.View_textDirection:
3475                    // Clear any text direction flag already set
3476                    mPrivateFlags2 &= ~TEXT_DIRECTION_MASK;
3477                    // Set the text direction flags depending on the value of the attribute
3478                    final int textDirection = a.getInt(attr, -1);
3479                    if (textDirection != -1) {
3480                        mPrivateFlags2 |= TEXT_DIRECTION_FLAGS[textDirection];
3481                    }
3482                    break;
3483                case R.styleable.View_textAlignment:
3484                    // Clear any text alignment flag already set
3485                    mPrivateFlags2 &= ~TEXT_ALIGNMENT_MASK;
3486                    // Set the text alignment flag depending on the value of the attribute
3487                    final int textAlignment = a.getInt(attr, TEXT_ALIGNMENT_DEFAULT);
3488                    mPrivateFlags2 |= TEXT_ALIGNMENT_FLAGS[textAlignment];
3489                    break;
3490                case R.styleable.View_importantForAccessibility:
3491                    setImportantForAccessibility(a.getInt(attr,
3492                            IMPORTANT_FOR_ACCESSIBILITY_DEFAULT));
3493            }
3494        }
3495
3496        a.recycle();
3497
3498        setOverScrollMode(overScrollMode);
3499
3500        if (background != null) {
3501            setBackground(background);
3502        }
3503
3504        // Cache user padding as we cannot fully resolve padding here (we dont have yet the resolved
3505        // layout direction). Those cached values will be used later during padding resolution.
3506        mUserPaddingStart = startPadding;
3507        mUserPaddingEnd = endPadding;
3508
3509        updateUserPaddingRelative();
3510
3511        if (padding >= 0) {
3512            leftPadding = padding;
3513            topPadding = padding;
3514            rightPadding = padding;
3515            bottomPadding = padding;
3516        }
3517
3518        // If the user specified the padding (either with android:padding or
3519        // android:paddingLeft/Top/Right/Bottom), use this padding, otherwise
3520        // use the default padding or the padding from the background drawable
3521        // (stored at this point in mPadding*)
3522        setPadding(leftPadding >= 0 ? leftPadding : mPaddingLeft,
3523                topPadding >= 0 ? topPadding : mPaddingTop,
3524                rightPadding >= 0 ? rightPadding : mPaddingRight,
3525                bottomPadding >= 0 ? bottomPadding : mPaddingBottom);
3526
3527        if (viewFlagMasks != 0) {
3528            setFlags(viewFlagValues, viewFlagMasks);
3529        }
3530
3531        // Needs to be called after mViewFlags is set
3532        if (scrollbarStyle != SCROLLBARS_INSIDE_OVERLAY) {
3533            recomputePadding();
3534        }
3535
3536        if (x != 0 || y != 0) {
3537            scrollTo(x, y);
3538        }
3539
3540        if (transformSet) {
3541            setTranslationX(tx);
3542            setTranslationY(ty);
3543            setRotation(rotation);
3544            setRotationX(rotationX);
3545            setRotationY(rotationY);
3546            setScaleX(sx);
3547            setScaleY(sy);
3548        }
3549
3550        if (!setScrollContainer && (viewFlagValues&SCROLLBARS_VERTICAL) != 0) {
3551            setScrollContainer(true);
3552        }
3553
3554        computeOpaqueFlags();
3555    }
3556
3557    private void updateUserPaddingRelative() {
3558        mUserPaddingRelative = (mUserPaddingStart >= 0 || mUserPaddingEnd >= 0);
3559    }
3560
3561    /**
3562     * Non-public constructor for use in testing
3563     */
3564    View() {
3565        mResources = null;
3566    }
3567
3568    /**
3569     * <p>
3570     * Initializes the fading edges from a given set of styled attributes. This
3571     * method should be called by subclasses that need fading edges and when an
3572     * instance of these subclasses is created programmatically rather than
3573     * being inflated from XML. This method is automatically called when the XML
3574     * is inflated.
3575     * </p>
3576     *
3577     * @param a the styled attributes set to initialize the fading edges from
3578     */
3579    protected void initializeFadingEdge(TypedArray a) {
3580        initScrollCache();
3581
3582        mScrollCache.fadingEdgeLength = a.getDimensionPixelSize(
3583                R.styleable.View_fadingEdgeLength,
3584                ViewConfiguration.get(mContext).getScaledFadingEdgeLength());
3585    }
3586
3587    /**
3588     * Returns the size of the vertical faded edges used to indicate that more
3589     * content in this view is visible.
3590     *
3591     * @return The size in pixels of the vertical faded edge or 0 if vertical
3592     *         faded edges are not enabled for this view.
3593     * @attr ref android.R.styleable#View_fadingEdgeLength
3594     */
3595    public int getVerticalFadingEdgeLength() {
3596        if (isVerticalFadingEdgeEnabled()) {
3597            ScrollabilityCache cache = mScrollCache;
3598            if (cache != null) {
3599                return cache.fadingEdgeLength;
3600            }
3601        }
3602        return 0;
3603    }
3604
3605    /**
3606     * Set the size of the faded edge used to indicate that more content in this
3607     * view is available.  Will not change whether the fading edge is enabled; use
3608     * {@link #setVerticalFadingEdgeEnabled(boolean)} or
3609     * {@link #setHorizontalFadingEdgeEnabled(boolean)} to enable the fading edge
3610     * for the vertical or horizontal fading edges.
3611     *
3612     * @param length The size in pixels of the faded edge used to indicate that more
3613     *        content in this view is visible.
3614     */
3615    public void setFadingEdgeLength(int length) {
3616        initScrollCache();
3617        mScrollCache.fadingEdgeLength = length;
3618    }
3619
3620    /**
3621     * Returns the size of the horizontal faded edges used to indicate that more
3622     * content in this view is visible.
3623     *
3624     * @return The size in pixels of the horizontal faded edge or 0 if horizontal
3625     *         faded edges are not enabled for this view.
3626     * @attr ref android.R.styleable#View_fadingEdgeLength
3627     */
3628    public int getHorizontalFadingEdgeLength() {
3629        if (isHorizontalFadingEdgeEnabled()) {
3630            ScrollabilityCache cache = mScrollCache;
3631            if (cache != null) {
3632                return cache.fadingEdgeLength;
3633            }
3634        }
3635        return 0;
3636    }
3637
3638    /**
3639     * Returns the width of the vertical scrollbar.
3640     *
3641     * @return The width in pixels of the vertical scrollbar or 0 if there
3642     *         is no vertical scrollbar.
3643     */
3644    public int getVerticalScrollbarWidth() {
3645        ScrollabilityCache cache = mScrollCache;
3646        if (cache != null) {
3647            ScrollBarDrawable scrollBar = cache.scrollBar;
3648            if (scrollBar != null) {
3649                int size = scrollBar.getSize(true);
3650                if (size <= 0) {
3651                    size = cache.scrollBarSize;
3652                }
3653                return size;
3654            }
3655            return 0;
3656        }
3657        return 0;
3658    }
3659
3660    /**
3661     * Returns the height of the horizontal scrollbar.
3662     *
3663     * @return The height in pixels of the horizontal scrollbar or 0 if
3664     *         there is no horizontal scrollbar.
3665     */
3666    protected int getHorizontalScrollbarHeight() {
3667        ScrollabilityCache cache = mScrollCache;
3668        if (cache != null) {
3669            ScrollBarDrawable scrollBar = cache.scrollBar;
3670            if (scrollBar != null) {
3671                int size = scrollBar.getSize(false);
3672                if (size <= 0) {
3673                    size = cache.scrollBarSize;
3674                }
3675                return size;
3676            }
3677            return 0;
3678        }
3679        return 0;
3680    }
3681
3682    /**
3683     * <p>
3684     * Initializes the scrollbars from a given set of styled attributes. This
3685     * method should be called by subclasses that need scrollbars and when an
3686     * instance of these subclasses is created programmatically rather than
3687     * being inflated from XML. This method is automatically called when the XML
3688     * is inflated.
3689     * </p>
3690     *
3691     * @param a the styled attributes set to initialize the scrollbars from
3692     */
3693    protected void initializeScrollbars(TypedArray a) {
3694        initScrollCache();
3695
3696        final ScrollabilityCache scrollabilityCache = mScrollCache;
3697
3698        if (scrollabilityCache.scrollBar == null) {
3699            scrollabilityCache.scrollBar = new ScrollBarDrawable();
3700        }
3701
3702        final boolean fadeScrollbars = a.getBoolean(R.styleable.View_fadeScrollbars, true);
3703
3704        if (!fadeScrollbars) {
3705            scrollabilityCache.state = ScrollabilityCache.ON;
3706        }
3707        scrollabilityCache.fadeScrollBars = fadeScrollbars;
3708
3709
3710        scrollabilityCache.scrollBarFadeDuration = a.getInt(
3711                R.styleable.View_scrollbarFadeDuration, ViewConfiguration
3712                        .getScrollBarFadeDuration());
3713        scrollabilityCache.scrollBarDefaultDelayBeforeFade = a.getInt(
3714                R.styleable.View_scrollbarDefaultDelayBeforeFade,
3715                ViewConfiguration.getScrollDefaultDelay());
3716
3717
3718        scrollabilityCache.scrollBarSize = a.getDimensionPixelSize(
3719                com.android.internal.R.styleable.View_scrollbarSize,
3720                ViewConfiguration.get(mContext).getScaledScrollBarSize());
3721
3722        Drawable track = a.getDrawable(R.styleable.View_scrollbarTrackHorizontal);
3723        scrollabilityCache.scrollBar.setHorizontalTrackDrawable(track);
3724
3725        Drawable thumb = a.getDrawable(R.styleable.View_scrollbarThumbHorizontal);
3726        if (thumb != null) {
3727            scrollabilityCache.scrollBar.setHorizontalThumbDrawable(thumb);
3728        }
3729
3730        boolean alwaysDraw = a.getBoolean(R.styleable.View_scrollbarAlwaysDrawHorizontalTrack,
3731                false);
3732        if (alwaysDraw) {
3733            scrollabilityCache.scrollBar.setAlwaysDrawHorizontalTrack(true);
3734        }
3735
3736        track = a.getDrawable(R.styleable.View_scrollbarTrackVertical);
3737        scrollabilityCache.scrollBar.setVerticalTrackDrawable(track);
3738
3739        thumb = a.getDrawable(R.styleable.View_scrollbarThumbVertical);
3740        if (thumb != null) {
3741            scrollabilityCache.scrollBar.setVerticalThumbDrawable(thumb);
3742        }
3743
3744        alwaysDraw = a.getBoolean(R.styleable.View_scrollbarAlwaysDrawVerticalTrack,
3745                false);
3746        if (alwaysDraw) {
3747            scrollabilityCache.scrollBar.setAlwaysDrawVerticalTrack(true);
3748        }
3749
3750        // Re-apply user/background padding so that scrollbar(s) get added
3751        resolvePadding();
3752    }
3753
3754    /**
3755     * <p>
3756     * Initalizes the scrollability cache if necessary.
3757     * </p>
3758     */
3759    private void initScrollCache() {
3760        if (mScrollCache == null) {
3761            mScrollCache = new ScrollabilityCache(ViewConfiguration.get(mContext), this);
3762        }
3763    }
3764
3765    private ScrollabilityCache getScrollCache() {
3766        initScrollCache();
3767        return mScrollCache;
3768    }
3769
3770    /**
3771     * Set the position of the vertical scroll bar. Should be one of
3772     * {@link #SCROLLBAR_POSITION_DEFAULT}, {@link #SCROLLBAR_POSITION_LEFT} or
3773     * {@link #SCROLLBAR_POSITION_RIGHT}.
3774     *
3775     * @param position Where the vertical scroll bar should be positioned.
3776     */
3777    public void setVerticalScrollbarPosition(int position) {
3778        if (mVerticalScrollbarPosition != position) {
3779            mVerticalScrollbarPosition = position;
3780            computeOpaqueFlags();
3781            resolvePadding();
3782        }
3783    }
3784
3785    /**
3786     * @return The position where the vertical scroll bar will show, if applicable.
3787     * @see #setVerticalScrollbarPosition(int)
3788     */
3789    public int getVerticalScrollbarPosition() {
3790        return mVerticalScrollbarPosition;
3791    }
3792
3793    ListenerInfo getListenerInfo() {
3794        if (mListenerInfo != null) {
3795            return mListenerInfo;
3796        }
3797        mListenerInfo = new ListenerInfo();
3798        return mListenerInfo;
3799    }
3800
3801    /**
3802     * Register a callback to be invoked when focus of this view changed.
3803     *
3804     * @param l The callback that will run.
3805     */
3806    public void setOnFocusChangeListener(OnFocusChangeListener l) {
3807        getListenerInfo().mOnFocusChangeListener = l;
3808    }
3809
3810    /**
3811     * Add a listener that will be called when the bounds of the view change due to
3812     * layout processing.
3813     *
3814     * @param listener The listener that will be called when layout bounds change.
3815     */
3816    public void addOnLayoutChangeListener(OnLayoutChangeListener listener) {
3817        ListenerInfo li = getListenerInfo();
3818        if (li.mOnLayoutChangeListeners == null) {
3819            li.mOnLayoutChangeListeners = new ArrayList<OnLayoutChangeListener>();
3820        }
3821        if (!li.mOnLayoutChangeListeners.contains(listener)) {
3822            li.mOnLayoutChangeListeners.add(listener);
3823        }
3824    }
3825
3826    /**
3827     * Remove a listener for layout changes.
3828     *
3829     * @param listener The listener for layout bounds change.
3830     */
3831    public void removeOnLayoutChangeListener(OnLayoutChangeListener listener) {
3832        ListenerInfo li = mListenerInfo;
3833        if (li == null || li.mOnLayoutChangeListeners == null) {
3834            return;
3835        }
3836        li.mOnLayoutChangeListeners.remove(listener);
3837    }
3838
3839    /**
3840     * Add a listener for attach state changes.
3841     *
3842     * This listener will be called whenever this view is attached or detached
3843     * from a window. Remove the listener using
3844     * {@link #removeOnAttachStateChangeListener(OnAttachStateChangeListener)}.
3845     *
3846     * @param listener Listener to attach
3847     * @see #removeOnAttachStateChangeListener(OnAttachStateChangeListener)
3848     */
3849    public void addOnAttachStateChangeListener(OnAttachStateChangeListener listener) {
3850        ListenerInfo li = getListenerInfo();
3851        if (li.mOnAttachStateChangeListeners == null) {
3852            li.mOnAttachStateChangeListeners
3853                    = new CopyOnWriteArrayList<OnAttachStateChangeListener>();
3854        }
3855        li.mOnAttachStateChangeListeners.add(listener);
3856    }
3857
3858    /**
3859     * Remove a listener for attach state changes. The listener will receive no further
3860     * notification of window attach/detach events.
3861     *
3862     * @param listener Listener to remove
3863     * @see #addOnAttachStateChangeListener(OnAttachStateChangeListener)
3864     */
3865    public void removeOnAttachStateChangeListener(OnAttachStateChangeListener listener) {
3866        ListenerInfo li = mListenerInfo;
3867        if (li == null || li.mOnAttachStateChangeListeners == null) {
3868            return;
3869        }
3870        li.mOnAttachStateChangeListeners.remove(listener);
3871    }
3872
3873    /**
3874     * Returns the focus-change callback registered for this view.
3875     *
3876     * @return The callback, or null if one is not registered.
3877     */
3878    public OnFocusChangeListener getOnFocusChangeListener() {
3879        ListenerInfo li = mListenerInfo;
3880        return li != null ? li.mOnFocusChangeListener : null;
3881    }
3882
3883    /**
3884     * Register a callback to be invoked when this view is clicked. If this view is not
3885     * clickable, it becomes clickable.
3886     *
3887     * @param l The callback that will run
3888     *
3889     * @see #setClickable(boolean)
3890     */
3891    public void setOnClickListener(OnClickListener l) {
3892        if (!isClickable()) {
3893            setClickable(true);
3894        }
3895        getListenerInfo().mOnClickListener = l;
3896    }
3897
3898    /**
3899     * Return whether this view has an attached OnClickListener.  Returns
3900     * true if there is a listener, false if there is none.
3901     */
3902    public boolean hasOnClickListeners() {
3903        ListenerInfo li = mListenerInfo;
3904        return (li != null && li.mOnClickListener != null);
3905    }
3906
3907    /**
3908     * Register a callback to be invoked when this view is clicked and held. If this view is not
3909     * long clickable, it becomes long clickable.
3910     *
3911     * @param l The callback that will run
3912     *
3913     * @see #setLongClickable(boolean)
3914     */
3915    public void setOnLongClickListener(OnLongClickListener l) {
3916        if (!isLongClickable()) {
3917            setLongClickable(true);
3918        }
3919        getListenerInfo().mOnLongClickListener = l;
3920    }
3921
3922    /**
3923     * Register a callback to be invoked when the context menu for this view is
3924     * being built. If this view is not long clickable, it becomes long clickable.
3925     *
3926     * @param l The callback that will run
3927     *
3928     */
3929    public void setOnCreateContextMenuListener(OnCreateContextMenuListener l) {
3930        if (!isLongClickable()) {
3931            setLongClickable(true);
3932        }
3933        getListenerInfo().mOnCreateContextMenuListener = l;
3934    }
3935
3936    /**
3937     * Call this view's OnClickListener, if it is defined.  Performs all normal
3938     * actions associated with clicking: reporting accessibility event, playing
3939     * a sound, etc.
3940     *
3941     * @return True there was an assigned OnClickListener that was called, false
3942     *         otherwise is returned.
3943     */
3944    public boolean performClick() {
3945        sendAccessibilityEvent(AccessibilityEvent.TYPE_VIEW_CLICKED);
3946
3947        ListenerInfo li = mListenerInfo;
3948        if (li != null && li.mOnClickListener != null) {
3949            playSoundEffect(SoundEffectConstants.CLICK);
3950            li.mOnClickListener.onClick(this);
3951            return true;
3952        }
3953
3954        return false;
3955    }
3956
3957    /**
3958     * Directly call any attached OnClickListener.  Unlike {@link #performClick()},
3959     * this only calls the listener, and does not do any associated clicking
3960     * actions like reporting an accessibility event.
3961     *
3962     * @return True there was an assigned OnClickListener that was called, false
3963     *         otherwise is returned.
3964     */
3965    public boolean callOnClick() {
3966        ListenerInfo li = mListenerInfo;
3967        if (li != null && li.mOnClickListener != null) {
3968            li.mOnClickListener.onClick(this);
3969            return true;
3970        }
3971        return false;
3972    }
3973
3974    /**
3975     * Call this view's OnLongClickListener, if it is defined. Invokes the context menu if the
3976     * OnLongClickListener did not consume the event.
3977     *
3978     * @return True if one of the above receivers consumed the event, false otherwise.
3979     */
3980    public boolean performLongClick() {
3981        sendAccessibilityEvent(AccessibilityEvent.TYPE_VIEW_LONG_CLICKED);
3982
3983        boolean handled = false;
3984        ListenerInfo li = mListenerInfo;
3985        if (li != null && li.mOnLongClickListener != null) {
3986            handled = li.mOnLongClickListener.onLongClick(View.this);
3987        }
3988        if (!handled) {
3989            handled = showContextMenu();
3990        }
3991        if (handled) {
3992            performHapticFeedback(HapticFeedbackConstants.LONG_PRESS);
3993        }
3994        return handled;
3995    }
3996
3997    /**
3998     * Performs button-related actions during a touch down event.
3999     *
4000     * @param event The event.
4001     * @return True if the down was consumed.
4002     *
4003     * @hide
4004     */
4005    protected boolean performButtonActionOnTouchDown(MotionEvent event) {
4006        if ((event.getButtonState() & MotionEvent.BUTTON_SECONDARY) != 0) {
4007            if (showContextMenu(event.getX(), event.getY(), event.getMetaState())) {
4008                return true;
4009            }
4010        }
4011        return false;
4012    }
4013
4014    /**
4015     * Bring up the context menu for this view.
4016     *
4017     * @return Whether a context menu was displayed.
4018     */
4019    public boolean showContextMenu() {
4020        return getParent().showContextMenuForChild(this);
4021    }
4022
4023    /**
4024     * Bring up the context menu for this view, referring to the item under the specified point.
4025     *
4026     * @param x The referenced x coordinate.
4027     * @param y The referenced y coordinate.
4028     * @param metaState The keyboard modifiers that were pressed.
4029     * @return Whether a context menu was displayed.
4030     *
4031     * @hide
4032     */
4033    public boolean showContextMenu(float x, float y, int metaState) {
4034        return showContextMenu();
4035    }
4036
4037    /**
4038     * Start an action mode.
4039     *
4040     * @param callback Callback that will control the lifecycle of the action mode
4041     * @return The new action mode if it is started, null otherwise
4042     *
4043     * @see ActionMode
4044     */
4045    public ActionMode startActionMode(ActionMode.Callback callback) {
4046        ViewParent parent = getParent();
4047        if (parent == null) return null;
4048        return parent.startActionModeForChild(this, callback);
4049    }
4050
4051    /**
4052     * Register a callback to be invoked when a key is pressed in this view.
4053     * @param l the key listener to attach to this view
4054     */
4055    public void setOnKeyListener(OnKeyListener l) {
4056        getListenerInfo().mOnKeyListener = l;
4057    }
4058
4059    /**
4060     * Register a callback to be invoked when a touch event is sent to this view.
4061     * @param l the touch listener to attach to this view
4062     */
4063    public void setOnTouchListener(OnTouchListener l) {
4064        getListenerInfo().mOnTouchListener = l;
4065    }
4066
4067    /**
4068     * Register a callback to be invoked when a generic motion event is sent to this view.
4069     * @param l the generic motion listener to attach to this view
4070     */
4071    public void setOnGenericMotionListener(OnGenericMotionListener l) {
4072        getListenerInfo().mOnGenericMotionListener = l;
4073    }
4074
4075    /**
4076     * Register a callback to be invoked when a hover event is sent to this view.
4077     * @param l the hover listener to attach to this view
4078     */
4079    public void setOnHoverListener(OnHoverListener l) {
4080        getListenerInfo().mOnHoverListener = l;
4081    }
4082
4083    /**
4084     * Register a drag event listener callback object for this View. The parameter is
4085     * an implementation of {@link android.view.View.OnDragListener}. To send a drag event to a
4086     * View, the system calls the
4087     * {@link android.view.View.OnDragListener#onDrag(View,DragEvent)} method.
4088     * @param l An implementation of {@link android.view.View.OnDragListener}.
4089     */
4090    public void setOnDragListener(OnDragListener l) {
4091        getListenerInfo().mOnDragListener = l;
4092    }
4093
4094    /**
4095     * Give this view focus. This will cause
4096     * {@link #onFocusChanged(boolean, int, android.graphics.Rect)} to be called.
4097     *
4098     * Note: this does not check whether this {@link View} should get focus, it just
4099     * gives it focus no matter what.  It should only be called internally by framework
4100     * code that knows what it is doing, namely {@link #requestFocus(int, Rect)}.
4101     *
4102     * @param direction values are {@link View#FOCUS_UP}, {@link View#FOCUS_DOWN},
4103     *        {@link View#FOCUS_LEFT} or {@link View#FOCUS_RIGHT}. This is the direction which
4104     *        focus moved when requestFocus() is called. It may not always
4105     *        apply, in which case use the default View.FOCUS_DOWN.
4106     * @param previouslyFocusedRect The rectangle of the view that had focus
4107     *        prior in this View's coordinate system.
4108     */
4109    void handleFocusGainInternal(int direction, Rect previouslyFocusedRect) {
4110        if (DBG) {
4111            System.out.println(this + " requestFocus()");
4112        }
4113
4114        if ((mPrivateFlags & FOCUSED) == 0) {
4115            mPrivateFlags |= FOCUSED;
4116
4117            if (mParent != null) {
4118                mParent.requestChildFocus(this, this);
4119            }
4120
4121            onFocusChanged(true, direction, previouslyFocusedRect);
4122            refreshDrawableState();
4123
4124            if (AccessibilityManager.getInstance(mContext).isEnabled()) {
4125                notifyAccessibilityStateChanged();
4126            }
4127        }
4128    }
4129
4130    /**
4131     * Request that a rectangle of this view be visible on the screen,
4132     * scrolling if necessary just enough.
4133     *
4134     * <p>A View should call this if it maintains some notion of which part
4135     * of its content is interesting.  For example, a text editing view
4136     * should call this when its cursor moves.
4137     *
4138     * @param rectangle The rectangle.
4139     * @return Whether any parent scrolled.
4140     */
4141    public boolean requestRectangleOnScreen(Rect rectangle) {
4142        return requestRectangleOnScreen(rectangle, false);
4143    }
4144
4145    /**
4146     * Request that a rectangle of this view be visible on the screen,
4147     * scrolling if necessary just enough.
4148     *
4149     * <p>A View should call this if it maintains some notion of which part
4150     * of its content is interesting.  For example, a text editing view
4151     * should call this when its cursor moves.
4152     *
4153     * <p>When <code>immediate</code> is set to true, scrolling will not be
4154     * animated.
4155     *
4156     * @param rectangle The rectangle.
4157     * @param immediate True to forbid animated scrolling, false otherwise
4158     * @return Whether any parent scrolled.
4159     */
4160    public boolean requestRectangleOnScreen(Rect rectangle, boolean immediate) {
4161        View child = this;
4162        ViewParent parent = mParent;
4163        boolean scrolled = false;
4164        while (parent != null) {
4165            scrolled |= parent.requestChildRectangleOnScreen(child,
4166                    rectangle, immediate);
4167
4168            // offset rect so next call has the rectangle in the
4169            // coordinate system of its direct child.
4170            rectangle.offset(child.getLeft(), child.getTop());
4171            rectangle.offset(-child.getScrollX(), -child.getScrollY());
4172
4173            if (!(parent instanceof View)) {
4174                break;
4175            }
4176
4177            child = (View) parent;
4178            parent = child.getParent();
4179        }
4180        return scrolled;
4181    }
4182
4183    /**
4184     * Called when this view wants to give up focus. If focus is cleared
4185     * {@link #onFocusChanged(boolean, int, android.graphics.Rect)} is called.
4186     * <p>
4187     * <strong>Note:</strong> When a View clears focus the framework is trying
4188     * to give focus to the first focusable View from the top. Hence, if this
4189     * View is the first from the top that can take focus, then all callbacks
4190     * related to clearing focus will be invoked after wich the framework will
4191     * give focus to this view.
4192     * </p>
4193     */
4194    public void clearFocus() {
4195        if (DBG) {
4196            System.out.println(this + " clearFocus()");
4197        }
4198
4199        if ((mPrivateFlags & FOCUSED) != 0) {
4200            mPrivateFlags &= ~FOCUSED;
4201
4202            if (mParent != null) {
4203                mParent.clearChildFocus(this);
4204            }
4205
4206            onFocusChanged(false, 0, null);
4207
4208            refreshDrawableState();
4209
4210            ensureInputFocusOnFirstFocusable();
4211
4212            if (AccessibilityManager.getInstance(mContext).isEnabled()) {
4213                notifyAccessibilityStateChanged();
4214            }
4215        }
4216    }
4217
4218    void ensureInputFocusOnFirstFocusable() {
4219        View root = getRootView();
4220        if (root != null) {
4221            root.requestFocus();
4222        }
4223    }
4224
4225    /**
4226     * Called internally by the view system when a new view is getting focus.
4227     * This is what clears the old focus.
4228     */
4229    void unFocus() {
4230        if (DBG) {
4231            System.out.println(this + " unFocus()");
4232        }
4233
4234        if ((mPrivateFlags & FOCUSED) != 0) {
4235            mPrivateFlags &= ~FOCUSED;
4236
4237            onFocusChanged(false, 0, null);
4238            refreshDrawableState();
4239
4240            if (AccessibilityManager.getInstance(mContext).isEnabled()) {
4241                notifyAccessibilityStateChanged();
4242            }
4243        }
4244    }
4245
4246    /**
4247     * Returns true if this view has focus iteself, or is the ancestor of the
4248     * view that has focus.
4249     *
4250     * @return True if this view has or contains focus, false otherwise.
4251     */
4252    @ViewDebug.ExportedProperty(category = "focus")
4253    public boolean hasFocus() {
4254        return (mPrivateFlags & FOCUSED) != 0;
4255    }
4256
4257    /**
4258     * Returns true if this view is focusable or if it contains a reachable View
4259     * for which {@link #hasFocusable()} returns true. A "reachable hasFocusable()"
4260     * is a View whose parents do not block descendants focus.
4261     *
4262     * Only {@link #VISIBLE} views are considered focusable.
4263     *
4264     * @return True if the view is focusable or if the view contains a focusable
4265     *         View, false otherwise.
4266     *
4267     * @see ViewGroup#FOCUS_BLOCK_DESCENDANTS
4268     */
4269    public boolean hasFocusable() {
4270        return (mViewFlags & VISIBILITY_MASK) == VISIBLE && isFocusable();
4271    }
4272
4273    /**
4274     * Called by the view system when the focus state of this view changes.
4275     * When the focus change event is caused by directional navigation, direction
4276     * and previouslyFocusedRect provide insight into where the focus is coming from.
4277     * When overriding, be sure to call up through to the super class so that
4278     * the standard focus handling will occur.
4279     *
4280     * @param gainFocus True if the View has focus; false otherwise.
4281     * @param direction The direction focus has moved when requestFocus()
4282     *                  is called to give this view focus. Values are
4283     *                  {@link #FOCUS_UP}, {@link #FOCUS_DOWN}, {@link #FOCUS_LEFT},
4284     *                  {@link #FOCUS_RIGHT}, {@link #FOCUS_FORWARD}, or {@link #FOCUS_BACKWARD}.
4285     *                  It may not always apply, in which case use the default.
4286     * @param previouslyFocusedRect The rectangle, in this view's coordinate
4287     *        system, of the previously focused view.  If applicable, this will be
4288     *        passed in as finer grained information about where the focus is coming
4289     *        from (in addition to direction).  Will be <code>null</code> otherwise.
4290     */
4291    protected void onFocusChanged(boolean gainFocus, int direction, Rect previouslyFocusedRect) {
4292        if (gainFocus) {
4293            if (AccessibilityManager.getInstance(mContext).isEnabled()) {
4294                sendAccessibilityEvent(AccessibilityEvent.TYPE_VIEW_FOCUSED);
4295                requestAccessibilityFocus();
4296            }
4297        }
4298
4299        InputMethodManager imm = InputMethodManager.peekInstance();
4300        if (!gainFocus) {
4301            if (isPressed()) {
4302                setPressed(false);
4303            }
4304            if (imm != null && mAttachInfo != null
4305                    && mAttachInfo.mHasWindowFocus) {
4306                imm.focusOut(this);
4307            }
4308            onFocusLost();
4309        } else if (imm != null && mAttachInfo != null
4310                && mAttachInfo.mHasWindowFocus) {
4311            imm.focusIn(this);
4312        }
4313
4314        invalidate(true);
4315        ListenerInfo li = mListenerInfo;
4316        if (li != null && li.mOnFocusChangeListener != null) {
4317            li.mOnFocusChangeListener.onFocusChange(this, gainFocus);
4318        }
4319
4320        if (mAttachInfo != null) {
4321            mAttachInfo.mKeyDispatchState.reset(this);
4322        }
4323    }
4324
4325    /**
4326     * Sends an accessibility event of the given type. If accessiiblity is
4327     * not enabled this method has no effect. The default implementation calls
4328     * {@link #onInitializeAccessibilityEvent(AccessibilityEvent)} first
4329     * to populate information about the event source (this View), then calls
4330     * {@link #dispatchPopulateAccessibilityEvent(AccessibilityEvent)} to
4331     * populate the text content of the event source including its descendants,
4332     * and last calls
4333     * {@link ViewParent#requestSendAccessibilityEvent(View, AccessibilityEvent)}
4334     * on its parent to resuest sending of the event to interested parties.
4335     * <p>
4336     * If an {@link AccessibilityDelegate} has been specified via calling
4337     * {@link #setAccessibilityDelegate(AccessibilityDelegate)} its
4338     * {@link AccessibilityDelegate#sendAccessibilityEvent(View, int)} is
4339     * responsible for handling this call.
4340     * </p>
4341     *
4342     * @param eventType The type of the event to send, as defined by several types from
4343     * {@link android.view.accessibility.AccessibilityEvent}, such as
4344     * {@link android.view.accessibility.AccessibilityEvent#TYPE_VIEW_CLICKED} or
4345     * {@link android.view.accessibility.AccessibilityEvent#TYPE_VIEW_HOVER_ENTER}.
4346     *
4347     * @see #onInitializeAccessibilityEvent(AccessibilityEvent)
4348     * @see #dispatchPopulateAccessibilityEvent(AccessibilityEvent)
4349     * @see ViewParent#requestSendAccessibilityEvent(View, AccessibilityEvent)
4350     * @see AccessibilityDelegate
4351     */
4352    public void sendAccessibilityEvent(int eventType) {
4353        if (mAccessibilityDelegate != null) {
4354            mAccessibilityDelegate.sendAccessibilityEvent(this, eventType);
4355        } else {
4356            sendAccessibilityEventInternal(eventType);
4357        }
4358    }
4359
4360    /**
4361     * Convenience method for sending a {@link AccessibilityEvent#TYPE_ANNOUNCEMENT}
4362     * {@link AccessibilityEvent} to make an announcement which is related to some
4363     * sort of a context change for which none of the events representing UI transitions
4364     * is a good fit. For example, announcing a new page in a book. If accessibility
4365     * is not enabled this method does nothing.
4366     *
4367     * @param text The announcement text.
4368     */
4369    public void announceForAccessibility(CharSequence text) {
4370        if (AccessibilityManager.getInstance(mContext).isEnabled()) {
4371            AccessibilityEvent event = AccessibilityEvent.obtain(
4372                    AccessibilityEvent.TYPE_ANNOUNCEMENT);
4373            event.getText().add(text);
4374            sendAccessibilityEventUnchecked(event);
4375        }
4376    }
4377
4378    /**
4379     * @see #sendAccessibilityEvent(int)
4380     *
4381     * Note: Called from the default {@link AccessibilityDelegate}.
4382     */
4383    void sendAccessibilityEventInternal(int eventType) {
4384        if (AccessibilityManager.getInstance(mContext).isEnabled()) {
4385            sendAccessibilityEventUnchecked(AccessibilityEvent.obtain(eventType));
4386        }
4387    }
4388
4389    /**
4390     * This method behaves exactly as {@link #sendAccessibilityEvent(int)} but
4391     * takes as an argument an empty {@link AccessibilityEvent} and does not
4392     * perform a check whether accessibility is enabled.
4393     * <p>
4394     * If an {@link AccessibilityDelegate} has been specified via calling
4395     * {@link #setAccessibilityDelegate(AccessibilityDelegate)} its
4396     * {@link AccessibilityDelegate#sendAccessibilityEventUnchecked(View, AccessibilityEvent)}
4397     * is responsible for handling this call.
4398     * </p>
4399     *
4400     * @param event The event to send.
4401     *
4402     * @see #sendAccessibilityEvent(int)
4403     */
4404    public void sendAccessibilityEventUnchecked(AccessibilityEvent event) {
4405        if (mAccessibilityDelegate != null) {
4406            mAccessibilityDelegate.sendAccessibilityEventUnchecked(this, event);
4407        } else {
4408            sendAccessibilityEventUncheckedInternal(event);
4409        }
4410    }
4411
4412    /**
4413     * @see #sendAccessibilityEventUnchecked(AccessibilityEvent)
4414     *
4415     * Note: Called from the default {@link AccessibilityDelegate}.
4416     */
4417    void sendAccessibilityEventUncheckedInternal(AccessibilityEvent event) {
4418        if (!isShown()) {
4419            return;
4420        }
4421        onInitializeAccessibilityEvent(event);
4422        // Only a subset of accessibility events populates text content.
4423        if ((event.getEventType() & POPULATING_ACCESSIBILITY_EVENT_TYPES) != 0) {
4424            dispatchPopulateAccessibilityEvent(event);
4425        }
4426        // Intercept accessibility focus events fired by virtual nodes to keep
4427        // track of accessibility focus position in such nodes.
4428        final int eventType = event.getEventType();
4429        switch (eventType) {
4430            case AccessibilityEvent.TYPE_VIEW_ACCESSIBILITY_FOCUSED: {
4431                final long virtualNodeId = AccessibilityNodeInfo.getVirtualDescendantId(
4432                        event.getSourceNodeId());
4433                if (virtualNodeId != AccessibilityNodeInfo.UNDEFINED) {
4434                    ViewRootImpl viewRootImpl = getViewRootImpl();
4435                    if (viewRootImpl != null) {
4436                        viewRootImpl.setAccessibilityFocusedHost(this);
4437                    }
4438                }
4439            } break;
4440            case AccessibilityEvent.TYPE_VIEW_ACCESSIBILITY_FOCUS_CLEARED: {
4441                final long virtualNodeId = AccessibilityNodeInfo.getVirtualDescendantId(
4442                        event.getSourceNodeId());
4443                if (virtualNodeId != AccessibilityNodeInfo.UNDEFINED) {
4444                    ViewRootImpl viewRootImpl = getViewRootImpl();
4445                    if (viewRootImpl != null) {
4446                        viewRootImpl.setAccessibilityFocusedHost(null);
4447                    }
4448                }
4449            } break;
4450        }
4451        // In the beginning we called #isShown(), so we know that getParent() is not null.
4452        getParent().requestSendAccessibilityEvent(this, event);
4453    }
4454
4455    /**
4456     * Dispatches an {@link AccessibilityEvent} to the {@link View} first and then
4457     * to its children for adding their text content to the event. Note that the
4458     * event text is populated in a separate dispatch path since we add to the
4459     * event not only the text of the source but also the text of all its descendants.
4460     * A typical implementation will call
4461     * {@link #onPopulateAccessibilityEvent(AccessibilityEvent)} on the this view
4462     * and then call the {@link #dispatchPopulateAccessibilityEvent(AccessibilityEvent)}
4463     * on each child. Override this method if custom population of the event text
4464     * content is required.
4465     * <p>
4466     * If an {@link AccessibilityDelegate} has been specified via calling
4467     * {@link #setAccessibilityDelegate(AccessibilityDelegate)} its
4468     * {@link AccessibilityDelegate#dispatchPopulateAccessibilityEvent(View, AccessibilityEvent)}
4469     * is responsible for handling this call.
4470     * </p>
4471     * <p>
4472     * <em>Note:</em> Accessibility events of certain types are not dispatched for
4473     * populating the event text via this method. For details refer to {@link AccessibilityEvent}.
4474     * </p>
4475     *
4476     * @param event The event.
4477     *
4478     * @return True if the event population was completed.
4479     */
4480    public boolean dispatchPopulateAccessibilityEvent(AccessibilityEvent event) {
4481        if (mAccessibilityDelegate != null) {
4482            return mAccessibilityDelegate.dispatchPopulateAccessibilityEvent(this, event);
4483        } else {
4484            return dispatchPopulateAccessibilityEventInternal(event);
4485        }
4486    }
4487
4488    /**
4489     * @see #dispatchPopulateAccessibilityEvent(AccessibilityEvent)
4490     *
4491     * Note: Called from the default {@link AccessibilityDelegate}.
4492     */
4493    boolean dispatchPopulateAccessibilityEventInternal(AccessibilityEvent event) {
4494        onPopulateAccessibilityEvent(event);
4495        return false;
4496    }
4497
4498    /**
4499     * Called from {@link #dispatchPopulateAccessibilityEvent(AccessibilityEvent)}
4500     * giving a chance to this View to populate the accessibility event with its
4501     * text content. While this method is free to modify event
4502     * attributes other than text content, doing so should normally be performed in
4503     * {@link #onInitializeAccessibilityEvent(AccessibilityEvent)}.
4504     * <p>
4505     * Example: Adding formatted date string to an accessibility event in addition
4506     *          to the text added by the super implementation:
4507     * <pre> public void onPopulateAccessibilityEvent(AccessibilityEvent event) {
4508     *     super.onPopulateAccessibilityEvent(event);
4509     *     final int flags = DateUtils.FORMAT_SHOW_DATE | DateUtils.FORMAT_SHOW_WEEKDAY;
4510     *     String selectedDateUtterance = DateUtils.formatDateTime(mContext,
4511     *         mCurrentDate.getTimeInMillis(), flags);
4512     *     event.getText().add(selectedDateUtterance);
4513     * }</pre>
4514     * <p>
4515     * If an {@link AccessibilityDelegate} has been specified via calling
4516     * {@link #setAccessibilityDelegate(AccessibilityDelegate)} its
4517     * {@link AccessibilityDelegate#onPopulateAccessibilityEvent(View, AccessibilityEvent)}
4518     * is responsible for handling this call.
4519     * </p>
4520     * <p class="note"><strong>Note:</strong> Always call the super implementation before adding
4521     * information to the event, in case the default implementation has basic information to add.
4522     * </p>
4523     *
4524     * @param event The accessibility event which to populate.
4525     *
4526     * @see #sendAccessibilityEvent(int)
4527     * @see #dispatchPopulateAccessibilityEvent(AccessibilityEvent)
4528     */
4529    public void onPopulateAccessibilityEvent(AccessibilityEvent event) {
4530        if (mAccessibilityDelegate != null) {
4531            mAccessibilityDelegate.onPopulateAccessibilityEvent(this, event);
4532        } else {
4533            onPopulateAccessibilityEventInternal(event);
4534        }
4535    }
4536
4537    /**
4538     * @see #onPopulateAccessibilityEvent(AccessibilityEvent)
4539     *
4540     * Note: Called from the default {@link AccessibilityDelegate}.
4541     */
4542    void onPopulateAccessibilityEventInternal(AccessibilityEvent event) {
4543
4544    }
4545
4546    /**
4547     * Initializes an {@link AccessibilityEvent} with information about
4548     * this View which is the event source. In other words, the source of
4549     * an accessibility event is the view whose state change triggered firing
4550     * the event.
4551     * <p>
4552     * Example: Setting the password property of an event in addition
4553     *          to properties set by the super implementation:
4554     * <pre> public void onInitializeAccessibilityEvent(AccessibilityEvent event) {
4555     *     super.onInitializeAccessibilityEvent(event);
4556     *     event.setPassword(true);
4557     * }</pre>
4558     * <p>
4559     * If an {@link AccessibilityDelegate} has been specified via calling
4560     * {@link #setAccessibilityDelegate(AccessibilityDelegate)} its
4561     * {@link AccessibilityDelegate#onInitializeAccessibilityEvent(View, AccessibilityEvent)}
4562     * is responsible for handling this call.
4563     * </p>
4564     * <p class="note"><strong>Note:</strong> Always call the super implementation before adding
4565     * information to the event, in case the default implementation has basic information to add.
4566     * </p>
4567     * @param event The event to initialize.
4568     *
4569     * @see #sendAccessibilityEvent(int)
4570     * @see #dispatchPopulateAccessibilityEvent(AccessibilityEvent)
4571     */
4572    public void onInitializeAccessibilityEvent(AccessibilityEvent event) {
4573        if (mAccessibilityDelegate != null) {
4574            mAccessibilityDelegate.onInitializeAccessibilityEvent(this, event);
4575        } else {
4576            onInitializeAccessibilityEventInternal(event);
4577        }
4578    }
4579
4580    /**
4581     * @see #onInitializeAccessibilityEvent(AccessibilityEvent)
4582     *
4583     * Note: Called from the default {@link AccessibilityDelegate}.
4584     */
4585    void onInitializeAccessibilityEventInternal(AccessibilityEvent event) {
4586        event.setSource(this);
4587        event.setClassName(View.class.getName());
4588        event.setPackageName(getContext().getPackageName());
4589        event.setEnabled(isEnabled());
4590        event.setContentDescription(mContentDescription);
4591
4592        if (event.getEventType() == AccessibilityEvent.TYPE_VIEW_FOCUSED && mAttachInfo != null) {
4593            ArrayList<View> focusablesTempList = mAttachInfo.mTempArrayList;
4594            getRootView().addFocusables(focusablesTempList, View.FOCUS_FORWARD,
4595                    FOCUSABLES_ALL);
4596            event.setItemCount(focusablesTempList.size());
4597            event.setCurrentItemIndex(focusablesTempList.indexOf(this));
4598            focusablesTempList.clear();
4599        }
4600    }
4601
4602    /**
4603     * Returns an {@link AccessibilityNodeInfo} representing this view from the
4604     * point of view of an {@link android.accessibilityservice.AccessibilityService}.
4605     * This method is responsible for obtaining an accessibility node info from a
4606     * pool of reusable instances and calling
4607     * {@link #onInitializeAccessibilityNodeInfo(AccessibilityNodeInfo)} on this view to
4608     * initialize the former.
4609     * <p>
4610     * Note: The client is responsible for recycling the obtained instance by calling
4611     *       {@link AccessibilityNodeInfo#recycle()} to minimize object creation.
4612     * </p>
4613     *
4614     * @return A populated {@link AccessibilityNodeInfo}.
4615     *
4616     * @see AccessibilityNodeInfo
4617     */
4618    public AccessibilityNodeInfo createAccessibilityNodeInfo() {
4619        AccessibilityNodeProvider provider = getAccessibilityNodeProvider();
4620        if (provider != null) {
4621            return provider.createAccessibilityNodeInfo(View.NO_ID);
4622        } else {
4623            AccessibilityNodeInfo info = AccessibilityNodeInfo.obtain(this);
4624            onInitializeAccessibilityNodeInfo(info);
4625            return info;
4626        }
4627    }
4628
4629    /**
4630     * Initializes an {@link AccessibilityNodeInfo} with information about this view.
4631     * The base implementation sets:
4632     * <ul>
4633     *   <li>{@link AccessibilityNodeInfo#setParent(View)},</li>
4634     *   <li>{@link AccessibilityNodeInfo#setBoundsInParent(Rect)},</li>
4635     *   <li>{@link AccessibilityNodeInfo#setBoundsInScreen(Rect)},</li>
4636     *   <li>{@link AccessibilityNodeInfo#setPackageName(CharSequence)},</li>
4637     *   <li>{@link AccessibilityNodeInfo#setClassName(CharSequence)},</li>
4638     *   <li>{@link AccessibilityNodeInfo#setContentDescription(CharSequence)},</li>
4639     *   <li>{@link AccessibilityNodeInfo#setEnabled(boolean)},</li>
4640     *   <li>{@link AccessibilityNodeInfo#setClickable(boolean)},</li>
4641     *   <li>{@link AccessibilityNodeInfo#setFocusable(boolean)},</li>
4642     *   <li>{@link AccessibilityNodeInfo#setFocused(boolean)},</li>
4643     *   <li>{@link AccessibilityNodeInfo#setLongClickable(boolean)},</li>
4644     *   <li>{@link AccessibilityNodeInfo#setSelected(boolean)},</li>
4645     * </ul>
4646     * <p>
4647     * Subclasses should override this method, call the super implementation,
4648     * and set additional attributes.
4649     * </p>
4650     * <p>
4651     * If an {@link AccessibilityDelegate} has been specified via calling
4652     * {@link #setAccessibilityDelegate(AccessibilityDelegate)} its
4653     * {@link AccessibilityDelegate#onInitializeAccessibilityNodeInfo(View, AccessibilityNodeInfo)}
4654     * is responsible for handling this call.
4655     * </p>
4656     *
4657     * @param info The instance to initialize.
4658     */
4659    public void onInitializeAccessibilityNodeInfo(AccessibilityNodeInfo info) {
4660        if (mAccessibilityDelegate != null) {
4661            mAccessibilityDelegate.onInitializeAccessibilityNodeInfo(this, info);
4662        } else {
4663            onInitializeAccessibilityNodeInfoInternal(info);
4664        }
4665    }
4666
4667    /**
4668     * Gets the location of this view in screen coordintates.
4669     *
4670     * @param outRect The output location
4671     */
4672    private void getBoundsOnScreen(Rect outRect) {
4673        if (mAttachInfo == null) {
4674            return;
4675        }
4676
4677        RectF position = mAttachInfo.mTmpTransformRect;
4678        position.set(0, 0, mRight - mLeft, mBottom - mTop);
4679
4680        if (!hasIdentityMatrix()) {
4681            getMatrix().mapRect(position);
4682        }
4683
4684        position.offset(mLeft, mTop);
4685
4686        ViewParent parent = mParent;
4687        while (parent instanceof View) {
4688            View parentView = (View) parent;
4689
4690            position.offset(-parentView.mScrollX, -parentView.mScrollY);
4691
4692            if (!parentView.hasIdentityMatrix()) {
4693                parentView.getMatrix().mapRect(position);
4694            }
4695
4696            position.offset(parentView.mLeft, parentView.mTop);
4697
4698            parent = parentView.mParent;
4699        }
4700
4701        if (parent instanceof ViewRootImpl) {
4702            ViewRootImpl viewRootImpl = (ViewRootImpl) parent;
4703            position.offset(0, -viewRootImpl.mCurScrollY);
4704        }
4705
4706        position.offset(mAttachInfo.mWindowLeft, mAttachInfo.mWindowTop);
4707
4708        outRect.set((int) (position.left + 0.5f), (int) (position.top + 0.5f),
4709                (int) (position.right + 0.5f), (int) (position.bottom + 0.5f));
4710    }
4711
4712    /**
4713     * @see #onInitializeAccessibilityNodeInfo(AccessibilityNodeInfo)
4714     *
4715     * Note: Called from the default {@link AccessibilityDelegate}.
4716     */
4717    void onInitializeAccessibilityNodeInfoInternal(AccessibilityNodeInfo info) {
4718        Rect bounds = mAttachInfo.mTmpInvalRect;
4719        getDrawingRect(bounds);
4720        info.setBoundsInParent(bounds);
4721
4722        getBoundsOnScreen(bounds);
4723        info.setBoundsInScreen(bounds);
4724
4725        ViewParent parent = getParentForAccessibility();
4726        if (parent instanceof View) {
4727            info.setParent((View) parent);
4728        }
4729
4730        info.setVisibleToUser(isVisibleToUser());
4731
4732        info.setPackageName(mContext.getPackageName());
4733        info.setClassName(View.class.getName());
4734        info.setContentDescription(getContentDescription());
4735
4736        info.setEnabled(isEnabled());
4737        info.setClickable(isClickable());
4738        info.setFocusable(isFocusable());
4739        info.setFocused(isFocused());
4740        info.setAccessibilityFocused(isAccessibilityFocused());
4741        info.setSelected(isSelected());
4742        info.setLongClickable(isLongClickable());
4743
4744        // TODO: These make sense only if we are in an AdapterView but all
4745        // views can be selected. Maybe from accessiiblity perspective
4746        // we should report as selectable view in an AdapterView.
4747        info.addAction(AccessibilityNodeInfo.ACTION_SELECT);
4748        info.addAction(AccessibilityNodeInfo.ACTION_CLEAR_SELECTION);
4749
4750        if (isFocusable()) {
4751            if (isFocused()) {
4752                info.addAction(AccessibilityNodeInfo.ACTION_CLEAR_FOCUS);
4753            } else {
4754                info.addAction(AccessibilityNodeInfo.ACTION_FOCUS);
4755            }
4756        }
4757
4758        if (!isAccessibilityFocused()) {
4759            info.addAction(AccessibilityNodeInfo.ACTION_ACCESSIBILITY_FOCUS);
4760        } else {
4761            info.addAction(AccessibilityNodeInfo.ACTION_CLEAR_ACCESSIBILITY_FOCUS);
4762        }
4763
4764        if (isClickable()) {
4765            info.addAction(AccessibilityNodeInfo.ACTION_CLICK);
4766        }
4767
4768        if (isLongClickable()) {
4769            info.addAction(AccessibilityNodeInfo.ACTION_LONG_CLICK);
4770        }
4771
4772        if (mContentDescription != null && mContentDescription.length() > 0) {
4773            info.addAction(AccessibilityNodeInfo.ACTION_NEXT_AT_MOVEMENT_GRANULARITY);
4774            info.addAction(AccessibilityNodeInfo.ACTION_PREVIOUS_AT_MOVEMENT_GRANULARITY);
4775            info.setMovementGranularities(AccessibilityNodeInfo.MOVEMENT_GRANULARITY_CHARACTER
4776                    | AccessibilityNodeInfo.MOVEMENT_GRANULARITY_WORD
4777                    | AccessibilityNodeInfo.MOVEMENT_GRANULARITY_PARAGRAPH);
4778        }
4779    }
4780
4781    /**
4782     * Computes whether this view is visible to the user. Such a view is
4783     * attached, visible, all its predecessors are visible, it is not clipped
4784     * entirely by its predecessors, and has an alpha greater than zero.
4785     *
4786     * @return Whether the view is visible on the screen.
4787     *
4788     * @hide
4789     */
4790    protected boolean isVisibleToUser() {
4791        return isVisibleToUser(null);
4792    }
4793
4794    /**
4795     * Computes whether the given portion of this view is visible to the user. Such a view is
4796     * attached, visible, all its predecessors are visible, has an alpha greater than zero, and
4797     * the specified portion is not clipped entirely by its predecessors.
4798     *
4799     * @param boundInView the portion of the view to test; coordinates should be relative; may be
4800     *                    <code>null</code>, and the entire view will be tested in this case.
4801     *                    When <code>true</code> is returned by the function, the actual visible
4802     *                    region will be stored in this parameter; that is, if boundInView is fully
4803     *                    contained within the view, no modification will be made, otherwise regions
4804     *                    outside of the visible area of the view will be clipped.
4805     *
4806     * @return Whether the specified portion of the view is visible on the screen.
4807     *
4808     * @hide
4809     */
4810    protected boolean isVisibleToUser(Rect boundInView) {
4811        Rect visibleRect = mAttachInfo.mTmpInvalRect;
4812        Point offset = mAttachInfo.mPoint;
4813        // The first two checks are made also made by isShown() which
4814        // however traverses the tree up to the parent to catch that.
4815        // Therefore, we do some fail fast check to minimize the up
4816        // tree traversal.
4817        boolean isVisible = mAttachInfo != null
4818            && mAttachInfo.mWindowVisibility == View.VISIBLE
4819            && getAlpha() > 0
4820            && isShown()
4821            && getGlobalVisibleRect(visibleRect, offset);
4822            if (isVisible && boundInView != null) {
4823                visibleRect.offset(-offset.x, -offset.y);
4824                isVisible &= boundInView.intersect(visibleRect);
4825            }
4826            return isVisible;
4827    }
4828
4829    /**
4830     * Sets a delegate for implementing accessibility support via compositon as
4831     * opposed to inheritance. The delegate's primary use is for implementing
4832     * backwards compatible widgets. For more details see {@link AccessibilityDelegate}.
4833     *
4834     * @param delegate The delegate instance.
4835     *
4836     * @see AccessibilityDelegate
4837     */
4838    public void setAccessibilityDelegate(AccessibilityDelegate delegate) {
4839        mAccessibilityDelegate = delegate;
4840    }
4841
4842    /**
4843     * Gets the provider for managing a virtual view hierarchy rooted at this View
4844     * and reported to {@link android.accessibilityservice.AccessibilityService}s
4845     * that explore the window content.
4846     * <p>
4847     * If this method returns an instance, this instance is responsible for managing
4848     * {@link AccessibilityNodeInfo}s describing the virtual sub-tree rooted at this
4849     * View including the one representing the View itself. Similarly the returned
4850     * instance is responsible for performing accessibility actions on any virtual
4851     * view or the root view itself.
4852     * </p>
4853     * <p>
4854     * If an {@link AccessibilityDelegate} has been specified via calling
4855     * {@link #setAccessibilityDelegate(AccessibilityDelegate)} its
4856     * {@link AccessibilityDelegate#getAccessibilityNodeProvider(View)}
4857     * is responsible for handling this call.
4858     * </p>
4859     *
4860     * @return The provider.
4861     *
4862     * @see AccessibilityNodeProvider
4863     */
4864    public AccessibilityNodeProvider getAccessibilityNodeProvider() {
4865        if (mAccessibilityDelegate != null) {
4866            return mAccessibilityDelegate.getAccessibilityNodeProvider(this);
4867        } else {
4868            return null;
4869        }
4870    }
4871
4872    /**
4873     * Gets the unique identifier of this view on the screen for accessibility purposes.
4874     * If this {@link View} is not attached to any window, {@value #NO_ID} is returned.
4875     *
4876     * @return The view accessibility id.
4877     *
4878     * @hide
4879     */
4880    public int getAccessibilityViewId() {
4881        if (mAccessibilityViewId == NO_ID) {
4882            mAccessibilityViewId = sNextAccessibilityViewId++;
4883        }
4884        return mAccessibilityViewId;
4885    }
4886
4887    /**
4888     * Gets the unique identifier of the window in which this View reseides.
4889     *
4890     * @return The window accessibility id.
4891     *
4892     * @hide
4893     */
4894    public int getAccessibilityWindowId() {
4895        return mAttachInfo != null ? mAttachInfo.mAccessibilityWindowId : NO_ID;
4896    }
4897
4898    /**
4899     * Gets the {@link View} description. It briefly describes the view and is
4900     * primarily used for accessibility support. Set this property to enable
4901     * better accessibility support for your application. This is especially
4902     * true for views that do not have textual representation (For example,
4903     * ImageButton).
4904     *
4905     * @return The content description.
4906     *
4907     * @attr ref android.R.styleable#View_contentDescription
4908     */
4909    @ViewDebug.ExportedProperty(category = "accessibility")
4910    public CharSequence getContentDescription() {
4911        return mContentDescription;
4912    }
4913
4914    /**
4915     * Sets the {@link View} description. It briefly describes the view and is
4916     * primarily used for accessibility support. Set this property to enable
4917     * better accessibility support for your application. This is especially
4918     * true for views that do not have textual representation (For example,
4919     * ImageButton).
4920     *
4921     * @param contentDescription The content description.
4922     *
4923     * @attr ref android.R.styleable#View_contentDescription
4924     */
4925    @RemotableViewMethod
4926    public void setContentDescription(CharSequence contentDescription) {
4927        mContentDescription = contentDescription;
4928    }
4929
4930    /**
4931     * Invoked whenever this view loses focus, either by losing window focus or by losing
4932     * focus within its window. This method can be used to clear any state tied to the
4933     * focus. For instance, if a button is held pressed with the trackball and the window
4934     * loses focus, this method can be used to cancel the press.
4935     *
4936     * Subclasses of View overriding this method should always call super.onFocusLost().
4937     *
4938     * @see #onFocusChanged(boolean, int, android.graphics.Rect)
4939     * @see #onWindowFocusChanged(boolean)
4940     *
4941     * @hide pending API council approval
4942     */
4943    protected void onFocusLost() {
4944        resetPressedState();
4945    }
4946
4947    private void resetPressedState() {
4948        if ((mViewFlags & ENABLED_MASK) == DISABLED) {
4949            return;
4950        }
4951
4952        if (isPressed()) {
4953            setPressed(false);
4954
4955            if (!mHasPerformedLongPress) {
4956                removeLongPressCallback();
4957            }
4958        }
4959    }
4960
4961    /**
4962     * Returns true if this view has focus
4963     *
4964     * @return True if this view has focus, false otherwise.
4965     */
4966    @ViewDebug.ExportedProperty(category = "focus")
4967    public boolean isFocused() {
4968        return (mPrivateFlags & FOCUSED) != 0;
4969    }
4970
4971    /**
4972     * Find the view in the hierarchy rooted at this view that currently has
4973     * focus.
4974     *
4975     * @return The view that currently has focus, or null if no focused view can
4976     *         be found.
4977     */
4978    public View findFocus() {
4979        return (mPrivateFlags & FOCUSED) != 0 ? this : null;
4980    }
4981
4982    /**
4983     * Indicates whether this view is one of the set of scrollable containers in
4984     * its window.
4985     *
4986     * @return whether this view is one of the set of scrollable containers in
4987     * its window
4988     *
4989     * @attr ref android.R.styleable#View_isScrollContainer
4990     */
4991    public boolean isScrollContainer() {
4992        return (mPrivateFlags & SCROLL_CONTAINER_ADDED) != 0;
4993    }
4994
4995    /**
4996     * Change whether this view is one of the set of scrollable containers in
4997     * its window.  This will be used to determine whether the window can
4998     * resize or must pan when a soft input area is open -- scrollable
4999     * containers allow the window to use resize mode since the container
5000     * will appropriately shrink.
5001     *
5002     * @attr ref android.R.styleable#View_isScrollContainer
5003     */
5004    public void setScrollContainer(boolean isScrollContainer) {
5005        if (isScrollContainer) {
5006            if (mAttachInfo != null && (mPrivateFlags&SCROLL_CONTAINER_ADDED) == 0) {
5007                mAttachInfo.mScrollContainers.add(this);
5008                mPrivateFlags |= SCROLL_CONTAINER_ADDED;
5009            }
5010            mPrivateFlags |= SCROLL_CONTAINER;
5011        } else {
5012            if ((mPrivateFlags&SCROLL_CONTAINER_ADDED) != 0) {
5013                mAttachInfo.mScrollContainers.remove(this);
5014            }
5015            mPrivateFlags &= ~(SCROLL_CONTAINER|SCROLL_CONTAINER_ADDED);
5016        }
5017    }
5018
5019    /**
5020     * Returns the quality of the drawing cache.
5021     *
5022     * @return One of {@link #DRAWING_CACHE_QUALITY_AUTO},
5023     *         {@link #DRAWING_CACHE_QUALITY_LOW}, or {@link #DRAWING_CACHE_QUALITY_HIGH}
5024     *
5025     * @see #setDrawingCacheQuality(int)
5026     * @see #setDrawingCacheEnabled(boolean)
5027     * @see #isDrawingCacheEnabled()
5028     *
5029     * @attr ref android.R.styleable#View_drawingCacheQuality
5030     */
5031    public int getDrawingCacheQuality() {
5032        return mViewFlags & DRAWING_CACHE_QUALITY_MASK;
5033    }
5034
5035    /**
5036     * Set the drawing cache quality of this view. This value is used only when the
5037     * drawing cache is enabled
5038     *
5039     * @param quality One of {@link #DRAWING_CACHE_QUALITY_AUTO},
5040     *        {@link #DRAWING_CACHE_QUALITY_LOW}, or {@link #DRAWING_CACHE_QUALITY_HIGH}
5041     *
5042     * @see #getDrawingCacheQuality()
5043     * @see #setDrawingCacheEnabled(boolean)
5044     * @see #isDrawingCacheEnabled()
5045     *
5046     * @attr ref android.R.styleable#View_drawingCacheQuality
5047     */
5048    public void setDrawingCacheQuality(int quality) {
5049        setFlags(quality, DRAWING_CACHE_QUALITY_MASK);
5050    }
5051
5052    /**
5053     * Returns whether the screen should remain on, corresponding to the current
5054     * value of {@link #KEEP_SCREEN_ON}.
5055     *
5056     * @return Returns true if {@link #KEEP_SCREEN_ON} is set.
5057     *
5058     * @see #setKeepScreenOn(boolean)
5059     *
5060     * @attr ref android.R.styleable#View_keepScreenOn
5061     */
5062    public boolean getKeepScreenOn() {
5063        return (mViewFlags & KEEP_SCREEN_ON) != 0;
5064    }
5065
5066    /**
5067     * Controls whether the screen should remain on, modifying the
5068     * value of {@link #KEEP_SCREEN_ON}.
5069     *
5070     * @param keepScreenOn Supply true to set {@link #KEEP_SCREEN_ON}.
5071     *
5072     * @see #getKeepScreenOn()
5073     *
5074     * @attr ref android.R.styleable#View_keepScreenOn
5075     */
5076    public void setKeepScreenOn(boolean keepScreenOn) {
5077        setFlags(keepScreenOn ? KEEP_SCREEN_ON : 0, KEEP_SCREEN_ON);
5078    }
5079
5080    /**
5081     * Gets the id of the view to use when the next focus is {@link #FOCUS_LEFT}.
5082     * @return The next focus ID, or {@link #NO_ID} if the framework should decide automatically.
5083     *
5084     * @attr ref android.R.styleable#View_nextFocusLeft
5085     */
5086    public int getNextFocusLeftId() {
5087        return mNextFocusLeftId;
5088    }
5089
5090    /**
5091     * Sets the id of the view to use when the next focus is {@link #FOCUS_LEFT}.
5092     * @param nextFocusLeftId The next focus ID, or {@link #NO_ID} if the framework should
5093     * decide automatically.
5094     *
5095     * @attr ref android.R.styleable#View_nextFocusLeft
5096     */
5097    public void setNextFocusLeftId(int nextFocusLeftId) {
5098        mNextFocusLeftId = nextFocusLeftId;
5099    }
5100
5101    /**
5102     * Gets the id of the view to use when the next focus is {@link #FOCUS_RIGHT}.
5103     * @return The next focus ID, or {@link #NO_ID} if the framework should decide automatically.
5104     *
5105     * @attr ref android.R.styleable#View_nextFocusRight
5106     */
5107    public int getNextFocusRightId() {
5108        return mNextFocusRightId;
5109    }
5110
5111    /**
5112     * Sets the id of the view to use when the next focus is {@link #FOCUS_RIGHT}.
5113     * @param nextFocusRightId The next focus ID, or {@link #NO_ID} if the framework should
5114     * decide automatically.
5115     *
5116     * @attr ref android.R.styleable#View_nextFocusRight
5117     */
5118    public void setNextFocusRightId(int nextFocusRightId) {
5119        mNextFocusRightId = nextFocusRightId;
5120    }
5121
5122    /**
5123     * Gets the id of the view to use when the next focus is {@link #FOCUS_UP}.
5124     * @return The next focus ID, or {@link #NO_ID} if the framework should decide automatically.
5125     *
5126     * @attr ref android.R.styleable#View_nextFocusUp
5127     */
5128    public int getNextFocusUpId() {
5129        return mNextFocusUpId;
5130    }
5131
5132    /**
5133     * Sets the id of the view to use when the next focus is {@link #FOCUS_UP}.
5134     * @param nextFocusUpId The next focus ID, or {@link #NO_ID} if the framework should
5135     * decide automatically.
5136     *
5137     * @attr ref android.R.styleable#View_nextFocusUp
5138     */
5139    public void setNextFocusUpId(int nextFocusUpId) {
5140        mNextFocusUpId = nextFocusUpId;
5141    }
5142
5143    /**
5144     * Gets the id of the view to use when the next focus is {@link #FOCUS_DOWN}.
5145     * @return The next focus ID, or {@link #NO_ID} if the framework should decide automatically.
5146     *
5147     * @attr ref android.R.styleable#View_nextFocusDown
5148     */
5149    public int getNextFocusDownId() {
5150        return mNextFocusDownId;
5151    }
5152
5153    /**
5154     * Sets the id of the view to use when the next focus is {@link #FOCUS_DOWN}.
5155     * @param nextFocusDownId The next focus ID, or {@link #NO_ID} if the framework should
5156     * decide automatically.
5157     *
5158     * @attr ref android.R.styleable#View_nextFocusDown
5159     */
5160    public void setNextFocusDownId(int nextFocusDownId) {
5161        mNextFocusDownId = nextFocusDownId;
5162    }
5163
5164    /**
5165     * Gets the id of the view to use when the next focus is {@link #FOCUS_FORWARD}.
5166     * @return The next focus ID, or {@link #NO_ID} if the framework should decide automatically.
5167     *
5168     * @attr ref android.R.styleable#View_nextFocusForward
5169     */
5170    public int getNextFocusForwardId() {
5171        return mNextFocusForwardId;
5172    }
5173
5174    /**
5175     * Sets the id of the view to use when the next focus is {@link #FOCUS_FORWARD}.
5176     * @param nextFocusForwardId The next focus ID, or {@link #NO_ID} if the framework should
5177     * decide automatically.
5178     *
5179     * @attr ref android.R.styleable#View_nextFocusForward
5180     */
5181    public void setNextFocusForwardId(int nextFocusForwardId) {
5182        mNextFocusForwardId = nextFocusForwardId;
5183    }
5184
5185    /**
5186     * Returns the visibility of this view and all of its ancestors
5187     *
5188     * @return True if this view and all of its ancestors are {@link #VISIBLE}
5189     */
5190    public boolean isShown() {
5191        View current = this;
5192        //noinspection ConstantConditions
5193        do {
5194            if ((current.mViewFlags & VISIBILITY_MASK) != VISIBLE) {
5195                return false;
5196            }
5197            ViewParent parent = current.mParent;
5198            if (parent == null) {
5199                return false; // We are not attached to the view root
5200            }
5201            if (!(parent instanceof View)) {
5202                return true;
5203            }
5204            current = (View) parent;
5205        } while (current != null);
5206
5207        return false;
5208    }
5209
5210    /**
5211     * Called by the view hierarchy when the content insets for a window have
5212     * changed, to allow it to adjust its content to fit within those windows.
5213     * The content insets tell you the space that the status bar, input method,
5214     * and other system windows infringe on the application's window.
5215     *
5216     * <p>You do not normally need to deal with this function, since the default
5217     * window decoration given to applications takes care of applying it to the
5218     * content of the window.  If you use {@link #SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN}
5219     * or {@link #SYSTEM_UI_FLAG_LAYOUT_HIDE_NAVIGATION} this will not be the case,
5220     * and your content can be placed under those system elements.  You can then
5221     * use this method within your view hierarchy if you have parts of your UI
5222     * which you would like to ensure are not being covered.
5223     *
5224     * <p>The default implementation of this method simply applies the content
5225     * inset's to the view's padding.  This can be enabled through
5226     * {@link #setFitsSystemWindows(boolean)}.  Alternatively, you can override
5227     * the method and handle the insets however you would like.  Note that the
5228     * insets provided by the framework are always relative to the far edges
5229     * of the window, not accounting for the location of the called view within
5230     * that window.  (In fact when this method is called you do not yet know
5231     * where the layout will place the view, as it is done before layout happens.)
5232     *
5233     * <p>Note: unlike many View methods, there is no dispatch phase to this
5234     * call.  If you are overriding it in a ViewGroup and want to allow the
5235     * call to continue to your children, you must be sure to call the super
5236     * implementation.
5237     *
5238     * <p>Here is a sample layout that makes use of fitting system windows
5239     * to have controls for a video view placed inside of the window decorations
5240     * that it hides and shows.  This can be used with code like the second
5241     * sample (video player) shown in {@link #setSystemUiVisibility(int)}.
5242     *
5243     * {@sample development/samples/ApiDemos/res/layout/video_player.xml complete}
5244     *
5245     * @param insets Current content insets of the window.  Prior to
5246     * {@link android.os.Build.VERSION_CODES#JELLY_BEAN} you must not modify
5247     * the insets or else you and Android will be unhappy.
5248     *
5249     * @return Return true if this view applied the insets and it should not
5250     * continue propagating further down the hierarchy, false otherwise.
5251     */
5252    protected boolean fitSystemWindows(Rect insets) {
5253        if ((mViewFlags & FITS_SYSTEM_WINDOWS) == FITS_SYSTEM_WINDOWS) {
5254            mUserPaddingStart = -1;
5255            mUserPaddingEnd = -1;
5256            mUserPaddingRelative = false;
5257            if ((mViewFlags & OPTIONAL_FITS_SYSTEM_WINDOWS) == 0
5258                    || mAttachInfo == null
5259                    || (mAttachInfo.mSystemUiVisibility & SYSTEM_UI_LAYOUT_FLAGS) == 0) {
5260                internalSetPadding(insets.left, insets.top, insets.right, insets.bottom);
5261                return true;
5262            } else {
5263                internalSetPadding(0, 0, 0, 0);
5264                return false;
5265            }
5266        }
5267        return false;
5268    }
5269
5270    /**
5271     * Set whether or not this view should account for system screen decorations
5272     * such as the status bar and inset its content. This allows this view to be
5273     * positioned in absolute screen coordinates and remain visible to the user.
5274     *
5275     * <p>This should only be used by top-level window decor views.
5276     *
5277     * @param fitSystemWindows true to inset content for system screen decorations, false for
5278     *                         default behavior.
5279     *
5280     * @attr ref android.R.styleable#View_fitsSystemWindows
5281     */
5282    public void setFitsSystemWindows(boolean fitSystemWindows) {
5283        setFlags(fitSystemWindows ? FITS_SYSTEM_WINDOWS : 0, FITS_SYSTEM_WINDOWS);
5284    }
5285
5286    /**
5287     * Check for state of {@link #setFitsSystemWindows(boolean). If this method
5288     * returns true, this view
5289     * will account for system screen decorations such as the status bar and inset its
5290     * content. This allows the view to be positioned in absolute screen coordinates
5291     * and remain visible to the user.
5292     *
5293     * @return true if this view will adjust its content bounds for system screen decorations.
5294     *
5295     * @attr ref android.R.styleable#View_fitsSystemWindows
5296     */
5297    public boolean getFitsSystemWindows() {
5298        return (mViewFlags & FITS_SYSTEM_WINDOWS) == FITS_SYSTEM_WINDOWS;
5299    }
5300
5301    /** @hide */
5302    public boolean fitsSystemWindows() {
5303        return getFitsSystemWindows();
5304    }
5305
5306    /**
5307     * Ask that a new dispatch of {@link #fitSystemWindows(Rect)} be performed.
5308     */
5309    public void requestFitSystemWindows() {
5310        if (mParent != null) {
5311            mParent.requestFitSystemWindows();
5312        }
5313    }
5314
5315    /**
5316     * For use by PhoneWindow to make its own system window fitting optional.
5317     * @hide
5318     */
5319    public void makeOptionalFitsSystemWindows() {
5320        setFlags(OPTIONAL_FITS_SYSTEM_WINDOWS, OPTIONAL_FITS_SYSTEM_WINDOWS);
5321    }
5322
5323    /**
5324     * Returns the visibility status for this view.
5325     *
5326     * @return One of {@link #VISIBLE}, {@link #INVISIBLE}, or {@link #GONE}.
5327     * @attr ref android.R.styleable#View_visibility
5328     */
5329    @ViewDebug.ExportedProperty(mapping = {
5330        @ViewDebug.IntToString(from = VISIBLE,   to = "VISIBLE"),
5331        @ViewDebug.IntToString(from = INVISIBLE, to = "INVISIBLE"),
5332        @ViewDebug.IntToString(from = GONE,      to = "GONE")
5333    })
5334    public int getVisibility() {
5335        return mViewFlags & VISIBILITY_MASK;
5336    }
5337
5338    /**
5339     * Set the enabled state of this view.
5340     *
5341     * @param visibility One of {@link #VISIBLE}, {@link #INVISIBLE}, or {@link #GONE}.
5342     * @attr ref android.R.styleable#View_visibility
5343     */
5344    @RemotableViewMethod
5345    public void setVisibility(int visibility) {
5346        setFlags(visibility, VISIBILITY_MASK);
5347        if (mBackground != null) mBackground.setVisible(visibility == VISIBLE, false);
5348    }
5349
5350    /**
5351     * Returns the enabled status for this view. The interpretation of the
5352     * enabled state varies by subclass.
5353     *
5354     * @return True if this view is enabled, false otherwise.
5355     */
5356    @ViewDebug.ExportedProperty
5357    public boolean isEnabled() {
5358        return (mViewFlags & ENABLED_MASK) == ENABLED;
5359    }
5360
5361    /**
5362     * Set the enabled state of this view. The interpretation of the enabled
5363     * state varies by subclass.
5364     *
5365     * @param enabled True if this view is enabled, false otherwise.
5366     */
5367    @RemotableViewMethod
5368    public void setEnabled(boolean enabled) {
5369        if (enabled == isEnabled()) return;
5370
5371        setFlags(enabled ? ENABLED : DISABLED, ENABLED_MASK);
5372
5373        /*
5374         * The View most likely has to change its appearance, so refresh
5375         * the drawable state.
5376         */
5377        refreshDrawableState();
5378
5379        // Invalidate too, since the default behavior for views is to be
5380        // be drawn at 50% alpha rather than to change the drawable.
5381        invalidate(true);
5382    }
5383
5384    /**
5385     * Set whether this view can receive the focus.
5386     *
5387     * Setting this to false will also ensure that this view is not focusable
5388     * in touch mode.
5389     *
5390     * @param focusable If true, this view can receive the focus.
5391     *
5392     * @see #setFocusableInTouchMode(boolean)
5393     * @attr ref android.R.styleable#View_focusable
5394     */
5395    public void setFocusable(boolean focusable) {
5396        if (!focusable) {
5397            setFlags(0, FOCUSABLE_IN_TOUCH_MODE);
5398        }
5399        setFlags(focusable ? FOCUSABLE : NOT_FOCUSABLE, FOCUSABLE_MASK);
5400    }
5401
5402    /**
5403     * Set whether this view can receive focus while in touch mode.
5404     *
5405     * Setting this to true will also ensure that this view is focusable.
5406     *
5407     * @param focusableInTouchMode If true, this view can receive the focus while
5408     *   in touch mode.
5409     *
5410     * @see #setFocusable(boolean)
5411     * @attr ref android.R.styleable#View_focusableInTouchMode
5412     */
5413    public void setFocusableInTouchMode(boolean focusableInTouchMode) {
5414        // Focusable in touch mode should always be set before the focusable flag
5415        // otherwise, setting the focusable flag will trigger a focusableViewAvailable()
5416        // which, in touch mode, will not successfully request focus on this view
5417        // because the focusable in touch mode flag is not set
5418        setFlags(focusableInTouchMode ? FOCUSABLE_IN_TOUCH_MODE : 0, FOCUSABLE_IN_TOUCH_MODE);
5419        if (focusableInTouchMode) {
5420            setFlags(FOCUSABLE, FOCUSABLE_MASK);
5421        }
5422    }
5423
5424    /**
5425     * Set whether this view should have sound effects enabled for events such as
5426     * clicking and touching.
5427     *
5428     * <p>You may wish to disable sound effects for a view if you already play sounds,
5429     * for instance, a dial key that plays dtmf tones.
5430     *
5431     * @param soundEffectsEnabled whether sound effects are enabled for this view.
5432     * @see #isSoundEffectsEnabled()
5433     * @see #playSoundEffect(int)
5434     * @attr ref android.R.styleable#View_soundEffectsEnabled
5435     */
5436    public void setSoundEffectsEnabled(boolean soundEffectsEnabled) {
5437        setFlags(soundEffectsEnabled ? SOUND_EFFECTS_ENABLED: 0, SOUND_EFFECTS_ENABLED);
5438    }
5439
5440    /**
5441     * @return whether this view should have sound effects enabled for events such as
5442     *     clicking and touching.
5443     *
5444     * @see #setSoundEffectsEnabled(boolean)
5445     * @see #playSoundEffect(int)
5446     * @attr ref android.R.styleable#View_soundEffectsEnabled
5447     */
5448    @ViewDebug.ExportedProperty
5449    public boolean isSoundEffectsEnabled() {
5450        return SOUND_EFFECTS_ENABLED == (mViewFlags & SOUND_EFFECTS_ENABLED);
5451    }
5452
5453    /**
5454     * Set whether this view should have haptic feedback for events such as
5455     * long presses.
5456     *
5457     * <p>You may wish to disable haptic feedback if your view already controls
5458     * its own haptic feedback.
5459     *
5460     * @param hapticFeedbackEnabled whether haptic feedback enabled for this view.
5461     * @see #isHapticFeedbackEnabled()
5462     * @see #performHapticFeedback(int)
5463     * @attr ref android.R.styleable#View_hapticFeedbackEnabled
5464     */
5465    public void setHapticFeedbackEnabled(boolean hapticFeedbackEnabled) {
5466        setFlags(hapticFeedbackEnabled ? HAPTIC_FEEDBACK_ENABLED: 0, HAPTIC_FEEDBACK_ENABLED);
5467    }
5468
5469    /**
5470     * @return whether this view should have haptic feedback enabled for events
5471     * long presses.
5472     *
5473     * @see #setHapticFeedbackEnabled(boolean)
5474     * @see #performHapticFeedback(int)
5475     * @attr ref android.R.styleable#View_hapticFeedbackEnabled
5476     */
5477    @ViewDebug.ExportedProperty
5478    public boolean isHapticFeedbackEnabled() {
5479        return HAPTIC_FEEDBACK_ENABLED == (mViewFlags & HAPTIC_FEEDBACK_ENABLED);
5480    }
5481
5482    /**
5483     * Returns the layout direction for this view.
5484     *
5485     * @return One of {@link #LAYOUT_DIRECTION_LTR},
5486     *   {@link #LAYOUT_DIRECTION_RTL},
5487     *   {@link #LAYOUT_DIRECTION_INHERIT} or
5488     *   {@link #LAYOUT_DIRECTION_LOCALE}.
5489     * @attr ref android.R.styleable#View_layoutDirection
5490     */
5491    @ViewDebug.ExportedProperty(category = "layout", mapping = {
5492        @ViewDebug.IntToString(from = LAYOUT_DIRECTION_LTR,     to = "LTR"),
5493        @ViewDebug.IntToString(from = LAYOUT_DIRECTION_RTL,     to = "RTL"),
5494        @ViewDebug.IntToString(from = LAYOUT_DIRECTION_INHERIT, to = "INHERIT"),
5495        @ViewDebug.IntToString(from = LAYOUT_DIRECTION_LOCALE,  to = "LOCALE")
5496    })
5497    public int getLayoutDirection() {
5498        return (mPrivateFlags2 & LAYOUT_DIRECTION_MASK) >> LAYOUT_DIRECTION_MASK_SHIFT;
5499    }
5500
5501    /**
5502     * Set the layout direction for this view. This will propagate a reset of layout direction
5503     * resolution to the view's children and resolve layout direction for this view.
5504     *
5505     * @param layoutDirection One of {@link #LAYOUT_DIRECTION_LTR},
5506     *   {@link #LAYOUT_DIRECTION_RTL},
5507     *   {@link #LAYOUT_DIRECTION_INHERIT} or
5508     *   {@link #LAYOUT_DIRECTION_LOCALE}.
5509     *
5510     * @attr ref android.R.styleable#View_layoutDirection
5511     */
5512    @RemotableViewMethod
5513    public void setLayoutDirection(int layoutDirection) {
5514        if (getLayoutDirection() != layoutDirection) {
5515            // Reset the current layout direction and the resolved one
5516            mPrivateFlags2 &= ~LAYOUT_DIRECTION_MASK;
5517            resetResolvedLayoutDirection();
5518            // Set the new layout direction (filtered) and ask for a layout pass
5519            mPrivateFlags2 |=
5520                    ((layoutDirection << LAYOUT_DIRECTION_MASK_SHIFT) & LAYOUT_DIRECTION_MASK);
5521            requestLayout();
5522        }
5523    }
5524
5525    /**
5526     * Returns the resolved layout direction for this view.
5527     *
5528     * @return {@link #LAYOUT_DIRECTION_RTL} if the layout direction is RTL or returns
5529     * {@link #LAYOUT_DIRECTION_LTR} if the layout direction is not RTL.
5530     */
5531    @ViewDebug.ExportedProperty(category = "layout", mapping = {
5532        @ViewDebug.IntToString(from = LAYOUT_DIRECTION_LTR, to = "RESOLVED_DIRECTION_LTR"),
5533        @ViewDebug.IntToString(from = LAYOUT_DIRECTION_RTL, to = "RESOLVED_DIRECTION_RTL")
5534    })
5535    public int getResolvedLayoutDirection() {
5536        // The layout diretion will be resolved only if needed
5537        if ((mPrivateFlags2 & LAYOUT_DIRECTION_RESOLVED) != LAYOUT_DIRECTION_RESOLVED) {
5538            resolveLayoutDirection();
5539        }
5540        return ((mPrivateFlags2 & LAYOUT_DIRECTION_RESOLVED_RTL) == LAYOUT_DIRECTION_RESOLVED_RTL) ?
5541                LAYOUT_DIRECTION_RTL : LAYOUT_DIRECTION_LTR;
5542    }
5543
5544    /**
5545     * Indicates whether or not this view's layout is right-to-left. This is resolved from
5546     * layout attribute and/or the inherited value from the parent
5547     *
5548     * @return true if the layout is right-to-left.
5549     */
5550    @ViewDebug.ExportedProperty(category = "layout")
5551    public boolean isLayoutRtl() {
5552        return (getResolvedLayoutDirection() == LAYOUT_DIRECTION_RTL);
5553    }
5554
5555    /**
5556     * Indicates whether the view is currently tracking transient state that the
5557     * app should not need to concern itself with saving and restoring, but that
5558     * the framework should take special note to preserve when possible.
5559     *
5560     * <p>A view with transient state cannot be trivially rebound from an external
5561     * data source, such as an adapter binding item views in a list. This may be
5562     * because the view is performing an animation, tracking user selection
5563     * of content, or similar.</p>
5564     *
5565     * @return true if the view has transient state
5566     */
5567    @ViewDebug.ExportedProperty(category = "layout")
5568    public boolean hasTransientState() {
5569        return (mPrivateFlags2 & HAS_TRANSIENT_STATE) == HAS_TRANSIENT_STATE;
5570    }
5571
5572    /**
5573     * Set whether this view is currently tracking transient state that the
5574     * framework should attempt to preserve when possible. This flag is reference counted,
5575     * so every call to setHasTransientState(true) should be paired with a later call
5576     * to setHasTransientState(false).
5577     *
5578     * <p>A view with transient state cannot be trivially rebound from an external
5579     * data source, such as an adapter binding item views in a list. This may be
5580     * because the view is performing an animation, tracking user selection
5581     * of content, or similar.</p>
5582     *
5583     * @param hasTransientState true if this view has transient state
5584     */
5585    public void setHasTransientState(boolean hasTransientState) {
5586        mTransientStateCount = hasTransientState ? mTransientStateCount + 1 :
5587                mTransientStateCount - 1;
5588        if (mTransientStateCount < 0) {
5589            mTransientStateCount = 0;
5590            Log.e(VIEW_LOG_TAG, "hasTransientState decremented below 0: " +
5591                    "unmatched pair of setHasTransientState calls");
5592        }
5593        if ((hasTransientState && mTransientStateCount == 1) ||
5594                (!hasTransientState && mTransientStateCount == 0)) {
5595            // update flag if we've just incremented up from 0 or decremented down to 0
5596            mPrivateFlags2 = (mPrivateFlags2 & ~HAS_TRANSIENT_STATE) |
5597                    (hasTransientState ? HAS_TRANSIENT_STATE : 0);
5598            if (mParent != null) {
5599                try {
5600                    mParent.childHasTransientStateChanged(this, hasTransientState);
5601                } catch (AbstractMethodError e) {
5602                    Log.e(VIEW_LOG_TAG, mParent.getClass().getSimpleName() +
5603                            " does not fully implement ViewParent", e);
5604                }
5605            }
5606        }
5607    }
5608
5609    /**
5610     * If this view doesn't do any drawing on its own, set this flag to
5611     * allow further optimizations. By default, this flag is not set on
5612     * View, but could be set on some View subclasses such as ViewGroup.
5613     *
5614     * Typically, if you override {@link #onDraw(android.graphics.Canvas)}
5615     * you should clear this flag.
5616     *
5617     * @param willNotDraw whether or not this View draw on its own
5618     */
5619    public void setWillNotDraw(boolean willNotDraw) {
5620        setFlags(willNotDraw ? WILL_NOT_DRAW : 0, DRAW_MASK);
5621    }
5622
5623    /**
5624     * Returns whether or not this View draws on its own.
5625     *
5626     * @return true if this view has nothing to draw, false otherwise
5627     */
5628    @ViewDebug.ExportedProperty(category = "drawing")
5629    public boolean willNotDraw() {
5630        return (mViewFlags & DRAW_MASK) == WILL_NOT_DRAW;
5631    }
5632
5633    /**
5634     * When a View's drawing cache is enabled, drawing is redirected to an
5635     * offscreen bitmap. Some views, like an ImageView, must be able to
5636     * bypass this mechanism if they already draw a single bitmap, to avoid
5637     * unnecessary usage of the memory.
5638     *
5639     * @param willNotCacheDrawing true if this view does not cache its
5640     *        drawing, false otherwise
5641     */
5642    public void setWillNotCacheDrawing(boolean willNotCacheDrawing) {
5643        setFlags(willNotCacheDrawing ? WILL_NOT_CACHE_DRAWING : 0, WILL_NOT_CACHE_DRAWING);
5644    }
5645
5646    /**
5647     * Returns whether or not this View can cache its drawing or not.
5648     *
5649     * @return true if this view does not cache its drawing, false otherwise
5650     */
5651    @ViewDebug.ExportedProperty(category = "drawing")
5652    public boolean willNotCacheDrawing() {
5653        return (mViewFlags & WILL_NOT_CACHE_DRAWING) == WILL_NOT_CACHE_DRAWING;
5654    }
5655
5656    /**
5657     * Indicates whether this view reacts to click events or not.
5658     *
5659     * @return true if the view is clickable, false otherwise
5660     *
5661     * @see #setClickable(boolean)
5662     * @attr ref android.R.styleable#View_clickable
5663     */
5664    @ViewDebug.ExportedProperty
5665    public boolean isClickable() {
5666        return (mViewFlags & CLICKABLE) == CLICKABLE;
5667    }
5668
5669    /**
5670     * Enables or disables click events for this view. When a view
5671     * is clickable it will change its state to "pressed" on every click.
5672     * Subclasses should set the view clickable to visually react to
5673     * user's clicks.
5674     *
5675     * @param clickable true to make the view clickable, false otherwise
5676     *
5677     * @see #isClickable()
5678     * @attr ref android.R.styleable#View_clickable
5679     */
5680    public void setClickable(boolean clickable) {
5681        setFlags(clickable ? CLICKABLE : 0, CLICKABLE);
5682    }
5683
5684    /**
5685     * Indicates whether this view reacts to long click events or not.
5686     *
5687     * @return true if the view is long clickable, false otherwise
5688     *
5689     * @see #setLongClickable(boolean)
5690     * @attr ref android.R.styleable#View_longClickable
5691     */
5692    public boolean isLongClickable() {
5693        return (mViewFlags & LONG_CLICKABLE) == LONG_CLICKABLE;
5694    }
5695
5696    /**
5697     * Enables or disables long click events for this view. When a view is long
5698     * clickable it reacts to the user holding down the button for a longer
5699     * duration than a tap. This event can either launch the listener or a
5700     * context menu.
5701     *
5702     * @param longClickable true to make the view long clickable, false otherwise
5703     * @see #isLongClickable()
5704     * @attr ref android.R.styleable#View_longClickable
5705     */
5706    public void setLongClickable(boolean longClickable) {
5707        setFlags(longClickable ? LONG_CLICKABLE : 0, LONG_CLICKABLE);
5708    }
5709
5710    /**
5711     * Sets the pressed state for this view.
5712     *
5713     * @see #isClickable()
5714     * @see #setClickable(boolean)
5715     *
5716     * @param pressed Pass true to set the View's internal state to "pressed", or false to reverts
5717     *        the View's internal state from a previously set "pressed" state.
5718     */
5719    public void setPressed(boolean pressed) {
5720        final boolean needsRefresh = pressed != ((mPrivateFlags & PRESSED) == PRESSED);
5721
5722        if (pressed) {
5723            mPrivateFlags |= PRESSED;
5724        } else {
5725            mPrivateFlags &= ~PRESSED;
5726        }
5727
5728        if (needsRefresh) {
5729            refreshDrawableState();
5730        }
5731        dispatchSetPressed(pressed);
5732    }
5733
5734    /**
5735     * Dispatch setPressed to all of this View's children.
5736     *
5737     * @see #setPressed(boolean)
5738     *
5739     * @param pressed The new pressed state
5740     */
5741    protected void dispatchSetPressed(boolean pressed) {
5742    }
5743
5744    /**
5745     * Indicates whether the view is currently in pressed state. Unless
5746     * {@link #setPressed(boolean)} is explicitly called, only clickable views can enter
5747     * the pressed state.
5748     *
5749     * @see #setPressed(boolean)
5750     * @see #isClickable()
5751     * @see #setClickable(boolean)
5752     *
5753     * @return true if the view is currently pressed, false otherwise
5754     */
5755    public boolean isPressed() {
5756        return (mPrivateFlags & PRESSED) == PRESSED;
5757    }
5758
5759    /**
5760     * Indicates whether this view will save its state (that is,
5761     * whether its {@link #onSaveInstanceState} method will be called).
5762     *
5763     * @return Returns true if the view state saving is enabled, else false.
5764     *
5765     * @see #setSaveEnabled(boolean)
5766     * @attr ref android.R.styleable#View_saveEnabled
5767     */
5768    public boolean isSaveEnabled() {
5769        return (mViewFlags & SAVE_DISABLED_MASK) != SAVE_DISABLED;
5770    }
5771
5772    /**
5773     * Controls whether the saving of this view's state is
5774     * enabled (that is, whether its {@link #onSaveInstanceState} method
5775     * will be called).  Note that even if freezing is enabled, the
5776     * view still must have an id assigned to it (via {@link #setId(int)})
5777     * for its state to be saved.  This flag can only disable the
5778     * saving of this view; any child views may still have their state saved.
5779     *
5780     * @param enabled Set to false to <em>disable</em> state saving, or true
5781     * (the default) to allow it.
5782     *
5783     * @see #isSaveEnabled()
5784     * @see #setId(int)
5785     * @see #onSaveInstanceState()
5786     * @attr ref android.R.styleable#View_saveEnabled
5787     */
5788    public void setSaveEnabled(boolean enabled) {
5789        setFlags(enabled ? 0 : SAVE_DISABLED, SAVE_DISABLED_MASK);
5790    }
5791
5792    /**
5793     * Gets whether the framework should discard touches when the view's
5794     * window is obscured by another visible window.
5795     * Refer to the {@link View} security documentation for more details.
5796     *
5797     * @return True if touch filtering is enabled.
5798     *
5799     * @see #setFilterTouchesWhenObscured(boolean)
5800     * @attr ref android.R.styleable#View_filterTouchesWhenObscured
5801     */
5802    @ViewDebug.ExportedProperty
5803    public boolean getFilterTouchesWhenObscured() {
5804        return (mViewFlags & FILTER_TOUCHES_WHEN_OBSCURED) != 0;
5805    }
5806
5807    /**
5808     * Sets whether the framework should discard touches when the view's
5809     * window is obscured by another visible window.
5810     * Refer to the {@link View} security documentation for more details.
5811     *
5812     * @param enabled True if touch filtering should be enabled.
5813     *
5814     * @see #getFilterTouchesWhenObscured
5815     * @attr ref android.R.styleable#View_filterTouchesWhenObscured
5816     */
5817    public void setFilterTouchesWhenObscured(boolean enabled) {
5818        setFlags(enabled ? 0 : FILTER_TOUCHES_WHEN_OBSCURED,
5819                FILTER_TOUCHES_WHEN_OBSCURED);
5820    }
5821
5822    /**
5823     * Indicates whether the entire hierarchy under this view will save its
5824     * state when a state saving traversal occurs from its parent.  The default
5825     * is true; if false, these views will not be saved unless
5826     * {@link #saveHierarchyState(SparseArray)} is called directly on this view.
5827     *
5828     * @return Returns true if the view state saving from parent is enabled, else false.
5829     *
5830     * @see #setSaveFromParentEnabled(boolean)
5831     */
5832    public boolean isSaveFromParentEnabled() {
5833        return (mViewFlags & PARENT_SAVE_DISABLED_MASK) != PARENT_SAVE_DISABLED;
5834    }
5835
5836    /**
5837     * Controls whether the entire hierarchy under this view will save its
5838     * state when a state saving traversal occurs from its parent.  The default
5839     * is true; if false, these views will not be saved unless
5840     * {@link #saveHierarchyState(SparseArray)} is called directly on this view.
5841     *
5842     * @param enabled Set to false to <em>disable</em> state saving, or true
5843     * (the default) to allow it.
5844     *
5845     * @see #isSaveFromParentEnabled()
5846     * @see #setId(int)
5847     * @see #onSaveInstanceState()
5848     */
5849    public void setSaveFromParentEnabled(boolean enabled) {
5850        setFlags(enabled ? 0 : PARENT_SAVE_DISABLED, PARENT_SAVE_DISABLED_MASK);
5851    }
5852
5853
5854    /**
5855     * Returns whether this View is able to take focus.
5856     *
5857     * @return True if this view can take focus, or false otherwise.
5858     * @attr ref android.R.styleable#View_focusable
5859     */
5860    @ViewDebug.ExportedProperty(category = "focus")
5861    public final boolean isFocusable() {
5862        return FOCUSABLE == (mViewFlags & FOCUSABLE_MASK);
5863    }
5864
5865    /**
5866     * When a view is focusable, it may not want to take focus when in touch mode.
5867     * For example, a button would like focus when the user is navigating via a D-pad
5868     * so that the user can click on it, but once the user starts touching the screen,
5869     * the button shouldn't take focus
5870     * @return Whether the view is focusable in touch mode.
5871     * @attr ref android.R.styleable#View_focusableInTouchMode
5872     */
5873    @ViewDebug.ExportedProperty
5874    public final boolean isFocusableInTouchMode() {
5875        return FOCUSABLE_IN_TOUCH_MODE == (mViewFlags & FOCUSABLE_IN_TOUCH_MODE);
5876    }
5877
5878    /**
5879     * Find the nearest view in the specified direction that can take focus.
5880     * This does not actually give focus to that view.
5881     *
5882     * @param direction One of FOCUS_UP, FOCUS_DOWN, FOCUS_LEFT, and FOCUS_RIGHT
5883     *
5884     * @return The nearest focusable in the specified direction, or null if none
5885     *         can be found.
5886     */
5887    public View focusSearch(int direction) {
5888        if (mParent != null) {
5889            return mParent.focusSearch(this, direction);
5890        } else {
5891            return null;
5892        }
5893    }
5894
5895    /**
5896     * This method is the last chance for the focused view and its ancestors to
5897     * respond to an arrow key. This is called when the focused view did not
5898     * consume the key internally, nor could the view system find a new view in
5899     * the requested direction to give focus to.
5900     *
5901     * @param focused The currently focused view.
5902     * @param direction The direction focus wants to move. One of FOCUS_UP,
5903     *        FOCUS_DOWN, FOCUS_LEFT, and FOCUS_RIGHT.
5904     * @return True if the this view consumed this unhandled move.
5905     */
5906    public boolean dispatchUnhandledMove(View focused, int direction) {
5907        return false;
5908    }
5909
5910    /**
5911     * If a user manually specified the next view id for a particular direction,
5912     * use the root to look up the view.
5913     * @param root The root view of the hierarchy containing this view.
5914     * @param direction One of FOCUS_UP, FOCUS_DOWN, FOCUS_LEFT, FOCUS_RIGHT, FOCUS_FORWARD,
5915     * or FOCUS_BACKWARD.
5916     * @return The user specified next view, or null if there is none.
5917     */
5918    View findUserSetNextFocus(View root, int direction) {
5919        switch (direction) {
5920            case FOCUS_LEFT:
5921                if (mNextFocusLeftId == View.NO_ID) return null;
5922                return findViewInsideOutShouldExist(root, mNextFocusLeftId);
5923            case FOCUS_RIGHT:
5924                if (mNextFocusRightId == View.NO_ID) return null;
5925                return findViewInsideOutShouldExist(root, mNextFocusRightId);
5926            case FOCUS_UP:
5927                if (mNextFocusUpId == View.NO_ID) return null;
5928                return findViewInsideOutShouldExist(root, mNextFocusUpId);
5929            case FOCUS_DOWN:
5930                if (mNextFocusDownId == View.NO_ID) return null;
5931                return findViewInsideOutShouldExist(root, mNextFocusDownId);
5932            case FOCUS_FORWARD:
5933                if (mNextFocusForwardId == View.NO_ID) return null;
5934                return findViewInsideOutShouldExist(root, mNextFocusForwardId);
5935            case FOCUS_BACKWARD: {
5936                if (mID == View.NO_ID) return null;
5937                final int id = mID;
5938                return root.findViewByPredicateInsideOut(this, new Predicate<View>() {
5939                    @Override
5940                    public boolean apply(View t) {
5941                        return t.mNextFocusForwardId == id;
5942                    }
5943                });
5944            }
5945        }
5946        return null;
5947    }
5948
5949    private View findViewInsideOutShouldExist(View root, final int childViewId) {
5950        View result = root.findViewByPredicateInsideOut(this, new Predicate<View>() {
5951            @Override
5952            public boolean apply(View t) {
5953                return t.mID == childViewId;
5954            }
5955        });
5956
5957        if (result == null) {
5958            Log.w(VIEW_LOG_TAG, "couldn't find next focus view specified "
5959                    + "by user for id " + childViewId);
5960        }
5961        return result;
5962    }
5963
5964    /**
5965     * Find and return all focusable views that are descendants of this view,
5966     * possibly including this view if it is focusable itself.
5967     *
5968     * @param direction The direction of the focus
5969     * @return A list of focusable views
5970     */
5971    public ArrayList<View> getFocusables(int direction) {
5972        ArrayList<View> result = new ArrayList<View>(24);
5973        addFocusables(result, direction);
5974        return result;
5975    }
5976
5977    /**
5978     * Add any focusable views that are descendants of this view (possibly
5979     * including this view if it is focusable itself) to views.  If we are in touch mode,
5980     * only add views that are also focusable in touch mode.
5981     *
5982     * @param views Focusable views found so far
5983     * @param direction The direction of the focus
5984     */
5985    public void addFocusables(ArrayList<View> views, int direction) {
5986        addFocusables(views, direction, FOCUSABLES_TOUCH_MODE);
5987    }
5988
5989    /**
5990     * Adds any focusable views that are descendants of this view (possibly
5991     * including this view if it is focusable itself) to views. This method
5992     * adds all focusable views regardless if we are in touch mode or
5993     * only views focusable in touch mode if we are in touch mode or
5994     * only views that can take accessibility focus if accessibility is enabeld
5995     * depending on the focusable mode paramater.
5996     *
5997     * @param views Focusable views found so far or null if all we are interested is
5998     *        the number of focusables.
5999     * @param direction The direction of the focus.
6000     * @param focusableMode The type of focusables to be added.
6001     *
6002     * @see #FOCUSABLES_ALL
6003     * @see #FOCUSABLES_TOUCH_MODE
6004     */
6005    public void addFocusables(ArrayList<View> views, int direction, int focusableMode) {
6006        if (views == null) {
6007            return;
6008        }
6009        if ((focusableMode & FOCUSABLES_ACCESSIBILITY) == FOCUSABLES_ACCESSIBILITY) {
6010            if (canTakeAccessibilityFocusFromHover() || getAccessibilityNodeProvider() != null) {
6011                views.add(this);
6012                return;
6013            }
6014        }
6015        if (!isFocusable()) {
6016            return;
6017        }
6018        if ((focusableMode & FOCUSABLES_TOUCH_MODE) == FOCUSABLES_TOUCH_MODE
6019                && isInTouchMode() && !isFocusableInTouchMode()) {
6020            return;
6021        }
6022        views.add(this);
6023    }
6024
6025    /**
6026     * Finds the Views that contain given text. The containment is case insensitive.
6027     * The search is performed by either the text that the View renders or the content
6028     * description that describes the view for accessibility purposes and the view does
6029     * not render or both. Clients can specify how the search is to be performed via
6030     * passing the {@link #FIND_VIEWS_WITH_TEXT} and
6031     * {@link #FIND_VIEWS_WITH_CONTENT_DESCRIPTION} flags.
6032     *
6033     * @param outViews The output list of matching Views.
6034     * @param searched The text to match against.
6035     *
6036     * @see #FIND_VIEWS_WITH_TEXT
6037     * @see #FIND_VIEWS_WITH_CONTENT_DESCRIPTION
6038     * @see #setContentDescription(CharSequence)
6039     */
6040    public void findViewsWithText(ArrayList<View> outViews, CharSequence searched, int flags) {
6041        if (getAccessibilityNodeProvider() != null) {
6042            if ((flags & FIND_VIEWS_WITH_ACCESSIBILITY_NODE_PROVIDERS) != 0) {
6043                outViews.add(this);
6044            }
6045        } else if ((flags & FIND_VIEWS_WITH_CONTENT_DESCRIPTION) != 0
6046                && (searched != null && searched.length() > 0)
6047                && (mContentDescription != null && mContentDescription.length() > 0)) {
6048            String searchedLowerCase = searched.toString().toLowerCase();
6049            String contentDescriptionLowerCase = mContentDescription.toString().toLowerCase();
6050            if (contentDescriptionLowerCase.contains(searchedLowerCase)) {
6051                outViews.add(this);
6052            }
6053        }
6054    }
6055
6056    /**
6057     * Find and return all touchable views that are descendants of this view,
6058     * possibly including this view if it is touchable itself.
6059     *
6060     * @return A list of touchable views
6061     */
6062    public ArrayList<View> getTouchables() {
6063        ArrayList<View> result = new ArrayList<View>();
6064        addTouchables(result);
6065        return result;
6066    }
6067
6068    /**
6069     * Add any touchable views that are descendants of this view (possibly
6070     * including this view if it is touchable itself) to views.
6071     *
6072     * @param views Touchable views found so far
6073     */
6074    public void addTouchables(ArrayList<View> views) {
6075        final int viewFlags = mViewFlags;
6076
6077        if (((viewFlags & CLICKABLE) == CLICKABLE || (viewFlags & LONG_CLICKABLE) == LONG_CLICKABLE)
6078                && (viewFlags & ENABLED_MASK) == ENABLED) {
6079            views.add(this);
6080        }
6081    }
6082
6083    /**
6084     * Returns whether this View is accessibility focused.
6085     *
6086     * @return True if this View is accessibility focused.
6087     */
6088    boolean isAccessibilityFocused() {
6089        return (mPrivateFlags2 & ACCESSIBILITY_FOCUSED) != 0;
6090    }
6091
6092    /**
6093     * Call this to try to give accessibility focus to this view.
6094     *
6095     * A view will not actually take focus if {@link AccessibilityManager#isEnabled()}
6096     * returns false or the view is no visible or the view already has accessibility
6097     * focus.
6098     *
6099     * See also {@link #focusSearch(int)}, which is what you call to say that you
6100     * have focus, and you want your parent to look for the next one.
6101     *
6102     * @return Whether this view actually took accessibility focus.
6103     *
6104     * @hide
6105     */
6106    public boolean requestAccessibilityFocus() {
6107        AccessibilityManager manager = AccessibilityManager.getInstance(mContext);
6108        if (!manager.isEnabled() || !manager.isTouchExplorationEnabled()) {
6109            return false;
6110        }
6111        if ((mViewFlags & VISIBILITY_MASK) != VISIBLE) {
6112            return false;
6113        }
6114        if ((mPrivateFlags2 & ACCESSIBILITY_FOCUSED) == 0) {
6115            mPrivateFlags2 |= ACCESSIBILITY_FOCUSED;
6116            ViewRootImpl viewRootImpl = getViewRootImpl();
6117            if (viewRootImpl != null) {
6118                viewRootImpl.setAccessibilityFocusedHost(this);
6119            }
6120            invalidate();
6121            sendAccessibilityEvent(AccessibilityEvent.TYPE_VIEW_ACCESSIBILITY_FOCUSED);
6122            notifyAccessibilityStateChanged();
6123            // Try to give input focus to this view - not a descendant.
6124            requestFocusNoSearch(View.FOCUS_DOWN, null);
6125            return true;
6126        }
6127        return false;
6128    }
6129
6130    /**
6131     * Call this to try to clear accessibility focus of this view.
6132     *
6133     * See also {@link #focusSearch(int)}, which is what you call to say that you
6134     * have focus, and you want your parent to look for the next one.
6135     *
6136     * @hide
6137     */
6138    public void clearAccessibilityFocus() {
6139        ViewRootImpl viewRootImpl = getViewRootImpl();
6140        if (viewRootImpl != null) {
6141            View focusHost = viewRootImpl.getAccessibilityFocusedHost();
6142            if (focusHost != null && focusHost != this
6143                    && ViewRootImpl.isViewDescendantOf(focusHost, this)) {
6144                viewRootImpl.setAccessibilityFocusedHost(null);
6145            }
6146        }
6147        if ((mPrivateFlags2 & ACCESSIBILITY_FOCUSED) != 0) {
6148            mPrivateFlags2 &= ~ACCESSIBILITY_FOCUSED;
6149            invalidate();
6150            sendAccessibilityEvent(AccessibilityEvent.TYPE_VIEW_ACCESSIBILITY_FOCUS_CLEARED);
6151            notifyAccessibilityStateChanged();
6152
6153            // Clear the text navigation state.
6154            setAccessibilityCursorPosition(-1);
6155
6156            // Try to move accessibility focus to the input focus.
6157            View rootView = getRootView();
6158            if (rootView != null) {
6159                View inputFocus = rootView.findFocus();
6160                if (inputFocus != null) {
6161                    inputFocus.requestAccessibilityFocus();
6162                }
6163            }
6164        }
6165    }
6166
6167    private void requestAccessibilityFocusFromHover() {
6168        if (includeForAccessibility() && isActionableForAccessibility()) {
6169            requestAccessibilityFocus();
6170        } else {
6171            if (mParent != null) {
6172                View nextFocus = mParent.findViewToTakeAccessibilityFocusFromHover(this, this);
6173                if (nextFocus != null) {
6174                    nextFocus.requestAccessibilityFocus();
6175                }
6176            }
6177        }
6178    }
6179
6180    /**
6181     * @hide
6182     */
6183    public boolean canTakeAccessibilityFocusFromHover() {
6184        if (includeForAccessibility() && isActionableForAccessibility()) {
6185            return true;
6186        }
6187        if (mParent != null) {
6188            return (mParent.findViewToTakeAccessibilityFocusFromHover(this, this) == this);
6189        }
6190        return false;
6191    }
6192
6193    /**
6194     * Clears accessibility focus without calling any callback methods
6195     * normally invoked in {@link #clearAccessibilityFocus()}. This method
6196     * is used for clearing accessibility focus when giving this focus to
6197     * another view.
6198     */
6199    void clearAccessibilityFocusNoCallbacks() {
6200        if ((mPrivateFlags2 & ACCESSIBILITY_FOCUSED) != 0) {
6201            mPrivateFlags2 &= ~ACCESSIBILITY_FOCUSED;
6202            invalidate();
6203        }
6204    }
6205
6206    /**
6207     * Call this to try to give focus to a specific view or to one of its
6208     * descendants.
6209     *
6210     * A view will not actually take focus if it is not focusable ({@link #isFocusable} returns
6211     * false), or if it is focusable and it is not focusable in touch mode
6212     * ({@link #isFocusableInTouchMode}) while the device is in touch mode.
6213     *
6214     * See also {@link #focusSearch(int)}, which is what you call to say that you
6215     * have focus, and you want your parent to look for the next one.
6216     *
6217     * This is equivalent to calling {@link #requestFocus(int, Rect)} with arguments
6218     * {@link #FOCUS_DOWN} and <code>null</code>.
6219     *
6220     * @return Whether this view or one of its descendants actually took focus.
6221     */
6222    public final boolean requestFocus() {
6223        return requestFocus(View.FOCUS_DOWN);
6224    }
6225
6226    /**
6227     * Call this to try to give focus to a specific view or to one of its
6228     * descendants and give it a hint about what direction focus is heading.
6229     *
6230     * A view will not actually take focus if it is not focusable ({@link #isFocusable} returns
6231     * false), or if it is focusable and it is not focusable in touch mode
6232     * ({@link #isFocusableInTouchMode}) while the device is in touch mode.
6233     *
6234     * See also {@link #focusSearch(int)}, which is what you call to say that you
6235     * have focus, and you want your parent to look for the next one.
6236     *
6237     * This is equivalent to calling {@link #requestFocus(int, Rect)} with
6238     * <code>null</code> set for the previously focused rectangle.
6239     *
6240     * @param direction One of FOCUS_UP, FOCUS_DOWN, FOCUS_LEFT, and FOCUS_RIGHT
6241     * @return Whether this view or one of its descendants actually took focus.
6242     */
6243    public final boolean requestFocus(int direction) {
6244        return requestFocus(direction, null);
6245    }
6246
6247    /**
6248     * Call this to try to give focus to a specific view or to one of its descendants
6249     * and give it hints about the direction and a specific rectangle that the focus
6250     * is coming from.  The rectangle can help give larger views a finer grained hint
6251     * about where focus is coming from, and therefore, where to show selection, or
6252     * forward focus change internally.
6253     *
6254     * A view will not actually take focus if it is not focusable ({@link #isFocusable} returns
6255     * false), or if it is focusable and it is not focusable in touch mode
6256     * ({@link #isFocusableInTouchMode}) while the device is in touch mode.
6257     *
6258     * A View will not take focus if it is not visible.
6259     *
6260     * A View will not take focus if one of its parents has
6261     * {@link android.view.ViewGroup#getDescendantFocusability()} equal to
6262     * {@link ViewGroup#FOCUS_BLOCK_DESCENDANTS}.
6263     *
6264     * See also {@link #focusSearch(int)}, which is what you call to say that you
6265     * have focus, and you want your parent to look for the next one.
6266     *
6267     * You may wish to override this method if your custom {@link View} has an internal
6268     * {@link View} that it wishes to forward the request to.
6269     *
6270     * @param direction One of FOCUS_UP, FOCUS_DOWN, FOCUS_LEFT, and FOCUS_RIGHT
6271     * @param previouslyFocusedRect The rectangle (in this View's coordinate system)
6272     *        to give a finer grained hint about where focus is coming from.  May be null
6273     *        if there is no hint.
6274     * @return Whether this view or one of its descendants actually took focus.
6275     */
6276    public boolean requestFocus(int direction, Rect previouslyFocusedRect) {
6277        return requestFocusNoSearch(direction, previouslyFocusedRect);
6278    }
6279
6280    private boolean requestFocusNoSearch(int direction, Rect previouslyFocusedRect) {
6281        // need to be focusable
6282        if ((mViewFlags & FOCUSABLE_MASK) != FOCUSABLE ||
6283                (mViewFlags & VISIBILITY_MASK) != VISIBLE) {
6284            return false;
6285        }
6286
6287        // need to be focusable in touch mode if in touch mode
6288        if (isInTouchMode() &&
6289            (FOCUSABLE_IN_TOUCH_MODE != (mViewFlags & FOCUSABLE_IN_TOUCH_MODE))) {
6290               return false;
6291        }
6292
6293        // need to not have any parents blocking us
6294        if (hasAncestorThatBlocksDescendantFocus()) {
6295            return false;
6296        }
6297
6298        handleFocusGainInternal(direction, previouslyFocusedRect);
6299        return true;
6300    }
6301
6302    /**
6303     * Call this to try to give focus to a specific view or to one of its descendants. This is a
6304     * special variant of {@link #requestFocus() } that will allow views that are not focuable in
6305     * touch mode to request focus when they are touched.
6306     *
6307     * @return Whether this view or one of its descendants actually took focus.
6308     *
6309     * @see #isInTouchMode()
6310     *
6311     */
6312    public final boolean requestFocusFromTouch() {
6313        // Leave touch mode if we need to
6314        if (isInTouchMode()) {
6315            ViewRootImpl viewRoot = getViewRootImpl();
6316            if (viewRoot != null) {
6317                viewRoot.ensureTouchMode(false);
6318            }
6319        }
6320        return requestFocus(View.FOCUS_DOWN);
6321    }
6322
6323    /**
6324     * @return Whether any ancestor of this view blocks descendant focus.
6325     */
6326    private boolean hasAncestorThatBlocksDescendantFocus() {
6327        ViewParent ancestor = mParent;
6328        while (ancestor instanceof ViewGroup) {
6329            final ViewGroup vgAncestor = (ViewGroup) ancestor;
6330            if (vgAncestor.getDescendantFocusability() == ViewGroup.FOCUS_BLOCK_DESCENDANTS) {
6331                return true;
6332            } else {
6333                ancestor = vgAncestor.getParent();
6334            }
6335        }
6336        return false;
6337    }
6338
6339    /**
6340     * Gets the mode for determining whether this View is important for accessibility
6341     * which is if it fires accessibility events and if it is reported to
6342     * accessibility services that query the screen.
6343     *
6344     * @return The mode for determining whether a View is important for accessibility.
6345     *
6346     * @attr ref android.R.styleable#View_importantForAccessibility
6347     *
6348     * @see #IMPORTANT_FOR_ACCESSIBILITY_YES
6349     * @see #IMPORTANT_FOR_ACCESSIBILITY_NO
6350     * @see #IMPORTANT_FOR_ACCESSIBILITY_AUTO
6351     */
6352    @ViewDebug.ExportedProperty(category = "accessibility", mapping = {
6353            @ViewDebug.IntToString(from = IMPORTANT_FOR_ACCESSIBILITY_AUTO,
6354                    to = "IMPORTANT_FOR_ACCESSIBILITY_AUTO"),
6355            @ViewDebug.IntToString(from = IMPORTANT_FOR_ACCESSIBILITY_YES,
6356                    to = "IMPORTANT_FOR_ACCESSIBILITY_YES"),
6357            @ViewDebug.IntToString(from = IMPORTANT_FOR_ACCESSIBILITY_NO,
6358                    to = "IMPORTANT_FOR_ACCESSIBILITY_NO")
6359        })
6360    public int getImportantForAccessibility() {
6361        return (mPrivateFlags2 & IMPORTANT_FOR_ACCESSIBILITY_MASK)
6362                >> IMPORTANT_FOR_ACCESSIBILITY_SHIFT;
6363    }
6364
6365    /**
6366     * Sets how to determine whether this view is important for accessibility
6367     * which is if it fires accessibility events and if it is reported to
6368     * accessibility services that query the screen.
6369     *
6370     * @param mode How to determine whether this view is important for accessibility.
6371     *
6372     * @attr ref android.R.styleable#View_importantForAccessibility
6373     *
6374     * @see #IMPORTANT_FOR_ACCESSIBILITY_YES
6375     * @see #IMPORTANT_FOR_ACCESSIBILITY_NO
6376     * @see #IMPORTANT_FOR_ACCESSIBILITY_AUTO
6377     */
6378    public void setImportantForAccessibility(int mode) {
6379        if (mode != getImportantForAccessibility()) {
6380            mPrivateFlags2 &= ~IMPORTANT_FOR_ACCESSIBILITY_MASK;
6381            mPrivateFlags2 |= (mode << IMPORTANT_FOR_ACCESSIBILITY_SHIFT)
6382                    & IMPORTANT_FOR_ACCESSIBILITY_MASK;
6383            notifyAccessibilityStateChanged();
6384        }
6385    }
6386
6387    /**
6388     * Gets whether this view should be exposed for accessibility.
6389     *
6390     * @return Whether the view is exposed for accessibility.
6391     *
6392     * @hide
6393     */
6394    public boolean isImportantForAccessibility() {
6395        final int mode = (mPrivateFlags2 & IMPORTANT_FOR_ACCESSIBILITY_MASK)
6396                >> IMPORTANT_FOR_ACCESSIBILITY_SHIFT;
6397        switch (mode) {
6398            case IMPORTANT_FOR_ACCESSIBILITY_YES:
6399                return true;
6400            case IMPORTANT_FOR_ACCESSIBILITY_NO:
6401                return false;
6402            case IMPORTANT_FOR_ACCESSIBILITY_AUTO:
6403                return isActionableForAccessibility() || hasListenersForAccessibility();
6404            default:
6405                throw new IllegalArgumentException("Unknow important for accessibility mode: "
6406                        + mode);
6407        }
6408    }
6409
6410    /**
6411     * Gets the parent for accessibility purposes. Note that the parent for
6412     * accessibility is not necessary the immediate parent. It is the first
6413     * predecessor that is important for accessibility.
6414     *
6415     * @return The parent for accessibility purposes.
6416     */
6417    public ViewParent getParentForAccessibility() {
6418        if (mParent instanceof View) {
6419            View parentView = (View) mParent;
6420            if (parentView.includeForAccessibility()) {
6421                return mParent;
6422            } else {
6423                return mParent.getParentForAccessibility();
6424            }
6425        }
6426        return null;
6427    }
6428
6429    /**
6430     * Adds the children of a given View for accessibility. Since some Views are
6431     * not important for accessibility the children for accessibility are not
6432     * necessarily direct children of the riew, rather they are the first level of
6433     * descendants important for accessibility.
6434     *
6435     * @param children The list of children for accessibility.
6436     */
6437    public void addChildrenForAccessibility(ArrayList<View> children) {
6438        if (includeForAccessibility()) {
6439            children.add(this);
6440        }
6441    }
6442
6443    /**
6444     * Whether to regard this view for accessibility. A view is regarded for
6445     * accessibility if it is important for accessibility or the querying
6446     * accessibility service has explicitly requested that view not
6447     * important for accessibility are regarded.
6448     *
6449     * @return Whether to regard the view for accessibility.
6450     *
6451     * @hide
6452     */
6453    public boolean includeForAccessibility() {
6454        if (mAttachInfo != null) {
6455            if (!mAttachInfo.mIncludeNotImportantViews) {
6456                return isImportantForAccessibility();
6457            }
6458            return true;
6459        }
6460        return false;
6461    }
6462
6463    /**
6464     * Returns whether the View is considered actionable from
6465     * accessibility perspective. Such view are important for
6466     * accessiiblity.
6467     *
6468     * @return True if the view is actionable for accessibility.
6469     *
6470     * @hide
6471     */
6472    public boolean isActionableForAccessibility() {
6473        return (isClickable() || isLongClickable() || isFocusable());
6474    }
6475
6476    /**
6477     * Returns whether the View has registered callbacks wich makes it
6478     * important for accessiiblity.
6479     *
6480     * @return True if the view is actionable for accessibility.
6481     */
6482    private boolean hasListenersForAccessibility() {
6483        ListenerInfo info = getListenerInfo();
6484        return mTouchDelegate != null || info.mOnKeyListener != null
6485                || info.mOnTouchListener != null || info.mOnGenericMotionListener != null
6486                || info.mOnHoverListener != null || info.mOnDragListener != null;
6487    }
6488
6489    /**
6490     * Notifies accessibility services that some view's important for
6491     * accessibility state has changed. Note that such notifications
6492     * are made at most once every
6493     * {@link ViewConfiguration#getSendRecurringAccessibilityEventsInterval()}
6494     * to avoid unnecessary load to the system. Also once a view has
6495     * made a notifucation this method is a NOP until the notification has
6496     * been sent to clients.
6497     *
6498     * @hide
6499     *
6500     * TODO: Makse sure this method is called for any view state change
6501     *       that is interesting for accessilility purposes.
6502     */
6503    public void notifyAccessibilityStateChanged() {
6504        if (!AccessibilityManager.getInstance(mContext).isEnabled()) {
6505            return;
6506        }
6507        if ((mPrivateFlags2 & ACCESSIBILITY_STATE_CHANGED) == 0) {
6508            mPrivateFlags2 |= ACCESSIBILITY_STATE_CHANGED;
6509            if (mParent != null) {
6510                mParent.childAccessibilityStateChanged(this);
6511            }
6512        }
6513    }
6514
6515    /**
6516     * Reset the state indicating the this view has requested clients
6517     * interested in its accessiblity state to be notified.
6518     *
6519     * @hide
6520     */
6521    public void resetAccessibilityStateChanged() {
6522        mPrivateFlags2 &= ~ACCESSIBILITY_STATE_CHANGED;
6523    }
6524
6525    /**
6526     * Performs the specified accessibility action on the view. For
6527     * possible accessibility actions look at {@link AccessibilityNodeInfo}.
6528    * <p>
6529    * If an {@link AccessibilityDelegate} has been specified via calling
6530    * {@link #setAccessibilityDelegate(AccessibilityDelegate)} its
6531    * {@link AccessibilityDelegate#performAccessibilityAction(View, int, Bundle)}
6532    * is responsible for handling this call.
6533    * </p>
6534     *
6535     * @param action The action to perform.
6536     * @param arguments Optional action arguments.
6537     * @return Whether the action was performed.
6538     */
6539    public boolean performAccessibilityAction(int action, Bundle arguments) {
6540      if (mAccessibilityDelegate != null) {
6541          return mAccessibilityDelegate.performAccessibilityAction(this, action, arguments);
6542      } else {
6543          return performAccessibilityActionInternal(action, arguments);
6544      }
6545    }
6546
6547   /**
6548    * @see #performAccessibilityAction(int, Bundle)
6549    *
6550    * Note: Called from the default {@link AccessibilityDelegate}.
6551    */
6552    boolean performAccessibilityActionInternal(int action, Bundle arguments) {
6553        switch (action) {
6554            case AccessibilityNodeInfo.ACTION_CLICK: {
6555                if (isClickable()) {
6556                    return performClick();
6557                }
6558            } break;
6559            case AccessibilityNodeInfo.ACTION_LONG_CLICK: {
6560                if (isLongClickable()) {
6561                    return performLongClick();
6562                }
6563            } break;
6564            case AccessibilityNodeInfo.ACTION_FOCUS: {
6565                if (!hasFocus()) {
6566                    // Get out of touch mode since accessibility
6567                    // wants to move focus around.
6568                    getViewRootImpl().ensureTouchMode(false);
6569                    return requestFocus();
6570                }
6571            } break;
6572            case AccessibilityNodeInfo.ACTION_CLEAR_FOCUS: {
6573                if (hasFocus()) {
6574                    clearFocus();
6575                    return !isFocused();
6576                }
6577            } break;
6578            case AccessibilityNodeInfo.ACTION_SELECT: {
6579                if (!isSelected()) {
6580                    setSelected(true);
6581                    return isSelected();
6582                }
6583            } break;
6584            case AccessibilityNodeInfo.ACTION_CLEAR_SELECTION: {
6585                if (isSelected()) {
6586                    setSelected(false);
6587                    return !isSelected();
6588                }
6589            } break;
6590            case AccessibilityNodeInfo.ACTION_ACCESSIBILITY_FOCUS: {
6591                if (!isAccessibilityFocused()) {
6592                    return requestAccessibilityFocus();
6593                }
6594            } break;
6595            case AccessibilityNodeInfo.ACTION_CLEAR_ACCESSIBILITY_FOCUS: {
6596                if (isAccessibilityFocused()) {
6597                    clearAccessibilityFocus();
6598                    return true;
6599                }
6600            } break;
6601            case AccessibilityNodeInfo.ACTION_NEXT_AT_MOVEMENT_GRANULARITY: {
6602                if (arguments != null) {
6603                    final int granularity = arguments.getInt(
6604                            AccessibilityNodeInfo.ACTION_ARGUMENT_MOVEMENT_GRANULARITY_INT);
6605                    return nextAtGranularity(granularity);
6606                }
6607            } break;
6608            case AccessibilityNodeInfo.ACTION_PREVIOUS_AT_MOVEMENT_GRANULARITY: {
6609                if (arguments != null) {
6610                    final int granularity = arguments.getInt(
6611                            AccessibilityNodeInfo.ACTION_ARGUMENT_MOVEMENT_GRANULARITY_INT);
6612                    return previousAtGranularity(granularity);
6613                }
6614            } break;
6615        }
6616        return false;
6617    }
6618
6619    private boolean nextAtGranularity(int granularity) {
6620        CharSequence text = getIterableTextForAccessibility();
6621        if (text == null || text.length() == 0) {
6622            return false;
6623        }
6624        TextSegmentIterator iterator = getIteratorForGranularity(granularity);
6625        if (iterator == null) {
6626            return false;
6627        }
6628        final int current = getAccessibilityCursorPosition();
6629        final int[] range = iterator.following(current);
6630        if (range == null) {
6631            setAccessibilityCursorPosition(-1);
6632            return false;
6633        }
6634        final int start = range[0];
6635        final int end = range[1];
6636        setAccessibilityCursorPosition(start);
6637        sendViewTextTraversedAtGranularityEvent(
6638                AccessibilityNodeInfo.ACTION_NEXT_AT_MOVEMENT_GRANULARITY,
6639                granularity, start, end);
6640        return true;
6641    }
6642
6643    private boolean previousAtGranularity(int granularity) {
6644        CharSequence text = getIterableTextForAccessibility();
6645        if (text == null || text.length() == 0) {
6646            return false;
6647        }
6648        TextSegmentIterator iterator = getIteratorForGranularity(granularity);
6649        if (iterator == null) {
6650            return false;
6651        }
6652        final int selectionStart = getAccessibilityCursorPosition();
6653        final int current = selectionStart >= 0 ? selectionStart : text.length() + 1;
6654        final int[] range = iterator.preceding(current);
6655        if (range == null) {
6656            setAccessibilityCursorPosition(-1);
6657            return false;
6658        }
6659        final int start = range[0];
6660        final int end = range[1];
6661        setAccessibilityCursorPosition(end);
6662        sendViewTextTraversedAtGranularityEvent(
6663                AccessibilityNodeInfo.ACTION_PREVIOUS_AT_MOVEMENT_GRANULARITY,
6664                granularity, start, end);
6665        return true;
6666    }
6667
6668    /**
6669     * Gets the text reported for accessibility purposes.
6670     *
6671     * @return The accessibility text.
6672     *
6673     * @hide
6674     */
6675    public CharSequence getIterableTextForAccessibility() {
6676        return mContentDescription;
6677    }
6678
6679    /**
6680     * @hide
6681     */
6682    public int getAccessibilityCursorPosition() {
6683        return mAccessibilityCursorPosition;
6684    }
6685
6686    /**
6687     * @hide
6688     */
6689    public void setAccessibilityCursorPosition(int position) {
6690        mAccessibilityCursorPosition = position;
6691    }
6692
6693    private void sendViewTextTraversedAtGranularityEvent(int action, int granularity,
6694            int fromIndex, int toIndex) {
6695        if (mParent == null) {
6696            return;
6697        }
6698        AccessibilityEvent event = AccessibilityEvent.obtain(
6699                AccessibilityEvent.TYPE_VIEW_TEXT_TRAVERSED_AT_MOVEMENT_GRANULARITY);
6700        onInitializeAccessibilityEvent(event);
6701        onPopulateAccessibilityEvent(event);
6702        event.setFromIndex(fromIndex);
6703        event.setToIndex(toIndex);
6704        event.setAction(action);
6705        event.setMovementGranularity(granularity);
6706        mParent.requestSendAccessibilityEvent(this, event);
6707    }
6708
6709    /**
6710     * @hide
6711     */
6712    public TextSegmentIterator getIteratorForGranularity(int granularity) {
6713        switch (granularity) {
6714            case AccessibilityNodeInfo.MOVEMENT_GRANULARITY_CHARACTER: {
6715                CharSequence text = getIterableTextForAccessibility();
6716                if (text != null && text.length() > 0) {
6717                    CharacterTextSegmentIterator iterator =
6718                        CharacterTextSegmentIterator.getInstance(mContext);
6719                    iterator.initialize(text.toString());
6720                    return iterator;
6721                }
6722            } break;
6723            case AccessibilityNodeInfo.MOVEMENT_GRANULARITY_WORD: {
6724                CharSequence text = getIterableTextForAccessibility();
6725                if (text != null && text.length() > 0) {
6726                    WordTextSegmentIterator iterator =
6727                        WordTextSegmentIterator.getInstance(mContext);
6728                    iterator.initialize(text.toString());
6729                    return iterator;
6730                }
6731            } break;
6732            case AccessibilityNodeInfo.MOVEMENT_GRANULARITY_PARAGRAPH: {
6733                CharSequence text = getIterableTextForAccessibility();
6734                if (text != null && text.length() > 0) {
6735                    ParagraphTextSegmentIterator iterator =
6736                        ParagraphTextSegmentIterator.getInstance();
6737                    iterator.initialize(text.toString());
6738                    return iterator;
6739                }
6740            } break;
6741        }
6742        return null;
6743    }
6744
6745    /**
6746     * @hide
6747     */
6748    public void dispatchStartTemporaryDetach() {
6749        clearAccessibilityFocus();
6750        onStartTemporaryDetach();
6751    }
6752
6753    /**
6754     * This is called when a container is going to temporarily detach a child, with
6755     * {@link ViewGroup#detachViewFromParent(View) ViewGroup.detachViewFromParent}.
6756     * It will either be followed by {@link #onFinishTemporaryDetach()} or
6757     * {@link #onDetachedFromWindow()} when the container is done.
6758     */
6759    public void onStartTemporaryDetach() {
6760        removeUnsetPressCallback();
6761        mPrivateFlags |= CANCEL_NEXT_UP_EVENT;
6762    }
6763
6764    /**
6765     * @hide
6766     */
6767    public void dispatchFinishTemporaryDetach() {
6768        onFinishTemporaryDetach();
6769    }
6770
6771    /**
6772     * Called after {@link #onStartTemporaryDetach} when the container is done
6773     * changing the view.
6774     */
6775    public void onFinishTemporaryDetach() {
6776    }
6777
6778    /**
6779     * Return the global {@link KeyEvent.DispatcherState KeyEvent.DispatcherState}
6780     * for this view's window.  Returns null if the view is not currently attached
6781     * to the window.  Normally you will not need to use this directly, but
6782     * just use the standard high-level event callbacks like
6783     * {@link #onKeyDown(int, KeyEvent)}.
6784     */
6785    public KeyEvent.DispatcherState getKeyDispatcherState() {
6786        return mAttachInfo != null ? mAttachInfo.mKeyDispatchState : null;
6787    }
6788
6789    /**
6790     * Dispatch a key event before it is processed by any input method
6791     * associated with the view hierarchy.  This can be used to intercept
6792     * key events in special situations before the IME consumes them; a
6793     * typical example would be handling the BACK key to update the application's
6794     * UI instead of allowing the IME to see it and close itself.
6795     *
6796     * @param event The key event to be dispatched.
6797     * @return True if the event was handled, false otherwise.
6798     */
6799    public boolean dispatchKeyEventPreIme(KeyEvent event) {
6800        return onKeyPreIme(event.getKeyCode(), event);
6801    }
6802
6803    /**
6804     * Dispatch a key event to the next view on the focus path. This path runs
6805     * from the top of the view tree down to the currently focused view. If this
6806     * view has focus, it will dispatch to itself. Otherwise it will dispatch
6807     * the next node down the focus path. This method also fires any key
6808     * listeners.
6809     *
6810     * @param event The key event to be dispatched.
6811     * @return True if the event was handled, false otherwise.
6812     */
6813    public boolean dispatchKeyEvent(KeyEvent event) {
6814        if (mInputEventConsistencyVerifier != null) {
6815            mInputEventConsistencyVerifier.onKeyEvent(event, 0);
6816        }
6817
6818        // Give any attached key listener a first crack at the event.
6819        //noinspection SimplifiableIfStatement
6820        ListenerInfo li = mListenerInfo;
6821        if (li != null && li.mOnKeyListener != null && (mViewFlags & ENABLED_MASK) == ENABLED
6822                && li.mOnKeyListener.onKey(this, event.getKeyCode(), event)) {
6823            return true;
6824        }
6825
6826        if (event.dispatch(this, mAttachInfo != null
6827                ? mAttachInfo.mKeyDispatchState : null, this)) {
6828            return true;
6829        }
6830
6831        if (mInputEventConsistencyVerifier != null) {
6832            mInputEventConsistencyVerifier.onUnhandledEvent(event, 0);
6833        }
6834        return false;
6835    }
6836
6837    /**
6838     * Dispatches a key shortcut event.
6839     *
6840     * @param event The key event to be dispatched.
6841     * @return True if the event was handled by the view, false otherwise.
6842     */
6843    public boolean dispatchKeyShortcutEvent(KeyEvent event) {
6844        return onKeyShortcut(event.getKeyCode(), event);
6845    }
6846
6847    /**
6848     * Pass the touch screen motion event down to the target view, or this
6849     * view if it is the target.
6850     *
6851     * @param event The motion event to be dispatched.
6852     * @return True if the event was handled by the view, false otherwise.
6853     */
6854    public boolean dispatchTouchEvent(MotionEvent event) {
6855        if (mInputEventConsistencyVerifier != null) {
6856            mInputEventConsistencyVerifier.onTouchEvent(event, 0);
6857        }
6858
6859        if (onFilterTouchEventForSecurity(event)) {
6860            //noinspection SimplifiableIfStatement
6861            ListenerInfo li = mListenerInfo;
6862            if (li != null && li.mOnTouchListener != null && (mViewFlags & ENABLED_MASK) == ENABLED
6863                    && li.mOnTouchListener.onTouch(this, event)) {
6864                return true;
6865            }
6866
6867            if (onTouchEvent(event)) {
6868                return true;
6869            }
6870        }
6871
6872        if (mInputEventConsistencyVerifier != null) {
6873            mInputEventConsistencyVerifier.onUnhandledEvent(event, 0);
6874        }
6875        return false;
6876    }
6877
6878    /**
6879     * Filter the touch event to apply security policies.
6880     *
6881     * @param event The motion event to be filtered.
6882     * @return True if the event should be dispatched, false if the event should be dropped.
6883     *
6884     * @see #getFilterTouchesWhenObscured
6885     */
6886    public boolean onFilterTouchEventForSecurity(MotionEvent event) {
6887        //noinspection RedundantIfStatement
6888        if ((mViewFlags & FILTER_TOUCHES_WHEN_OBSCURED) != 0
6889                && (event.getFlags() & MotionEvent.FLAG_WINDOW_IS_OBSCURED) != 0) {
6890            // Window is obscured, drop this touch.
6891            return false;
6892        }
6893        return true;
6894    }
6895
6896    /**
6897     * Pass a trackball motion event down to the focused view.
6898     *
6899     * @param event The motion event to be dispatched.
6900     * @return True if the event was handled by the view, false otherwise.
6901     */
6902    public boolean dispatchTrackballEvent(MotionEvent event) {
6903        if (mInputEventConsistencyVerifier != null) {
6904            mInputEventConsistencyVerifier.onTrackballEvent(event, 0);
6905        }
6906
6907        return onTrackballEvent(event);
6908    }
6909
6910    /**
6911     * Dispatch a generic motion event.
6912     * <p>
6913     * Generic motion events with source class {@link InputDevice#SOURCE_CLASS_POINTER}
6914     * are delivered to the view under the pointer.  All other generic motion events are
6915     * delivered to the focused view.  Hover events are handled specially and are delivered
6916     * to {@link #onHoverEvent(MotionEvent)}.
6917     * </p>
6918     *
6919     * @param event The motion event to be dispatched.
6920     * @return True if the event was handled by the view, false otherwise.
6921     */
6922    public boolean dispatchGenericMotionEvent(MotionEvent event) {
6923        if (mInputEventConsistencyVerifier != null) {
6924            mInputEventConsistencyVerifier.onGenericMotionEvent(event, 0);
6925        }
6926
6927        final int source = event.getSource();
6928        if ((source & InputDevice.SOURCE_CLASS_POINTER) != 0) {
6929            final int action = event.getAction();
6930            if (action == MotionEvent.ACTION_HOVER_ENTER
6931                    || action == MotionEvent.ACTION_HOVER_MOVE
6932                    || action == MotionEvent.ACTION_HOVER_EXIT) {
6933                if (dispatchHoverEvent(event)) {
6934                    return true;
6935                }
6936            } else if (dispatchGenericPointerEvent(event)) {
6937                return true;
6938            }
6939        } else if (dispatchGenericFocusedEvent(event)) {
6940            return true;
6941        }
6942
6943        if (dispatchGenericMotionEventInternal(event)) {
6944            return true;
6945        }
6946
6947        if (mInputEventConsistencyVerifier != null) {
6948            mInputEventConsistencyVerifier.onUnhandledEvent(event, 0);
6949        }
6950        return false;
6951    }
6952
6953    private boolean dispatchGenericMotionEventInternal(MotionEvent event) {
6954        //noinspection SimplifiableIfStatement
6955        ListenerInfo li = mListenerInfo;
6956        if (li != null && li.mOnGenericMotionListener != null
6957                && (mViewFlags & ENABLED_MASK) == ENABLED
6958                && li.mOnGenericMotionListener.onGenericMotion(this, event)) {
6959            return true;
6960        }
6961
6962        if (onGenericMotionEvent(event)) {
6963            return true;
6964        }
6965
6966        if (mInputEventConsistencyVerifier != null) {
6967            mInputEventConsistencyVerifier.onUnhandledEvent(event, 0);
6968        }
6969        return false;
6970    }
6971
6972    /**
6973     * Dispatch a hover event.
6974     * <p>
6975     * Do not call this method directly.
6976     * Call {@link #dispatchGenericMotionEvent(MotionEvent)} instead.
6977     * </p>
6978     *
6979     * @param event The motion event to be dispatched.
6980     * @return True if the event was handled by the view, false otherwise.
6981     */
6982    protected boolean dispatchHoverEvent(MotionEvent event) {
6983        //noinspection SimplifiableIfStatement
6984        ListenerInfo li = mListenerInfo;
6985        if (li != null && li.mOnHoverListener != null
6986                && (mViewFlags & ENABLED_MASK) == ENABLED
6987                && li.mOnHoverListener.onHover(this, event)) {
6988            return true;
6989        }
6990
6991        return onHoverEvent(event);
6992    }
6993
6994    /**
6995     * Returns true if the view has a child to which it has recently sent
6996     * {@link MotionEvent#ACTION_HOVER_ENTER}.  If this view is hovered and
6997     * it does not have a hovered child, then it must be the innermost hovered view.
6998     * @hide
6999     */
7000    protected boolean hasHoveredChild() {
7001        return false;
7002    }
7003
7004    /**
7005     * Dispatch a generic motion event to the view under the first pointer.
7006     * <p>
7007     * Do not call this method directly.
7008     * Call {@link #dispatchGenericMotionEvent(MotionEvent)} instead.
7009     * </p>
7010     *
7011     * @param event The motion event to be dispatched.
7012     * @return True if the event was handled by the view, false otherwise.
7013     */
7014    protected boolean dispatchGenericPointerEvent(MotionEvent event) {
7015        return false;
7016    }
7017
7018    /**
7019     * Dispatch a generic motion event to the currently focused view.
7020     * <p>
7021     * Do not call this method directly.
7022     * Call {@link #dispatchGenericMotionEvent(MotionEvent)} instead.
7023     * </p>
7024     *
7025     * @param event The motion event to be dispatched.
7026     * @return True if the event was handled by the view, false otherwise.
7027     */
7028    protected boolean dispatchGenericFocusedEvent(MotionEvent event) {
7029        return false;
7030    }
7031
7032    /**
7033     * Dispatch a pointer event.
7034     * <p>
7035     * Dispatches touch related pointer events to {@link #onTouchEvent(MotionEvent)} and all
7036     * other events to {@link #onGenericMotionEvent(MotionEvent)}.  This separation of concerns
7037     * reinforces the invariant that {@link #onTouchEvent(MotionEvent)} is really about touches
7038     * and should not be expected to handle other pointing device features.
7039     * </p>
7040     *
7041     * @param event The motion event to be dispatched.
7042     * @return True if the event was handled by the view, false otherwise.
7043     * @hide
7044     */
7045    public final boolean dispatchPointerEvent(MotionEvent event) {
7046        if (event.isTouchEvent()) {
7047            return dispatchTouchEvent(event);
7048        } else {
7049            return dispatchGenericMotionEvent(event);
7050        }
7051    }
7052
7053    /**
7054     * Called when the window containing this view gains or loses window focus.
7055     * ViewGroups should override to route to their children.
7056     *
7057     * @param hasFocus True if the window containing this view now has focus,
7058     *        false otherwise.
7059     */
7060    public void dispatchWindowFocusChanged(boolean hasFocus) {
7061        onWindowFocusChanged(hasFocus);
7062    }
7063
7064    /**
7065     * Called when the window containing this view gains or loses focus.  Note
7066     * that this is separate from view focus: to receive key events, both
7067     * your view and its window must have focus.  If a window is displayed
7068     * on top of yours that takes input focus, then your own window will lose
7069     * focus but the view focus will remain unchanged.
7070     *
7071     * @param hasWindowFocus True if the window containing this view now has
7072     *        focus, false otherwise.
7073     */
7074    public void onWindowFocusChanged(boolean hasWindowFocus) {
7075        InputMethodManager imm = InputMethodManager.peekInstance();
7076        if (!hasWindowFocus) {
7077            if (isPressed()) {
7078                setPressed(false);
7079            }
7080            if (imm != null && (mPrivateFlags & FOCUSED) != 0) {
7081                imm.focusOut(this);
7082            }
7083            removeLongPressCallback();
7084            removeTapCallback();
7085            onFocusLost();
7086        } else if (imm != null && (mPrivateFlags & FOCUSED) != 0) {
7087            imm.focusIn(this);
7088        }
7089        refreshDrawableState();
7090    }
7091
7092    /**
7093     * Returns true if this view is in a window that currently has window focus.
7094     * Note that this is not the same as the view itself having focus.
7095     *
7096     * @return True if this view is in a window that currently has window focus.
7097     */
7098    public boolean hasWindowFocus() {
7099        return mAttachInfo != null && mAttachInfo.mHasWindowFocus;
7100    }
7101
7102    /**
7103     * Dispatch a view visibility change down the view hierarchy.
7104     * ViewGroups should override to route to their children.
7105     * @param changedView The view whose visibility changed. Could be 'this' or
7106     * an ancestor view.
7107     * @param visibility The new visibility of changedView: {@link #VISIBLE},
7108     * {@link #INVISIBLE} or {@link #GONE}.
7109     */
7110    protected void dispatchVisibilityChanged(View changedView, int visibility) {
7111        onVisibilityChanged(changedView, visibility);
7112    }
7113
7114    /**
7115     * Called when the visibility of the view or an ancestor of the view is changed.
7116     * @param changedView The view whose visibility changed. Could be 'this' or
7117     * an ancestor view.
7118     * @param visibility The new visibility of changedView: {@link #VISIBLE},
7119     * {@link #INVISIBLE} or {@link #GONE}.
7120     */
7121    protected void onVisibilityChanged(View changedView, int visibility) {
7122        if (visibility == VISIBLE) {
7123            if (mAttachInfo != null) {
7124                initialAwakenScrollBars();
7125            } else {
7126                mPrivateFlags |= AWAKEN_SCROLL_BARS_ON_ATTACH;
7127            }
7128        }
7129    }
7130
7131    /**
7132     * Dispatch a hint about whether this view is displayed. For instance, when
7133     * a View moves out of the screen, it might receives a display hint indicating
7134     * the view is not displayed. Applications should not <em>rely</em> on this hint
7135     * as there is no guarantee that they will receive one.
7136     *
7137     * @param hint A hint about whether or not this view is displayed:
7138     * {@link #VISIBLE} or {@link #INVISIBLE}.
7139     */
7140    public void dispatchDisplayHint(int hint) {
7141        onDisplayHint(hint);
7142    }
7143
7144    /**
7145     * Gives this view a hint about whether is displayed or not. For instance, when
7146     * a View moves out of the screen, it might receives a display hint indicating
7147     * the view is not displayed. Applications should not <em>rely</em> on this hint
7148     * as there is no guarantee that they will receive one.
7149     *
7150     * @param hint A hint about whether or not this view is displayed:
7151     * {@link #VISIBLE} or {@link #INVISIBLE}.
7152     */
7153    protected void onDisplayHint(int hint) {
7154    }
7155
7156    /**
7157     * Dispatch a window visibility change down the view hierarchy.
7158     * ViewGroups should override to route to their children.
7159     *
7160     * @param visibility The new visibility of the window.
7161     *
7162     * @see #onWindowVisibilityChanged(int)
7163     */
7164    public void dispatchWindowVisibilityChanged(int visibility) {
7165        onWindowVisibilityChanged(visibility);
7166    }
7167
7168    /**
7169     * Called when the window containing has change its visibility
7170     * (between {@link #GONE}, {@link #INVISIBLE}, and {@link #VISIBLE}).  Note
7171     * that this tells you whether or not your window is being made visible
7172     * to the window manager; this does <em>not</em> tell you whether or not
7173     * your window is obscured by other windows on the screen, even if it
7174     * is itself visible.
7175     *
7176     * @param visibility The new visibility of the window.
7177     */
7178    protected void onWindowVisibilityChanged(int visibility) {
7179        if (visibility == VISIBLE) {
7180            initialAwakenScrollBars();
7181        }
7182    }
7183
7184    /**
7185     * Returns the current visibility of the window this view is attached to
7186     * (either {@link #GONE}, {@link #INVISIBLE}, or {@link #VISIBLE}).
7187     *
7188     * @return Returns the current visibility of the view's window.
7189     */
7190    public int getWindowVisibility() {
7191        return mAttachInfo != null ? mAttachInfo.mWindowVisibility : GONE;
7192    }
7193
7194    /**
7195     * Retrieve the overall visible display size in which the window this view is
7196     * attached to has been positioned in.  This takes into account screen
7197     * decorations above the window, for both cases where the window itself
7198     * is being position inside of them or the window is being placed under
7199     * then and covered insets are used for the window to position its content
7200     * inside.  In effect, this tells you the available area where content can
7201     * be placed and remain visible to users.
7202     *
7203     * <p>This function requires an IPC back to the window manager to retrieve
7204     * the requested information, so should not be used in performance critical
7205     * code like drawing.
7206     *
7207     * @param outRect Filled in with the visible display frame.  If the view
7208     * is not attached to a window, this is simply the raw display size.
7209     */
7210    public void getWindowVisibleDisplayFrame(Rect outRect) {
7211        if (mAttachInfo != null) {
7212            try {
7213                mAttachInfo.mSession.getDisplayFrame(mAttachInfo.mWindow, outRect);
7214            } catch (RemoteException e) {
7215                return;
7216            }
7217            // XXX This is really broken, and probably all needs to be done
7218            // in the window manager, and we need to know more about whether
7219            // we want the area behind or in front of the IME.
7220            final Rect insets = mAttachInfo.mVisibleInsets;
7221            outRect.left += insets.left;
7222            outRect.top += insets.top;
7223            outRect.right -= insets.right;
7224            outRect.bottom -= insets.bottom;
7225            return;
7226        }
7227        Display d = WindowManagerImpl.getDefault().getDefaultDisplay();
7228        d.getRectSize(outRect);
7229    }
7230
7231    /**
7232     * Dispatch a notification about a resource configuration change down
7233     * the view hierarchy.
7234     * ViewGroups should override to route to their children.
7235     *
7236     * @param newConfig The new resource configuration.
7237     *
7238     * @see #onConfigurationChanged(android.content.res.Configuration)
7239     */
7240    public void dispatchConfigurationChanged(Configuration newConfig) {
7241        onConfigurationChanged(newConfig);
7242    }
7243
7244    /**
7245     * Called when the current configuration of the resources being used
7246     * by the application have changed.  You can use this to decide when
7247     * to reload resources that can changed based on orientation and other
7248     * configuration characterstics.  You only need to use this if you are
7249     * not relying on the normal {@link android.app.Activity} mechanism of
7250     * recreating the activity instance upon a configuration change.
7251     *
7252     * @param newConfig The new resource configuration.
7253     */
7254    protected void onConfigurationChanged(Configuration newConfig) {
7255    }
7256
7257    /**
7258     * Private function to aggregate all per-view attributes in to the view
7259     * root.
7260     */
7261    void dispatchCollectViewAttributes(AttachInfo attachInfo, int visibility) {
7262        performCollectViewAttributes(attachInfo, visibility);
7263    }
7264
7265    void performCollectViewAttributes(AttachInfo attachInfo, int visibility) {
7266        if ((visibility & VISIBILITY_MASK) == VISIBLE) {
7267            if ((mViewFlags & KEEP_SCREEN_ON) == KEEP_SCREEN_ON) {
7268                attachInfo.mKeepScreenOn = true;
7269            }
7270            attachInfo.mSystemUiVisibility |= mSystemUiVisibility;
7271            ListenerInfo li = mListenerInfo;
7272            if (li != null && li.mOnSystemUiVisibilityChangeListener != null) {
7273                attachInfo.mHasSystemUiListeners = true;
7274            }
7275        }
7276    }
7277
7278    void needGlobalAttributesUpdate(boolean force) {
7279        final AttachInfo ai = mAttachInfo;
7280        if (ai != null) {
7281            if (force || ai.mKeepScreenOn || (ai.mSystemUiVisibility != 0)
7282                    || ai.mHasSystemUiListeners) {
7283                ai.mRecomputeGlobalAttributes = true;
7284            }
7285        }
7286    }
7287
7288    /**
7289     * Returns whether the device is currently in touch mode.  Touch mode is entered
7290     * once the user begins interacting with the device by touch, and affects various
7291     * things like whether focus is always visible to the user.
7292     *
7293     * @return Whether the device is in touch mode.
7294     */
7295    @ViewDebug.ExportedProperty
7296    public boolean isInTouchMode() {
7297        if (mAttachInfo != null) {
7298            return mAttachInfo.mInTouchMode;
7299        } else {
7300            return ViewRootImpl.isInTouchMode();
7301        }
7302    }
7303
7304    /**
7305     * Returns the context the view is running in, through which it can
7306     * access the current theme, resources, etc.
7307     *
7308     * @return The view's Context.
7309     */
7310    @ViewDebug.CapturedViewProperty
7311    public final Context getContext() {
7312        return mContext;
7313    }
7314
7315    /**
7316     * Handle a key event before it is processed by any input method
7317     * associated with the view hierarchy.  This can be used to intercept
7318     * key events in special situations before the IME consumes them; a
7319     * typical example would be handling the BACK key to update the application's
7320     * UI instead of allowing the IME to see it and close itself.
7321     *
7322     * @param keyCode The value in event.getKeyCode().
7323     * @param event Description of the key event.
7324     * @return If you handled the event, return true. If you want to allow the
7325     *         event to be handled by the next receiver, return false.
7326     */
7327    public boolean onKeyPreIme(int keyCode, KeyEvent event) {
7328        return false;
7329    }
7330
7331    /**
7332     * Default implementation of {@link KeyEvent.Callback#onKeyDown(int, KeyEvent)
7333     * KeyEvent.Callback.onKeyDown()}: perform press of the view
7334     * when {@link KeyEvent#KEYCODE_DPAD_CENTER} or {@link KeyEvent#KEYCODE_ENTER}
7335     * is released, if the view is enabled and clickable.
7336     *
7337     * @param keyCode A key code that represents the button pressed, from
7338     *                {@link android.view.KeyEvent}.
7339     * @param event   The KeyEvent object that defines the button action.
7340     */
7341    public boolean onKeyDown(int keyCode, KeyEvent event) {
7342        boolean result = false;
7343
7344        switch (keyCode) {
7345            case KeyEvent.KEYCODE_DPAD_CENTER:
7346            case KeyEvent.KEYCODE_ENTER: {
7347                if ((mViewFlags & ENABLED_MASK) == DISABLED) {
7348                    return true;
7349                }
7350                // Long clickable items don't necessarily have to be clickable
7351                if (((mViewFlags & CLICKABLE) == CLICKABLE ||
7352                        (mViewFlags & LONG_CLICKABLE) == LONG_CLICKABLE) &&
7353                        (event.getRepeatCount() == 0)) {
7354                    setPressed(true);
7355                    checkForLongClick(0);
7356                    return true;
7357                }
7358                break;
7359            }
7360        }
7361        return result;
7362    }
7363
7364    /**
7365     * Default implementation of {@link KeyEvent.Callback#onKeyLongPress(int, KeyEvent)
7366     * KeyEvent.Callback.onKeyLongPress()}: always returns false (doesn't handle
7367     * the event).
7368     */
7369    public boolean onKeyLongPress(int keyCode, KeyEvent event) {
7370        return false;
7371    }
7372
7373    /**
7374     * Default implementation of {@link KeyEvent.Callback#onKeyUp(int, KeyEvent)
7375     * KeyEvent.Callback.onKeyUp()}: perform clicking of the view
7376     * when {@link KeyEvent#KEYCODE_DPAD_CENTER} or
7377     * {@link KeyEvent#KEYCODE_ENTER} is released.
7378     *
7379     * @param keyCode A key code that represents the button pressed, from
7380     *                {@link android.view.KeyEvent}.
7381     * @param event   The KeyEvent object that defines the button action.
7382     */
7383    public boolean onKeyUp(int keyCode, KeyEvent event) {
7384        boolean result = false;
7385
7386        switch (keyCode) {
7387            case KeyEvent.KEYCODE_DPAD_CENTER:
7388            case KeyEvent.KEYCODE_ENTER: {
7389                if ((mViewFlags & ENABLED_MASK) == DISABLED) {
7390                    return true;
7391                }
7392                if ((mViewFlags & CLICKABLE) == CLICKABLE && isPressed()) {
7393                    setPressed(false);
7394
7395                    if (!mHasPerformedLongPress) {
7396                        // This is a tap, so remove the longpress check
7397                        removeLongPressCallback();
7398
7399                        result = performClick();
7400                    }
7401                }
7402                break;
7403            }
7404        }
7405        return result;
7406    }
7407
7408    /**
7409     * Default implementation of {@link KeyEvent.Callback#onKeyMultiple(int, int, KeyEvent)
7410     * KeyEvent.Callback.onKeyMultiple()}: always returns false (doesn't handle
7411     * the event).
7412     *
7413     * @param keyCode     A key code that represents the button pressed, from
7414     *                    {@link android.view.KeyEvent}.
7415     * @param repeatCount The number of times the action was made.
7416     * @param event       The KeyEvent object that defines the button action.
7417     */
7418    public boolean onKeyMultiple(int keyCode, int repeatCount, KeyEvent event) {
7419        return false;
7420    }
7421
7422    /**
7423     * Called on the focused view when a key shortcut event is not handled.
7424     * Override this method to implement local key shortcuts for the View.
7425     * Key shortcuts can also be implemented by setting the
7426     * {@link MenuItem#setShortcut(char, char) shortcut} property of menu items.
7427     *
7428     * @param keyCode The value in event.getKeyCode().
7429     * @param event Description of the key event.
7430     * @return If you handled the event, return true. If you want to allow the
7431     *         event to be handled by the next receiver, return false.
7432     */
7433    public boolean onKeyShortcut(int keyCode, KeyEvent event) {
7434        return false;
7435    }
7436
7437    /**
7438     * Check whether the called view is a text editor, in which case it
7439     * would make sense to automatically display a soft input window for
7440     * it.  Subclasses should override this if they implement
7441     * {@link #onCreateInputConnection(EditorInfo)} to return true if
7442     * a call on that method would return a non-null InputConnection, and
7443     * they are really a first-class editor that the user would normally
7444     * start typing on when the go into a window containing your view.
7445     *
7446     * <p>The default implementation always returns false.  This does
7447     * <em>not</em> mean that its {@link #onCreateInputConnection(EditorInfo)}
7448     * will not be called or the user can not otherwise perform edits on your
7449     * view; it is just a hint to the system that this is not the primary
7450     * purpose of this view.
7451     *
7452     * @return Returns true if this view is a text editor, else false.
7453     */
7454    public boolean onCheckIsTextEditor() {
7455        return false;
7456    }
7457
7458    /**
7459     * Create a new InputConnection for an InputMethod to interact
7460     * with the view.  The default implementation returns null, since it doesn't
7461     * support input methods.  You can override this to implement such support.
7462     * This is only needed for views that take focus and text input.
7463     *
7464     * <p>When implementing this, you probably also want to implement
7465     * {@link #onCheckIsTextEditor()} to indicate you will return a
7466     * non-null InputConnection.
7467     *
7468     * @param outAttrs Fill in with attribute information about the connection.
7469     */
7470    public InputConnection onCreateInputConnection(EditorInfo outAttrs) {
7471        return null;
7472    }
7473
7474    /**
7475     * Called by the {@link android.view.inputmethod.InputMethodManager}
7476     * when a view who is not the current
7477     * input connection target is trying to make a call on the manager.  The
7478     * default implementation returns false; you can override this to return
7479     * true for certain views if you are performing InputConnection proxying
7480     * to them.
7481     * @param view The View that is making the InputMethodManager call.
7482     * @return Return true to allow the call, false to reject.
7483     */
7484    public boolean checkInputConnectionProxy(View view) {
7485        return false;
7486    }
7487
7488    /**
7489     * Show the context menu for this view. It is not safe to hold on to the
7490     * menu after returning from this method.
7491     *
7492     * You should normally not overload this method. Overload
7493     * {@link #onCreateContextMenu(ContextMenu)} or define an
7494     * {@link OnCreateContextMenuListener} to add items to the context menu.
7495     *
7496     * @param menu The context menu to populate
7497     */
7498    public void createContextMenu(ContextMenu menu) {
7499        ContextMenuInfo menuInfo = getContextMenuInfo();
7500
7501        // Sets the current menu info so all items added to menu will have
7502        // my extra info set.
7503        ((MenuBuilder)menu).setCurrentMenuInfo(menuInfo);
7504
7505        onCreateContextMenu(menu);
7506        ListenerInfo li = mListenerInfo;
7507        if (li != null && li.mOnCreateContextMenuListener != null) {
7508            li.mOnCreateContextMenuListener.onCreateContextMenu(menu, this, menuInfo);
7509        }
7510
7511        // Clear the extra information so subsequent items that aren't mine don't
7512        // have my extra info.
7513        ((MenuBuilder)menu).setCurrentMenuInfo(null);
7514
7515        if (mParent != null) {
7516            mParent.createContextMenu(menu);
7517        }
7518    }
7519
7520    /**
7521     * Views should implement this if they have extra information to associate
7522     * with the context menu. The return result is supplied as a parameter to
7523     * the {@link OnCreateContextMenuListener#onCreateContextMenu(ContextMenu, View, ContextMenuInfo)}
7524     * callback.
7525     *
7526     * @return Extra information about the item for which the context menu
7527     *         should be shown. This information will vary across different
7528     *         subclasses of View.
7529     */
7530    protected ContextMenuInfo getContextMenuInfo() {
7531        return null;
7532    }
7533
7534    /**
7535     * Views should implement this if the view itself is going to add items to
7536     * the context menu.
7537     *
7538     * @param menu the context menu to populate
7539     */
7540    protected void onCreateContextMenu(ContextMenu menu) {
7541    }
7542
7543    /**
7544     * Implement this method to handle trackball motion events.  The
7545     * <em>relative</em> movement of the trackball since the last event
7546     * can be retrieve with {@link MotionEvent#getX MotionEvent.getX()} and
7547     * {@link MotionEvent#getY MotionEvent.getY()}.  These are normalized so
7548     * that a movement of 1 corresponds to the user pressing one DPAD key (so
7549     * they will often be fractional values, representing the more fine-grained
7550     * movement information available from a trackball).
7551     *
7552     * @param event The motion event.
7553     * @return True if the event was handled, false otherwise.
7554     */
7555    public boolean onTrackballEvent(MotionEvent event) {
7556        return false;
7557    }
7558
7559    /**
7560     * Implement this method to handle generic motion events.
7561     * <p>
7562     * Generic motion events describe joystick movements, mouse hovers, track pad
7563     * touches, scroll wheel movements and other input events.  The
7564     * {@link MotionEvent#getSource() source} of the motion event specifies
7565     * the class of input that was received.  Implementations of this method
7566     * must examine the bits in the source before processing the event.
7567     * The following code example shows how this is done.
7568     * </p><p>
7569     * Generic motion events with source class {@link InputDevice#SOURCE_CLASS_POINTER}
7570     * are delivered to the view under the pointer.  All other generic motion events are
7571     * delivered to the focused view.
7572     * </p>
7573     * <pre> public boolean onGenericMotionEvent(MotionEvent event) {
7574     *     if ((event.getSource() &amp; InputDevice.SOURCE_CLASS_JOYSTICK) != 0) {
7575     *         if (event.getAction() == MotionEvent.ACTION_MOVE) {
7576     *             // process the joystick movement...
7577     *             return true;
7578     *         }
7579     *     }
7580     *     if ((event.getSource() &amp; InputDevice.SOURCE_CLASS_POINTER) != 0) {
7581     *         switch (event.getAction()) {
7582     *             case MotionEvent.ACTION_HOVER_MOVE:
7583     *                 // process the mouse hover movement...
7584     *                 return true;
7585     *             case MotionEvent.ACTION_SCROLL:
7586     *                 // process the scroll wheel movement...
7587     *                 return true;
7588     *         }
7589     *     }
7590     *     return super.onGenericMotionEvent(event);
7591     * }</pre>
7592     *
7593     * @param event The generic motion event being processed.
7594     * @return True if the event was handled, false otherwise.
7595     */
7596    public boolean onGenericMotionEvent(MotionEvent event) {
7597        return false;
7598    }
7599
7600    /**
7601     * Implement this method to handle hover events.
7602     * <p>
7603     * This method is called whenever a pointer is hovering into, over, or out of the
7604     * bounds of a view and the view is not currently being touched.
7605     * Hover events are represented as pointer events with action
7606     * {@link MotionEvent#ACTION_HOVER_ENTER}, {@link MotionEvent#ACTION_HOVER_MOVE},
7607     * or {@link MotionEvent#ACTION_HOVER_EXIT}.
7608     * </p>
7609     * <ul>
7610     * <li>The view receives a hover event with action {@link MotionEvent#ACTION_HOVER_ENTER}
7611     * when the pointer enters the bounds of the view.</li>
7612     * <li>The view receives a hover event with action {@link MotionEvent#ACTION_HOVER_MOVE}
7613     * when the pointer has already entered the bounds of the view and has moved.</li>
7614     * <li>The view receives a hover event with action {@link MotionEvent#ACTION_HOVER_EXIT}
7615     * when the pointer has exited the bounds of the view or when the pointer is
7616     * about to go down due to a button click, tap, or similar user action that
7617     * causes the view to be touched.</li>
7618     * </ul>
7619     * <p>
7620     * The view should implement this method to return true to indicate that it is
7621     * handling the hover event, such as by changing its drawable state.
7622     * </p><p>
7623     * The default implementation calls {@link #setHovered} to update the hovered state
7624     * of the view when a hover enter or hover exit event is received, if the view
7625     * is enabled and is clickable.  The default implementation also sends hover
7626     * accessibility events.
7627     * </p>
7628     *
7629     * @param event The motion event that describes the hover.
7630     * @return True if the view handled the hover event.
7631     *
7632     * @see #isHovered
7633     * @see #setHovered
7634     * @see #onHoverChanged
7635     */
7636    public boolean onHoverEvent(MotionEvent event) {
7637        // The root view may receive hover (or touch) events that are outside the bounds of
7638        // the window.  This code ensures that we only send accessibility events for
7639        // hovers that are actually within the bounds of the root view.
7640        final int action = event.getActionMasked();
7641        if (!mSendingHoverAccessibilityEvents) {
7642            if ((action == MotionEvent.ACTION_HOVER_ENTER
7643                    || action == MotionEvent.ACTION_HOVER_MOVE)
7644                    && !hasHoveredChild()
7645                    && pointInView(event.getX(), event.getY())) {
7646                sendAccessibilityEvent(AccessibilityEvent.TYPE_VIEW_HOVER_ENTER);
7647                mSendingHoverAccessibilityEvents = true;
7648                requestAccessibilityFocusFromHover();
7649            }
7650        } else {
7651            if (action == MotionEvent.ACTION_HOVER_EXIT
7652                    || (action == MotionEvent.ACTION_MOVE
7653                            && !pointInView(event.getX(), event.getY()))) {
7654                mSendingHoverAccessibilityEvents = false;
7655                sendAccessibilityEvent(AccessibilityEvent.TYPE_VIEW_HOVER_EXIT);
7656                // If the window does not have input focus we take away accessibility
7657                // focus as soon as the user stop hovering over the view.
7658                if (mAttachInfo != null && !mAttachInfo.mHasWindowFocus) {
7659                    getViewRootImpl().setAccessibilityFocusedHost(null);
7660                }
7661            }
7662        }
7663
7664        if (isHoverable()) {
7665            switch (action) {
7666                case MotionEvent.ACTION_HOVER_ENTER:
7667                    setHovered(true);
7668                    break;
7669                case MotionEvent.ACTION_HOVER_EXIT:
7670                    setHovered(false);
7671                    break;
7672            }
7673
7674            // Dispatch the event to onGenericMotionEvent before returning true.
7675            // This is to provide compatibility with existing applications that
7676            // handled HOVER_MOVE events in onGenericMotionEvent and that would
7677            // break because of the new default handling for hoverable views
7678            // in onHoverEvent.
7679            // Note that onGenericMotionEvent will be called by default when
7680            // onHoverEvent returns false (refer to dispatchGenericMotionEvent).
7681            dispatchGenericMotionEventInternal(event);
7682            return true;
7683        }
7684
7685        return false;
7686    }
7687
7688    /**
7689     * Returns true if the view should handle {@link #onHoverEvent}
7690     * by calling {@link #setHovered} to change its hovered state.
7691     *
7692     * @return True if the view is hoverable.
7693     */
7694    private boolean isHoverable() {
7695        final int viewFlags = mViewFlags;
7696        if ((viewFlags & ENABLED_MASK) == DISABLED) {
7697            return false;
7698        }
7699
7700        return (viewFlags & CLICKABLE) == CLICKABLE
7701                || (viewFlags & LONG_CLICKABLE) == LONG_CLICKABLE;
7702    }
7703
7704    /**
7705     * Returns true if the view is currently hovered.
7706     *
7707     * @return True if the view is currently hovered.
7708     *
7709     * @see #setHovered
7710     * @see #onHoverChanged
7711     */
7712    @ViewDebug.ExportedProperty
7713    public boolean isHovered() {
7714        return (mPrivateFlags & HOVERED) != 0;
7715    }
7716
7717    /**
7718     * Sets whether the view is currently hovered.
7719     * <p>
7720     * Calling this method also changes the drawable state of the view.  This
7721     * enables the view to react to hover by using different drawable resources
7722     * to change its appearance.
7723     * </p><p>
7724     * The {@link #onHoverChanged} method is called when the hovered state changes.
7725     * </p>
7726     *
7727     * @param hovered True if the view is hovered.
7728     *
7729     * @see #isHovered
7730     * @see #onHoverChanged
7731     */
7732    public void setHovered(boolean hovered) {
7733        if (hovered) {
7734            if ((mPrivateFlags & HOVERED) == 0) {
7735                mPrivateFlags |= HOVERED;
7736                refreshDrawableState();
7737                onHoverChanged(true);
7738            }
7739        } else {
7740            if ((mPrivateFlags & HOVERED) != 0) {
7741                mPrivateFlags &= ~HOVERED;
7742                refreshDrawableState();
7743                onHoverChanged(false);
7744            }
7745        }
7746    }
7747
7748    /**
7749     * Implement this method to handle hover state changes.
7750     * <p>
7751     * This method is called whenever the hover state changes as a result of a
7752     * call to {@link #setHovered}.
7753     * </p>
7754     *
7755     * @param hovered The current hover state, as returned by {@link #isHovered}.
7756     *
7757     * @see #isHovered
7758     * @see #setHovered
7759     */
7760    public void onHoverChanged(boolean hovered) {
7761    }
7762
7763    /**
7764     * Implement this method to handle touch screen motion events.
7765     *
7766     * @param event The motion event.
7767     * @return True if the event was handled, false otherwise.
7768     */
7769    public boolean onTouchEvent(MotionEvent event) {
7770        final int viewFlags = mViewFlags;
7771
7772        if ((viewFlags & ENABLED_MASK) == DISABLED) {
7773            if (event.getAction() == MotionEvent.ACTION_UP && (mPrivateFlags & PRESSED) != 0) {
7774                setPressed(false);
7775            }
7776            // A disabled view that is clickable still consumes the touch
7777            // events, it just doesn't respond to them.
7778            return (((viewFlags & CLICKABLE) == CLICKABLE ||
7779                    (viewFlags & LONG_CLICKABLE) == LONG_CLICKABLE));
7780        }
7781
7782        if (mTouchDelegate != null) {
7783            if (mTouchDelegate.onTouchEvent(event)) {
7784                return true;
7785            }
7786        }
7787
7788        if (((viewFlags & CLICKABLE) == CLICKABLE ||
7789                (viewFlags & LONG_CLICKABLE) == LONG_CLICKABLE)) {
7790            switch (event.getAction()) {
7791                case MotionEvent.ACTION_UP:
7792                    boolean prepressed = (mPrivateFlags & PREPRESSED) != 0;
7793                    if ((mPrivateFlags & PRESSED) != 0 || prepressed) {
7794                        // take focus if we don't have it already and we should in
7795                        // touch mode.
7796                        boolean focusTaken = false;
7797                        if (isFocusable() && isFocusableInTouchMode() && !isFocused()) {
7798                            focusTaken = requestFocus();
7799                        }
7800
7801                        if (prepressed) {
7802                            // The button is being released before we actually
7803                            // showed it as pressed.  Make it show the pressed
7804                            // state now (before scheduling the click) to ensure
7805                            // the user sees it.
7806                            setPressed(true);
7807                       }
7808
7809                        if (!mHasPerformedLongPress) {
7810                            // This is a tap, so remove the longpress check
7811                            removeLongPressCallback();
7812
7813                            // Only perform take click actions if we were in the pressed state
7814                            if (!focusTaken) {
7815                                // Use a Runnable and post this rather than calling
7816                                // performClick directly. This lets other visual state
7817                                // of the view update before click actions start.
7818                                if (mPerformClick == null) {
7819                                    mPerformClick = new PerformClick();
7820                                }
7821                                if (!post(mPerformClick)) {
7822                                    performClick();
7823                                }
7824                            }
7825                        }
7826
7827                        if (mUnsetPressedState == null) {
7828                            mUnsetPressedState = new UnsetPressedState();
7829                        }
7830
7831                        if (prepressed) {
7832                            postDelayed(mUnsetPressedState,
7833                                    ViewConfiguration.getPressedStateDuration());
7834                        } else if (!post(mUnsetPressedState)) {
7835                            // If the post failed, unpress right now
7836                            mUnsetPressedState.run();
7837                        }
7838                        removeTapCallback();
7839                    }
7840                    break;
7841
7842                case MotionEvent.ACTION_DOWN:
7843                    mHasPerformedLongPress = false;
7844
7845                    if (performButtonActionOnTouchDown(event)) {
7846                        break;
7847                    }
7848
7849                    // Walk up the hierarchy to determine if we're inside a scrolling container.
7850                    boolean isInScrollingContainer = isInScrollingContainer();
7851
7852                    // For views inside a scrolling container, delay the pressed feedback for
7853                    // a short period in case this is a scroll.
7854                    if (isInScrollingContainer) {
7855                        mPrivateFlags |= PREPRESSED;
7856                        if (mPendingCheckForTap == null) {
7857                            mPendingCheckForTap = new CheckForTap();
7858                        }
7859                        postDelayed(mPendingCheckForTap, ViewConfiguration.getTapTimeout());
7860                    } else {
7861                        // Not inside a scrolling container, so show the feedback right away
7862                        setPressed(true);
7863                        checkForLongClick(0);
7864                    }
7865                    break;
7866
7867                case MotionEvent.ACTION_CANCEL:
7868                    setPressed(false);
7869                    removeTapCallback();
7870                    break;
7871
7872                case MotionEvent.ACTION_MOVE:
7873                    final int x = (int) event.getX();
7874                    final int y = (int) event.getY();
7875
7876                    // Be lenient about moving outside of buttons
7877                    if (!pointInView(x, y, mTouchSlop)) {
7878                        // Outside button
7879                        removeTapCallback();
7880                        if ((mPrivateFlags & PRESSED) != 0) {
7881                            // Remove any future long press/tap checks
7882                            removeLongPressCallback();
7883
7884                            setPressed(false);
7885                        }
7886                    }
7887                    break;
7888            }
7889            return true;
7890        }
7891
7892        return false;
7893    }
7894
7895    /**
7896     * @hide
7897     */
7898    public boolean isInScrollingContainer() {
7899        ViewParent p = getParent();
7900        while (p != null && p instanceof ViewGroup) {
7901            if (((ViewGroup) p).shouldDelayChildPressedState()) {
7902                return true;
7903            }
7904            p = p.getParent();
7905        }
7906        return false;
7907    }
7908
7909    /**
7910     * Remove the longpress detection timer.
7911     */
7912    private void removeLongPressCallback() {
7913        if (mPendingCheckForLongPress != null) {
7914          removeCallbacks(mPendingCheckForLongPress);
7915        }
7916    }
7917
7918    /**
7919     * Remove the pending click action
7920     */
7921    private void removePerformClickCallback() {
7922        if (mPerformClick != null) {
7923            removeCallbacks(mPerformClick);
7924        }
7925    }
7926
7927    /**
7928     * Remove the prepress detection timer.
7929     */
7930    private void removeUnsetPressCallback() {
7931        if ((mPrivateFlags & PRESSED) != 0 && mUnsetPressedState != null) {
7932            setPressed(false);
7933            removeCallbacks(mUnsetPressedState);
7934        }
7935    }
7936
7937    /**
7938     * Remove the tap detection timer.
7939     */
7940    private void removeTapCallback() {
7941        if (mPendingCheckForTap != null) {
7942            mPrivateFlags &= ~PREPRESSED;
7943            removeCallbacks(mPendingCheckForTap);
7944        }
7945    }
7946
7947    /**
7948     * Cancels a pending long press.  Your subclass can use this if you
7949     * want the context menu to come up if the user presses and holds
7950     * at the same place, but you don't want it to come up if they press
7951     * and then move around enough to cause scrolling.
7952     */
7953    public void cancelLongPress() {
7954        removeLongPressCallback();
7955
7956        /*
7957         * The prepressed state handled by the tap callback is a display
7958         * construct, but the tap callback will post a long press callback
7959         * less its own timeout. Remove it here.
7960         */
7961        removeTapCallback();
7962    }
7963
7964    /**
7965     * Remove the pending callback for sending a
7966     * {@link AccessibilityEvent#TYPE_VIEW_SCROLLED} accessibility event.
7967     */
7968    private void removeSendViewScrolledAccessibilityEventCallback() {
7969        if (mSendViewScrolledAccessibilityEvent != null) {
7970            removeCallbacks(mSendViewScrolledAccessibilityEvent);
7971        }
7972    }
7973
7974    /**
7975     * Sets the TouchDelegate for this View.
7976     */
7977    public void setTouchDelegate(TouchDelegate delegate) {
7978        mTouchDelegate = delegate;
7979    }
7980
7981    /**
7982     * Gets the TouchDelegate for this View.
7983     */
7984    public TouchDelegate getTouchDelegate() {
7985        return mTouchDelegate;
7986    }
7987
7988    /**
7989     * Set flags controlling behavior of this view.
7990     *
7991     * @param flags Constant indicating the value which should be set
7992     * @param mask Constant indicating the bit range that should be changed
7993     */
7994    void setFlags(int flags, int mask) {
7995        int old = mViewFlags;
7996        mViewFlags = (mViewFlags & ~mask) | (flags & mask);
7997
7998        int changed = mViewFlags ^ old;
7999        if (changed == 0) {
8000            return;
8001        }
8002        int privateFlags = mPrivateFlags;
8003
8004        /* Check if the FOCUSABLE bit has changed */
8005        if (((changed & FOCUSABLE_MASK) != 0) &&
8006                ((privateFlags & HAS_BOUNDS) !=0)) {
8007            if (((old & FOCUSABLE_MASK) == FOCUSABLE)
8008                    && ((privateFlags & FOCUSED) != 0)) {
8009                /* Give up focus if we are no longer focusable */
8010                clearFocus();
8011            } else if (((old & FOCUSABLE_MASK) == NOT_FOCUSABLE)
8012                    && ((privateFlags & FOCUSED) == 0)) {
8013                /*
8014                 * Tell the view system that we are now available to take focus
8015                 * if no one else already has it.
8016                 */
8017                if (mParent != null) mParent.focusableViewAvailable(this);
8018            }
8019            if (AccessibilityManager.getInstance(mContext).isEnabled()) {
8020                notifyAccessibilityStateChanged();
8021            }
8022        }
8023
8024        if ((flags & VISIBILITY_MASK) == VISIBLE) {
8025            if ((changed & VISIBILITY_MASK) != 0) {
8026                /*
8027                 * If this view is becoming visible, invalidate it in case it changed while
8028                 * it was not visible. Marking it drawn ensures that the invalidation will
8029                 * go through.
8030                 */
8031                mPrivateFlags |= DRAWN;
8032                invalidate(true);
8033
8034                needGlobalAttributesUpdate(true);
8035
8036                // a view becoming visible is worth notifying the parent
8037                // about in case nothing has focus.  even if this specific view
8038                // isn't focusable, it may contain something that is, so let
8039                // the root view try to give this focus if nothing else does.
8040                if ((mParent != null) && (mBottom > mTop) && (mRight > mLeft)) {
8041                    mParent.focusableViewAvailable(this);
8042                }
8043            }
8044        }
8045
8046        /* Check if the GONE bit has changed */
8047        if ((changed & GONE) != 0) {
8048            needGlobalAttributesUpdate(false);
8049            requestLayout();
8050
8051            if (((mViewFlags & VISIBILITY_MASK) == GONE)) {
8052                if (hasFocus()) clearFocus();
8053                clearAccessibilityFocus();
8054                destroyDrawingCache();
8055                if (mParent instanceof View) {
8056                    // GONE views noop invalidation, so invalidate the parent
8057                    ((View) mParent).invalidate(true);
8058                }
8059                // Mark the view drawn to ensure that it gets invalidated properly the next
8060                // time it is visible and gets invalidated
8061                mPrivateFlags |= DRAWN;
8062            }
8063            if (mAttachInfo != null) {
8064                mAttachInfo.mViewVisibilityChanged = true;
8065            }
8066        }
8067
8068        /* Check if the VISIBLE bit has changed */
8069        if ((changed & INVISIBLE) != 0) {
8070            needGlobalAttributesUpdate(false);
8071            /*
8072             * If this view is becoming invisible, set the DRAWN flag so that
8073             * the next invalidate() will not be skipped.
8074             */
8075            mPrivateFlags |= DRAWN;
8076
8077            if (((mViewFlags & VISIBILITY_MASK) == INVISIBLE) && hasFocus()) {
8078                // root view becoming invisible shouldn't clear focus and accessibility focus
8079                if (getRootView() != this) {
8080                    clearFocus();
8081                    clearAccessibilityFocus();
8082                }
8083            }
8084            if (mAttachInfo != null) {
8085                mAttachInfo.mViewVisibilityChanged = true;
8086            }
8087        }
8088
8089        if ((changed & VISIBILITY_MASK) != 0) {
8090            if (mParent instanceof ViewGroup) {
8091                ((ViewGroup) mParent).onChildVisibilityChanged(this,
8092                        (changed & VISIBILITY_MASK), (flags & VISIBILITY_MASK));
8093                ((View) mParent).invalidate(true);
8094            } else if (mParent != null) {
8095                mParent.invalidateChild(this, null);
8096            }
8097            dispatchVisibilityChanged(this, (flags & VISIBILITY_MASK));
8098        }
8099
8100        if ((changed & WILL_NOT_CACHE_DRAWING) != 0) {
8101            destroyDrawingCache();
8102        }
8103
8104        if ((changed & DRAWING_CACHE_ENABLED) != 0) {
8105            destroyDrawingCache();
8106            mPrivateFlags &= ~DRAWING_CACHE_VALID;
8107            invalidateParentCaches();
8108        }
8109
8110        if ((changed & DRAWING_CACHE_QUALITY_MASK) != 0) {
8111            destroyDrawingCache();
8112            mPrivateFlags &= ~DRAWING_CACHE_VALID;
8113        }
8114
8115        if ((changed & DRAW_MASK) != 0) {
8116            if ((mViewFlags & WILL_NOT_DRAW) != 0) {
8117                if (mBackground != null) {
8118                    mPrivateFlags &= ~SKIP_DRAW;
8119                    mPrivateFlags |= ONLY_DRAWS_BACKGROUND;
8120                } else {
8121                    mPrivateFlags |= SKIP_DRAW;
8122                }
8123            } else {
8124                mPrivateFlags &= ~SKIP_DRAW;
8125            }
8126            requestLayout();
8127            invalidate(true);
8128        }
8129
8130        if ((changed & KEEP_SCREEN_ON) != 0) {
8131            if (mParent != null && mAttachInfo != null && !mAttachInfo.mRecomputeGlobalAttributes) {
8132                mParent.recomputeViewAttributes(this);
8133            }
8134        }
8135
8136        if (AccessibilityManager.getInstance(mContext).isEnabled()
8137                && ((changed & FOCUSABLE) != 0 || (changed & CLICKABLE) != 0
8138                        || (changed & LONG_CLICKABLE) != 0 || (changed & ENABLED) != 0)) {
8139            notifyAccessibilityStateChanged();
8140        }
8141    }
8142
8143    /**
8144     * Change the view's z order in the tree, so it's on top of other sibling
8145     * views
8146     */
8147    public void bringToFront() {
8148        if (mParent != null) {
8149            mParent.bringChildToFront(this);
8150        }
8151    }
8152
8153    /**
8154     * This is called in response to an internal scroll in this view (i.e., the
8155     * view scrolled its own contents). This is typically as a result of
8156     * {@link #scrollBy(int, int)} or {@link #scrollTo(int, int)} having been
8157     * called.
8158     *
8159     * @param l Current horizontal scroll origin.
8160     * @param t Current vertical scroll origin.
8161     * @param oldl Previous horizontal scroll origin.
8162     * @param oldt Previous vertical scroll origin.
8163     */
8164    protected void onScrollChanged(int l, int t, int oldl, int oldt) {
8165        if (AccessibilityManager.getInstance(mContext).isEnabled()) {
8166            postSendViewScrolledAccessibilityEventCallback();
8167        }
8168
8169        mBackgroundSizeChanged = true;
8170
8171        final AttachInfo ai = mAttachInfo;
8172        if (ai != null) {
8173            ai.mViewScrollChanged = true;
8174        }
8175    }
8176
8177    /**
8178     * Interface definition for a callback to be invoked when the layout bounds of a view
8179     * changes due to layout processing.
8180     */
8181    public interface OnLayoutChangeListener {
8182        /**
8183         * Called when the focus state of a view has changed.
8184         *
8185         * @param v The view whose state has changed.
8186         * @param left The new value of the view's left property.
8187         * @param top The new value of the view's top property.
8188         * @param right The new value of the view's right property.
8189         * @param bottom The new value of the view's bottom property.
8190         * @param oldLeft The previous value of the view's left property.
8191         * @param oldTop The previous value of the view's top property.
8192         * @param oldRight The previous value of the view's right property.
8193         * @param oldBottom The previous value of the view's bottom property.
8194         */
8195        void onLayoutChange(View v, int left, int top, int right, int bottom,
8196            int oldLeft, int oldTop, int oldRight, int oldBottom);
8197    }
8198
8199    /**
8200     * This is called during layout when the size of this view has changed. If
8201     * you were just added to the view hierarchy, you're called with the old
8202     * values of 0.
8203     *
8204     * @param w Current width of this view.
8205     * @param h Current height of this view.
8206     * @param oldw Old width of this view.
8207     * @param oldh Old height of this view.
8208     */
8209    protected void onSizeChanged(int w, int h, int oldw, int oldh) {
8210    }
8211
8212    /**
8213     * Called by draw to draw the child views. This may be overridden
8214     * by derived classes to gain control just before its children are drawn
8215     * (but after its own view has been drawn).
8216     * @param canvas the canvas on which to draw the view
8217     */
8218    protected void dispatchDraw(Canvas canvas) {
8219
8220    }
8221
8222    /**
8223     * Gets the parent of this view. Note that the parent is a
8224     * ViewParent and not necessarily a View.
8225     *
8226     * @return Parent of this view.
8227     */
8228    public final ViewParent getParent() {
8229        return mParent;
8230    }
8231
8232    /**
8233     * Set the horizontal scrolled position of your view. This will cause a call to
8234     * {@link #onScrollChanged(int, int, int, int)} and the view will be
8235     * invalidated.
8236     * @param value the x position to scroll to
8237     */
8238    public void setScrollX(int value) {
8239        scrollTo(value, mScrollY);
8240    }
8241
8242    /**
8243     * Set the vertical scrolled position of your view. This will cause a call to
8244     * {@link #onScrollChanged(int, int, int, int)} and the view will be
8245     * invalidated.
8246     * @param value the y position to scroll to
8247     */
8248    public void setScrollY(int value) {
8249        scrollTo(mScrollX, value);
8250    }
8251
8252    /**
8253     * Return the scrolled left position of this view. This is the left edge of
8254     * the displayed part of your view. You do not need to draw any pixels
8255     * farther left, since those are outside of the frame of your view on
8256     * screen.
8257     *
8258     * @return The left edge of the displayed part of your view, in pixels.
8259     */
8260    public final int getScrollX() {
8261        return mScrollX;
8262    }
8263
8264    /**
8265     * Return the scrolled top position of this view. This is the top edge of
8266     * the displayed part of your view. You do not need to draw any pixels above
8267     * it, since those are outside of the frame of your view on screen.
8268     *
8269     * @return The top edge of the displayed part of your view, in pixels.
8270     */
8271    public final int getScrollY() {
8272        return mScrollY;
8273    }
8274
8275    /**
8276     * Return the width of the your view.
8277     *
8278     * @return The width of your view, in pixels.
8279     */
8280    @ViewDebug.ExportedProperty(category = "layout")
8281    public final int getWidth() {
8282        return mRight - mLeft;
8283    }
8284
8285    /**
8286     * Return the height of your view.
8287     *
8288     * @return The height of your view, in pixels.
8289     */
8290    @ViewDebug.ExportedProperty(category = "layout")
8291    public final int getHeight() {
8292        return mBottom - mTop;
8293    }
8294
8295    /**
8296     * Return the visible drawing bounds of your view. Fills in the output
8297     * rectangle with the values from getScrollX(), getScrollY(),
8298     * getWidth(), and getHeight().
8299     *
8300     * @param outRect The (scrolled) drawing bounds of the view.
8301     */
8302    public void getDrawingRect(Rect outRect) {
8303        outRect.left = mScrollX;
8304        outRect.top = mScrollY;
8305        outRect.right = mScrollX + (mRight - mLeft);
8306        outRect.bottom = mScrollY + (mBottom - mTop);
8307    }
8308
8309    /**
8310     * Like {@link #getMeasuredWidthAndState()}, but only returns the
8311     * raw width component (that is the result is masked by
8312     * {@link #MEASURED_SIZE_MASK}).
8313     *
8314     * @return The raw measured width of this view.
8315     */
8316    public final int getMeasuredWidth() {
8317        return mMeasuredWidth & MEASURED_SIZE_MASK;
8318    }
8319
8320    /**
8321     * Return the full width measurement information for this view as computed
8322     * by the most recent call to {@link #measure(int, int)}.  This result is a bit mask
8323     * as defined by {@link #MEASURED_SIZE_MASK} and {@link #MEASURED_STATE_TOO_SMALL}.
8324     * This should be used during measurement and layout calculations only. Use
8325     * {@link #getWidth()} to see how wide a view is after layout.
8326     *
8327     * @return The measured width of this view as a bit mask.
8328     */
8329    public final int getMeasuredWidthAndState() {
8330        return mMeasuredWidth;
8331    }
8332
8333    /**
8334     * Like {@link #getMeasuredHeightAndState()}, but only returns the
8335     * raw width component (that is the result is masked by
8336     * {@link #MEASURED_SIZE_MASK}).
8337     *
8338     * @return The raw measured height of this view.
8339     */
8340    public final int getMeasuredHeight() {
8341        return mMeasuredHeight & MEASURED_SIZE_MASK;
8342    }
8343
8344    /**
8345     * Return the full height measurement information for this view as computed
8346     * by the most recent call to {@link #measure(int, int)}.  This result is a bit mask
8347     * as defined by {@link #MEASURED_SIZE_MASK} and {@link #MEASURED_STATE_TOO_SMALL}.
8348     * This should be used during measurement and layout calculations only. Use
8349     * {@link #getHeight()} to see how wide a view is after layout.
8350     *
8351     * @return The measured width of this view as a bit mask.
8352     */
8353    public final int getMeasuredHeightAndState() {
8354        return mMeasuredHeight;
8355    }
8356
8357    /**
8358     * Return only the state bits of {@link #getMeasuredWidthAndState()}
8359     * and {@link #getMeasuredHeightAndState()}, combined into one integer.
8360     * The width component is in the regular bits {@link #MEASURED_STATE_MASK}
8361     * and the height component is at the shifted bits
8362     * {@link #MEASURED_HEIGHT_STATE_SHIFT}>>{@link #MEASURED_STATE_MASK}.
8363     */
8364    public final int getMeasuredState() {
8365        return (mMeasuredWidth&MEASURED_STATE_MASK)
8366                | ((mMeasuredHeight>>MEASURED_HEIGHT_STATE_SHIFT)
8367                        & (MEASURED_STATE_MASK>>MEASURED_HEIGHT_STATE_SHIFT));
8368    }
8369
8370    /**
8371     * The transform matrix of this view, which is calculated based on the current
8372     * roation, scale, and pivot properties.
8373     *
8374     * @see #getRotation()
8375     * @see #getScaleX()
8376     * @see #getScaleY()
8377     * @see #getPivotX()
8378     * @see #getPivotY()
8379     * @return The current transform matrix for the view
8380     */
8381    public Matrix getMatrix() {
8382        if (mTransformationInfo != null) {
8383            updateMatrix();
8384            return mTransformationInfo.mMatrix;
8385        }
8386        return Matrix.IDENTITY_MATRIX;
8387    }
8388
8389    /**
8390     * Utility function to determine if the value is far enough away from zero to be
8391     * considered non-zero.
8392     * @param value A floating point value to check for zero-ness
8393     * @return whether the passed-in value is far enough away from zero to be considered non-zero
8394     */
8395    private static boolean nonzero(float value) {
8396        return (value < -NONZERO_EPSILON || value > NONZERO_EPSILON);
8397    }
8398
8399    /**
8400     * Returns true if the transform matrix is the identity matrix.
8401     * Recomputes the matrix if necessary.
8402     *
8403     * @return True if the transform matrix is the identity matrix, false otherwise.
8404     */
8405    final boolean hasIdentityMatrix() {
8406        if (mTransformationInfo != null) {
8407            updateMatrix();
8408            return mTransformationInfo.mMatrixIsIdentity;
8409        }
8410        return true;
8411    }
8412
8413    void ensureTransformationInfo() {
8414        if (mTransformationInfo == null) {
8415            mTransformationInfo = new TransformationInfo();
8416        }
8417    }
8418
8419    /**
8420     * Recomputes the transform matrix if necessary.
8421     */
8422    private void updateMatrix() {
8423        final TransformationInfo info = mTransformationInfo;
8424        if (info == null) {
8425            return;
8426        }
8427        if (info.mMatrixDirty) {
8428            // transform-related properties have changed since the last time someone
8429            // asked for the matrix; recalculate it with the current values
8430
8431            // Figure out if we need to update the pivot point
8432            if ((mPrivateFlags & PIVOT_EXPLICITLY_SET) == 0) {
8433                if ((mRight - mLeft) != info.mPrevWidth || (mBottom - mTop) != info.mPrevHeight) {
8434                    info.mPrevWidth = mRight - mLeft;
8435                    info.mPrevHeight = mBottom - mTop;
8436                    info.mPivotX = info.mPrevWidth / 2f;
8437                    info.mPivotY = info.mPrevHeight / 2f;
8438                }
8439            }
8440            info.mMatrix.reset();
8441            if (!nonzero(info.mRotationX) && !nonzero(info.mRotationY)) {
8442                info.mMatrix.setTranslate(info.mTranslationX, info.mTranslationY);
8443                info.mMatrix.preRotate(info.mRotation, info.mPivotX, info.mPivotY);
8444                info.mMatrix.preScale(info.mScaleX, info.mScaleY, info.mPivotX, info.mPivotY);
8445            } else {
8446                if (info.mCamera == null) {
8447                    info.mCamera = new Camera();
8448                    info.matrix3D = new Matrix();
8449                }
8450                info.mCamera.save();
8451                info.mMatrix.preScale(info.mScaleX, info.mScaleY, info.mPivotX, info.mPivotY);
8452                info.mCamera.rotate(info.mRotationX, info.mRotationY, -info.mRotation);
8453                info.mCamera.getMatrix(info.matrix3D);
8454                info.matrix3D.preTranslate(-info.mPivotX, -info.mPivotY);
8455                info.matrix3D.postTranslate(info.mPivotX + info.mTranslationX,
8456                        info.mPivotY + info.mTranslationY);
8457                info.mMatrix.postConcat(info.matrix3D);
8458                info.mCamera.restore();
8459            }
8460            info.mMatrixDirty = false;
8461            info.mMatrixIsIdentity = info.mMatrix.isIdentity();
8462            info.mInverseMatrixDirty = true;
8463        }
8464    }
8465
8466    /**
8467     * Utility method to retrieve the inverse of the current mMatrix property.
8468     * We cache the matrix to avoid recalculating it when transform properties
8469     * have not changed.
8470     *
8471     * @return The inverse of the current matrix of this view.
8472     */
8473    final Matrix getInverseMatrix() {
8474        final TransformationInfo info = mTransformationInfo;
8475        if (info != null) {
8476            updateMatrix();
8477            if (info.mInverseMatrixDirty) {
8478                if (info.mInverseMatrix == null) {
8479                    info.mInverseMatrix = new Matrix();
8480                }
8481                info.mMatrix.invert(info.mInverseMatrix);
8482                info.mInverseMatrixDirty = false;
8483            }
8484            return info.mInverseMatrix;
8485        }
8486        return Matrix.IDENTITY_MATRIX;
8487    }
8488
8489    /**
8490     * Gets the distance along the Z axis from the camera to this view.
8491     *
8492     * @see #setCameraDistance(float)
8493     *
8494     * @return The distance along the Z axis.
8495     */
8496    public float getCameraDistance() {
8497        ensureTransformationInfo();
8498        final float dpi = mResources.getDisplayMetrics().densityDpi;
8499        final TransformationInfo info = mTransformationInfo;
8500        if (info.mCamera == null) {
8501            info.mCamera = new Camera();
8502            info.matrix3D = new Matrix();
8503        }
8504        return -(info.mCamera.getLocationZ() * dpi);
8505    }
8506
8507    /**
8508     * <p>Sets the distance along the Z axis (orthogonal to the X/Y plane on which
8509     * views are drawn) from the camera to this view. The camera's distance
8510     * affects 3D transformations, for instance rotations around the X and Y
8511     * axis. If the rotationX or rotationY properties are changed and this view is
8512     * large (more than half the size of the screen), it is recommended to always
8513     * use a camera distance that's greater than the height (X axis rotation) or
8514     * the width (Y axis rotation) of this view.</p>
8515     *
8516     * <p>The distance of the camera from the view plane can have an affect on the
8517     * perspective distortion of the view when it is rotated around the x or y axis.
8518     * For example, a large distance will result in a large viewing angle, and there
8519     * will not be much perspective distortion of the view as it rotates. A short
8520     * distance may cause much more perspective distortion upon rotation, and can
8521     * also result in some drawing artifacts if the rotated view ends up partially
8522     * behind the camera (which is why the recommendation is to use a distance at
8523     * least as far as the size of the view, if the view is to be rotated.)</p>
8524     *
8525     * <p>The distance is expressed in "depth pixels." The default distance depends
8526     * on the screen density. For instance, on a medium density display, the
8527     * default distance is 1280. On a high density display, the default distance
8528     * is 1920.</p>
8529     *
8530     * <p>If you want to specify a distance that leads to visually consistent
8531     * results across various densities, use the following formula:</p>
8532     * <pre>
8533     * float scale = context.getResources().getDisplayMetrics().density;
8534     * view.setCameraDistance(distance * scale);
8535     * </pre>
8536     *
8537     * <p>The density scale factor of a high density display is 1.5,
8538     * and 1920 = 1280 * 1.5.</p>
8539     *
8540     * @param distance The distance in "depth pixels", if negative the opposite
8541     *        value is used
8542     *
8543     * @see #setRotationX(float)
8544     * @see #setRotationY(float)
8545     */
8546    public void setCameraDistance(float distance) {
8547        invalidateViewProperty(true, false);
8548
8549        ensureTransformationInfo();
8550        final float dpi = mResources.getDisplayMetrics().densityDpi;
8551        final TransformationInfo info = mTransformationInfo;
8552        if (info.mCamera == null) {
8553            info.mCamera = new Camera();
8554            info.matrix3D = new Matrix();
8555        }
8556
8557        info.mCamera.setLocation(0.0f, 0.0f, -Math.abs(distance) / dpi);
8558        info.mMatrixDirty = true;
8559
8560        invalidateViewProperty(false, false);
8561        if (mDisplayList != null) {
8562            mDisplayList.setCameraDistance(-Math.abs(distance) / dpi);
8563        }
8564        if ((mPrivateFlags2 & VIEW_QUICK_REJECTED) == VIEW_QUICK_REJECTED) {
8565            // View was rejected last time it was drawn by its parent; this may have changed
8566            invalidateParentIfNeeded();
8567        }
8568    }
8569
8570    /**
8571     * The degrees that the view is rotated around the pivot point.
8572     *
8573     * @see #setRotation(float)
8574     * @see #getPivotX()
8575     * @see #getPivotY()
8576     *
8577     * @return The degrees of rotation.
8578     */
8579    @ViewDebug.ExportedProperty(category = "drawing")
8580    public float getRotation() {
8581        return mTransformationInfo != null ? mTransformationInfo.mRotation : 0;
8582    }
8583
8584    /**
8585     * Sets the degrees that the view is rotated around the pivot point. Increasing values
8586     * result in clockwise rotation.
8587     *
8588     * @param rotation The degrees of rotation.
8589     *
8590     * @see #getRotation()
8591     * @see #getPivotX()
8592     * @see #getPivotY()
8593     * @see #setRotationX(float)
8594     * @see #setRotationY(float)
8595     *
8596     * @attr ref android.R.styleable#View_rotation
8597     */
8598    public void setRotation(float rotation) {
8599        ensureTransformationInfo();
8600        final TransformationInfo info = mTransformationInfo;
8601        if (info.mRotation != rotation) {
8602            // Double-invalidation is necessary to capture view's old and new areas
8603            invalidateViewProperty(true, false);
8604            info.mRotation = rotation;
8605            info.mMatrixDirty = true;
8606            invalidateViewProperty(false, true);
8607            if (mDisplayList != null) {
8608                mDisplayList.setRotation(rotation);
8609            }
8610            if ((mPrivateFlags2 & VIEW_QUICK_REJECTED) == VIEW_QUICK_REJECTED) {
8611                // View was rejected last time it was drawn by its parent; this may have changed
8612                invalidateParentIfNeeded();
8613            }
8614        }
8615    }
8616
8617    /**
8618     * The degrees that the view is rotated around the vertical axis through the pivot point.
8619     *
8620     * @see #getPivotX()
8621     * @see #getPivotY()
8622     * @see #setRotationY(float)
8623     *
8624     * @return The degrees of Y rotation.
8625     */
8626    @ViewDebug.ExportedProperty(category = "drawing")
8627    public float getRotationY() {
8628        return mTransformationInfo != null ? mTransformationInfo.mRotationY : 0;
8629    }
8630
8631    /**
8632     * Sets the degrees that the view is rotated around the vertical axis through the pivot point.
8633     * Increasing values result in counter-clockwise rotation from the viewpoint of looking
8634     * down the y axis.
8635     *
8636     * When rotating large views, it is recommended to adjust the camera distance
8637     * accordingly. Refer to {@link #setCameraDistance(float)} for more information.
8638     *
8639     * @param rotationY The degrees of Y rotation.
8640     *
8641     * @see #getRotationY()
8642     * @see #getPivotX()
8643     * @see #getPivotY()
8644     * @see #setRotation(float)
8645     * @see #setRotationX(float)
8646     * @see #setCameraDistance(float)
8647     *
8648     * @attr ref android.R.styleable#View_rotationY
8649     */
8650    public void setRotationY(float rotationY) {
8651        ensureTransformationInfo();
8652        final TransformationInfo info = mTransformationInfo;
8653        if (info.mRotationY != rotationY) {
8654            invalidateViewProperty(true, false);
8655            info.mRotationY = rotationY;
8656            info.mMatrixDirty = true;
8657            invalidateViewProperty(false, true);
8658            if (mDisplayList != null) {
8659                mDisplayList.setRotationY(rotationY);
8660            }
8661            if ((mPrivateFlags2 & VIEW_QUICK_REJECTED) == VIEW_QUICK_REJECTED) {
8662                // View was rejected last time it was drawn by its parent; this may have changed
8663                invalidateParentIfNeeded();
8664            }
8665        }
8666    }
8667
8668    /**
8669     * The degrees that the view is rotated around the horizontal axis through the pivot point.
8670     *
8671     * @see #getPivotX()
8672     * @see #getPivotY()
8673     * @see #setRotationX(float)
8674     *
8675     * @return The degrees of X rotation.
8676     */
8677    @ViewDebug.ExportedProperty(category = "drawing")
8678    public float getRotationX() {
8679        return mTransformationInfo != null ? mTransformationInfo.mRotationX : 0;
8680    }
8681
8682    /**
8683     * Sets the degrees that the view is rotated around the horizontal axis through the pivot point.
8684     * Increasing values result in clockwise rotation from the viewpoint of looking down the
8685     * x axis.
8686     *
8687     * When rotating large views, it is recommended to adjust the camera distance
8688     * accordingly. Refer to {@link #setCameraDistance(float)} for more information.
8689     *
8690     * @param rotationX The degrees of X rotation.
8691     *
8692     * @see #getRotationX()
8693     * @see #getPivotX()
8694     * @see #getPivotY()
8695     * @see #setRotation(float)
8696     * @see #setRotationY(float)
8697     * @see #setCameraDistance(float)
8698     *
8699     * @attr ref android.R.styleable#View_rotationX
8700     */
8701    public void setRotationX(float rotationX) {
8702        ensureTransformationInfo();
8703        final TransformationInfo info = mTransformationInfo;
8704        if (info.mRotationX != rotationX) {
8705            invalidateViewProperty(true, false);
8706            info.mRotationX = rotationX;
8707            info.mMatrixDirty = true;
8708            invalidateViewProperty(false, true);
8709            if (mDisplayList != null) {
8710                mDisplayList.setRotationX(rotationX);
8711            }
8712            if ((mPrivateFlags2 & VIEW_QUICK_REJECTED) == VIEW_QUICK_REJECTED) {
8713                // View was rejected last time it was drawn by its parent; this may have changed
8714                invalidateParentIfNeeded();
8715            }
8716        }
8717    }
8718
8719    /**
8720     * The amount that the view is scaled in x around the pivot point, as a proportion of
8721     * the view's unscaled width. A value of 1, the default, means that no scaling is applied.
8722     *
8723     * <p>By default, this is 1.0f.
8724     *
8725     * @see #getPivotX()
8726     * @see #getPivotY()
8727     * @return The scaling factor.
8728     */
8729    @ViewDebug.ExportedProperty(category = "drawing")
8730    public float getScaleX() {
8731        return mTransformationInfo != null ? mTransformationInfo.mScaleX : 1;
8732    }
8733
8734    /**
8735     * Sets the amount that the view is scaled in x around the pivot point, as a proportion of
8736     * the view's unscaled width. A value of 1 means that no scaling is applied.
8737     *
8738     * @param scaleX The scaling factor.
8739     * @see #getPivotX()
8740     * @see #getPivotY()
8741     *
8742     * @attr ref android.R.styleable#View_scaleX
8743     */
8744    public void setScaleX(float scaleX) {
8745        ensureTransformationInfo();
8746        final TransformationInfo info = mTransformationInfo;
8747        if (info.mScaleX != scaleX) {
8748            invalidateViewProperty(true, false);
8749            info.mScaleX = scaleX;
8750            info.mMatrixDirty = true;
8751            invalidateViewProperty(false, true);
8752            if (mDisplayList != null) {
8753                mDisplayList.setScaleX(scaleX);
8754            }
8755            if ((mPrivateFlags2 & VIEW_QUICK_REJECTED) == VIEW_QUICK_REJECTED) {
8756                // View was rejected last time it was drawn by its parent; this may have changed
8757                invalidateParentIfNeeded();
8758            }
8759        }
8760    }
8761
8762    /**
8763     * The amount that the view is scaled in y around the pivot point, as a proportion of
8764     * the view's unscaled height. A value of 1, the default, means that no scaling is applied.
8765     *
8766     * <p>By default, this is 1.0f.
8767     *
8768     * @see #getPivotX()
8769     * @see #getPivotY()
8770     * @return The scaling factor.
8771     */
8772    @ViewDebug.ExportedProperty(category = "drawing")
8773    public float getScaleY() {
8774        return mTransformationInfo != null ? mTransformationInfo.mScaleY : 1;
8775    }
8776
8777    /**
8778     * Sets the amount that the view is scaled in Y around the pivot point, as a proportion of
8779     * the view's unscaled width. A value of 1 means that no scaling is applied.
8780     *
8781     * @param scaleY The scaling factor.
8782     * @see #getPivotX()
8783     * @see #getPivotY()
8784     *
8785     * @attr ref android.R.styleable#View_scaleY
8786     */
8787    public void setScaleY(float scaleY) {
8788        ensureTransformationInfo();
8789        final TransformationInfo info = mTransformationInfo;
8790        if (info.mScaleY != scaleY) {
8791            invalidateViewProperty(true, false);
8792            info.mScaleY = scaleY;
8793            info.mMatrixDirty = true;
8794            invalidateViewProperty(false, true);
8795            if (mDisplayList != null) {
8796                mDisplayList.setScaleY(scaleY);
8797            }
8798            if ((mPrivateFlags2 & VIEW_QUICK_REJECTED) == VIEW_QUICK_REJECTED) {
8799                // View was rejected last time it was drawn by its parent; this may have changed
8800                invalidateParentIfNeeded();
8801            }
8802        }
8803    }
8804
8805    /**
8806     * The x location of the point around which the view is {@link #setRotation(float) rotated}
8807     * and {@link #setScaleX(float) scaled}.
8808     *
8809     * @see #getRotation()
8810     * @see #getScaleX()
8811     * @see #getScaleY()
8812     * @see #getPivotY()
8813     * @return The x location of the pivot point.
8814     *
8815     * @attr ref android.R.styleable#View_transformPivotX
8816     */
8817    @ViewDebug.ExportedProperty(category = "drawing")
8818    public float getPivotX() {
8819        return mTransformationInfo != null ? mTransformationInfo.mPivotX : 0;
8820    }
8821
8822    /**
8823     * Sets the x location of the point around which the view is
8824     * {@link #setRotation(float) rotated} and {@link #setScaleX(float) scaled}.
8825     * By default, the pivot point is centered on the object.
8826     * Setting this property disables this behavior and causes the view to use only the
8827     * explicitly set pivotX and pivotY values.
8828     *
8829     * @param pivotX The x location of the pivot point.
8830     * @see #getRotation()
8831     * @see #getScaleX()
8832     * @see #getScaleY()
8833     * @see #getPivotY()
8834     *
8835     * @attr ref android.R.styleable#View_transformPivotX
8836     */
8837    public void setPivotX(float pivotX) {
8838        ensureTransformationInfo();
8839        mPrivateFlags |= PIVOT_EXPLICITLY_SET;
8840        final TransformationInfo info = mTransformationInfo;
8841        if (info.mPivotX != pivotX) {
8842            invalidateViewProperty(true, false);
8843            info.mPivotX = pivotX;
8844            info.mMatrixDirty = true;
8845            invalidateViewProperty(false, true);
8846            if (mDisplayList != null) {
8847                mDisplayList.setPivotX(pivotX);
8848            }
8849            if ((mPrivateFlags2 & VIEW_QUICK_REJECTED) == VIEW_QUICK_REJECTED) {
8850                // View was rejected last time it was drawn by its parent; this may have changed
8851                invalidateParentIfNeeded();
8852            }
8853        }
8854    }
8855
8856    /**
8857     * The y location of the point around which the view is {@link #setRotation(float) rotated}
8858     * and {@link #setScaleY(float) scaled}.
8859     *
8860     * @see #getRotation()
8861     * @see #getScaleX()
8862     * @see #getScaleY()
8863     * @see #getPivotY()
8864     * @return The y location of the pivot point.
8865     *
8866     * @attr ref android.R.styleable#View_transformPivotY
8867     */
8868    @ViewDebug.ExportedProperty(category = "drawing")
8869    public float getPivotY() {
8870        return mTransformationInfo != null ? mTransformationInfo.mPivotY : 0;
8871    }
8872
8873    /**
8874     * Sets the y location of the point around which the view is {@link #setRotation(float) rotated}
8875     * and {@link #setScaleY(float) scaled}. By default, the pivot point is centered on the object.
8876     * Setting this property disables this behavior and causes the view to use only the
8877     * explicitly set pivotX and pivotY values.
8878     *
8879     * @param pivotY The y location of the pivot point.
8880     * @see #getRotation()
8881     * @see #getScaleX()
8882     * @see #getScaleY()
8883     * @see #getPivotY()
8884     *
8885     * @attr ref android.R.styleable#View_transformPivotY
8886     */
8887    public void setPivotY(float pivotY) {
8888        ensureTransformationInfo();
8889        mPrivateFlags |= PIVOT_EXPLICITLY_SET;
8890        final TransformationInfo info = mTransformationInfo;
8891        if (info.mPivotY != pivotY) {
8892            invalidateViewProperty(true, false);
8893            info.mPivotY = pivotY;
8894            info.mMatrixDirty = true;
8895            invalidateViewProperty(false, true);
8896            if (mDisplayList != null) {
8897                mDisplayList.setPivotY(pivotY);
8898            }
8899            if ((mPrivateFlags2 & VIEW_QUICK_REJECTED) == VIEW_QUICK_REJECTED) {
8900                // View was rejected last time it was drawn by its parent; this may have changed
8901                invalidateParentIfNeeded();
8902            }
8903        }
8904    }
8905
8906    /**
8907     * The opacity of the view. This is a value from 0 to 1, where 0 means the view is
8908     * completely transparent and 1 means the view is completely opaque.
8909     *
8910     * <p>By default this is 1.0f.
8911     * @return The opacity of the view.
8912     */
8913    @ViewDebug.ExportedProperty(category = "drawing")
8914    public float getAlpha() {
8915        return mTransformationInfo != null ? mTransformationInfo.mAlpha : 1;
8916    }
8917
8918    /**
8919     * Returns whether this View has content which overlaps. This function, intended to be
8920     * overridden by specific View types, is an optimization when alpha is set on a view. If
8921     * rendering overlaps in a view with alpha < 1, that view is drawn to an offscreen buffer
8922     * and then composited it into place, which can be expensive. If the view has no overlapping
8923     * rendering, the view can draw each primitive with the appropriate alpha value directly.
8924     * An example of overlapping rendering is a TextView with a background image, such as a
8925     * Button. An example of non-overlapping rendering is a TextView with no background, or
8926     * an ImageView with only the foreground image. The default implementation returns true;
8927     * subclasses should override if they have cases which can be optimized.
8928     *
8929     * @return true if the content in this view might overlap, false otherwise.
8930     */
8931    public boolean hasOverlappingRendering() {
8932        return true;
8933    }
8934
8935    /**
8936     * <p>Sets the opacity of the view. This is a value from 0 to 1, where 0 means the view is
8937     * completely transparent and 1 means the view is completely opaque.</p>
8938     *
8939     * <p>If this view overrides {@link #onSetAlpha(int)} to return true, then this view is
8940     * responsible for applying the opacity itself. Otherwise, calling this method is
8941     * equivalent to calling {@link #setLayerType(int, android.graphics.Paint)} and
8942     * setting a hardware layer.</p>
8943     *
8944     * <p>Note that setting alpha to a translucent value (0 < alpha < 1) may have
8945     * performance implications. It is generally best to use the alpha property sparingly and
8946     * transiently, as in the case of fading animations.</p>
8947     *
8948     * @param alpha The opacity of the view.
8949     *
8950     * @see #setLayerType(int, android.graphics.Paint)
8951     *
8952     * @attr ref android.R.styleable#View_alpha
8953     */
8954    public void setAlpha(float alpha) {
8955        ensureTransformationInfo();
8956        if (mTransformationInfo.mAlpha != alpha) {
8957            mTransformationInfo.mAlpha = alpha;
8958            if (onSetAlpha((int) (alpha * 255))) {
8959                mPrivateFlags |= ALPHA_SET;
8960                // subclass is handling alpha - don't optimize rendering cache invalidation
8961                invalidateParentCaches();
8962                invalidate(true);
8963            } else {
8964                mPrivateFlags &= ~ALPHA_SET;
8965                invalidateViewProperty(true, false);
8966                if (mDisplayList != null) {
8967                    mDisplayList.setAlpha(alpha);
8968                }
8969            }
8970        }
8971    }
8972
8973    /**
8974     * Faster version of setAlpha() which performs the same steps except there are
8975     * no calls to invalidate(). The caller of this function should perform proper invalidation
8976     * on the parent and this object. The return value indicates whether the subclass handles
8977     * alpha (the return value for onSetAlpha()).
8978     *
8979     * @param alpha The new value for the alpha property
8980     * @return true if the View subclass handles alpha (the return value for onSetAlpha()) and
8981     *         the new value for the alpha property is different from the old value
8982     */
8983    boolean setAlphaNoInvalidation(float alpha) {
8984        ensureTransformationInfo();
8985        if (mTransformationInfo.mAlpha != alpha) {
8986            mTransformationInfo.mAlpha = alpha;
8987            boolean subclassHandlesAlpha = onSetAlpha((int) (alpha * 255));
8988            if (subclassHandlesAlpha) {
8989                mPrivateFlags |= ALPHA_SET;
8990                return true;
8991            } else {
8992                mPrivateFlags &= ~ALPHA_SET;
8993                if (mDisplayList != null) {
8994                    mDisplayList.setAlpha(alpha);
8995                }
8996            }
8997        }
8998        return false;
8999    }
9000
9001    /**
9002     * Top position of this view relative to its parent.
9003     *
9004     * @return The top of this view, in pixels.
9005     */
9006    @ViewDebug.CapturedViewProperty
9007    public final int getTop() {
9008        return mTop;
9009    }
9010
9011    /**
9012     * Sets the top position of this view relative to its parent. This method is meant to be called
9013     * by the layout system and should not generally be called otherwise, because the property
9014     * may be changed at any time by the layout.
9015     *
9016     * @param top The top of this view, in pixels.
9017     */
9018    public final void setTop(int top) {
9019        if (top != mTop) {
9020            updateMatrix();
9021            final boolean matrixIsIdentity = mTransformationInfo == null
9022                    || mTransformationInfo.mMatrixIsIdentity;
9023            if (matrixIsIdentity) {
9024                if (mAttachInfo != null) {
9025                    int minTop;
9026                    int yLoc;
9027                    if (top < mTop) {
9028                        minTop = top;
9029                        yLoc = top - mTop;
9030                    } else {
9031                        minTop = mTop;
9032                        yLoc = 0;
9033                    }
9034                    invalidate(0, yLoc, mRight - mLeft, mBottom - minTop);
9035                }
9036            } else {
9037                // Double-invalidation is necessary to capture view's old and new areas
9038                invalidate(true);
9039            }
9040
9041            int width = mRight - mLeft;
9042            int oldHeight = mBottom - mTop;
9043
9044            mTop = top;
9045            if (mDisplayList != null) {
9046                mDisplayList.setTop(mTop);
9047            }
9048
9049            onSizeChanged(width, mBottom - mTop, width, oldHeight);
9050
9051            if (!matrixIsIdentity) {
9052                if ((mPrivateFlags & PIVOT_EXPLICITLY_SET) == 0) {
9053                    // A change in dimension means an auto-centered pivot point changes, too
9054                    mTransformationInfo.mMatrixDirty = true;
9055                }
9056                mPrivateFlags |= DRAWN; // force another invalidation with the new orientation
9057                invalidate(true);
9058            }
9059            mBackgroundSizeChanged = true;
9060            invalidateParentIfNeeded();
9061            if ((mPrivateFlags2 & VIEW_QUICK_REJECTED) == VIEW_QUICK_REJECTED) {
9062                // View was rejected last time it was drawn by its parent; this may have changed
9063                invalidateParentIfNeeded();
9064            }
9065        }
9066    }
9067
9068    /**
9069     * Bottom position of this view relative to its parent.
9070     *
9071     * @return The bottom of this view, in pixels.
9072     */
9073    @ViewDebug.CapturedViewProperty
9074    public final int getBottom() {
9075        return mBottom;
9076    }
9077
9078    /**
9079     * True if this view has changed since the last time being drawn.
9080     *
9081     * @return The dirty state of this view.
9082     */
9083    public boolean isDirty() {
9084        return (mPrivateFlags & DIRTY_MASK) != 0;
9085    }
9086
9087    /**
9088     * Sets the bottom position of this view relative to its parent. This method is meant to be
9089     * called by the layout system and should not generally be called otherwise, because the
9090     * property may be changed at any time by the layout.
9091     *
9092     * @param bottom The bottom of this view, in pixels.
9093     */
9094    public final void setBottom(int bottom) {
9095        if (bottom != mBottom) {
9096            updateMatrix();
9097            final boolean matrixIsIdentity = mTransformationInfo == null
9098                    || mTransformationInfo.mMatrixIsIdentity;
9099            if (matrixIsIdentity) {
9100                if (mAttachInfo != null) {
9101                    int maxBottom;
9102                    if (bottom < mBottom) {
9103                        maxBottom = mBottom;
9104                    } else {
9105                        maxBottom = bottom;
9106                    }
9107                    invalidate(0, 0, mRight - mLeft, maxBottom - mTop);
9108                }
9109            } else {
9110                // Double-invalidation is necessary to capture view's old and new areas
9111                invalidate(true);
9112            }
9113
9114            int width = mRight - mLeft;
9115            int oldHeight = mBottom - mTop;
9116
9117            mBottom = bottom;
9118            if (mDisplayList != null) {
9119                mDisplayList.setBottom(mBottom);
9120            }
9121
9122            onSizeChanged(width, mBottom - mTop, width, oldHeight);
9123
9124            if (!matrixIsIdentity) {
9125                if ((mPrivateFlags & PIVOT_EXPLICITLY_SET) == 0) {
9126                    // A change in dimension means an auto-centered pivot point changes, too
9127                    mTransformationInfo.mMatrixDirty = true;
9128                }
9129                mPrivateFlags |= DRAWN; // force another invalidation with the new orientation
9130                invalidate(true);
9131            }
9132            mBackgroundSizeChanged = true;
9133            invalidateParentIfNeeded();
9134            if ((mPrivateFlags2 & VIEW_QUICK_REJECTED) == VIEW_QUICK_REJECTED) {
9135                // View was rejected last time it was drawn by its parent; this may have changed
9136                invalidateParentIfNeeded();
9137            }
9138        }
9139    }
9140
9141    /**
9142     * Left position of this view relative to its parent.
9143     *
9144     * @return The left edge of this view, in pixels.
9145     */
9146    @ViewDebug.CapturedViewProperty
9147    public final int getLeft() {
9148        return mLeft;
9149    }
9150
9151    /**
9152     * Sets the left position of this view relative to its parent. This method is meant to be called
9153     * by the layout system and should not generally be called otherwise, because the property
9154     * may be changed at any time by the layout.
9155     *
9156     * @param left The bottom of this view, in pixels.
9157     */
9158    public final void setLeft(int left) {
9159        if (left != mLeft) {
9160            updateMatrix();
9161            final boolean matrixIsIdentity = mTransformationInfo == null
9162                    || mTransformationInfo.mMatrixIsIdentity;
9163            if (matrixIsIdentity) {
9164                if (mAttachInfo != null) {
9165                    int minLeft;
9166                    int xLoc;
9167                    if (left < mLeft) {
9168                        minLeft = left;
9169                        xLoc = left - mLeft;
9170                    } else {
9171                        minLeft = mLeft;
9172                        xLoc = 0;
9173                    }
9174                    invalidate(xLoc, 0, mRight - minLeft, mBottom - mTop);
9175                }
9176            } else {
9177                // Double-invalidation is necessary to capture view's old and new areas
9178                invalidate(true);
9179            }
9180
9181            int oldWidth = mRight - mLeft;
9182            int height = mBottom - mTop;
9183
9184            mLeft = left;
9185            if (mDisplayList != null) {
9186                mDisplayList.setLeft(left);
9187            }
9188
9189            onSizeChanged(mRight - mLeft, height, oldWidth, height);
9190
9191            if (!matrixIsIdentity) {
9192                if ((mPrivateFlags & PIVOT_EXPLICITLY_SET) == 0) {
9193                    // A change in dimension means an auto-centered pivot point changes, too
9194                    mTransformationInfo.mMatrixDirty = true;
9195                }
9196                mPrivateFlags |= DRAWN; // force another invalidation with the new orientation
9197                invalidate(true);
9198            }
9199            mBackgroundSizeChanged = true;
9200            invalidateParentIfNeeded();
9201            if ((mPrivateFlags2 & VIEW_QUICK_REJECTED) == VIEW_QUICK_REJECTED) {
9202                // View was rejected last time it was drawn by its parent; this may have changed
9203                invalidateParentIfNeeded();
9204            }
9205        }
9206    }
9207
9208    /**
9209     * Right position of this view relative to its parent.
9210     *
9211     * @return The right edge of this view, in pixels.
9212     */
9213    @ViewDebug.CapturedViewProperty
9214    public final int getRight() {
9215        return mRight;
9216    }
9217
9218    /**
9219     * Sets the right position of this view relative to its parent. This method is meant to be called
9220     * by the layout system and should not generally be called otherwise, because the property
9221     * may be changed at any time by the layout.
9222     *
9223     * @param right The bottom of this view, in pixels.
9224     */
9225    public final void setRight(int right) {
9226        if (right != mRight) {
9227            updateMatrix();
9228            final boolean matrixIsIdentity = mTransformationInfo == null
9229                    || mTransformationInfo.mMatrixIsIdentity;
9230            if (matrixIsIdentity) {
9231                if (mAttachInfo != null) {
9232                    int maxRight;
9233                    if (right < mRight) {
9234                        maxRight = mRight;
9235                    } else {
9236                        maxRight = right;
9237                    }
9238                    invalidate(0, 0, maxRight - mLeft, mBottom - mTop);
9239                }
9240            } else {
9241                // Double-invalidation is necessary to capture view's old and new areas
9242                invalidate(true);
9243            }
9244
9245            int oldWidth = mRight - mLeft;
9246            int height = mBottom - mTop;
9247
9248            mRight = right;
9249            if (mDisplayList != null) {
9250                mDisplayList.setRight(mRight);
9251            }
9252
9253            onSizeChanged(mRight - mLeft, height, oldWidth, height);
9254
9255            if (!matrixIsIdentity) {
9256                if ((mPrivateFlags & PIVOT_EXPLICITLY_SET) == 0) {
9257                    // A change in dimension means an auto-centered pivot point changes, too
9258                    mTransformationInfo.mMatrixDirty = true;
9259                }
9260                mPrivateFlags |= DRAWN; // force another invalidation with the new orientation
9261                invalidate(true);
9262            }
9263            mBackgroundSizeChanged = true;
9264            invalidateParentIfNeeded();
9265            if ((mPrivateFlags2 & VIEW_QUICK_REJECTED) == VIEW_QUICK_REJECTED) {
9266                // View was rejected last time it was drawn by its parent; this may have changed
9267                invalidateParentIfNeeded();
9268            }
9269        }
9270    }
9271
9272    /**
9273     * The visual x position of this view, in pixels. This is equivalent to the
9274     * {@link #setTranslationX(float) translationX} property plus the current
9275     * {@link #getLeft() left} property.
9276     *
9277     * @return The visual x position of this view, in pixels.
9278     */
9279    @ViewDebug.ExportedProperty(category = "drawing")
9280    public float getX() {
9281        return mLeft + (mTransformationInfo != null ? mTransformationInfo.mTranslationX : 0);
9282    }
9283
9284    /**
9285     * Sets the visual x position of this view, in pixels. This is equivalent to setting the
9286     * {@link #setTranslationX(float) translationX} property to be the difference between
9287     * the x value passed in and the current {@link #getLeft() left} property.
9288     *
9289     * @param x The visual x position of this view, in pixels.
9290     */
9291    public void setX(float x) {
9292        setTranslationX(x - mLeft);
9293    }
9294
9295    /**
9296     * The visual y position of this view, in pixels. This is equivalent to the
9297     * {@link #setTranslationY(float) translationY} property plus the current
9298     * {@link #getTop() top} property.
9299     *
9300     * @return The visual y position of this view, in pixels.
9301     */
9302    @ViewDebug.ExportedProperty(category = "drawing")
9303    public float getY() {
9304        return mTop + (mTransformationInfo != null ? mTransformationInfo.mTranslationY : 0);
9305    }
9306
9307    /**
9308     * Sets the visual y position of this view, in pixels. This is equivalent to setting the
9309     * {@link #setTranslationY(float) translationY} property to be the difference between
9310     * the y value passed in and the current {@link #getTop() top} property.
9311     *
9312     * @param y The visual y position of this view, in pixels.
9313     */
9314    public void setY(float y) {
9315        setTranslationY(y - mTop);
9316    }
9317
9318
9319    /**
9320     * The horizontal location of this view relative to its {@link #getLeft() left} position.
9321     * This position is post-layout, in addition to wherever the object's
9322     * layout placed it.
9323     *
9324     * @return The horizontal position of this view relative to its left position, in pixels.
9325     */
9326    @ViewDebug.ExportedProperty(category = "drawing")
9327    public float getTranslationX() {
9328        return mTransformationInfo != null ? mTransformationInfo.mTranslationX : 0;
9329    }
9330
9331    /**
9332     * Sets the horizontal location of this view relative to its {@link #getLeft() left} position.
9333     * This effectively positions the object post-layout, in addition to wherever the object's
9334     * layout placed it.
9335     *
9336     * @param translationX The horizontal position of this view relative to its left position,
9337     * in pixels.
9338     *
9339     * @attr ref android.R.styleable#View_translationX
9340     */
9341    public void setTranslationX(float translationX) {
9342        ensureTransformationInfo();
9343        final TransformationInfo info = mTransformationInfo;
9344        if (info.mTranslationX != translationX) {
9345            // Double-invalidation is necessary to capture view's old and new areas
9346            invalidateViewProperty(true, false);
9347            info.mTranslationX = translationX;
9348            info.mMatrixDirty = true;
9349            invalidateViewProperty(false, true);
9350            if (mDisplayList != null) {
9351                mDisplayList.setTranslationX(translationX);
9352            }
9353            if ((mPrivateFlags2 & VIEW_QUICK_REJECTED) == VIEW_QUICK_REJECTED) {
9354                // View was rejected last time it was drawn by its parent; this may have changed
9355                invalidateParentIfNeeded();
9356            }
9357        }
9358    }
9359
9360    /**
9361     * The horizontal location of this view relative to its {@link #getTop() top} position.
9362     * This position is post-layout, in addition to wherever the object's
9363     * layout placed it.
9364     *
9365     * @return The vertical position of this view relative to its top position,
9366     * in pixels.
9367     */
9368    @ViewDebug.ExportedProperty(category = "drawing")
9369    public float getTranslationY() {
9370        return mTransformationInfo != null ? mTransformationInfo.mTranslationY : 0;
9371    }
9372
9373    /**
9374     * Sets the vertical location of this view relative to its {@link #getTop() top} position.
9375     * This effectively positions the object post-layout, in addition to wherever the object's
9376     * layout placed it.
9377     *
9378     * @param translationY The vertical position of this view relative to its top position,
9379     * in pixels.
9380     *
9381     * @attr ref android.R.styleable#View_translationY
9382     */
9383    public void setTranslationY(float translationY) {
9384        ensureTransformationInfo();
9385        final TransformationInfo info = mTransformationInfo;
9386        if (info.mTranslationY != translationY) {
9387            invalidateViewProperty(true, false);
9388            info.mTranslationY = translationY;
9389            info.mMatrixDirty = true;
9390            invalidateViewProperty(false, true);
9391            if (mDisplayList != null) {
9392                mDisplayList.setTranslationY(translationY);
9393            }
9394            if ((mPrivateFlags2 & VIEW_QUICK_REJECTED) == VIEW_QUICK_REJECTED) {
9395                // View was rejected last time it was drawn by its parent; this may have changed
9396                invalidateParentIfNeeded();
9397            }
9398        }
9399    }
9400
9401    /**
9402     * Hit rectangle in parent's coordinates
9403     *
9404     * @param outRect The hit rectangle of the view.
9405     */
9406    public void getHitRect(Rect outRect) {
9407        updateMatrix();
9408        final TransformationInfo info = mTransformationInfo;
9409        if (info == null || info.mMatrixIsIdentity || mAttachInfo == null) {
9410            outRect.set(mLeft, mTop, mRight, mBottom);
9411        } else {
9412            final RectF tmpRect = mAttachInfo.mTmpTransformRect;
9413            tmpRect.set(-info.mPivotX, -info.mPivotY,
9414                    getWidth() - info.mPivotX, getHeight() - info.mPivotY);
9415            info.mMatrix.mapRect(tmpRect);
9416            outRect.set((int) tmpRect.left + mLeft, (int) tmpRect.top + mTop,
9417                    (int) tmpRect.right + mLeft, (int) tmpRect.bottom + mTop);
9418        }
9419    }
9420
9421    /**
9422     * Determines whether the given point, in local coordinates is inside the view.
9423     */
9424    /*package*/ final boolean pointInView(float localX, float localY) {
9425        return localX >= 0 && localX < (mRight - mLeft)
9426                && localY >= 0 && localY < (mBottom - mTop);
9427    }
9428
9429    /**
9430     * Utility method to determine whether the given point, in local coordinates,
9431     * is inside the view, where the area of the view is expanded by the slop factor.
9432     * This method is called while processing touch-move events to determine if the event
9433     * is still within the view.
9434     */
9435    private boolean pointInView(float localX, float localY, float slop) {
9436        return localX >= -slop && localY >= -slop && localX < ((mRight - mLeft) + slop) &&
9437                localY < ((mBottom - mTop) + slop);
9438    }
9439
9440    /**
9441     * When a view has focus and the user navigates away from it, the next view is searched for
9442     * starting from the rectangle filled in by this method.
9443     *
9444     * By default, the rectange is the {@link #getDrawingRect(android.graphics.Rect)})
9445     * of the view.  However, if your view maintains some idea of internal selection,
9446     * such as a cursor, or a selected row or column, you should override this method and
9447     * fill in a more specific rectangle.
9448     *
9449     * @param r The rectangle to fill in, in this view's coordinates.
9450     */
9451    public void getFocusedRect(Rect r) {
9452        getDrawingRect(r);
9453    }
9454
9455    /**
9456     * If some part of this view is not clipped by any of its parents, then
9457     * return that area in r in global (root) coordinates. To convert r to local
9458     * coordinates (without taking possible View rotations into account), offset
9459     * it by -globalOffset (e.g. r.offset(-globalOffset.x, -globalOffset.y)).
9460     * If the view is completely clipped or translated out, return false.
9461     *
9462     * @param r If true is returned, r holds the global coordinates of the
9463     *        visible portion of this view.
9464     * @param globalOffset If true is returned, globalOffset holds the dx,dy
9465     *        between this view and its root. globalOffet may be null.
9466     * @return true if r is non-empty (i.e. part of the view is visible at the
9467     *         root level.
9468     */
9469    public boolean getGlobalVisibleRect(Rect r, Point globalOffset) {
9470        int width = mRight - mLeft;
9471        int height = mBottom - mTop;
9472        if (width > 0 && height > 0) {
9473            r.set(0, 0, width, height);
9474            if (globalOffset != null) {
9475                globalOffset.set(-mScrollX, -mScrollY);
9476            }
9477            return mParent == null || mParent.getChildVisibleRect(this, r, globalOffset);
9478        }
9479        return false;
9480    }
9481
9482    public final boolean getGlobalVisibleRect(Rect r) {
9483        return getGlobalVisibleRect(r, null);
9484    }
9485
9486    public final boolean getLocalVisibleRect(Rect r) {
9487        final Point offset = mAttachInfo != null ? mAttachInfo.mPoint : new Point();
9488        if (getGlobalVisibleRect(r, offset)) {
9489            r.offset(-offset.x, -offset.y); // make r local
9490            return true;
9491        }
9492        return false;
9493    }
9494
9495    /**
9496     * Offset this view's vertical location by the specified number of pixels.
9497     *
9498     * @param offset the number of pixels to offset the view by
9499     */
9500    public void offsetTopAndBottom(int offset) {
9501        if (offset != 0) {
9502            updateMatrix();
9503            final boolean matrixIsIdentity = mTransformationInfo == null
9504                    || mTransformationInfo.mMatrixIsIdentity;
9505            if (matrixIsIdentity) {
9506                if (mDisplayList != null) {
9507                    invalidateViewProperty(false, false);
9508                } else {
9509                    final ViewParent p = mParent;
9510                    if (p != null && mAttachInfo != null) {
9511                        final Rect r = mAttachInfo.mTmpInvalRect;
9512                        int minTop;
9513                        int maxBottom;
9514                        int yLoc;
9515                        if (offset < 0) {
9516                            minTop = mTop + offset;
9517                            maxBottom = mBottom;
9518                            yLoc = offset;
9519                        } else {
9520                            minTop = mTop;
9521                            maxBottom = mBottom + offset;
9522                            yLoc = 0;
9523                        }
9524                        r.set(0, yLoc, mRight - mLeft, maxBottom - minTop);
9525                        p.invalidateChild(this, r);
9526                    }
9527                }
9528            } else {
9529                invalidateViewProperty(false, false);
9530            }
9531
9532            mTop += offset;
9533            mBottom += offset;
9534            if (mDisplayList != null) {
9535                mDisplayList.offsetTopBottom(offset);
9536                invalidateViewProperty(false, false);
9537            } else {
9538                if (!matrixIsIdentity) {
9539                    invalidateViewProperty(false, true);
9540                }
9541                invalidateParentIfNeeded();
9542            }
9543        }
9544    }
9545
9546    /**
9547     * Offset this view's horizontal location by the specified amount of pixels.
9548     *
9549     * @param offset the numer of pixels to offset the view by
9550     */
9551    public void offsetLeftAndRight(int offset) {
9552        if (offset != 0) {
9553            updateMatrix();
9554            final boolean matrixIsIdentity = mTransformationInfo == null
9555                    || mTransformationInfo.mMatrixIsIdentity;
9556            if (matrixIsIdentity) {
9557                if (mDisplayList != null) {
9558                    invalidateViewProperty(false, false);
9559                } else {
9560                    final ViewParent p = mParent;
9561                    if (p != null && mAttachInfo != null) {
9562                        final Rect r = mAttachInfo.mTmpInvalRect;
9563                        int minLeft;
9564                        int maxRight;
9565                        if (offset < 0) {
9566                            minLeft = mLeft + offset;
9567                            maxRight = mRight;
9568                        } else {
9569                            minLeft = mLeft;
9570                            maxRight = mRight + offset;
9571                        }
9572                        r.set(0, 0, maxRight - minLeft, mBottom - mTop);
9573                        p.invalidateChild(this, r);
9574                    }
9575                }
9576            } else {
9577                invalidateViewProperty(false, false);
9578            }
9579
9580            mLeft += offset;
9581            mRight += offset;
9582            if (mDisplayList != null) {
9583                mDisplayList.offsetLeftRight(offset);
9584                invalidateViewProperty(false, false);
9585            } else {
9586                if (!matrixIsIdentity) {
9587                    invalidateViewProperty(false, true);
9588                }
9589                invalidateParentIfNeeded();
9590            }
9591        }
9592    }
9593
9594    /**
9595     * Get the LayoutParams associated with this view. All views should have
9596     * layout parameters. These supply parameters to the <i>parent</i> of this
9597     * view specifying how it should be arranged. There are many subclasses of
9598     * ViewGroup.LayoutParams, and these correspond to the different subclasses
9599     * of ViewGroup that are responsible for arranging their children.
9600     *
9601     * This method may return null if this View is not attached to a parent
9602     * ViewGroup or {@link #setLayoutParams(android.view.ViewGroup.LayoutParams)}
9603     * was not invoked successfully. When a View is attached to a parent
9604     * ViewGroup, this method must not return null.
9605     *
9606     * @return The LayoutParams associated with this view, or null if no
9607     *         parameters have been set yet
9608     */
9609    @ViewDebug.ExportedProperty(deepExport = true, prefix = "layout_")
9610    public ViewGroup.LayoutParams getLayoutParams() {
9611        return mLayoutParams;
9612    }
9613
9614    /**
9615     * Set the layout parameters associated with this view. These supply
9616     * parameters to the <i>parent</i> of this view specifying how it should be
9617     * arranged. There are many subclasses of ViewGroup.LayoutParams, and these
9618     * correspond to the different subclasses of ViewGroup that are responsible
9619     * for arranging their children.
9620     *
9621     * @param params The layout parameters for this view, cannot be null
9622     */
9623    public void setLayoutParams(ViewGroup.LayoutParams params) {
9624        if (params == null) {
9625            throw new NullPointerException("Layout parameters cannot be null");
9626        }
9627        mLayoutParams = params;
9628        if (mParent instanceof ViewGroup) {
9629            ((ViewGroup) mParent).onSetLayoutParams(this, params);
9630        }
9631        requestLayout();
9632    }
9633
9634    /**
9635     * Set the scrolled position of your view. This will cause a call to
9636     * {@link #onScrollChanged(int, int, int, int)} and the view will be
9637     * invalidated.
9638     * @param x the x position to scroll to
9639     * @param y the y position to scroll to
9640     */
9641    public void scrollTo(int x, int y) {
9642        if (mScrollX != x || mScrollY != y) {
9643            int oldX = mScrollX;
9644            int oldY = mScrollY;
9645            mScrollX = x;
9646            mScrollY = y;
9647            invalidateParentCaches();
9648            onScrollChanged(mScrollX, mScrollY, oldX, oldY);
9649            if (!awakenScrollBars()) {
9650                postInvalidateOnAnimation();
9651            }
9652        }
9653    }
9654
9655    /**
9656     * Move the scrolled position of your view. This will cause a call to
9657     * {@link #onScrollChanged(int, int, int, int)} and the view will be
9658     * invalidated.
9659     * @param x the amount of pixels to scroll by horizontally
9660     * @param y the amount of pixels to scroll by vertically
9661     */
9662    public void scrollBy(int x, int y) {
9663        scrollTo(mScrollX + x, mScrollY + y);
9664    }
9665
9666    /**
9667     * <p>Trigger the scrollbars to draw. When invoked this method starts an
9668     * animation to fade the scrollbars out after a default delay. If a subclass
9669     * provides animated scrolling, the start delay should equal the duration
9670     * of the scrolling animation.</p>
9671     *
9672     * <p>The animation starts only if at least one of the scrollbars is
9673     * enabled, as specified by {@link #isHorizontalScrollBarEnabled()} and
9674     * {@link #isVerticalScrollBarEnabled()}. When the animation is started,
9675     * this method returns true, and false otherwise. If the animation is
9676     * started, this method calls {@link #invalidate()}; in that case the
9677     * caller should not call {@link #invalidate()}.</p>
9678     *
9679     * <p>This method should be invoked every time a subclass directly updates
9680     * the scroll parameters.</p>
9681     *
9682     * <p>This method is automatically invoked by {@link #scrollBy(int, int)}
9683     * and {@link #scrollTo(int, int)}.</p>
9684     *
9685     * @return true if the animation is played, false otherwise
9686     *
9687     * @see #awakenScrollBars(int)
9688     * @see #scrollBy(int, int)
9689     * @see #scrollTo(int, int)
9690     * @see #isHorizontalScrollBarEnabled()
9691     * @see #isVerticalScrollBarEnabled()
9692     * @see #setHorizontalScrollBarEnabled(boolean)
9693     * @see #setVerticalScrollBarEnabled(boolean)
9694     */
9695    protected boolean awakenScrollBars() {
9696        return mScrollCache != null &&
9697                awakenScrollBars(mScrollCache.scrollBarDefaultDelayBeforeFade, true);
9698    }
9699
9700    /**
9701     * Trigger the scrollbars to draw.
9702     * This method differs from awakenScrollBars() only in its default duration.
9703     * initialAwakenScrollBars() will show the scroll bars for longer than
9704     * usual to give the user more of a chance to notice them.
9705     *
9706     * @return true if the animation is played, false otherwise.
9707     */
9708    private boolean initialAwakenScrollBars() {
9709        return mScrollCache != null &&
9710                awakenScrollBars(mScrollCache.scrollBarDefaultDelayBeforeFade * 4, true);
9711    }
9712
9713    /**
9714     * <p>
9715     * Trigger the scrollbars to draw. When invoked this method starts an
9716     * animation to fade the scrollbars out after a fixed delay. If a subclass
9717     * provides animated scrolling, the start delay should equal the duration of
9718     * the scrolling animation.
9719     * </p>
9720     *
9721     * <p>
9722     * The animation starts only if at least one of the scrollbars is enabled,
9723     * as specified by {@link #isHorizontalScrollBarEnabled()} and
9724     * {@link #isVerticalScrollBarEnabled()}. When the animation is started,
9725     * this method returns true, and false otherwise. If the animation is
9726     * started, this method calls {@link #invalidate()}; in that case the caller
9727     * should not call {@link #invalidate()}.
9728     * </p>
9729     *
9730     * <p>
9731     * This method should be invoked everytime a subclass directly updates the
9732     * scroll parameters.
9733     * </p>
9734     *
9735     * @param startDelay the delay, in milliseconds, after which the animation
9736     *        should start; when the delay is 0, the animation starts
9737     *        immediately
9738     * @return true if the animation is played, false otherwise
9739     *
9740     * @see #scrollBy(int, int)
9741     * @see #scrollTo(int, int)
9742     * @see #isHorizontalScrollBarEnabled()
9743     * @see #isVerticalScrollBarEnabled()
9744     * @see #setHorizontalScrollBarEnabled(boolean)
9745     * @see #setVerticalScrollBarEnabled(boolean)
9746     */
9747    protected boolean awakenScrollBars(int startDelay) {
9748        return awakenScrollBars(startDelay, true);
9749    }
9750
9751    /**
9752     * <p>
9753     * Trigger the scrollbars to draw. When invoked this method starts an
9754     * animation to fade the scrollbars out after a fixed delay. If a subclass
9755     * provides animated scrolling, the start delay should equal the duration of
9756     * the scrolling animation.
9757     * </p>
9758     *
9759     * <p>
9760     * The animation starts only if at least one of the scrollbars is enabled,
9761     * as specified by {@link #isHorizontalScrollBarEnabled()} and
9762     * {@link #isVerticalScrollBarEnabled()}. When the animation is started,
9763     * this method returns true, and false otherwise. If the animation is
9764     * started, this method calls {@link #invalidate()} if the invalidate parameter
9765     * is set to true; in that case the caller
9766     * should not call {@link #invalidate()}.
9767     * </p>
9768     *
9769     * <p>
9770     * This method should be invoked everytime a subclass directly updates the
9771     * scroll parameters.
9772     * </p>
9773     *
9774     * @param startDelay the delay, in milliseconds, after which the animation
9775     *        should start; when the delay is 0, the animation starts
9776     *        immediately
9777     *
9778     * @param invalidate Wheter this method should call invalidate
9779     *
9780     * @return true if the animation is played, false otherwise
9781     *
9782     * @see #scrollBy(int, int)
9783     * @see #scrollTo(int, int)
9784     * @see #isHorizontalScrollBarEnabled()
9785     * @see #isVerticalScrollBarEnabled()
9786     * @see #setHorizontalScrollBarEnabled(boolean)
9787     * @see #setVerticalScrollBarEnabled(boolean)
9788     */
9789    protected boolean awakenScrollBars(int startDelay, boolean invalidate) {
9790        final ScrollabilityCache scrollCache = mScrollCache;
9791
9792        if (scrollCache == null || !scrollCache.fadeScrollBars) {
9793            return false;
9794        }
9795
9796        if (scrollCache.scrollBar == null) {
9797            scrollCache.scrollBar = new ScrollBarDrawable();
9798        }
9799
9800        if (isHorizontalScrollBarEnabled() || isVerticalScrollBarEnabled()) {
9801
9802            if (invalidate) {
9803                // Invalidate to show the scrollbars
9804                postInvalidateOnAnimation();
9805            }
9806
9807            if (scrollCache.state == ScrollabilityCache.OFF) {
9808                // FIXME: this is copied from WindowManagerService.
9809                // We should get this value from the system when it
9810                // is possible to do so.
9811                final int KEY_REPEAT_FIRST_DELAY = 750;
9812                startDelay = Math.max(KEY_REPEAT_FIRST_DELAY, startDelay);
9813            }
9814
9815            // Tell mScrollCache when we should start fading. This may
9816            // extend the fade start time if one was already scheduled
9817            long fadeStartTime = AnimationUtils.currentAnimationTimeMillis() + startDelay;
9818            scrollCache.fadeStartTime = fadeStartTime;
9819            scrollCache.state = ScrollabilityCache.ON;
9820
9821            // Schedule our fader to run, unscheduling any old ones first
9822            if (mAttachInfo != null) {
9823                mAttachInfo.mHandler.removeCallbacks(scrollCache);
9824                mAttachInfo.mHandler.postAtTime(scrollCache, fadeStartTime);
9825            }
9826
9827            return true;
9828        }
9829
9830        return false;
9831    }
9832
9833    /**
9834     * Do not invalidate views which are not visible and which are not running an animation. They
9835     * will not get drawn and they should not set dirty flags as if they will be drawn
9836     */
9837    private boolean skipInvalidate() {
9838        return (mViewFlags & VISIBILITY_MASK) != VISIBLE && mCurrentAnimation == null &&
9839                (!(mParent instanceof ViewGroup) ||
9840                        !((ViewGroup) mParent).isViewTransitioning(this));
9841    }
9842    /**
9843     * Mark the area defined by dirty as needing to be drawn. If the view is
9844     * visible, {@link #onDraw(android.graphics.Canvas)} will be called at some point
9845     * in the future. This must be called from a UI thread. To call from a non-UI
9846     * thread, call {@link #postInvalidate()}.
9847     *
9848     * WARNING: This method is destructive to dirty.
9849     * @param dirty the rectangle representing the bounds of the dirty region
9850     */
9851    public void invalidate(Rect dirty) {
9852        if (ViewDebug.TRACE_HIERARCHY) {
9853            ViewDebug.trace(this, ViewDebug.HierarchyTraceType.INVALIDATE);
9854        }
9855
9856        if (skipInvalidate()) {
9857            return;
9858        }
9859        if ((mPrivateFlags & (DRAWN | HAS_BOUNDS)) == (DRAWN | HAS_BOUNDS) ||
9860                (mPrivateFlags & DRAWING_CACHE_VALID) == DRAWING_CACHE_VALID ||
9861                (mPrivateFlags & INVALIDATED) != INVALIDATED) {
9862            mPrivateFlags &= ~DRAWING_CACHE_VALID;
9863            mPrivateFlags |= INVALIDATED;
9864            mPrivateFlags |= DIRTY;
9865            final ViewParent p = mParent;
9866            final AttachInfo ai = mAttachInfo;
9867            //noinspection PointlessBooleanExpression,ConstantConditions
9868            if (!HardwareRenderer.RENDER_DIRTY_REGIONS) {
9869                if (p != null && ai != null && ai.mHardwareAccelerated) {
9870                    // fast-track for GL-enabled applications; just invalidate the whole hierarchy
9871                    // with a null dirty rect, which tells the ViewAncestor to redraw everything
9872                    p.invalidateChild(this, null);
9873                    return;
9874                }
9875            }
9876            if (p != null && ai != null) {
9877                final int scrollX = mScrollX;
9878                final int scrollY = mScrollY;
9879                final Rect r = ai.mTmpInvalRect;
9880                r.set(dirty.left - scrollX, dirty.top - scrollY,
9881                        dirty.right - scrollX, dirty.bottom - scrollY);
9882                mParent.invalidateChild(this, r);
9883            }
9884        }
9885    }
9886
9887    /**
9888     * Mark the area defined by the rect (l,t,r,b) as needing to be drawn.
9889     * The coordinates of the dirty rect are relative to the view.
9890     * If the view is visible, {@link #onDraw(android.graphics.Canvas)}
9891     * will be called at some point in the future. This must be called from
9892     * a UI thread. To call from a non-UI thread, call {@link #postInvalidate()}.
9893     * @param l the left position of the dirty region
9894     * @param t the top position of the dirty region
9895     * @param r the right position of the dirty region
9896     * @param b the bottom position of the dirty region
9897     */
9898    public void invalidate(int l, int t, int r, int b) {
9899        if (ViewDebug.TRACE_HIERARCHY) {
9900            ViewDebug.trace(this, ViewDebug.HierarchyTraceType.INVALIDATE);
9901        }
9902
9903        if (skipInvalidate()) {
9904            return;
9905        }
9906        if ((mPrivateFlags & (DRAWN | HAS_BOUNDS)) == (DRAWN | HAS_BOUNDS) ||
9907                (mPrivateFlags & DRAWING_CACHE_VALID) == DRAWING_CACHE_VALID ||
9908                (mPrivateFlags & INVALIDATED) != INVALIDATED) {
9909            mPrivateFlags &= ~DRAWING_CACHE_VALID;
9910            mPrivateFlags |= INVALIDATED;
9911            mPrivateFlags |= DIRTY;
9912            final ViewParent p = mParent;
9913            final AttachInfo ai = mAttachInfo;
9914            //noinspection PointlessBooleanExpression,ConstantConditions
9915            if (!HardwareRenderer.RENDER_DIRTY_REGIONS) {
9916                if (p != null && ai != null && ai.mHardwareAccelerated) {
9917                    // fast-track for GL-enabled applications; just invalidate the whole hierarchy
9918                    // with a null dirty rect, which tells the ViewAncestor to redraw everything
9919                    p.invalidateChild(this, null);
9920                    return;
9921                }
9922            }
9923            if (p != null && ai != null && l < r && t < b) {
9924                final int scrollX = mScrollX;
9925                final int scrollY = mScrollY;
9926                final Rect tmpr = ai.mTmpInvalRect;
9927                tmpr.set(l - scrollX, t - scrollY, r - scrollX, b - scrollY);
9928                p.invalidateChild(this, tmpr);
9929            }
9930        }
9931    }
9932
9933    /**
9934     * Invalidate the whole view. If the view is visible,
9935     * {@link #onDraw(android.graphics.Canvas)} will be called at some point in
9936     * the future. This must be called from a UI thread. To call from a non-UI thread,
9937     * call {@link #postInvalidate()}.
9938     */
9939    public void invalidate() {
9940        invalidate(true);
9941    }
9942
9943    /**
9944     * This is where the invalidate() work actually happens. A full invalidate()
9945     * causes the drawing cache to be invalidated, but this function can be called with
9946     * invalidateCache set to false to skip that invalidation step for cases that do not
9947     * need it (for example, a component that remains at the same dimensions with the same
9948     * content).
9949     *
9950     * @param invalidateCache Whether the drawing cache for this view should be invalidated as
9951     * well. This is usually true for a full invalidate, but may be set to false if the
9952     * View's contents or dimensions have not changed.
9953     */
9954    void invalidate(boolean invalidateCache) {
9955        if (ViewDebug.TRACE_HIERARCHY) {
9956            ViewDebug.trace(this, ViewDebug.HierarchyTraceType.INVALIDATE);
9957        }
9958
9959        if (skipInvalidate()) {
9960            return;
9961        }
9962        if ((mPrivateFlags & (DRAWN | HAS_BOUNDS)) == (DRAWN | HAS_BOUNDS) ||
9963                (invalidateCache && (mPrivateFlags & DRAWING_CACHE_VALID) == DRAWING_CACHE_VALID) ||
9964                (mPrivateFlags & INVALIDATED) != INVALIDATED || isOpaque() != mLastIsOpaque) {
9965            mLastIsOpaque = isOpaque();
9966            mPrivateFlags &= ~DRAWN;
9967            mPrivateFlags |= DIRTY;
9968            if (invalidateCache) {
9969                mPrivateFlags |= INVALIDATED;
9970                mPrivateFlags &= ~DRAWING_CACHE_VALID;
9971            }
9972            final AttachInfo ai = mAttachInfo;
9973            final ViewParent p = mParent;
9974            //noinspection PointlessBooleanExpression,ConstantConditions
9975            if (!HardwareRenderer.RENDER_DIRTY_REGIONS) {
9976                if (p != null && ai != null && ai.mHardwareAccelerated) {
9977                    // fast-track for GL-enabled applications; just invalidate the whole hierarchy
9978                    // with a null dirty rect, which tells the ViewAncestor to redraw everything
9979                    p.invalidateChild(this, null);
9980                    return;
9981                }
9982            }
9983
9984            if (p != null && ai != null) {
9985                final Rect r = ai.mTmpInvalRect;
9986                r.set(0, 0, mRight - mLeft, mBottom - mTop);
9987                // Don't call invalidate -- we don't want to internally scroll
9988                // our own bounds
9989                p.invalidateChild(this, r);
9990            }
9991        }
9992    }
9993
9994    /**
9995     * Quick invalidation for View property changes (alpha, translationXY, etc.). We don't want to
9996     * set any flags or handle all of the cases handled by the default invalidation methods.
9997     * Instead, we just want to schedule a traversal in ViewRootImpl with the appropriate
9998     * dirty rect. This method calls into fast invalidation methods in ViewGroup that
9999     * walk up the hierarchy, transforming the dirty rect as necessary.
10000     *
10001     * The method also handles normal invalidation logic if display list properties are not
10002     * being used in this view. The invalidateParent and forceRedraw flags are used by that
10003     * backup approach, to handle these cases used in the various property-setting methods.
10004     *
10005     * @param invalidateParent Force a call to invalidateParentCaches() if display list properties
10006     * are not being used in this view
10007     * @param forceRedraw Mark the view as DRAWN to force the invalidation to propagate, if display
10008     * list properties are not being used in this view
10009     */
10010    void invalidateViewProperty(boolean invalidateParent, boolean forceRedraw) {
10011        if (mDisplayList == null || (mPrivateFlags & DRAW_ANIMATION) == DRAW_ANIMATION) {
10012            if (invalidateParent) {
10013                invalidateParentCaches();
10014            }
10015            if (forceRedraw) {
10016                mPrivateFlags |= DRAWN; // force another invalidation with the new orientation
10017            }
10018            invalidate(false);
10019        } else {
10020            final AttachInfo ai = mAttachInfo;
10021            final ViewParent p = mParent;
10022            if (p != null && ai != null) {
10023                final Rect r = ai.mTmpInvalRect;
10024                r.set(0, 0, mRight - mLeft, mBottom - mTop);
10025                if (mParent instanceof ViewGroup) {
10026                    ((ViewGroup) mParent).invalidateChildFast(this, r);
10027                } else {
10028                    mParent.invalidateChild(this, r);
10029                }
10030            }
10031        }
10032    }
10033
10034    /**
10035     * Utility method to transform a given Rect by the current matrix of this view.
10036     */
10037    void transformRect(final Rect rect) {
10038        if (!getMatrix().isIdentity()) {
10039            RectF boundingRect = mAttachInfo.mTmpTransformRect;
10040            boundingRect.set(rect);
10041            getMatrix().mapRect(boundingRect);
10042            rect.set((int) (boundingRect.left - 0.5f),
10043                    (int) (boundingRect.top - 0.5f),
10044                    (int) (boundingRect.right + 0.5f),
10045                    (int) (boundingRect.bottom + 0.5f));
10046        }
10047    }
10048
10049    /**
10050     * Used to indicate that the parent of this view should clear its caches. This functionality
10051     * is used to force the parent to rebuild its display list (when hardware-accelerated),
10052     * which is necessary when various parent-managed properties of the view change, such as
10053     * alpha, translationX/Y, scrollX/Y, scaleX/Y, and rotation/X/Y. This method only
10054     * clears the parent caches and does not causes an invalidate event.
10055     *
10056     * @hide
10057     */
10058    protected void invalidateParentCaches() {
10059        if (mParent instanceof View) {
10060            ((View) mParent).mPrivateFlags |= INVALIDATED;
10061        }
10062    }
10063
10064    /**
10065     * Used to indicate that the parent of this view should be invalidated. This functionality
10066     * is used to force the parent to rebuild its display list (when hardware-accelerated),
10067     * which is necessary when various parent-managed properties of the view change, such as
10068     * alpha, translationX/Y, scrollX/Y, scaleX/Y, and rotation/X/Y. This method will propagate
10069     * an invalidation event to the parent.
10070     *
10071     * @hide
10072     */
10073    protected void invalidateParentIfNeeded() {
10074        if (isHardwareAccelerated() && mParent instanceof View) {
10075            ((View) mParent).invalidate(true);
10076        }
10077    }
10078
10079    /**
10080     * Indicates whether this View is opaque. An opaque View guarantees that it will
10081     * draw all the pixels overlapping its bounds using a fully opaque color.
10082     *
10083     * Subclasses of View should override this method whenever possible to indicate
10084     * whether an instance is opaque. Opaque Views are treated in a special way by
10085     * the View hierarchy, possibly allowing it to perform optimizations during
10086     * invalidate/draw passes.
10087     *
10088     * @return True if this View is guaranteed to be fully opaque, false otherwise.
10089     */
10090    @ViewDebug.ExportedProperty(category = "drawing")
10091    public boolean isOpaque() {
10092        return (mPrivateFlags & OPAQUE_MASK) == OPAQUE_MASK &&
10093                ((mTransformationInfo != null ? mTransformationInfo.mAlpha : 1)
10094                        >= 1.0f - ViewConfiguration.ALPHA_THRESHOLD);
10095    }
10096
10097    /**
10098     * @hide
10099     */
10100    protected void computeOpaqueFlags() {
10101        // Opaque if:
10102        //   - Has a background
10103        //   - Background is opaque
10104        //   - Doesn't have scrollbars or scrollbars are inside overlay
10105
10106        if (mBackground != null && mBackground.getOpacity() == PixelFormat.OPAQUE) {
10107            mPrivateFlags |= OPAQUE_BACKGROUND;
10108        } else {
10109            mPrivateFlags &= ~OPAQUE_BACKGROUND;
10110        }
10111
10112        final int flags = mViewFlags;
10113        if (((flags & SCROLLBARS_VERTICAL) == 0 && (flags & SCROLLBARS_HORIZONTAL) == 0) ||
10114                (flags & SCROLLBARS_STYLE_MASK) == SCROLLBARS_INSIDE_OVERLAY) {
10115            mPrivateFlags |= OPAQUE_SCROLLBARS;
10116        } else {
10117            mPrivateFlags &= ~OPAQUE_SCROLLBARS;
10118        }
10119    }
10120
10121    /**
10122     * @hide
10123     */
10124    protected boolean hasOpaqueScrollbars() {
10125        return (mPrivateFlags & OPAQUE_SCROLLBARS) == OPAQUE_SCROLLBARS;
10126    }
10127
10128    /**
10129     * @return A handler associated with the thread running the View. This
10130     * handler can be used to pump events in the UI events queue.
10131     */
10132    public Handler getHandler() {
10133        if (mAttachInfo != null) {
10134            return mAttachInfo.mHandler;
10135        }
10136        return null;
10137    }
10138
10139    /**
10140     * Gets the view root associated with the View.
10141     * @return The view root, or null if none.
10142     * @hide
10143     */
10144    public ViewRootImpl getViewRootImpl() {
10145        if (mAttachInfo != null) {
10146            return mAttachInfo.mViewRootImpl;
10147        }
10148        return null;
10149    }
10150
10151    /**
10152     * <p>Causes the Runnable to be added to the message queue.
10153     * The runnable will be run on the user interface thread.</p>
10154     *
10155     * <p>This method can be invoked from outside of the UI thread
10156     * only when this View is attached to a window.</p>
10157     *
10158     * @param action The Runnable that will be executed.
10159     *
10160     * @return Returns true if the Runnable was successfully placed in to the
10161     *         message queue.  Returns false on failure, usually because the
10162     *         looper processing the message queue is exiting.
10163     *
10164     * @see #postDelayed
10165     * @see #removeCallbacks
10166     */
10167    public boolean post(Runnable action) {
10168        final AttachInfo attachInfo = mAttachInfo;
10169        if (attachInfo != null) {
10170            return attachInfo.mHandler.post(action);
10171        }
10172        // Assume that post will succeed later
10173        ViewRootImpl.getRunQueue().post(action);
10174        return true;
10175    }
10176
10177    /**
10178     * <p>Causes the Runnable to be added to the message queue, to be run
10179     * after the specified amount of time elapses.
10180     * The runnable will be run on the user interface thread.</p>
10181     *
10182     * <p>This method can be invoked from outside of the UI thread
10183     * only when this View is attached to a window.</p>
10184     *
10185     * @param action The Runnable that will be executed.
10186     * @param delayMillis The delay (in milliseconds) until the Runnable
10187     *        will be executed.
10188     *
10189     * @return true if the Runnable was successfully placed in to the
10190     *         message queue.  Returns false on failure, usually because the
10191     *         looper processing the message queue is exiting.  Note that a
10192     *         result of true does not mean the Runnable will be processed --
10193     *         if the looper is quit before the delivery time of the message
10194     *         occurs then the message will be dropped.
10195     *
10196     * @see #post
10197     * @see #removeCallbacks
10198     */
10199    public boolean postDelayed(Runnable action, long delayMillis) {
10200        final AttachInfo attachInfo = mAttachInfo;
10201        if (attachInfo != null) {
10202            return attachInfo.mHandler.postDelayed(action, delayMillis);
10203        }
10204        // Assume that post will succeed later
10205        ViewRootImpl.getRunQueue().postDelayed(action, delayMillis);
10206        return true;
10207    }
10208
10209    /**
10210     * <p>Causes the Runnable to execute on the next animation time step.
10211     * The runnable will be run on the user interface thread.</p>
10212     *
10213     * <p>This method can be invoked from outside of the UI thread
10214     * only when this View is attached to a window.</p>
10215     *
10216     * @param action The Runnable that will be executed.
10217     *
10218     * @see #postOnAnimationDelayed
10219     * @see #removeCallbacks
10220     */
10221    public void postOnAnimation(Runnable action) {
10222        final AttachInfo attachInfo = mAttachInfo;
10223        if (attachInfo != null) {
10224            attachInfo.mViewRootImpl.mChoreographer.postCallback(
10225                    Choreographer.CALLBACK_ANIMATION, action, null);
10226        } else {
10227            // Assume that post will succeed later
10228            ViewRootImpl.getRunQueue().post(action);
10229        }
10230    }
10231
10232    /**
10233     * <p>Causes the Runnable to execute on the next animation time step,
10234     * after the specified amount of time elapses.
10235     * The runnable will be run on the user interface thread.</p>
10236     *
10237     * <p>This method can be invoked from outside of the UI thread
10238     * only when this View is attached to a window.</p>
10239     *
10240     * @param action The Runnable that will be executed.
10241     * @param delayMillis The delay (in milliseconds) until the Runnable
10242     *        will be executed.
10243     *
10244     * @see #postOnAnimation
10245     * @see #removeCallbacks
10246     */
10247    public void postOnAnimationDelayed(Runnable action, long delayMillis) {
10248        final AttachInfo attachInfo = mAttachInfo;
10249        if (attachInfo != null) {
10250            attachInfo.mViewRootImpl.mChoreographer.postCallbackDelayed(
10251                    Choreographer.CALLBACK_ANIMATION, action, null, delayMillis);
10252        } else {
10253            // Assume that post will succeed later
10254            ViewRootImpl.getRunQueue().postDelayed(action, delayMillis);
10255        }
10256    }
10257
10258    /**
10259     * <p>Removes the specified Runnable from the message queue.</p>
10260     *
10261     * <p>This method can be invoked from outside of the UI thread
10262     * only when this View is attached to a window.</p>
10263     *
10264     * @param action The Runnable to remove from the message handling queue
10265     *
10266     * @return true if this view could ask the Handler to remove the Runnable,
10267     *         false otherwise. When the returned value is true, the Runnable
10268     *         may or may not have been actually removed from the message queue
10269     *         (for instance, if the Runnable was not in the queue already.)
10270     *
10271     * @see #post
10272     * @see #postDelayed
10273     * @see #postOnAnimation
10274     * @see #postOnAnimationDelayed
10275     */
10276    public boolean removeCallbacks(Runnable action) {
10277        if (action != null) {
10278            final AttachInfo attachInfo = mAttachInfo;
10279            if (attachInfo != null) {
10280                attachInfo.mHandler.removeCallbacks(action);
10281                attachInfo.mViewRootImpl.mChoreographer.removeCallbacks(
10282                        Choreographer.CALLBACK_ANIMATION, action, null);
10283            } else {
10284                // Assume that post will succeed later
10285                ViewRootImpl.getRunQueue().removeCallbacks(action);
10286            }
10287        }
10288        return true;
10289    }
10290
10291    /**
10292     * <p>Cause an invalidate to happen on a subsequent cycle through the event loop.
10293     * Use this to invalidate the View from a non-UI thread.</p>
10294     *
10295     * <p>This method can be invoked from outside of the UI thread
10296     * only when this View is attached to a window.</p>
10297     *
10298     * @see #invalidate()
10299     * @see #postInvalidateDelayed(long)
10300     */
10301    public void postInvalidate() {
10302        postInvalidateDelayed(0);
10303    }
10304
10305    /**
10306     * <p>Cause an invalidate of the specified area to happen on a subsequent cycle
10307     * through the event loop. Use this to invalidate the View from a non-UI thread.</p>
10308     *
10309     * <p>This method can be invoked from outside of the UI thread
10310     * only when this View is attached to a window.</p>
10311     *
10312     * @param left The left coordinate of the rectangle to invalidate.
10313     * @param top The top coordinate of the rectangle to invalidate.
10314     * @param right The right coordinate of the rectangle to invalidate.
10315     * @param bottom The bottom coordinate of the rectangle to invalidate.
10316     *
10317     * @see #invalidate(int, int, int, int)
10318     * @see #invalidate(Rect)
10319     * @see #postInvalidateDelayed(long, int, int, int, int)
10320     */
10321    public void postInvalidate(int left, int top, int right, int bottom) {
10322        postInvalidateDelayed(0, left, top, right, bottom);
10323    }
10324
10325    /**
10326     * <p>Cause an invalidate to happen on a subsequent cycle through the event
10327     * loop. Waits for the specified amount of time.</p>
10328     *
10329     * <p>This method can be invoked from outside of the UI thread
10330     * only when this View is attached to a window.</p>
10331     *
10332     * @param delayMilliseconds the duration in milliseconds to delay the
10333     *         invalidation by
10334     *
10335     * @see #invalidate()
10336     * @see #postInvalidate()
10337     */
10338    public void postInvalidateDelayed(long delayMilliseconds) {
10339        // We try only with the AttachInfo because there's no point in invalidating
10340        // if we are not attached to our window
10341        final AttachInfo attachInfo = mAttachInfo;
10342        if (attachInfo != null) {
10343            attachInfo.mViewRootImpl.dispatchInvalidateDelayed(this, delayMilliseconds);
10344        }
10345    }
10346
10347    /**
10348     * <p>Cause an invalidate of the specified area to happen on a subsequent cycle
10349     * through the event loop. Waits for the specified amount of time.</p>
10350     *
10351     * <p>This method can be invoked from outside of the UI thread
10352     * only when this View is attached to a window.</p>
10353     *
10354     * @param delayMilliseconds the duration in milliseconds to delay the
10355     *         invalidation by
10356     * @param left The left coordinate of the rectangle to invalidate.
10357     * @param top The top coordinate of the rectangle to invalidate.
10358     * @param right The right coordinate of the rectangle to invalidate.
10359     * @param bottom The bottom coordinate of the rectangle to invalidate.
10360     *
10361     * @see #invalidate(int, int, int, int)
10362     * @see #invalidate(Rect)
10363     * @see #postInvalidate(int, int, int, int)
10364     */
10365    public void postInvalidateDelayed(long delayMilliseconds, int left, int top,
10366            int right, int bottom) {
10367
10368        // We try only with the AttachInfo because there's no point in invalidating
10369        // if we are not attached to our window
10370        final AttachInfo attachInfo = mAttachInfo;
10371        if (attachInfo != null) {
10372            final AttachInfo.InvalidateInfo info = AttachInfo.InvalidateInfo.acquire();
10373            info.target = this;
10374            info.left = left;
10375            info.top = top;
10376            info.right = right;
10377            info.bottom = bottom;
10378
10379            attachInfo.mViewRootImpl.dispatchInvalidateRectDelayed(info, delayMilliseconds);
10380        }
10381    }
10382
10383    /**
10384     * <p>Cause an invalidate to happen on the next animation time step, typically the
10385     * next display frame.</p>
10386     *
10387     * <p>This method can be invoked from outside of the UI thread
10388     * only when this View is attached to a window.</p>
10389     *
10390     * @see #invalidate()
10391     */
10392    public void postInvalidateOnAnimation() {
10393        // We try only with the AttachInfo because there's no point in invalidating
10394        // if we are not attached to our window
10395        final AttachInfo attachInfo = mAttachInfo;
10396        if (attachInfo != null) {
10397            attachInfo.mViewRootImpl.dispatchInvalidateOnAnimation(this);
10398        }
10399    }
10400
10401    /**
10402     * <p>Cause an invalidate of the specified area to happen on the next animation
10403     * time step, typically the next display frame.</p>
10404     *
10405     * <p>This method can be invoked from outside of the UI thread
10406     * only when this View is attached to a window.</p>
10407     *
10408     * @param left The left coordinate of the rectangle to invalidate.
10409     * @param top The top coordinate of the rectangle to invalidate.
10410     * @param right The right coordinate of the rectangle to invalidate.
10411     * @param bottom The bottom coordinate of the rectangle to invalidate.
10412     *
10413     * @see #invalidate(int, int, int, int)
10414     * @see #invalidate(Rect)
10415     */
10416    public void postInvalidateOnAnimation(int left, int top, int right, int bottom) {
10417        // We try only with the AttachInfo because there's no point in invalidating
10418        // if we are not attached to our window
10419        final AttachInfo attachInfo = mAttachInfo;
10420        if (attachInfo != null) {
10421            final AttachInfo.InvalidateInfo info = AttachInfo.InvalidateInfo.acquire();
10422            info.target = this;
10423            info.left = left;
10424            info.top = top;
10425            info.right = right;
10426            info.bottom = bottom;
10427
10428            attachInfo.mViewRootImpl.dispatchInvalidateRectOnAnimation(info);
10429        }
10430    }
10431
10432    /**
10433     * Post a callback to send a {@link AccessibilityEvent#TYPE_VIEW_SCROLLED} event.
10434     * This event is sent at most once every
10435     * {@link ViewConfiguration#getSendRecurringAccessibilityEventsInterval()}.
10436     */
10437    private void postSendViewScrolledAccessibilityEventCallback() {
10438        if (mSendViewScrolledAccessibilityEvent == null) {
10439            mSendViewScrolledAccessibilityEvent = new SendViewScrolledAccessibilityEvent();
10440        }
10441        if (!mSendViewScrolledAccessibilityEvent.mIsPending) {
10442            mSendViewScrolledAccessibilityEvent.mIsPending = true;
10443            postDelayed(mSendViewScrolledAccessibilityEvent,
10444                    ViewConfiguration.getSendRecurringAccessibilityEventsInterval());
10445        }
10446    }
10447
10448    /**
10449     * Called by a parent to request that a child update its values for mScrollX
10450     * and mScrollY if necessary. This will typically be done if the child is
10451     * animating a scroll using a {@link android.widget.Scroller Scroller}
10452     * object.
10453     */
10454    public void computeScroll() {
10455    }
10456
10457    /**
10458     * <p>Indicate whether the horizontal edges are faded when the view is
10459     * scrolled horizontally.</p>
10460     *
10461     * @return true if the horizontal edges should are faded on scroll, false
10462     *         otherwise
10463     *
10464     * @see #setHorizontalFadingEdgeEnabled(boolean)
10465     *
10466     * @attr ref android.R.styleable#View_requiresFadingEdge
10467     */
10468    public boolean isHorizontalFadingEdgeEnabled() {
10469        return (mViewFlags & FADING_EDGE_HORIZONTAL) == FADING_EDGE_HORIZONTAL;
10470    }
10471
10472    /**
10473     * <p>Define whether the horizontal edges should be faded when this view
10474     * is scrolled horizontally.</p>
10475     *
10476     * @param horizontalFadingEdgeEnabled true if the horizontal edges should
10477     *                                    be faded when the view is scrolled
10478     *                                    horizontally
10479     *
10480     * @see #isHorizontalFadingEdgeEnabled()
10481     *
10482     * @attr ref android.R.styleable#View_requiresFadingEdge
10483     */
10484    public void setHorizontalFadingEdgeEnabled(boolean horizontalFadingEdgeEnabled) {
10485        if (isHorizontalFadingEdgeEnabled() != horizontalFadingEdgeEnabled) {
10486            if (horizontalFadingEdgeEnabled) {
10487                initScrollCache();
10488            }
10489
10490            mViewFlags ^= FADING_EDGE_HORIZONTAL;
10491        }
10492    }
10493
10494    /**
10495     * <p>Indicate whether the vertical edges are faded when the view is
10496     * scrolled horizontally.</p>
10497     *
10498     * @return true if the vertical edges should are faded on scroll, false
10499     *         otherwise
10500     *
10501     * @see #setVerticalFadingEdgeEnabled(boolean)
10502     *
10503     * @attr ref android.R.styleable#View_requiresFadingEdge
10504     */
10505    public boolean isVerticalFadingEdgeEnabled() {
10506        return (mViewFlags & FADING_EDGE_VERTICAL) == FADING_EDGE_VERTICAL;
10507    }
10508
10509    /**
10510     * <p>Define whether the vertical edges should be faded when this view
10511     * is scrolled vertically.</p>
10512     *
10513     * @param verticalFadingEdgeEnabled true if the vertical edges should
10514     *                                  be faded when the view is scrolled
10515     *                                  vertically
10516     *
10517     * @see #isVerticalFadingEdgeEnabled()
10518     *
10519     * @attr ref android.R.styleable#View_requiresFadingEdge
10520     */
10521    public void setVerticalFadingEdgeEnabled(boolean verticalFadingEdgeEnabled) {
10522        if (isVerticalFadingEdgeEnabled() != verticalFadingEdgeEnabled) {
10523            if (verticalFadingEdgeEnabled) {
10524                initScrollCache();
10525            }
10526
10527            mViewFlags ^= FADING_EDGE_VERTICAL;
10528        }
10529    }
10530
10531    /**
10532     * Returns the strength, or intensity, of the top faded edge. The strength is
10533     * a value between 0.0 (no fade) and 1.0 (full fade). The default implementation
10534     * returns 0.0 or 1.0 but no value in between.
10535     *
10536     * Subclasses should override this method to provide a smoother fade transition
10537     * when scrolling occurs.
10538     *
10539     * @return the intensity of the top fade as a float between 0.0f and 1.0f
10540     */
10541    protected float getTopFadingEdgeStrength() {
10542        return computeVerticalScrollOffset() > 0 ? 1.0f : 0.0f;
10543    }
10544
10545    /**
10546     * Returns the strength, or intensity, of the bottom faded edge. The strength is
10547     * a value between 0.0 (no fade) and 1.0 (full fade). The default implementation
10548     * returns 0.0 or 1.0 but no value in between.
10549     *
10550     * Subclasses should override this method to provide a smoother fade transition
10551     * when scrolling occurs.
10552     *
10553     * @return the intensity of the bottom fade as a float between 0.0f and 1.0f
10554     */
10555    protected float getBottomFadingEdgeStrength() {
10556        return computeVerticalScrollOffset() + computeVerticalScrollExtent() <
10557                computeVerticalScrollRange() ? 1.0f : 0.0f;
10558    }
10559
10560    /**
10561     * Returns the strength, or intensity, of the left faded edge. The strength is
10562     * a value between 0.0 (no fade) and 1.0 (full fade). The default implementation
10563     * returns 0.0 or 1.0 but no value in between.
10564     *
10565     * Subclasses should override this method to provide a smoother fade transition
10566     * when scrolling occurs.
10567     *
10568     * @return the intensity of the left fade as a float between 0.0f and 1.0f
10569     */
10570    protected float getLeftFadingEdgeStrength() {
10571        return computeHorizontalScrollOffset() > 0 ? 1.0f : 0.0f;
10572    }
10573
10574    /**
10575     * Returns the strength, or intensity, of the right faded edge. The strength is
10576     * a value between 0.0 (no fade) and 1.0 (full fade). The default implementation
10577     * returns 0.0 or 1.0 but no value in between.
10578     *
10579     * Subclasses should override this method to provide a smoother fade transition
10580     * when scrolling occurs.
10581     *
10582     * @return the intensity of the right fade as a float between 0.0f and 1.0f
10583     */
10584    protected float getRightFadingEdgeStrength() {
10585        return computeHorizontalScrollOffset() + computeHorizontalScrollExtent() <
10586                computeHorizontalScrollRange() ? 1.0f : 0.0f;
10587    }
10588
10589    /**
10590     * <p>Indicate whether the horizontal scrollbar should be drawn or not. The
10591     * scrollbar is not drawn by default.</p>
10592     *
10593     * @return true if the horizontal scrollbar should be painted, false
10594     *         otherwise
10595     *
10596     * @see #setHorizontalScrollBarEnabled(boolean)
10597     */
10598    public boolean isHorizontalScrollBarEnabled() {
10599        return (mViewFlags & SCROLLBARS_HORIZONTAL) == SCROLLBARS_HORIZONTAL;
10600    }
10601
10602    /**
10603     * <p>Define whether the horizontal scrollbar should be drawn or not. The
10604     * scrollbar is not drawn by default.</p>
10605     *
10606     * @param horizontalScrollBarEnabled true if the horizontal scrollbar should
10607     *                                   be painted
10608     *
10609     * @see #isHorizontalScrollBarEnabled()
10610     */
10611    public void setHorizontalScrollBarEnabled(boolean horizontalScrollBarEnabled) {
10612        if (isHorizontalScrollBarEnabled() != horizontalScrollBarEnabled) {
10613            mViewFlags ^= SCROLLBARS_HORIZONTAL;
10614            computeOpaqueFlags();
10615            resolvePadding();
10616        }
10617    }
10618
10619    /**
10620     * <p>Indicate whether the vertical scrollbar should be drawn or not. The
10621     * scrollbar is not drawn by default.</p>
10622     *
10623     * @return true if the vertical scrollbar should be painted, false
10624     *         otherwise
10625     *
10626     * @see #setVerticalScrollBarEnabled(boolean)
10627     */
10628    public boolean isVerticalScrollBarEnabled() {
10629        return (mViewFlags & SCROLLBARS_VERTICAL) == SCROLLBARS_VERTICAL;
10630    }
10631
10632    /**
10633     * <p>Define whether the vertical scrollbar should be drawn or not. The
10634     * scrollbar is not drawn by default.</p>
10635     *
10636     * @param verticalScrollBarEnabled true if the vertical scrollbar should
10637     *                                 be painted
10638     *
10639     * @see #isVerticalScrollBarEnabled()
10640     */
10641    public void setVerticalScrollBarEnabled(boolean verticalScrollBarEnabled) {
10642        if (isVerticalScrollBarEnabled() != verticalScrollBarEnabled) {
10643            mViewFlags ^= SCROLLBARS_VERTICAL;
10644            computeOpaqueFlags();
10645            resolvePadding();
10646        }
10647    }
10648
10649    /**
10650     * @hide
10651     */
10652    protected void recomputePadding() {
10653        setPadding(mUserPaddingLeft, mPaddingTop, mUserPaddingRight, mUserPaddingBottom);
10654    }
10655
10656    /**
10657     * Define whether scrollbars will fade when the view is not scrolling.
10658     *
10659     * @param fadeScrollbars wheter to enable fading
10660     *
10661     * @attr ref android.R.styleable#View_fadeScrollbars
10662     */
10663    public void setScrollbarFadingEnabled(boolean fadeScrollbars) {
10664        initScrollCache();
10665        final ScrollabilityCache scrollabilityCache = mScrollCache;
10666        scrollabilityCache.fadeScrollBars = fadeScrollbars;
10667        if (fadeScrollbars) {
10668            scrollabilityCache.state = ScrollabilityCache.OFF;
10669        } else {
10670            scrollabilityCache.state = ScrollabilityCache.ON;
10671        }
10672    }
10673
10674    /**
10675     *
10676     * Returns true if scrollbars will fade when this view is not scrolling
10677     *
10678     * @return true if scrollbar fading is enabled
10679     *
10680     * @attr ref android.R.styleable#View_fadeScrollbars
10681     */
10682    public boolean isScrollbarFadingEnabled() {
10683        return mScrollCache != null && mScrollCache.fadeScrollBars;
10684    }
10685
10686    /**
10687     *
10688     * Returns the delay before scrollbars fade.
10689     *
10690     * @return the delay before scrollbars fade
10691     *
10692     * @attr ref android.R.styleable#View_scrollbarDefaultDelayBeforeFade
10693     */
10694    public int getScrollBarDefaultDelayBeforeFade() {
10695        return mScrollCache == null ? ViewConfiguration.getScrollDefaultDelay() :
10696                mScrollCache.scrollBarDefaultDelayBeforeFade;
10697    }
10698
10699    /**
10700     * Define the delay before scrollbars fade.
10701     *
10702     * @param scrollBarDefaultDelayBeforeFade - the delay before scrollbars fade
10703     *
10704     * @attr ref android.R.styleable#View_scrollbarDefaultDelayBeforeFade
10705     */
10706    public void setScrollBarDefaultDelayBeforeFade(int scrollBarDefaultDelayBeforeFade) {
10707        getScrollCache().scrollBarDefaultDelayBeforeFade = scrollBarDefaultDelayBeforeFade;
10708    }
10709
10710    /**
10711     *
10712     * Returns the scrollbar fade duration.
10713     *
10714     * @return the scrollbar fade duration
10715     *
10716     * @attr ref android.R.styleable#View_scrollbarFadeDuration
10717     */
10718    public int getScrollBarFadeDuration() {
10719        return mScrollCache == null ? ViewConfiguration.getScrollBarFadeDuration() :
10720                mScrollCache.scrollBarFadeDuration;
10721    }
10722
10723    /**
10724     * Define the scrollbar fade duration.
10725     *
10726     * @param scrollBarFadeDuration - the scrollbar fade duration
10727     *
10728     * @attr ref android.R.styleable#View_scrollbarFadeDuration
10729     */
10730    public void setScrollBarFadeDuration(int scrollBarFadeDuration) {
10731        getScrollCache().scrollBarFadeDuration = scrollBarFadeDuration;
10732    }
10733
10734    /**
10735     *
10736     * Returns the scrollbar size.
10737     *
10738     * @return the scrollbar size
10739     *
10740     * @attr ref android.R.styleable#View_scrollbarSize
10741     */
10742    public int getScrollBarSize() {
10743        return mScrollCache == null ? ViewConfiguration.get(mContext).getScaledScrollBarSize() :
10744                mScrollCache.scrollBarSize;
10745    }
10746
10747    /**
10748     * Define the scrollbar size.
10749     *
10750     * @param scrollBarSize - the scrollbar size
10751     *
10752     * @attr ref android.R.styleable#View_scrollbarSize
10753     */
10754    public void setScrollBarSize(int scrollBarSize) {
10755        getScrollCache().scrollBarSize = scrollBarSize;
10756    }
10757
10758    /**
10759     * <p>Specify the style of the scrollbars. The scrollbars can be overlaid or
10760     * inset. When inset, they add to the padding of the view. And the scrollbars
10761     * can be drawn inside the padding area or on the edge of the view. For example,
10762     * if a view has a background drawable and you want to draw the scrollbars
10763     * inside the padding specified by the drawable, you can use
10764     * SCROLLBARS_INSIDE_OVERLAY or SCROLLBARS_INSIDE_INSET. If you want them to
10765     * appear at the edge of the view, ignoring the padding, then you can use
10766     * SCROLLBARS_OUTSIDE_OVERLAY or SCROLLBARS_OUTSIDE_INSET.</p>
10767     * @param style the style of the scrollbars. Should be one of
10768     * SCROLLBARS_INSIDE_OVERLAY, SCROLLBARS_INSIDE_INSET,
10769     * SCROLLBARS_OUTSIDE_OVERLAY or SCROLLBARS_OUTSIDE_INSET.
10770     * @see #SCROLLBARS_INSIDE_OVERLAY
10771     * @see #SCROLLBARS_INSIDE_INSET
10772     * @see #SCROLLBARS_OUTSIDE_OVERLAY
10773     * @see #SCROLLBARS_OUTSIDE_INSET
10774     *
10775     * @attr ref android.R.styleable#View_scrollbarStyle
10776     */
10777    public void setScrollBarStyle(int style) {
10778        if (style != (mViewFlags & SCROLLBARS_STYLE_MASK)) {
10779            mViewFlags = (mViewFlags & ~SCROLLBARS_STYLE_MASK) | (style & SCROLLBARS_STYLE_MASK);
10780            computeOpaqueFlags();
10781            resolvePadding();
10782        }
10783    }
10784
10785    /**
10786     * <p>Returns the current scrollbar style.</p>
10787     * @return the current scrollbar style
10788     * @see #SCROLLBARS_INSIDE_OVERLAY
10789     * @see #SCROLLBARS_INSIDE_INSET
10790     * @see #SCROLLBARS_OUTSIDE_OVERLAY
10791     * @see #SCROLLBARS_OUTSIDE_INSET
10792     *
10793     * @attr ref android.R.styleable#View_scrollbarStyle
10794     */
10795    @ViewDebug.ExportedProperty(mapping = {
10796            @ViewDebug.IntToString(from = SCROLLBARS_INSIDE_OVERLAY, to = "INSIDE_OVERLAY"),
10797            @ViewDebug.IntToString(from = SCROLLBARS_INSIDE_INSET, to = "INSIDE_INSET"),
10798            @ViewDebug.IntToString(from = SCROLLBARS_OUTSIDE_OVERLAY, to = "OUTSIDE_OVERLAY"),
10799            @ViewDebug.IntToString(from = SCROLLBARS_OUTSIDE_INSET, to = "OUTSIDE_INSET")
10800    })
10801    public int getScrollBarStyle() {
10802        return mViewFlags & SCROLLBARS_STYLE_MASK;
10803    }
10804
10805    /**
10806     * <p>Compute the horizontal range that the horizontal scrollbar
10807     * represents.</p>
10808     *
10809     * <p>The range is expressed in arbitrary units that must be the same as the
10810     * units used by {@link #computeHorizontalScrollExtent()} and
10811     * {@link #computeHorizontalScrollOffset()}.</p>
10812     *
10813     * <p>The default range is the drawing width of this view.</p>
10814     *
10815     * @return the total horizontal range represented by the horizontal
10816     *         scrollbar
10817     *
10818     * @see #computeHorizontalScrollExtent()
10819     * @see #computeHorizontalScrollOffset()
10820     * @see android.widget.ScrollBarDrawable
10821     */
10822    protected int computeHorizontalScrollRange() {
10823        return getWidth();
10824    }
10825
10826    /**
10827     * <p>Compute the horizontal offset of the horizontal scrollbar's thumb
10828     * within the horizontal range. This value is used to compute the position
10829     * of the thumb within the scrollbar's track.</p>
10830     *
10831     * <p>The range is expressed in arbitrary units that must be the same as the
10832     * units used by {@link #computeHorizontalScrollRange()} and
10833     * {@link #computeHorizontalScrollExtent()}.</p>
10834     *
10835     * <p>The default offset is the scroll offset of this view.</p>
10836     *
10837     * @return the horizontal offset of the scrollbar's thumb
10838     *
10839     * @see #computeHorizontalScrollRange()
10840     * @see #computeHorizontalScrollExtent()
10841     * @see android.widget.ScrollBarDrawable
10842     */
10843    protected int computeHorizontalScrollOffset() {
10844        return mScrollX;
10845    }
10846
10847    /**
10848     * <p>Compute the horizontal extent of the horizontal scrollbar's thumb
10849     * within the horizontal range. This value is used to compute the length
10850     * of the thumb within the scrollbar's track.</p>
10851     *
10852     * <p>The range is expressed in arbitrary units that must be the same as the
10853     * units used by {@link #computeHorizontalScrollRange()} and
10854     * {@link #computeHorizontalScrollOffset()}.</p>
10855     *
10856     * <p>The default extent is the drawing width of this view.</p>
10857     *
10858     * @return the horizontal extent of the scrollbar's thumb
10859     *
10860     * @see #computeHorizontalScrollRange()
10861     * @see #computeHorizontalScrollOffset()
10862     * @see android.widget.ScrollBarDrawable
10863     */
10864    protected int computeHorizontalScrollExtent() {
10865        return getWidth();
10866    }
10867
10868    /**
10869     * <p>Compute the vertical range that the vertical scrollbar represents.</p>
10870     *
10871     * <p>The range is expressed in arbitrary units that must be the same as the
10872     * units used by {@link #computeVerticalScrollExtent()} and
10873     * {@link #computeVerticalScrollOffset()}.</p>
10874     *
10875     * @return the total vertical range represented by the vertical scrollbar
10876     *
10877     * <p>The default range is the drawing height of this view.</p>
10878     *
10879     * @see #computeVerticalScrollExtent()
10880     * @see #computeVerticalScrollOffset()
10881     * @see android.widget.ScrollBarDrawable
10882     */
10883    protected int computeVerticalScrollRange() {
10884        return getHeight();
10885    }
10886
10887    /**
10888     * <p>Compute the vertical offset of the vertical scrollbar's thumb
10889     * within the horizontal range. This value is used to compute the position
10890     * of the thumb within the scrollbar's track.</p>
10891     *
10892     * <p>The range is expressed in arbitrary units that must be the same as the
10893     * units used by {@link #computeVerticalScrollRange()} and
10894     * {@link #computeVerticalScrollExtent()}.</p>
10895     *
10896     * <p>The default offset is the scroll offset of this view.</p>
10897     *
10898     * @return the vertical offset of the scrollbar's thumb
10899     *
10900     * @see #computeVerticalScrollRange()
10901     * @see #computeVerticalScrollExtent()
10902     * @see android.widget.ScrollBarDrawable
10903     */
10904    protected int computeVerticalScrollOffset() {
10905        return mScrollY;
10906    }
10907
10908    /**
10909     * <p>Compute the vertical extent of the horizontal scrollbar's thumb
10910     * within the vertical range. This value is used to compute the length
10911     * of the thumb within the scrollbar's track.</p>
10912     *
10913     * <p>The range is expressed in arbitrary units that must be the same as the
10914     * units used by {@link #computeVerticalScrollRange()} and
10915     * {@link #computeVerticalScrollOffset()}.</p>
10916     *
10917     * <p>The default extent is the drawing height of this view.</p>
10918     *
10919     * @return the vertical extent of the scrollbar's thumb
10920     *
10921     * @see #computeVerticalScrollRange()
10922     * @see #computeVerticalScrollOffset()
10923     * @see android.widget.ScrollBarDrawable
10924     */
10925    protected int computeVerticalScrollExtent() {
10926        return getHeight();
10927    }
10928
10929    /**
10930     * Check if this view can be scrolled horizontally in a certain direction.
10931     *
10932     * @param direction Negative to check scrolling left, positive to check scrolling right.
10933     * @return true if this view can be scrolled in the specified direction, false otherwise.
10934     */
10935    public boolean canScrollHorizontally(int direction) {
10936        final int offset = computeHorizontalScrollOffset();
10937        final int range = computeHorizontalScrollRange() - computeHorizontalScrollExtent();
10938        if (range == 0) return false;
10939        if (direction < 0) {
10940            return offset > 0;
10941        } else {
10942            return offset < range - 1;
10943        }
10944    }
10945
10946    /**
10947     * Check if this view can be scrolled vertically in a certain direction.
10948     *
10949     * @param direction Negative to check scrolling up, positive to check scrolling down.
10950     * @return true if this view can be scrolled in the specified direction, false otherwise.
10951     */
10952    public boolean canScrollVertically(int direction) {
10953        final int offset = computeVerticalScrollOffset();
10954        final int range = computeVerticalScrollRange() - computeVerticalScrollExtent();
10955        if (range == 0) return false;
10956        if (direction < 0) {
10957            return offset > 0;
10958        } else {
10959            return offset < range - 1;
10960        }
10961    }
10962
10963    /**
10964     * <p>Request the drawing of the horizontal and the vertical scrollbar. The
10965     * scrollbars are painted only if they have been awakened first.</p>
10966     *
10967     * @param canvas the canvas on which to draw the scrollbars
10968     *
10969     * @see #awakenScrollBars(int)
10970     */
10971    protected final void onDrawScrollBars(Canvas canvas) {
10972        // scrollbars are drawn only when the animation is running
10973        final ScrollabilityCache cache = mScrollCache;
10974        if (cache != null) {
10975
10976            int state = cache.state;
10977
10978            if (state == ScrollabilityCache.OFF) {
10979                return;
10980            }
10981
10982            boolean invalidate = false;
10983
10984            if (state == ScrollabilityCache.FADING) {
10985                // We're fading -- get our fade interpolation
10986                if (cache.interpolatorValues == null) {
10987                    cache.interpolatorValues = new float[1];
10988                }
10989
10990                float[] values = cache.interpolatorValues;
10991
10992                // Stops the animation if we're done
10993                if (cache.scrollBarInterpolator.timeToValues(values) ==
10994                        Interpolator.Result.FREEZE_END) {
10995                    cache.state = ScrollabilityCache.OFF;
10996                } else {
10997                    cache.scrollBar.setAlpha(Math.round(values[0]));
10998                }
10999
11000                // This will make the scroll bars inval themselves after
11001                // drawing. We only want this when we're fading so that
11002                // we prevent excessive redraws
11003                invalidate = true;
11004            } else {
11005                // We're just on -- but we may have been fading before so
11006                // reset alpha
11007                cache.scrollBar.setAlpha(255);
11008            }
11009
11010
11011            final int viewFlags = mViewFlags;
11012
11013            final boolean drawHorizontalScrollBar =
11014                (viewFlags & SCROLLBARS_HORIZONTAL) == SCROLLBARS_HORIZONTAL;
11015            final boolean drawVerticalScrollBar =
11016                (viewFlags & SCROLLBARS_VERTICAL) == SCROLLBARS_VERTICAL
11017                && !isVerticalScrollBarHidden();
11018
11019            if (drawVerticalScrollBar || drawHorizontalScrollBar) {
11020                final int width = mRight - mLeft;
11021                final int height = mBottom - mTop;
11022
11023                final ScrollBarDrawable scrollBar = cache.scrollBar;
11024
11025                final int scrollX = mScrollX;
11026                final int scrollY = mScrollY;
11027                final int inside = (viewFlags & SCROLLBARS_OUTSIDE_MASK) == 0 ? ~0 : 0;
11028
11029                int left, top, right, bottom;
11030
11031                if (drawHorizontalScrollBar) {
11032                    int size = scrollBar.getSize(false);
11033                    if (size <= 0) {
11034                        size = cache.scrollBarSize;
11035                    }
11036
11037                    scrollBar.setParameters(computeHorizontalScrollRange(),
11038                                            computeHorizontalScrollOffset(),
11039                                            computeHorizontalScrollExtent(), false);
11040                    final int verticalScrollBarGap = drawVerticalScrollBar ?
11041                            getVerticalScrollbarWidth() : 0;
11042                    top = scrollY + height - size - (mUserPaddingBottom & inside);
11043                    left = scrollX + (mPaddingLeft & inside);
11044                    right = scrollX + width - (mUserPaddingRight & inside) - verticalScrollBarGap;
11045                    bottom = top + size;
11046                    onDrawHorizontalScrollBar(canvas, scrollBar, left, top, right, bottom);
11047                    if (invalidate) {
11048                        invalidate(left, top, right, bottom);
11049                    }
11050                }
11051
11052                if (drawVerticalScrollBar) {
11053                    int size = scrollBar.getSize(true);
11054                    if (size <= 0) {
11055                        size = cache.scrollBarSize;
11056                    }
11057
11058                    scrollBar.setParameters(computeVerticalScrollRange(),
11059                                            computeVerticalScrollOffset(),
11060                                            computeVerticalScrollExtent(), true);
11061                    switch (mVerticalScrollbarPosition) {
11062                        default:
11063                        case SCROLLBAR_POSITION_DEFAULT:
11064                        case SCROLLBAR_POSITION_RIGHT:
11065                            left = scrollX + width - size - (mUserPaddingRight & inside);
11066                            break;
11067                        case SCROLLBAR_POSITION_LEFT:
11068                            left = scrollX + (mUserPaddingLeft & inside);
11069                            break;
11070                    }
11071                    top = scrollY + (mPaddingTop & inside);
11072                    right = left + size;
11073                    bottom = scrollY + height - (mUserPaddingBottom & inside);
11074                    onDrawVerticalScrollBar(canvas, scrollBar, left, top, right, bottom);
11075                    if (invalidate) {
11076                        invalidate(left, top, right, bottom);
11077                    }
11078                }
11079            }
11080        }
11081    }
11082
11083    /**
11084     * Override this if the vertical scrollbar needs to be hidden in a subclass, like when
11085     * FastScroller is visible.
11086     * @return whether to temporarily hide the vertical scrollbar
11087     * @hide
11088     */
11089    protected boolean isVerticalScrollBarHidden() {
11090        return false;
11091    }
11092
11093    /**
11094     * <p>Draw the horizontal scrollbar if
11095     * {@link #isHorizontalScrollBarEnabled()} returns true.</p>
11096     *
11097     * @param canvas the canvas on which to draw the scrollbar
11098     * @param scrollBar the scrollbar's drawable
11099     *
11100     * @see #isHorizontalScrollBarEnabled()
11101     * @see #computeHorizontalScrollRange()
11102     * @see #computeHorizontalScrollExtent()
11103     * @see #computeHorizontalScrollOffset()
11104     * @see android.widget.ScrollBarDrawable
11105     * @hide
11106     */
11107    protected void onDrawHorizontalScrollBar(Canvas canvas, Drawable scrollBar,
11108            int l, int t, int r, int b) {
11109        scrollBar.setBounds(l, t, r, b);
11110        scrollBar.draw(canvas);
11111    }
11112
11113    /**
11114     * <p>Draw the vertical scrollbar if {@link #isVerticalScrollBarEnabled()}
11115     * returns true.</p>
11116     *
11117     * @param canvas the canvas on which to draw the scrollbar
11118     * @param scrollBar the scrollbar's drawable
11119     *
11120     * @see #isVerticalScrollBarEnabled()
11121     * @see #computeVerticalScrollRange()
11122     * @see #computeVerticalScrollExtent()
11123     * @see #computeVerticalScrollOffset()
11124     * @see android.widget.ScrollBarDrawable
11125     * @hide
11126     */
11127    protected void onDrawVerticalScrollBar(Canvas canvas, Drawable scrollBar,
11128            int l, int t, int r, int b) {
11129        scrollBar.setBounds(l, t, r, b);
11130        scrollBar.draw(canvas);
11131    }
11132
11133    /**
11134     * Implement this to do your drawing.
11135     *
11136     * @param canvas the canvas on which the background will be drawn
11137     */
11138    protected void onDraw(Canvas canvas) {
11139    }
11140
11141    /*
11142     * Caller is responsible for calling requestLayout if necessary.
11143     * (This allows addViewInLayout to not request a new layout.)
11144     */
11145    void assignParent(ViewParent parent) {
11146        if (mParent == null) {
11147            mParent = parent;
11148        } else if (parent == null) {
11149            mParent = null;
11150        } else {
11151            throw new RuntimeException("view " + this + " being added, but"
11152                    + " it already has a parent");
11153        }
11154    }
11155
11156    /**
11157     * This is called when the view is attached to a window.  At this point it
11158     * has a Surface and will start drawing.  Note that this function is
11159     * guaranteed to be called before {@link #onDraw(android.graphics.Canvas)},
11160     * however it may be called any time before the first onDraw -- including
11161     * before or after {@link #onMeasure(int, int)}.
11162     *
11163     * @see #onDetachedFromWindow()
11164     */
11165    protected void onAttachedToWindow() {
11166        if ((mPrivateFlags & REQUEST_TRANSPARENT_REGIONS) != 0) {
11167            mParent.requestTransparentRegion(this);
11168        }
11169
11170        if ((mPrivateFlags & AWAKEN_SCROLL_BARS_ON_ATTACH) != 0) {
11171            initialAwakenScrollBars();
11172            mPrivateFlags &= ~AWAKEN_SCROLL_BARS_ON_ATTACH;
11173        }
11174
11175        jumpDrawablesToCurrentState();
11176
11177        // Order is important here: LayoutDirection MUST be resolved before Padding
11178        // and TextDirection
11179        resolveLayoutDirection();
11180        resolvePadding();
11181        resolveTextDirection();
11182        resolveTextAlignment();
11183
11184        clearAccessibilityFocus();
11185        if (isFocused()) {
11186            InputMethodManager imm = InputMethodManager.peekInstance();
11187            imm.focusIn(this);
11188        }
11189
11190        if (mAttachInfo != null && mDisplayList != null) {
11191            mAttachInfo.mViewRootImpl.dequeueDisplayList(mDisplayList);
11192        }
11193    }
11194
11195    /**
11196     * @see #onScreenStateChanged(int)
11197     */
11198    void dispatchScreenStateChanged(int screenState) {
11199        onScreenStateChanged(screenState);
11200    }
11201
11202    /**
11203     * This method is called whenever the state of the screen this view is
11204     * attached to changes. A state change will usually occurs when the screen
11205     * turns on or off (whether it happens automatically or the user does it
11206     * manually.)
11207     *
11208     * @param screenState The new state of the screen. Can be either
11209     *                    {@link #SCREEN_STATE_ON} or {@link #SCREEN_STATE_OFF}
11210     */
11211    public void onScreenStateChanged(int screenState) {
11212    }
11213
11214    /**
11215     * Return true if the application tag in the AndroidManifest has set "supportRtl" to true
11216     */
11217    private boolean hasRtlSupport() {
11218        return mContext.getApplicationInfo().hasRtlSupport();
11219    }
11220
11221    /**
11222     * Resolve and cache the layout direction. LTR is set initially. This is implicitly supposing
11223     * that the parent directionality can and will be resolved before its children.
11224     * Will call {@link View#onResolvedLayoutDirectionChanged} when resolution is done.
11225     */
11226    public void resolveLayoutDirection() {
11227        // Clear any previous layout direction resolution
11228        mPrivateFlags2 &= ~LAYOUT_DIRECTION_RESOLVED_MASK;
11229
11230        if (hasRtlSupport()) {
11231            // Set resolved depending on layout direction
11232            switch (getLayoutDirection()) {
11233                case LAYOUT_DIRECTION_INHERIT:
11234                    // If this is root view, no need to look at parent's layout dir.
11235                    if (canResolveLayoutDirection()) {
11236                        ViewGroup viewGroup = ((ViewGroup) mParent);
11237
11238                        if (viewGroup.getResolvedLayoutDirection() == LAYOUT_DIRECTION_RTL) {
11239                            mPrivateFlags2 |= LAYOUT_DIRECTION_RESOLVED_RTL;
11240                        }
11241                    } else {
11242                        // Nothing to do, LTR by default
11243                    }
11244                    break;
11245                case LAYOUT_DIRECTION_RTL:
11246                    mPrivateFlags2 |= LAYOUT_DIRECTION_RESOLVED_RTL;
11247                    break;
11248                case LAYOUT_DIRECTION_LOCALE:
11249                    if(isLayoutDirectionRtl(Locale.getDefault())) {
11250                        mPrivateFlags2 |= LAYOUT_DIRECTION_RESOLVED_RTL;
11251                    }
11252                    break;
11253                default:
11254                    // Nothing to do, LTR by default
11255            }
11256        }
11257
11258        // Set to resolved
11259        mPrivateFlags2 |= LAYOUT_DIRECTION_RESOLVED;
11260        onResolvedLayoutDirectionChanged();
11261        // Resolve padding
11262        resolvePadding();
11263    }
11264
11265    /**
11266     * Called when layout direction has been resolved.
11267     *
11268     * The default implementation does nothing.
11269     */
11270    public void onResolvedLayoutDirectionChanged() {
11271    }
11272
11273    /**
11274     * Resolve padding depending on layout direction.
11275     */
11276    public void resolvePadding() {
11277        // If the user specified the absolute padding (either with android:padding or
11278        // android:paddingLeft/Top/Right/Bottom), use this padding, otherwise
11279        // use the default padding or the padding from the background drawable
11280        // (stored at this point in mPadding*)
11281        int resolvedLayoutDirection = getResolvedLayoutDirection();
11282        switch (resolvedLayoutDirection) {
11283            case LAYOUT_DIRECTION_RTL:
11284                // Start user padding override Right user padding. Otherwise, if Right user
11285                // padding is not defined, use the default Right padding. If Right user padding
11286                // is defined, just use it.
11287                if (mUserPaddingStart >= 0) {
11288                    mUserPaddingRight = mUserPaddingStart;
11289                } else if (mUserPaddingRight < 0) {
11290                    mUserPaddingRight = mPaddingRight;
11291                }
11292                if (mUserPaddingEnd >= 0) {
11293                    mUserPaddingLeft = mUserPaddingEnd;
11294                } else if (mUserPaddingLeft < 0) {
11295                    mUserPaddingLeft = mPaddingLeft;
11296                }
11297                break;
11298            case LAYOUT_DIRECTION_LTR:
11299            default:
11300                // Start user padding override Left user padding. Otherwise, if Left user
11301                // padding is not defined, use the default left padding. If Left user padding
11302                // is defined, just use it.
11303                if (mUserPaddingStart >= 0) {
11304                    mUserPaddingLeft = mUserPaddingStart;
11305                } else if (mUserPaddingLeft < 0) {
11306                    mUserPaddingLeft = mPaddingLeft;
11307                }
11308                if (mUserPaddingEnd >= 0) {
11309                    mUserPaddingRight = mUserPaddingEnd;
11310                } else if (mUserPaddingRight < 0) {
11311                    mUserPaddingRight = mPaddingRight;
11312                }
11313        }
11314
11315        mUserPaddingBottom = (mUserPaddingBottom >= 0) ? mUserPaddingBottom : mPaddingBottom;
11316
11317        if(isPaddingRelative()) {
11318            setPaddingRelative(mUserPaddingStart, mPaddingTop, mUserPaddingEnd, mUserPaddingBottom);
11319        } else {
11320            recomputePadding();
11321        }
11322        onPaddingChanged(resolvedLayoutDirection);
11323    }
11324
11325    /**
11326     * Resolve padding depending on the layout direction. Subclasses that care about
11327     * padding resolution should override this method. The default implementation does
11328     * nothing.
11329     *
11330     * @param layoutDirection the direction of the layout
11331     *
11332     * @see {@link #LAYOUT_DIRECTION_LTR}
11333     * @see {@link #LAYOUT_DIRECTION_RTL}
11334     */
11335    public void onPaddingChanged(int layoutDirection) {
11336    }
11337
11338    /**
11339     * Check if layout direction resolution can be done.
11340     *
11341     * @return true if layout direction resolution can be done otherwise return false.
11342     */
11343    public boolean canResolveLayoutDirection() {
11344        switch (getLayoutDirection()) {
11345            case LAYOUT_DIRECTION_INHERIT:
11346                return (mParent != null) && (mParent instanceof ViewGroup);
11347            default:
11348                return true;
11349        }
11350    }
11351
11352    /**
11353     * Reset the resolved layout direction. Will call {@link View#onResolvedLayoutDirectionReset}
11354     * when reset is done.
11355     */
11356    public void resetResolvedLayoutDirection() {
11357        // Reset the current resolved bits
11358        mPrivateFlags2 &= ~LAYOUT_DIRECTION_RESOLVED_MASK;
11359        onResolvedLayoutDirectionReset();
11360        // Reset also the text direction
11361        resetResolvedTextDirection();
11362    }
11363
11364    /**
11365     * Called during reset of resolved layout direction.
11366     *
11367     * Subclasses need to override this method to clear cached information that depends on the
11368     * resolved layout direction, or to inform child views that inherit their layout direction.
11369     *
11370     * The default implementation does nothing.
11371     */
11372    public void onResolvedLayoutDirectionReset() {
11373    }
11374
11375    /**
11376     * Check if a Locale uses an RTL script.
11377     *
11378     * @param locale Locale to check
11379     * @return true if the Locale uses an RTL script.
11380     */
11381    protected static boolean isLayoutDirectionRtl(Locale locale) {
11382        return (LAYOUT_DIRECTION_RTL == LocaleUtil.getLayoutDirectionFromLocale(locale));
11383    }
11384
11385    /**
11386     * This is called when the view is detached from a window.  At this point it
11387     * no longer has a surface for drawing.
11388     *
11389     * @see #onAttachedToWindow()
11390     */
11391    protected void onDetachedFromWindow() {
11392        mPrivateFlags &= ~CANCEL_NEXT_UP_EVENT;
11393
11394        removeUnsetPressCallback();
11395        removeLongPressCallback();
11396        removePerformClickCallback();
11397        removeSendViewScrolledAccessibilityEventCallback();
11398
11399        destroyDrawingCache();
11400
11401        destroyLayer(false);
11402
11403        if (mAttachInfo != null) {
11404            if (mDisplayList != null) {
11405                mAttachInfo.mViewRootImpl.enqueueDisplayList(mDisplayList);
11406            }
11407            mAttachInfo.mViewRootImpl.cancelInvalidate(this);
11408        } else {
11409            if (mDisplayList != null) {
11410                // Should never happen
11411                mDisplayList.invalidate();
11412            }
11413        }
11414
11415        mCurrentAnimation = null;
11416
11417        resetResolvedLayoutDirection();
11418        resetResolvedTextAlignment();
11419        resetAccessibilityStateChanged();
11420    }
11421
11422    /**
11423     * @return The number of times this view has been attached to a window
11424     */
11425    protected int getWindowAttachCount() {
11426        return mWindowAttachCount;
11427    }
11428
11429    /**
11430     * Retrieve a unique token identifying the window this view is attached to.
11431     * @return Return the window's token for use in
11432     * {@link WindowManager.LayoutParams#token WindowManager.LayoutParams.token}.
11433     */
11434    public IBinder getWindowToken() {
11435        return mAttachInfo != null ? mAttachInfo.mWindowToken : null;
11436    }
11437
11438    /**
11439     * Retrieve a unique token identifying the top-level "real" window of
11440     * the window that this view is attached to.  That is, this is like
11441     * {@link #getWindowToken}, except if the window this view in is a panel
11442     * window (attached to another containing window), then the token of
11443     * the containing window is returned instead.
11444     *
11445     * @return Returns the associated window token, either
11446     * {@link #getWindowToken()} or the containing window's token.
11447     */
11448    public IBinder getApplicationWindowToken() {
11449        AttachInfo ai = mAttachInfo;
11450        if (ai != null) {
11451            IBinder appWindowToken = ai.mPanelParentWindowToken;
11452            if (appWindowToken == null) {
11453                appWindowToken = ai.mWindowToken;
11454            }
11455            return appWindowToken;
11456        }
11457        return null;
11458    }
11459
11460    /**
11461     * Retrieve private session object this view hierarchy is using to
11462     * communicate with the window manager.
11463     * @return the session object to communicate with the window manager
11464     */
11465    /*package*/ IWindowSession getWindowSession() {
11466        return mAttachInfo != null ? mAttachInfo.mSession : null;
11467    }
11468
11469    /**
11470     * @param info the {@link android.view.View.AttachInfo} to associated with
11471     *        this view
11472     */
11473    void dispatchAttachedToWindow(AttachInfo info, int visibility) {
11474        //System.out.println("Attached! " + this);
11475        mAttachInfo = info;
11476        mWindowAttachCount++;
11477        // We will need to evaluate the drawable state at least once.
11478        mPrivateFlags |= DRAWABLE_STATE_DIRTY;
11479        if (mFloatingTreeObserver != null) {
11480            info.mTreeObserver.merge(mFloatingTreeObserver);
11481            mFloatingTreeObserver = null;
11482        }
11483        if ((mPrivateFlags&SCROLL_CONTAINER) != 0) {
11484            mAttachInfo.mScrollContainers.add(this);
11485            mPrivateFlags |= SCROLL_CONTAINER_ADDED;
11486        }
11487        performCollectViewAttributes(mAttachInfo, visibility);
11488        onAttachedToWindow();
11489
11490        ListenerInfo li = mListenerInfo;
11491        final CopyOnWriteArrayList<OnAttachStateChangeListener> listeners =
11492                li != null ? li.mOnAttachStateChangeListeners : null;
11493        if (listeners != null && listeners.size() > 0) {
11494            // NOTE: because of the use of CopyOnWriteArrayList, we *must* use an iterator to
11495            // perform the dispatching. The iterator is a safe guard against listeners that
11496            // could mutate the list by calling the various add/remove methods. This prevents
11497            // the array from being modified while we iterate it.
11498            for (OnAttachStateChangeListener listener : listeners) {
11499                listener.onViewAttachedToWindow(this);
11500            }
11501        }
11502
11503        int vis = info.mWindowVisibility;
11504        if (vis != GONE) {
11505            onWindowVisibilityChanged(vis);
11506        }
11507        if ((mPrivateFlags&DRAWABLE_STATE_DIRTY) != 0) {
11508            // If nobody has evaluated the drawable state yet, then do it now.
11509            refreshDrawableState();
11510        }
11511    }
11512
11513    void dispatchDetachedFromWindow() {
11514        AttachInfo info = mAttachInfo;
11515        if (info != null) {
11516            int vis = info.mWindowVisibility;
11517            if (vis != GONE) {
11518                onWindowVisibilityChanged(GONE);
11519            }
11520        }
11521
11522        onDetachedFromWindow();
11523
11524        ListenerInfo li = mListenerInfo;
11525        final CopyOnWriteArrayList<OnAttachStateChangeListener> listeners =
11526                li != null ? li.mOnAttachStateChangeListeners : null;
11527        if (listeners != null && listeners.size() > 0) {
11528            // NOTE: because of the use of CopyOnWriteArrayList, we *must* use an iterator to
11529            // perform the dispatching. The iterator is a safe guard against listeners that
11530            // could mutate the list by calling the various add/remove methods. This prevents
11531            // the array from being modified while we iterate it.
11532            for (OnAttachStateChangeListener listener : listeners) {
11533                listener.onViewDetachedFromWindow(this);
11534            }
11535        }
11536
11537        if ((mPrivateFlags & SCROLL_CONTAINER_ADDED) != 0) {
11538            mAttachInfo.mScrollContainers.remove(this);
11539            mPrivateFlags &= ~SCROLL_CONTAINER_ADDED;
11540        }
11541
11542        mAttachInfo = null;
11543    }
11544
11545    /**
11546     * Store this view hierarchy's frozen state into the given container.
11547     *
11548     * @param container The SparseArray in which to save the view's state.
11549     *
11550     * @see #restoreHierarchyState(android.util.SparseArray)
11551     * @see #dispatchSaveInstanceState(android.util.SparseArray)
11552     * @see #onSaveInstanceState()
11553     */
11554    public void saveHierarchyState(SparseArray<Parcelable> container) {
11555        dispatchSaveInstanceState(container);
11556    }
11557
11558    /**
11559     * Called by {@link #saveHierarchyState(android.util.SparseArray)} to store the state for
11560     * this view and its children. May be overridden to modify how freezing happens to a
11561     * view's children; for example, some views may want to not store state for their children.
11562     *
11563     * @param container The SparseArray in which to save the view's state.
11564     *
11565     * @see #dispatchRestoreInstanceState(android.util.SparseArray)
11566     * @see #saveHierarchyState(android.util.SparseArray)
11567     * @see #onSaveInstanceState()
11568     */
11569    protected void dispatchSaveInstanceState(SparseArray<Parcelable> container) {
11570        if (mID != NO_ID && (mViewFlags & SAVE_DISABLED_MASK) == 0) {
11571            mPrivateFlags &= ~SAVE_STATE_CALLED;
11572            Parcelable state = onSaveInstanceState();
11573            if ((mPrivateFlags & SAVE_STATE_CALLED) == 0) {
11574                throw new IllegalStateException(
11575                        "Derived class did not call super.onSaveInstanceState()");
11576            }
11577            if (state != null) {
11578                // Log.i("View", "Freezing #" + Integer.toHexString(mID)
11579                // + ": " + state);
11580                container.put(mID, state);
11581            }
11582        }
11583    }
11584
11585    /**
11586     * Hook allowing a view to generate a representation of its internal state
11587     * that can later be used to create a new instance with that same state.
11588     * This state should only contain information that is not persistent or can
11589     * not be reconstructed later. For example, you will never store your
11590     * current position on screen because that will be computed again when a
11591     * new instance of the view is placed in its view hierarchy.
11592     * <p>
11593     * Some examples of things you may store here: the current cursor position
11594     * in a text view (but usually not the text itself since that is stored in a
11595     * content provider or other persistent storage), the currently selected
11596     * item in a list view.
11597     *
11598     * @return Returns a Parcelable object containing the view's current dynamic
11599     *         state, or null if there is nothing interesting to save. The
11600     *         default implementation returns null.
11601     * @see #onRestoreInstanceState(android.os.Parcelable)
11602     * @see #saveHierarchyState(android.util.SparseArray)
11603     * @see #dispatchSaveInstanceState(android.util.SparseArray)
11604     * @see #setSaveEnabled(boolean)
11605     */
11606    protected Parcelable onSaveInstanceState() {
11607        mPrivateFlags |= SAVE_STATE_CALLED;
11608        return BaseSavedState.EMPTY_STATE;
11609    }
11610
11611    /**
11612     * Restore this view hierarchy's frozen state from the given container.
11613     *
11614     * @param container The SparseArray which holds previously frozen states.
11615     *
11616     * @see #saveHierarchyState(android.util.SparseArray)
11617     * @see #dispatchRestoreInstanceState(android.util.SparseArray)
11618     * @see #onRestoreInstanceState(android.os.Parcelable)
11619     */
11620    public void restoreHierarchyState(SparseArray<Parcelable> container) {
11621        dispatchRestoreInstanceState(container);
11622    }
11623
11624    /**
11625     * Called by {@link #restoreHierarchyState(android.util.SparseArray)} to retrieve the
11626     * state for this view and its children. May be overridden to modify how restoring
11627     * happens to a view's children; for example, some views may want to not store state
11628     * for their children.
11629     *
11630     * @param container The SparseArray which holds previously saved state.
11631     *
11632     * @see #dispatchSaveInstanceState(android.util.SparseArray)
11633     * @see #restoreHierarchyState(android.util.SparseArray)
11634     * @see #onRestoreInstanceState(android.os.Parcelable)
11635     */
11636    protected void dispatchRestoreInstanceState(SparseArray<Parcelable> container) {
11637        if (mID != NO_ID) {
11638            Parcelable state = container.get(mID);
11639            if (state != null) {
11640                // Log.i("View", "Restoreing #" + Integer.toHexString(mID)
11641                // + ": " + state);
11642                mPrivateFlags &= ~SAVE_STATE_CALLED;
11643                onRestoreInstanceState(state);
11644                if ((mPrivateFlags & SAVE_STATE_CALLED) == 0) {
11645                    throw new IllegalStateException(
11646                            "Derived class did not call super.onRestoreInstanceState()");
11647                }
11648            }
11649        }
11650    }
11651
11652    /**
11653     * Hook allowing a view to re-apply a representation of its internal state that had previously
11654     * been generated by {@link #onSaveInstanceState}. This function will never be called with a
11655     * null state.
11656     *
11657     * @param state The frozen state that had previously been returned by
11658     *        {@link #onSaveInstanceState}.
11659     *
11660     * @see #onSaveInstanceState()
11661     * @see #restoreHierarchyState(android.util.SparseArray)
11662     * @see #dispatchRestoreInstanceState(android.util.SparseArray)
11663     */
11664    protected void onRestoreInstanceState(Parcelable state) {
11665        mPrivateFlags |= SAVE_STATE_CALLED;
11666        if (state != BaseSavedState.EMPTY_STATE && state != null) {
11667            throw new IllegalArgumentException("Wrong state class, expecting View State but "
11668                    + "received " + state.getClass().toString() + " instead. This usually happens "
11669                    + "when two views of different type have the same id in the same hierarchy. "
11670                    + "This view's id is " + ViewDebug.resolveId(mContext, getId()) + ". Make sure "
11671                    + "other views do not use the same id.");
11672        }
11673    }
11674
11675    /**
11676     * <p>Return the time at which the drawing of the view hierarchy started.</p>
11677     *
11678     * @return the drawing start time in milliseconds
11679     */
11680    public long getDrawingTime() {
11681        return mAttachInfo != null ? mAttachInfo.mDrawingTime : 0;
11682    }
11683
11684    /**
11685     * <p>Enables or disables the duplication of the parent's state into this view. When
11686     * duplication is enabled, this view gets its drawable state from its parent rather
11687     * than from its own internal properties.</p>
11688     *
11689     * <p>Note: in the current implementation, setting this property to true after the
11690     * view was added to a ViewGroup might have no effect at all. This property should
11691     * always be used from XML or set to true before adding this view to a ViewGroup.</p>
11692     *
11693     * <p>Note: if this view's parent addStateFromChildren property is enabled and this
11694     * property is enabled, an exception will be thrown.</p>
11695     *
11696     * <p>Note: if the child view uses and updates additionnal states which are unknown to the
11697     * parent, these states should not be affected by this method.</p>
11698     *
11699     * @param enabled True to enable duplication of the parent's drawable state, false
11700     *                to disable it.
11701     *
11702     * @see #getDrawableState()
11703     * @see #isDuplicateParentStateEnabled()
11704     */
11705    public void setDuplicateParentStateEnabled(boolean enabled) {
11706        setFlags(enabled ? DUPLICATE_PARENT_STATE : 0, DUPLICATE_PARENT_STATE);
11707    }
11708
11709    /**
11710     * <p>Indicates whether this duplicates its drawable state from its parent.</p>
11711     *
11712     * @return True if this view's drawable state is duplicated from the parent,
11713     *         false otherwise
11714     *
11715     * @see #getDrawableState()
11716     * @see #setDuplicateParentStateEnabled(boolean)
11717     */
11718    public boolean isDuplicateParentStateEnabled() {
11719        return (mViewFlags & DUPLICATE_PARENT_STATE) == DUPLICATE_PARENT_STATE;
11720    }
11721
11722    /**
11723     * <p>Specifies the type of layer backing this view. The layer can be
11724     * {@link #LAYER_TYPE_NONE disabled}, {@link #LAYER_TYPE_SOFTWARE software} or
11725     * {@link #LAYER_TYPE_HARDWARE hardware}.</p>
11726     *
11727     * <p>A layer is associated with an optional {@link android.graphics.Paint}
11728     * instance that controls how the layer is composed on screen. The following
11729     * properties of the paint are taken into account when composing the layer:</p>
11730     * <ul>
11731     * <li>{@link android.graphics.Paint#getAlpha() Translucency (alpha)}</li>
11732     * <li>{@link android.graphics.Paint#getXfermode() Blending mode}</li>
11733     * <li>{@link android.graphics.Paint#getColorFilter() Color filter}</li>
11734     * </ul>
11735     *
11736     * <p>If this view has an alpha value set to < 1.0 by calling
11737     * {@link #setAlpha(float)}, the alpha value of the layer's paint is replaced by
11738     * this view's alpha value. Calling {@link #setAlpha(float)} is therefore
11739     * equivalent to setting a hardware layer on this view and providing a paint with
11740     * the desired alpha value.<p>
11741     *
11742     * <p>Refer to the documentation of {@link #LAYER_TYPE_NONE disabled},
11743     * {@link #LAYER_TYPE_SOFTWARE software} and {@link #LAYER_TYPE_HARDWARE hardware}
11744     * for more information on when and how to use layers.</p>
11745     *
11746     * @param layerType The ype of layer to use with this view, must be one of
11747     *        {@link #LAYER_TYPE_NONE}, {@link #LAYER_TYPE_SOFTWARE} or
11748     *        {@link #LAYER_TYPE_HARDWARE}
11749     * @param paint The paint used to compose the layer. This argument is optional
11750     *        and can be null. It is ignored when the layer type is
11751     *        {@link #LAYER_TYPE_NONE}
11752     *
11753     * @see #getLayerType()
11754     * @see #LAYER_TYPE_NONE
11755     * @see #LAYER_TYPE_SOFTWARE
11756     * @see #LAYER_TYPE_HARDWARE
11757     * @see #setAlpha(float)
11758     *
11759     * @attr ref android.R.styleable#View_layerType
11760     */
11761    public void setLayerType(int layerType, Paint paint) {
11762        if (layerType < LAYER_TYPE_NONE || layerType > LAYER_TYPE_HARDWARE) {
11763            throw new IllegalArgumentException("Layer type can only be one of: LAYER_TYPE_NONE, "
11764                    + "LAYER_TYPE_SOFTWARE or LAYER_TYPE_HARDWARE");
11765        }
11766
11767        if (layerType == mLayerType) {
11768            if (layerType != LAYER_TYPE_NONE && paint != mLayerPaint) {
11769                mLayerPaint = paint == null ? new Paint() : paint;
11770                invalidateParentCaches();
11771                invalidate(true);
11772            }
11773            return;
11774        }
11775
11776        // Destroy any previous software drawing cache if needed
11777        switch (mLayerType) {
11778            case LAYER_TYPE_HARDWARE:
11779                destroyLayer(false);
11780                // fall through - non-accelerated views may use software layer mechanism instead
11781            case LAYER_TYPE_SOFTWARE:
11782                destroyDrawingCache();
11783                break;
11784            default:
11785                break;
11786        }
11787
11788        mLayerType = layerType;
11789        final boolean layerDisabled = mLayerType == LAYER_TYPE_NONE;
11790        mLayerPaint = layerDisabled ? null : (paint == null ? new Paint() : paint);
11791        mLocalDirtyRect = layerDisabled ? null : new Rect();
11792
11793        invalidateParentCaches();
11794        invalidate(true);
11795    }
11796
11797    /**
11798     * Indicates whether this view has a static layer. A view with layer type
11799     * {@link #LAYER_TYPE_NONE} is a static layer. Other types of layers are
11800     * dynamic.
11801     */
11802    boolean hasStaticLayer() {
11803        return true;
11804    }
11805
11806    /**
11807     * Indicates what type of layer is currently associated with this view. By default
11808     * a view does not have a layer, and the layer type is {@link #LAYER_TYPE_NONE}.
11809     * Refer to the documentation of {@link #setLayerType(int, android.graphics.Paint)}
11810     * for more information on the different types of layers.
11811     *
11812     * @return {@link #LAYER_TYPE_NONE}, {@link #LAYER_TYPE_SOFTWARE} or
11813     *         {@link #LAYER_TYPE_HARDWARE}
11814     *
11815     * @see #setLayerType(int, android.graphics.Paint)
11816     * @see #buildLayer()
11817     * @see #LAYER_TYPE_NONE
11818     * @see #LAYER_TYPE_SOFTWARE
11819     * @see #LAYER_TYPE_HARDWARE
11820     */
11821    public int getLayerType() {
11822        return mLayerType;
11823    }
11824
11825    /**
11826     * Forces this view's layer to be created and this view to be rendered
11827     * into its layer. If this view's layer type is set to {@link #LAYER_TYPE_NONE},
11828     * invoking this method will have no effect.
11829     *
11830     * This method can for instance be used to render a view into its layer before
11831     * starting an animation. If this view is complex, rendering into the layer
11832     * before starting the animation will avoid skipping frames.
11833     *
11834     * @throws IllegalStateException If this view is not attached to a window
11835     *
11836     * @see #setLayerType(int, android.graphics.Paint)
11837     */
11838    public void buildLayer() {
11839        if (mLayerType == LAYER_TYPE_NONE) return;
11840
11841        if (mAttachInfo == null) {
11842            throw new IllegalStateException("This view must be attached to a window first");
11843        }
11844
11845        switch (mLayerType) {
11846            case LAYER_TYPE_HARDWARE:
11847                if (mAttachInfo.mHardwareRenderer != null &&
11848                        mAttachInfo.mHardwareRenderer.isEnabled() &&
11849                        mAttachInfo.mHardwareRenderer.validate()) {
11850                    getHardwareLayer();
11851                }
11852                break;
11853            case LAYER_TYPE_SOFTWARE:
11854                buildDrawingCache(true);
11855                break;
11856        }
11857    }
11858
11859    // Make sure the HardwareRenderer.validate() was invoked before calling this method
11860    void flushLayer() {
11861        if (mLayerType == LAYER_TYPE_HARDWARE && mHardwareLayer != null) {
11862            mHardwareLayer.flush();
11863        }
11864    }
11865
11866    /**
11867     * <p>Returns a hardware layer that can be used to draw this view again
11868     * without executing its draw method.</p>
11869     *
11870     * @return A HardwareLayer ready to render, or null if an error occurred.
11871     */
11872    HardwareLayer getHardwareLayer() {
11873        if (mAttachInfo == null || mAttachInfo.mHardwareRenderer == null ||
11874                !mAttachInfo.mHardwareRenderer.isEnabled()) {
11875            return null;
11876        }
11877
11878        if (!mAttachInfo.mHardwareRenderer.validate()) return null;
11879
11880        final int width = mRight - mLeft;
11881        final int height = mBottom - mTop;
11882
11883        if (width == 0 || height == 0) {
11884            return null;
11885        }
11886
11887        if ((mPrivateFlags & DRAWING_CACHE_VALID) == 0 || mHardwareLayer == null) {
11888            if (mHardwareLayer == null) {
11889                mHardwareLayer = mAttachInfo.mHardwareRenderer.createHardwareLayer(
11890                        width, height, isOpaque());
11891                mLocalDirtyRect.set(0, 0, width, height);
11892            } else if (mHardwareLayer.getWidth() != width || mHardwareLayer.getHeight() != height) {
11893                mHardwareLayer.resize(width, height);
11894                mLocalDirtyRect.set(0, 0, width, height);
11895            }
11896
11897            // The layer is not valid if the underlying GPU resources cannot be allocated
11898            if (!mHardwareLayer.isValid()) {
11899                return null;
11900            }
11901
11902            mHardwareLayer.redraw(getHardwareLayerDisplayList(mHardwareLayer), mLocalDirtyRect);
11903            mLocalDirtyRect.setEmpty();
11904        }
11905
11906        return mHardwareLayer;
11907    }
11908
11909    /**
11910     * Destroys this View's hardware layer if possible.
11911     *
11912     * @return True if the layer was destroyed, false otherwise.
11913     *
11914     * @see #setLayerType(int, android.graphics.Paint)
11915     * @see #LAYER_TYPE_HARDWARE
11916     */
11917    boolean destroyLayer(boolean valid) {
11918        if (mHardwareLayer != null) {
11919            AttachInfo info = mAttachInfo;
11920            if (info != null && info.mHardwareRenderer != null &&
11921                    info.mHardwareRenderer.isEnabled() &&
11922                    (valid || info.mHardwareRenderer.validate())) {
11923                mHardwareLayer.destroy();
11924                mHardwareLayer = null;
11925
11926                invalidate(true);
11927                invalidateParentCaches();
11928            }
11929            return true;
11930        }
11931        return false;
11932    }
11933
11934    /**
11935     * Destroys all hardware rendering resources. This method is invoked
11936     * when the system needs to reclaim resources. Upon execution of this
11937     * method, you should free any OpenGL resources created by the view.
11938     *
11939     * Note: you <strong>must</strong> call
11940     * <code>super.destroyHardwareResources()</code> when overriding
11941     * this method.
11942     *
11943     * @hide
11944     */
11945    protected void destroyHardwareResources() {
11946        destroyLayer(true);
11947    }
11948
11949    /**
11950     * <p>Enables or disables the drawing cache. When the drawing cache is enabled, the next call
11951     * to {@link #getDrawingCache()} or {@link #buildDrawingCache()} will draw the view in a
11952     * bitmap. Calling {@link #draw(android.graphics.Canvas)} will not draw from the cache when
11953     * the cache is enabled. To benefit from the cache, you must request the drawing cache by
11954     * calling {@link #getDrawingCache()} and draw it on screen if the returned bitmap is not
11955     * null.</p>
11956     *
11957     * <p>Enabling the drawing cache is similar to
11958     * {@link #setLayerType(int, android.graphics.Paint) setting a layer} when hardware
11959     * acceleration is turned off. When hardware acceleration is turned on, enabling the
11960     * drawing cache has no effect on rendering because the system uses a different mechanism
11961     * for acceleration which ignores the flag. If you want to use a Bitmap for the view, even
11962     * when hardware acceleration is enabled, see {@link #setLayerType(int, android.graphics.Paint)}
11963     * for information on how to enable software and hardware layers.</p>
11964     *
11965     * <p>This API can be used to manually generate
11966     * a bitmap copy of this view, by setting the flag to <code>true</code> and calling
11967     * {@link #getDrawingCache()}.</p>
11968     *
11969     * @param enabled true to enable the drawing cache, false otherwise
11970     *
11971     * @see #isDrawingCacheEnabled()
11972     * @see #getDrawingCache()
11973     * @see #buildDrawingCache()
11974     * @see #setLayerType(int, android.graphics.Paint)
11975     */
11976    public void setDrawingCacheEnabled(boolean enabled) {
11977        mCachingFailed = false;
11978        setFlags(enabled ? DRAWING_CACHE_ENABLED : 0, DRAWING_CACHE_ENABLED);
11979    }
11980
11981    /**
11982     * <p>Indicates whether the drawing cache is enabled for this view.</p>
11983     *
11984     * @return true if the drawing cache is enabled
11985     *
11986     * @see #setDrawingCacheEnabled(boolean)
11987     * @see #getDrawingCache()
11988     */
11989    @ViewDebug.ExportedProperty(category = "drawing")
11990    public boolean isDrawingCacheEnabled() {
11991        return (mViewFlags & DRAWING_CACHE_ENABLED) == DRAWING_CACHE_ENABLED;
11992    }
11993
11994    /**
11995     * Debugging utility which recursively outputs the dirty state of a view and its
11996     * descendants.
11997     *
11998     * @hide
11999     */
12000    @SuppressWarnings({"UnusedDeclaration"})
12001    public void outputDirtyFlags(String indent, boolean clear, int clearMask) {
12002        Log.d("View", indent + this + "             DIRTY(" + (mPrivateFlags & View.DIRTY_MASK) +
12003                ") DRAWN(" + (mPrivateFlags & DRAWN) + ")" + " CACHE_VALID(" +
12004                (mPrivateFlags & View.DRAWING_CACHE_VALID) +
12005                ") INVALIDATED(" + (mPrivateFlags & INVALIDATED) + ")");
12006        if (clear) {
12007            mPrivateFlags &= clearMask;
12008        }
12009        if (this instanceof ViewGroup) {
12010            ViewGroup parent = (ViewGroup) this;
12011            final int count = parent.getChildCount();
12012            for (int i = 0; i < count; i++) {
12013                final View child = parent.getChildAt(i);
12014                child.outputDirtyFlags(indent + "  ", clear, clearMask);
12015            }
12016        }
12017    }
12018
12019    /**
12020     * This method is used by ViewGroup to cause its children to restore or recreate their
12021     * display lists. It is called by getDisplayList() when the parent ViewGroup does not need
12022     * to recreate its own display list, which would happen if it went through the normal
12023     * draw/dispatchDraw mechanisms.
12024     *
12025     * @hide
12026     */
12027    protected void dispatchGetDisplayList() {}
12028
12029    /**
12030     * A view that is not attached or hardware accelerated cannot create a display list.
12031     * This method checks these conditions and returns the appropriate result.
12032     *
12033     * @return true if view has the ability to create a display list, false otherwise.
12034     *
12035     * @hide
12036     */
12037    public boolean canHaveDisplayList() {
12038        return !(mAttachInfo == null || mAttachInfo.mHardwareRenderer == null);
12039    }
12040
12041    /**
12042     * @return The HardwareRenderer associated with that view or null if hardware rendering
12043     * is not supported or this this has not been attached to a window.
12044     *
12045     * @hide
12046     */
12047    public HardwareRenderer getHardwareRenderer() {
12048        if (mAttachInfo != null) {
12049            return mAttachInfo.mHardwareRenderer;
12050        }
12051        return null;
12052    }
12053
12054    /**
12055     * Returns a DisplayList. If the incoming displayList is null, one will be created.
12056     * Otherwise, the same display list will be returned (after having been rendered into
12057     * along the way, depending on the invalidation state of the view).
12058     *
12059     * @param displayList The previous version of this displayList, could be null.
12060     * @param isLayer Whether the requester of the display list is a layer. If so,
12061     * the view will avoid creating a layer inside the resulting display list.
12062     * @return A new or reused DisplayList object.
12063     */
12064    private DisplayList getDisplayList(DisplayList displayList, boolean isLayer) {
12065        if (!canHaveDisplayList()) {
12066            return null;
12067        }
12068
12069        if (((mPrivateFlags & DRAWING_CACHE_VALID) == 0 ||
12070                displayList == null || !displayList.isValid() ||
12071                (!isLayer && mRecreateDisplayList))) {
12072            // Don't need to recreate the display list, just need to tell our
12073            // children to restore/recreate theirs
12074            if (displayList != null && displayList.isValid() &&
12075                    !isLayer && !mRecreateDisplayList) {
12076                mPrivateFlags |= DRAWN | DRAWING_CACHE_VALID;
12077                mPrivateFlags &= ~DIRTY_MASK;
12078                dispatchGetDisplayList();
12079
12080                return displayList;
12081            }
12082
12083            if (!isLayer) {
12084                // If we got here, we're recreating it. Mark it as such to ensure that
12085                // we copy in child display lists into ours in drawChild()
12086                mRecreateDisplayList = true;
12087            }
12088            if (displayList == null) {
12089                final String name = getClass().getSimpleName();
12090                displayList = mAttachInfo.mHardwareRenderer.createDisplayList(name);
12091                // If we're creating a new display list, make sure our parent gets invalidated
12092                // since they will need to recreate their display list to account for this
12093                // new child display list.
12094                invalidateParentCaches();
12095            }
12096
12097            boolean caching = false;
12098            final HardwareCanvas canvas = displayList.start();
12099            int width = mRight - mLeft;
12100            int height = mBottom - mTop;
12101
12102            try {
12103                canvas.setViewport(width, height);
12104                // The dirty rect should always be null for a display list
12105                canvas.onPreDraw(null);
12106                int layerType = (
12107                        !(mParent instanceof ViewGroup) || ((ViewGroup)mParent).mDrawLayers) ?
12108                        getLayerType() : LAYER_TYPE_NONE;
12109                if (!isLayer && layerType != LAYER_TYPE_NONE) {
12110                    if (layerType == LAYER_TYPE_HARDWARE) {
12111                        final HardwareLayer layer = getHardwareLayer();
12112                        if (layer != null && layer.isValid()) {
12113                            canvas.drawHardwareLayer(layer, 0, 0, mLayerPaint);
12114                        } else {
12115                            canvas.saveLayer(0, 0, mRight - mLeft, mBottom - mTop, mLayerPaint,
12116                                    Canvas.HAS_ALPHA_LAYER_SAVE_FLAG |
12117                                            Canvas.CLIP_TO_LAYER_SAVE_FLAG);
12118                        }
12119                        caching = true;
12120                    } else {
12121                        buildDrawingCache(true);
12122                        Bitmap cache = getDrawingCache(true);
12123                        if (cache != null) {
12124                            canvas.drawBitmap(cache, 0, 0, mLayerPaint);
12125                            caching = true;
12126                        }
12127                    }
12128                } else {
12129
12130                    computeScroll();
12131
12132                    canvas.translate(-mScrollX, -mScrollY);
12133                    if (!isLayer) {
12134                        mPrivateFlags |= DRAWN | DRAWING_CACHE_VALID;
12135                        mPrivateFlags &= ~DIRTY_MASK;
12136                    }
12137
12138                    // Fast path for layouts with no backgrounds
12139                    if ((mPrivateFlags & SKIP_DRAW) == SKIP_DRAW) {
12140                        dispatchDraw(canvas);
12141                    } else {
12142                        draw(canvas);
12143                    }
12144                }
12145            } finally {
12146                canvas.onPostDraw();
12147
12148                displayList.end();
12149                displayList.setCaching(caching);
12150                if (isLayer) {
12151                    displayList.setLeftTopRightBottom(0, 0, width, height);
12152                } else {
12153                    setDisplayListProperties(displayList);
12154                }
12155            }
12156        } else if (!isLayer) {
12157            mPrivateFlags |= DRAWN | DRAWING_CACHE_VALID;
12158            mPrivateFlags &= ~DIRTY_MASK;
12159        }
12160
12161        return displayList;
12162    }
12163
12164    /**
12165     * Get the DisplayList for the HardwareLayer
12166     *
12167     * @param layer The HardwareLayer whose DisplayList we want
12168     * @return A DisplayList fopr the specified HardwareLayer
12169     */
12170    private DisplayList getHardwareLayerDisplayList(HardwareLayer layer) {
12171        DisplayList displayList = getDisplayList(layer.getDisplayList(), true);
12172        layer.setDisplayList(displayList);
12173        return displayList;
12174    }
12175
12176
12177    /**
12178     * <p>Returns a display list that can be used to draw this view again
12179     * without executing its draw method.</p>
12180     *
12181     * @return A DisplayList ready to replay, or null if caching is not enabled.
12182     *
12183     * @hide
12184     */
12185    public DisplayList getDisplayList() {
12186        mDisplayList = getDisplayList(mDisplayList, false);
12187        return mDisplayList;
12188    }
12189
12190    /**
12191     * <p>Calling this method is equivalent to calling <code>getDrawingCache(false)</code>.</p>
12192     *
12193     * @return A non-scaled bitmap representing this view or null if cache is disabled.
12194     *
12195     * @see #getDrawingCache(boolean)
12196     */
12197    public Bitmap getDrawingCache() {
12198        return getDrawingCache(false);
12199    }
12200
12201    /**
12202     * <p>Returns the bitmap in which this view drawing is cached. The returned bitmap
12203     * is null when caching is disabled. If caching is enabled and the cache is not ready,
12204     * this method will create it. Calling {@link #draw(android.graphics.Canvas)} will not
12205     * draw from the cache when the cache is enabled. To benefit from the cache, you must
12206     * request the drawing cache by calling this method and draw it on screen if the
12207     * returned bitmap is not null.</p>
12208     *
12209     * <p>Note about auto scaling in compatibility mode: When auto scaling is not enabled,
12210     * this method will create a bitmap of the same size as this view. Because this bitmap
12211     * will be drawn scaled by the parent ViewGroup, the result on screen might show
12212     * scaling artifacts. To avoid such artifacts, you should call this method by setting
12213     * the auto scaling to true. Doing so, however, will generate a bitmap of a different
12214     * size than the view. This implies that your application must be able to handle this
12215     * size.</p>
12216     *
12217     * @param autoScale Indicates whether the generated bitmap should be scaled based on
12218     *        the current density of the screen when the application is in compatibility
12219     *        mode.
12220     *
12221     * @return A bitmap representing this view or null if cache is disabled.
12222     *
12223     * @see #setDrawingCacheEnabled(boolean)
12224     * @see #isDrawingCacheEnabled()
12225     * @see #buildDrawingCache(boolean)
12226     * @see #destroyDrawingCache()
12227     */
12228    public Bitmap getDrawingCache(boolean autoScale) {
12229        if ((mViewFlags & WILL_NOT_CACHE_DRAWING) == WILL_NOT_CACHE_DRAWING) {
12230            return null;
12231        }
12232        if ((mViewFlags & DRAWING_CACHE_ENABLED) == DRAWING_CACHE_ENABLED) {
12233            buildDrawingCache(autoScale);
12234        }
12235        return autoScale ? mDrawingCache : mUnscaledDrawingCache;
12236    }
12237
12238    /**
12239     * <p>Frees the resources used by the drawing cache. If you call
12240     * {@link #buildDrawingCache()} manually without calling
12241     * {@link #setDrawingCacheEnabled(boolean) setDrawingCacheEnabled(true)}, you
12242     * should cleanup the cache with this method afterwards.</p>
12243     *
12244     * @see #setDrawingCacheEnabled(boolean)
12245     * @see #buildDrawingCache()
12246     * @see #getDrawingCache()
12247     */
12248    public void destroyDrawingCache() {
12249        if (mDrawingCache != null) {
12250            mDrawingCache.recycle();
12251            mDrawingCache = null;
12252        }
12253        if (mUnscaledDrawingCache != null) {
12254            mUnscaledDrawingCache.recycle();
12255            mUnscaledDrawingCache = null;
12256        }
12257    }
12258
12259    /**
12260     * Setting a solid background color for the drawing cache's bitmaps will improve
12261     * performance and memory usage. Note, though that this should only be used if this
12262     * view will always be drawn on top of a solid color.
12263     *
12264     * @param color The background color to use for the drawing cache's bitmap
12265     *
12266     * @see #setDrawingCacheEnabled(boolean)
12267     * @see #buildDrawingCache()
12268     * @see #getDrawingCache()
12269     */
12270    public void setDrawingCacheBackgroundColor(int color) {
12271        if (color != mDrawingCacheBackgroundColor) {
12272            mDrawingCacheBackgroundColor = color;
12273            mPrivateFlags &= ~DRAWING_CACHE_VALID;
12274        }
12275    }
12276
12277    /**
12278     * @see #setDrawingCacheBackgroundColor(int)
12279     *
12280     * @return The background color to used for the drawing cache's bitmap
12281     */
12282    public int getDrawingCacheBackgroundColor() {
12283        return mDrawingCacheBackgroundColor;
12284    }
12285
12286    /**
12287     * <p>Calling this method is equivalent to calling <code>buildDrawingCache(false)</code>.</p>
12288     *
12289     * @see #buildDrawingCache(boolean)
12290     */
12291    public void buildDrawingCache() {
12292        buildDrawingCache(false);
12293    }
12294
12295    /**
12296     * <p>Forces the drawing cache to be built if the drawing cache is invalid.</p>
12297     *
12298     * <p>If you call {@link #buildDrawingCache()} manually without calling
12299     * {@link #setDrawingCacheEnabled(boolean) setDrawingCacheEnabled(true)}, you
12300     * should cleanup the cache by calling {@link #destroyDrawingCache()} afterwards.</p>
12301     *
12302     * <p>Note about auto scaling in compatibility mode: When auto scaling is not enabled,
12303     * this method will create a bitmap of the same size as this view. Because this bitmap
12304     * will be drawn scaled by the parent ViewGroup, the result on screen might show
12305     * scaling artifacts. To avoid such artifacts, you should call this method by setting
12306     * the auto scaling to true. Doing so, however, will generate a bitmap of a different
12307     * size than the view. This implies that your application must be able to handle this
12308     * size.</p>
12309     *
12310     * <p>You should avoid calling this method when hardware acceleration is enabled. If
12311     * you do not need the drawing cache bitmap, calling this method will increase memory
12312     * usage and cause the view to be rendered in software once, thus negatively impacting
12313     * performance.</p>
12314     *
12315     * @see #getDrawingCache()
12316     * @see #destroyDrawingCache()
12317     */
12318    public void buildDrawingCache(boolean autoScale) {
12319        if ((mPrivateFlags & DRAWING_CACHE_VALID) == 0 || (autoScale ?
12320                mDrawingCache == null : mUnscaledDrawingCache == null)) {
12321            mCachingFailed = false;
12322
12323            if (ViewDebug.TRACE_HIERARCHY) {
12324                ViewDebug.trace(this, ViewDebug.HierarchyTraceType.BUILD_CACHE);
12325            }
12326
12327            int width = mRight - mLeft;
12328            int height = mBottom - mTop;
12329
12330            final AttachInfo attachInfo = mAttachInfo;
12331            final boolean scalingRequired = attachInfo != null && attachInfo.mScalingRequired;
12332
12333            if (autoScale && scalingRequired) {
12334                width = (int) ((width * attachInfo.mApplicationScale) + 0.5f);
12335                height = (int) ((height * attachInfo.mApplicationScale) + 0.5f);
12336            }
12337
12338            final int drawingCacheBackgroundColor = mDrawingCacheBackgroundColor;
12339            final boolean opaque = drawingCacheBackgroundColor != 0 || isOpaque();
12340            final boolean use32BitCache = attachInfo != null && attachInfo.mUse32BitDrawingCache;
12341
12342            if (width <= 0 || height <= 0 ||
12343                     // Projected bitmap size in bytes
12344                    (width * height * (opaque && !use32BitCache ? 2 : 4) >
12345                            ViewConfiguration.get(mContext).getScaledMaximumDrawingCacheSize())) {
12346                destroyDrawingCache();
12347                mCachingFailed = true;
12348                return;
12349            }
12350
12351            boolean clear = true;
12352            Bitmap bitmap = autoScale ? mDrawingCache : mUnscaledDrawingCache;
12353
12354            if (bitmap == null || bitmap.getWidth() != width || bitmap.getHeight() != height) {
12355                Bitmap.Config quality;
12356                if (!opaque) {
12357                    // Never pick ARGB_4444 because it looks awful
12358                    // Keep the DRAWING_CACHE_QUALITY_LOW flag just in case
12359                    switch (mViewFlags & DRAWING_CACHE_QUALITY_MASK) {
12360                        case DRAWING_CACHE_QUALITY_AUTO:
12361                            quality = Bitmap.Config.ARGB_8888;
12362                            break;
12363                        case DRAWING_CACHE_QUALITY_LOW:
12364                            quality = Bitmap.Config.ARGB_8888;
12365                            break;
12366                        case DRAWING_CACHE_QUALITY_HIGH:
12367                            quality = Bitmap.Config.ARGB_8888;
12368                            break;
12369                        default:
12370                            quality = Bitmap.Config.ARGB_8888;
12371                            break;
12372                    }
12373                } else {
12374                    // Optimization for translucent windows
12375                    // If the window is translucent, use a 32 bits bitmap to benefit from memcpy()
12376                    quality = use32BitCache ? Bitmap.Config.ARGB_8888 : Bitmap.Config.RGB_565;
12377                }
12378
12379                // Try to cleanup memory
12380                if (bitmap != null) bitmap.recycle();
12381
12382                try {
12383                    bitmap = Bitmap.createBitmap(width, height, quality);
12384                    bitmap.setDensity(getResources().getDisplayMetrics().densityDpi);
12385                    if (autoScale) {
12386                        mDrawingCache = bitmap;
12387                    } else {
12388                        mUnscaledDrawingCache = bitmap;
12389                    }
12390                    if (opaque && use32BitCache) bitmap.setHasAlpha(false);
12391                } catch (OutOfMemoryError e) {
12392                    // If there is not enough memory to create the bitmap cache, just
12393                    // ignore the issue as bitmap caches are not required to draw the
12394                    // view hierarchy
12395                    if (autoScale) {
12396                        mDrawingCache = null;
12397                    } else {
12398                        mUnscaledDrawingCache = null;
12399                    }
12400                    mCachingFailed = true;
12401                    return;
12402                }
12403
12404                clear = drawingCacheBackgroundColor != 0;
12405            }
12406
12407            Canvas canvas;
12408            if (attachInfo != null) {
12409                canvas = attachInfo.mCanvas;
12410                if (canvas == null) {
12411                    canvas = new Canvas();
12412                }
12413                canvas.setBitmap(bitmap);
12414                // Temporarily clobber the cached Canvas in case one of our children
12415                // is also using a drawing cache. Without this, the children would
12416                // steal the canvas by attaching their own bitmap to it and bad, bad
12417                // thing would happen (invisible views, corrupted drawings, etc.)
12418                attachInfo.mCanvas = null;
12419            } else {
12420                // This case should hopefully never or seldom happen
12421                canvas = new Canvas(bitmap);
12422            }
12423
12424            if (clear) {
12425                bitmap.eraseColor(drawingCacheBackgroundColor);
12426            }
12427
12428            computeScroll();
12429            final int restoreCount = canvas.save();
12430
12431            if (autoScale && scalingRequired) {
12432                final float scale = attachInfo.mApplicationScale;
12433                canvas.scale(scale, scale);
12434            }
12435
12436            canvas.translate(-mScrollX, -mScrollY);
12437
12438            mPrivateFlags |= DRAWN;
12439            if (mAttachInfo == null || !mAttachInfo.mHardwareAccelerated ||
12440                    mLayerType != LAYER_TYPE_NONE) {
12441                mPrivateFlags |= DRAWING_CACHE_VALID;
12442            }
12443
12444            // Fast path for layouts with no backgrounds
12445            if ((mPrivateFlags & SKIP_DRAW) == SKIP_DRAW) {
12446                if (ViewDebug.TRACE_HIERARCHY) {
12447                    ViewDebug.trace(this, ViewDebug.HierarchyTraceType.DRAW);
12448                }
12449                mPrivateFlags &= ~DIRTY_MASK;
12450                dispatchDraw(canvas);
12451            } else {
12452                draw(canvas);
12453            }
12454
12455            canvas.restoreToCount(restoreCount);
12456            canvas.setBitmap(null);
12457
12458            if (attachInfo != null) {
12459                // Restore the cached Canvas for our siblings
12460                attachInfo.mCanvas = canvas;
12461            }
12462        }
12463    }
12464
12465    /**
12466     * Create a snapshot of the view into a bitmap.  We should probably make
12467     * some form of this public, but should think about the API.
12468     */
12469    Bitmap createSnapshot(Bitmap.Config quality, int backgroundColor, boolean skipChildren) {
12470        int width = mRight - mLeft;
12471        int height = mBottom - mTop;
12472
12473        final AttachInfo attachInfo = mAttachInfo;
12474        final float scale = attachInfo != null ? attachInfo.mApplicationScale : 1.0f;
12475        width = (int) ((width * scale) + 0.5f);
12476        height = (int) ((height * scale) + 0.5f);
12477
12478        Bitmap bitmap = Bitmap.createBitmap(width > 0 ? width : 1, height > 0 ? height : 1, quality);
12479        if (bitmap == null) {
12480            throw new OutOfMemoryError();
12481        }
12482
12483        Resources resources = getResources();
12484        if (resources != null) {
12485            bitmap.setDensity(resources.getDisplayMetrics().densityDpi);
12486        }
12487
12488        Canvas canvas;
12489        if (attachInfo != null) {
12490            canvas = attachInfo.mCanvas;
12491            if (canvas == null) {
12492                canvas = new Canvas();
12493            }
12494            canvas.setBitmap(bitmap);
12495            // Temporarily clobber the cached Canvas in case one of our children
12496            // is also using a drawing cache. Without this, the children would
12497            // steal the canvas by attaching their own bitmap to it and bad, bad
12498            // things would happen (invisible views, corrupted drawings, etc.)
12499            attachInfo.mCanvas = null;
12500        } else {
12501            // This case should hopefully never or seldom happen
12502            canvas = new Canvas(bitmap);
12503        }
12504
12505        if ((backgroundColor & 0xff000000) != 0) {
12506            bitmap.eraseColor(backgroundColor);
12507        }
12508
12509        computeScroll();
12510        final int restoreCount = canvas.save();
12511        canvas.scale(scale, scale);
12512        canvas.translate(-mScrollX, -mScrollY);
12513
12514        // Temporarily remove the dirty mask
12515        int flags = mPrivateFlags;
12516        mPrivateFlags &= ~DIRTY_MASK;
12517
12518        // Fast path for layouts with no backgrounds
12519        if ((mPrivateFlags & SKIP_DRAW) == SKIP_DRAW) {
12520            dispatchDraw(canvas);
12521        } else {
12522            draw(canvas);
12523        }
12524
12525        mPrivateFlags = flags;
12526
12527        canvas.restoreToCount(restoreCount);
12528        canvas.setBitmap(null);
12529
12530        if (attachInfo != null) {
12531            // Restore the cached Canvas for our siblings
12532            attachInfo.mCanvas = canvas;
12533        }
12534
12535        return bitmap;
12536    }
12537
12538    /**
12539     * Indicates whether this View is currently in edit mode. A View is usually
12540     * in edit mode when displayed within a developer tool. For instance, if
12541     * this View is being drawn by a visual user interface builder, this method
12542     * should return true.
12543     *
12544     * Subclasses should check the return value of this method to provide
12545     * different behaviors if their normal behavior might interfere with the
12546     * host environment. For instance: the class spawns a thread in its
12547     * constructor, the drawing code relies on device-specific features, etc.
12548     *
12549     * This method is usually checked in the drawing code of custom widgets.
12550     *
12551     * @return True if this View is in edit mode, false otherwise.
12552     */
12553    public boolean isInEditMode() {
12554        return false;
12555    }
12556
12557    /**
12558     * If the View draws content inside its padding and enables fading edges,
12559     * it needs to support padding offsets. Padding offsets are added to the
12560     * fading edges to extend the length of the fade so that it covers pixels
12561     * drawn inside the padding.
12562     *
12563     * Subclasses of this class should override this method if they need
12564     * to draw content inside the padding.
12565     *
12566     * @return True if padding offset must be applied, false otherwise.
12567     *
12568     * @see #getLeftPaddingOffset()
12569     * @see #getRightPaddingOffset()
12570     * @see #getTopPaddingOffset()
12571     * @see #getBottomPaddingOffset()
12572     *
12573     * @since CURRENT
12574     */
12575    protected boolean isPaddingOffsetRequired() {
12576        return false;
12577    }
12578
12579    /**
12580     * Amount by which to extend the left fading region. Called only when
12581     * {@link #isPaddingOffsetRequired()} returns true.
12582     *
12583     * @return The left padding offset in pixels.
12584     *
12585     * @see #isPaddingOffsetRequired()
12586     *
12587     * @since CURRENT
12588     */
12589    protected int getLeftPaddingOffset() {
12590        return 0;
12591    }
12592
12593    /**
12594     * Amount by which to extend the right fading region. Called only when
12595     * {@link #isPaddingOffsetRequired()} returns true.
12596     *
12597     * @return The right padding offset in pixels.
12598     *
12599     * @see #isPaddingOffsetRequired()
12600     *
12601     * @since CURRENT
12602     */
12603    protected int getRightPaddingOffset() {
12604        return 0;
12605    }
12606
12607    /**
12608     * Amount by which to extend the top fading region. Called only when
12609     * {@link #isPaddingOffsetRequired()} returns true.
12610     *
12611     * @return The top padding offset in pixels.
12612     *
12613     * @see #isPaddingOffsetRequired()
12614     *
12615     * @since CURRENT
12616     */
12617    protected int getTopPaddingOffset() {
12618        return 0;
12619    }
12620
12621    /**
12622     * Amount by which to extend the bottom fading region. Called only when
12623     * {@link #isPaddingOffsetRequired()} returns true.
12624     *
12625     * @return The bottom padding offset in pixels.
12626     *
12627     * @see #isPaddingOffsetRequired()
12628     *
12629     * @since CURRENT
12630     */
12631    protected int getBottomPaddingOffset() {
12632        return 0;
12633    }
12634
12635    /**
12636     * @hide
12637     * @param offsetRequired
12638     */
12639    protected int getFadeTop(boolean offsetRequired) {
12640        int top = mPaddingTop;
12641        if (offsetRequired) top += getTopPaddingOffset();
12642        return top;
12643    }
12644
12645    /**
12646     * @hide
12647     * @param offsetRequired
12648     */
12649    protected int getFadeHeight(boolean offsetRequired) {
12650        int padding = mPaddingTop;
12651        if (offsetRequired) padding += getTopPaddingOffset();
12652        return mBottom - mTop - mPaddingBottom - padding;
12653    }
12654
12655    /**
12656     * <p>Indicates whether this view is attached to a hardware accelerated
12657     * window or not.</p>
12658     *
12659     * <p>Even if this method returns true, it does not mean that every call
12660     * to {@link #draw(android.graphics.Canvas)} will be made with an hardware
12661     * accelerated {@link android.graphics.Canvas}. For instance, if this view
12662     * is drawn onto an offscreen {@link android.graphics.Bitmap} and its
12663     * window is hardware accelerated,
12664     * {@link android.graphics.Canvas#isHardwareAccelerated()} will likely
12665     * return false, and this method will return true.</p>
12666     *
12667     * @return True if the view is attached to a window and the window is
12668     *         hardware accelerated; false in any other case.
12669     */
12670    public boolean isHardwareAccelerated() {
12671        return mAttachInfo != null && mAttachInfo.mHardwareAccelerated;
12672    }
12673
12674    /**
12675     * Utility function, called by draw(canvas, parent, drawingTime) to handle the less common
12676     * case of an active Animation being run on the view.
12677     */
12678    private boolean drawAnimation(ViewGroup parent, long drawingTime,
12679            Animation a, boolean scalingRequired) {
12680        Transformation invalidationTransform;
12681        final int flags = parent.mGroupFlags;
12682        final boolean initialized = a.isInitialized();
12683        if (!initialized) {
12684            a.initialize(mRight - mLeft, mBottom - mTop, parent.getWidth(), parent.getHeight());
12685            a.initializeInvalidateRegion(0, 0, mRight - mLeft, mBottom - mTop);
12686            onAnimationStart();
12687        }
12688
12689        boolean more = a.getTransformation(drawingTime, parent.mChildTransformation, 1f);
12690        if (scalingRequired && mAttachInfo.mApplicationScale != 1f) {
12691            if (parent.mInvalidationTransformation == null) {
12692                parent.mInvalidationTransformation = new Transformation();
12693            }
12694            invalidationTransform = parent.mInvalidationTransformation;
12695            a.getTransformation(drawingTime, invalidationTransform, 1f);
12696        } else {
12697            invalidationTransform = parent.mChildTransformation;
12698        }
12699        if (more) {
12700            if (!a.willChangeBounds()) {
12701                if ((flags & (parent.FLAG_OPTIMIZE_INVALIDATE | parent.FLAG_ANIMATION_DONE)) ==
12702                        parent.FLAG_OPTIMIZE_INVALIDATE) {
12703                    parent.mGroupFlags |= parent.FLAG_INVALIDATE_REQUIRED;
12704                } else if ((flags & parent.FLAG_INVALIDATE_REQUIRED) == 0) {
12705                    // The child need to draw an animation, potentially offscreen, so
12706                    // make sure we do not cancel invalidate requests
12707                    parent.mPrivateFlags |= DRAW_ANIMATION;
12708                    parent.invalidate(mLeft, mTop, mRight, mBottom);
12709                }
12710            } else {
12711                if (parent.mInvalidateRegion == null) {
12712                    parent.mInvalidateRegion = new RectF();
12713                }
12714                final RectF region = parent.mInvalidateRegion;
12715                a.getInvalidateRegion(0, 0, mRight - mLeft, mBottom - mTop, region,
12716                        invalidationTransform);
12717
12718                // The child need to draw an animation, potentially offscreen, so
12719                // make sure we do not cancel invalidate requests
12720                parent.mPrivateFlags |= DRAW_ANIMATION;
12721
12722                final int left = mLeft + (int) region.left;
12723                final int top = mTop + (int) region.top;
12724                parent.invalidate(left, top, left + (int) (region.width() + .5f),
12725                        top + (int) (region.height() + .5f));
12726            }
12727        }
12728        return more;
12729    }
12730
12731    /**
12732     * This method is called by getDisplayList() when a display list is created or re-rendered.
12733     * It sets or resets the current value of all properties on that display list (resetting is
12734     * necessary when a display list is being re-created, because we need to make sure that
12735     * previously-set transform values
12736     */
12737    void setDisplayListProperties(DisplayList displayList) {
12738        if (displayList != null) {
12739            displayList.setLeftTopRightBottom(mLeft, mTop, mRight, mBottom);
12740            displayList.setHasOverlappingRendering(hasOverlappingRendering());
12741            if (mParent instanceof ViewGroup) {
12742                displayList.setClipChildren(
12743                        (((ViewGroup)mParent).mGroupFlags & ViewGroup.FLAG_CLIP_CHILDREN) != 0);
12744            }
12745            float alpha = 1;
12746            if (mParent instanceof ViewGroup && (((ViewGroup) mParent).mGroupFlags &
12747                    ViewGroup.FLAG_SUPPORT_STATIC_TRANSFORMATIONS) != 0) {
12748                ViewGroup parentVG = (ViewGroup) mParent;
12749                final boolean hasTransform =
12750                        parentVG.getChildStaticTransformation(this, parentVG.mChildTransformation);
12751                if (hasTransform) {
12752                    Transformation transform = parentVG.mChildTransformation;
12753                    final int transformType = parentVG.mChildTransformation.getTransformationType();
12754                    if (transformType != Transformation.TYPE_IDENTITY) {
12755                        if ((transformType & Transformation.TYPE_ALPHA) != 0) {
12756                            alpha = transform.getAlpha();
12757                        }
12758                        if ((transformType & Transformation.TYPE_MATRIX) != 0) {
12759                            displayList.setStaticMatrix(transform.getMatrix());
12760                        }
12761                    }
12762                }
12763            }
12764            if (mTransformationInfo != null) {
12765                alpha *= mTransformationInfo.mAlpha;
12766                if (alpha < 1) {
12767                    final int multipliedAlpha = (int) (255 * alpha);
12768                    if (onSetAlpha(multipliedAlpha)) {
12769                        alpha = 1;
12770                    }
12771                }
12772                displayList.setTransformationInfo(alpha,
12773                        mTransformationInfo.mTranslationX, mTransformationInfo.mTranslationY,
12774                        mTransformationInfo.mRotation, mTransformationInfo.mRotationX,
12775                        mTransformationInfo.mRotationY, mTransformationInfo.mScaleX,
12776                        mTransformationInfo.mScaleY);
12777                if (mTransformationInfo.mCamera == null) {
12778                    mTransformationInfo.mCamera = new Camera();
12779                    mTransformationInfo.matrix3D = new Matrix();
12780                }
12781                displayList.setCameraDistance(mTransformationInfo.mCamera.getLocationZ());
12782                if ((mPrivateFlags & PIVOT_EXPLICITLY_SET) == PIVOT_EXPLICITLY_SET) {
12783                    displayList.setPivotX(getPivotX());
12784                    displayList.setPivotY(getPivotY());
12785                }
12786            } else if (alpha < 1) {
12787                displayList.setAlpha(alpha);
12788            }
12789        }
12790    }
12791
12792    /**
12793     * This method is called by ViewGroup.drawChild() to have each child view draw itself.
12794     * This draw() method is an implementation detail and is not intended to be overridden or
12795     * to be called from anywhere else other than ViewGroup.drawChild().
12796     */
12797    boolean draw(Canvas canvas, ViewGroup parent, long drawingTime) {
12798        boolean useDisplayListProperties = mAttachInfo != null && mAttachInfo.mHardwareAccelerated;
12799        boolean more = false;
12800        final boolean childHasIdentityMatrix = hasIdentityMatrix();
12801        final int flags = parent.mGroupFlags;
12802
12803        if ((flags & ViewGroup.FLAG_CLEAR_TRANSFORMATION) == ViewGroup.FLAG_CLEAR_TRANSFORMATION) {
12804            parent.mChildTransformation.clear();
12805            parent.mGroupFlags &= ~ViewGroup.FLAG_CLEAR_TRANSFORMATION;
12806        }
12807
12808        Transformation transformToApply = null;
12809        boolean concatMatrix = false;
12810
12811        boolean scalingRequired = false;
12812        boolean caching;
12813        int layerType = parent.mDrawLayers ? getLayerType() : LAYER_TYPE_NONE;
12814
12815        final boolean hardwareAccelerated = canvas.isHardwareAccelerated();
12816        if ((flags & ViewGroup.FLAG_CHILDREN_DRAWN_WITH_CACHE) != 0 ||
12817                (flags & ViewGroup.FLAG_ALWAYS_DRAWN_WITH_CACHE) != 0) {
12818            caching = true;
12819            // Auto-scaled apps are not hw-accelerated, no need to set scaling flag on DisplayList
12820            if (mAttachInfo != null) scalingRequired = mAttachInfo.mScalingRequired;
12821        } else {
12822            caching = (layerType != LAYER_TYPE_NONE) || hardwareAccelerated;
12823        }
12824
12825        final Animation a = getAnimation();
12826        if (a != null) {
12827            more = drawAnimation(parent, drawingTime, a, scalingRequired);
12828            concatMatrix = a.willChangeTransformationMatrix();
12829            if (concatMatrix) {
12830                mPrivateFlags2 |= VIEW_IS_ANIMATING_TRANSFORM;
12831            }
12832            transformToApply = parent.mChildTransformation;
12833        } else {
12834            if ((mPrivateFlags2 & VIEW_IS_ANIMATING_TRANSFORM) == VIEW_IS_ANIMATING_TRANSFORM &&
12835                    mDisplayList != null) {
12836                // No longer animating: clear out old animation matrix
12837                mDisplayList.setAnimationMatrix(null);
12838                mPrivateFlags2 &= ~VIEW_IS_ANIMATING_TRANSFORM;
12839            }
12840            if (!useDisplayListProperties &&
12841                    (flags & ViewGroup.FLAG_SUPPORT_STATIC_TRANSFORMATIONS) != 0) {
12842                final boolean hasTransform =
12843                        parent.getChildStaticTransformation(this, parent.mChildTransformation);
12844                if (hasTransform) {
12845                    final int transformType = parent.mChildTransformation.getTransformationType();
12846                    transformToApply = transformType != Transformation.TYPE_IDENTITY ?
12847                            parent.mChildTransformation : null;
12848                    concatMatrix = (transformType & Transformation.TYPE_MATRIX) != 0;
12849                }
12850            }
12851        }
12852
12853        concatMatrix |= !childHasIdentityMatrix;
12854
12855        // Sets the flag as early as possible to allow draw() implementations
12856        // to call invalidate() successfully when doing animations
12857        mPrivateFlags |= DRAWN;
12858
12859        if (!concatMatrix && canvas.quickReject(mLeft, mTop, mRight, mBottom, Canvas.EdgeType.BW) &&
12860                (mPrivateFlags & DRAW_ANIMATION) == 0) {
12861            mPrivateFlags2 |= VIEW_QUICK_REJECTED;
12862            return more;
12863        }
12864        mPrivateFlags2 &= ~VIEW_QUICK_REJECTED;
12865
12866        if (hardwareAccelerated) {
12867            // Clear INVALIDATED flag to allow invalidation to occur during rendering, but
12868            // retain the flag's value temporarily in the mRecreateDisplayList flag
12869            mRecreateDisplayList = (mPrivateFlags & INVALIDATED) == INVALIDATED;
12870            mPrivateFlags &= ~INVALIDATED;
12871        }
12872
12873        computeScroll();
12874
12875        final int sx = mScrollX;
12876        final int sy = mScrollY;
12877
12878        DisplayList displayList = null;
12879        Bitmap cache = null;
12880        boolean hasDisplayList = false;
12881        if (caching) {
12882            if (!hardwareAccelerated) {
12883                if (layerType != LAYER_TYPE_NONE) {
12884                    layerType = LAYER_TYPE_SOFTWARE;
12885                    buildDrawingCache(true);
12886                }
12887                cache = getDrawingCache(true);
12888            } else {
12889                switch (layerType) {
12890                    case LAYER_TYPE_SOFTWARE:
12891                        if (useDisplayListProperties) {
12892                            hasDisplayList = canHaveDisplayList();
12893                        } else {
12894                            buildDrawingCache(true);
12895                            cache = getDrawingCache(true);
12896                        }
12897                        break;
12898                    case LAYER_TYPE_HARDWARE:
12899                        if (useDisplayListProperties) {
12900                            hasDisplayList = canHaveDisplayList();
12901                        }
12902                        break;
12903                    case LAYER_TYPE_NONE:
12904                        // Delay getting the display list until animation-driven alpha values are
12905                        // set up and possibly passed on to the view
12906                        hasDisplayList = canHaveDisplayList();
12907                        break;
12908                }
12909            }
12910        }
12911        useDisplayListProperties &= hasDisplayList;
12912        if (useDisplayListProperties) {
12913            displayList = getDisplayList();
12914            if (!displayList.isValid()) {
12915                // Uncommon, but possible. If a view is removed from the hierarchy during the call
12916                // to getDisplayList(), the display list will be marked invalid and we should not
12917                // try to use it again.
12918                displayList = null;
12919                hasDisplayList = false;
12920                useDisplayListProperties = false;
12921            }
12922        }
12923
12924        final boolean hasNoCache = cache == null || hasDisplayList;
12925        final boolean offsetForScroll = cache == null && !hasDisplayList &&
12926                layerType != LAYER_TYPE_HARDWARE;
12927
12928        int restoreTo = -1;
12929        if (!useDisplayListProperties || transformToApply != null) {
12930            restoreTo = canvas.save();
12931        }
12932        if (offsetForScroll) {
12933            canvas.translate(mLeft - sx, mTop - sy);
12934        } else {
12935            if (!useDisplayListProperties) {
12936                canvas.translate(mLeft, mTop);
12937            }
12938            if (scalingRequired) {
12939                if (useDisplayListProperties) {
12940                    // TODO: Might not need this if we put everything inside the DL
12941                    restoreTo = canvas.save();
12942                }
12943                // mAttachInfo cannot be null, otherwise scalingRequired == false
12944                final float scale = 1.0f / mAttachInfo.mApplicationScale;
12945                canvas.scale(scale, scale);
12946            }
12947        }
12948
12949        float alpha = useDisplayListProperties ? 1 : getAlpha();
12950        if (transformToApply != null || alpha < 1 || !hasIdentityMatrix()) {
12951            if (transformToApply != null || !childHasIdentityMatrix) {
12952                int transX = 0;
12953                int transY = 0;
12954
12955                if (offsetForScroll) {
12956                    transX = -sx;
12957                    transY = -sy;
12958                }
12959
12960                if (transformToApply != null) {
12961                    if (concatMatrix) {
12962                        if (useDisplayListProperties) {
12963                            displayList.setAnimationMatrix(transformToApply.getMatrix());
12964                        } else {
12965                            // Undo the scroll translation, apply the transformation matrix,
12966                            // then redo the scroll translate to get the correct result.
12967                            canvas.translate(-transX, -transY);
12968                            canvas.concat(transformToApply.getMatrix());
12969                            canvas.translate(transX, transY);
12970                        }
12971                        parent.mGroupFlags |= ViewGroup.FLAG_CLEAR_TRANSFORMATION;
12972                    }
12973
12974                    float transformAlpha = transformToApply.getAlpha();
12975                    if (transformAlpha < 1) {
12976                        alpha *= transformToApply.getAlpha();
12977                        parent.mGroupFlags |= ViewGroup.FLAG_CLEAR_TRANSFORMATION;
12978                    }
12979                }
12980
12981                if (!childHasIdentityMatrix && !useDisplayListProperties) {
12982                    canvas.translate(-transX, -transY);
12983                    canvas.concat(getMatrix());
12984                    canvas.translate(transX, transY);
12985                }
12986            }
12987
12988            if (alpha < 1) {
12989                parent.mGroupFlags |= ViewGroup.FLAG_CLEAR_TRANSFORMATION;
12990                if (hasNoCache) {
12991                    final int multipliedAlpha = (int) (255 * alpha);
12992                    if (!onSetAlpha(multipliedAlpha)) {
12993                        int layerFlags = Canvas.HAS_ALPHA_LAYER_SAVE_FLAG;
12994                        if ((flags & ViewGroup.FLAG_CLIP_CHILDREN) != 0 ||
12995                                layerType != LAYER_TYPE_NONE) {
12996                            layerFlags |= Canvas.CLIP_TO_LAYER_SAVE_FLAG;
12997                        }
12998                        if (useDisplayListProperties) {
12999                            displayList.setAlpha(alpha * getAlpha());
13000                        } else  if (layerType == LAYER_TYPE_NONE) {
13001                            final int scrollX = hasDisplayList ? 0 : sx;
13002                            final int scrollY = hasDisplayList ? 0 : sy;
13003                            canvas.saveLayerAlpha(scrollX, scrollY, scrollX + mRight - mLeft,
13004                                    scrollY + mBottom - mTop, multipliedAlpha, layerFlags);
13005                        }
13006                    } else {
13007                        // Alpha is handled by the child directly, clobber the layer's alpha
13008                        mPrivateFlags |= ALPHA_SET;
13009                    }
13010                }
13011            }
13012        } else if ((mPrivateFlags & ALPHA_SET) == ALPHA_SET) {
13013            onSetAlpha(255);
13014            mPrivateFlags &= ~ALPHA_SET;
13015        }
13016
13017        if ((flags & ViewGroup.FLAG_CLIP_CHILDREN) == ViewGroup.FLAG_CLIP_CHILDREN &&
13018                !useDisplayListProperties) {
13019            if (offsetForScroll) {
13020                canvas.clipRect(sx, sy, sx + (mRight - mLeft), sy + (mBottom - mTop));
13021            } else {
13022                if (!scalingRequired || cache == null) {
13023                    canvas.clipRect(0, 0, mRight - mLeft, mBottom - mTop);
13024                } else {
13025                    canvas.clipRect(0, 0, cache.getWidth(), cache.getHeight());
13026                }
13027            }
13028        }
13029
13030        if (!useDisplayListProperties && hasDisplayList) {
13031            displayList = getDisplayList();
13032            if (!displayList.isValid()) {
13033                // Uncommon, but possible. If a view is removed from the hierarchy during the call
13034                // to getDisplayList(), the display list will be marked invalid and we should not
13035                // try to use it again.
13036                displayList = null;
13037                hasDisplayList = false;
13038            }
13039        }
13040
13041        if (hasNoCache) {
13042            boolean layerRendered = false;
13043            if (layerType == LAYER_TYPE_HARDWARE && !useDisplayListProperties) {
13044                final HardwareLayer layer = getHardwareLayer();
13045                if (layer != null && layer.isValid()) {
13046                    mLayerPaint.setAlpha((int) (alpha * 255));
13047                    ((HardwareCanvas) canvas).drawHardwareLayer(layer, 0, 0, mLayerPaint);
13048                    layerRendered = true;
13049                } else {
13050                    final int scrollX = hasDisplayList ? 0 : sx;
13051                    final int scrollY = hasDisplayList ? 0 : sy;
13052                    canvas.saveLayer(scrollX, scrollY,
13053                            scrollX + mRight - mLeft, scrollY + mBottom - mTop, mLayerPaint,
13054                            Canvas.HAS_ALPHA_LAYER_SAVE_FLAG | Canvas.CLIP_TO_LAYER_SAVE_FLAG);
13055                }
13056            }
13057
13058            if (!layerRendered) {
13059                if (!hasDisplayList) {
13060                    // Fast path for layouts with no backgrounds
13061                    if ((mPrivateFlags & SKIP_DRAW) == SKIP_DRAW) {
13062                        if (ViewDebug.TRACE_HIERARCHY) {
13063                            ViewDebug.trace(parent, ViewDebug.HierarchyTraceType.DRAW);
13064                        }
13065                        mPrivateFlags &= ~DIRTY_MASK;
13066                        dispatchDraw(canvas);
13067                    } else {
13068                        draw(canvas);
13069                    }
13070                } else {
13071                    mPrivateFlags &= ~DIRTY_MASK;
13072                    ((HardwareCanvas) canvas).drawDisplayList(displayList, null, flags);
13073                }
13074            }
13075        } else if (cache != null) {
13076            mPrivateFlags &= ~DIRTY_MASK;
13077            Paint cachePaint;
13078
13079            if (layerType == LAYER_TYPE_NONE) {
13080                cachePaint = parent.mCachePaint;
13081                if (cachePaint == null) {
13082                    cachePaint = new Paint();
13083                    cachePaint.setDither(false);
13084                    parent.mCachePaint = cachePaint;
13085                }
13086                if (alpha < 1) {
13087                    cachePaint.setAlpha((int) (alpha * 255));
13088                    parent.mGroupFlags |= ViewGroup.FLAG_ALPHA_LOWER_THAN_ONE;
13089                } else if  ((flags & ViewGroup.FLAG_ALPHA_LOWER_THAN_ONE) != 0) {
13090                    cachePaint.setAlpha(255);
13091                    parent.mGroupFlags &= ~ViewGroup.FLAG_ALPHA_LOWER_THAN_ONE;
13092                }
13093            } else {
13094                cachePaint = mLayerPaint;
13095                cachePaint.setAlpha((int) (alpha * 255));
13096            }
13097            canvas.drawBitmap(cache, 0.0f, 0.0f, cachePaint);
13098        }
13099
13100        if (restoreTo >= 0) {
13101            canvas.restoreToCount(restoreTo);
13102        }
13103
13104        if (a != null && !more) {
13105            if (!hardwareAccelerated && !a.getFillAfter()) {
13106                onSetAlpha(255);
13107            }
13108            parent.finishAnimatingView(this, a);
13109        }
13110
13111        if (more && hardwareAccelerated) {
13112            // invalidation is the trigger to recreate display lists, so if we're using
13113            // display lists to render, force an invalidate to allow the animation to
13114            // continue drawing another frame
13115            parent.invalidate(true);
13116            if (a.hasAlpha() && (mPrivateFlags & ALPHA_SET) == ALPHA_SET) {
13117                // alpha animations should cause the child to recreate its display list
13118                invalidate(true);
13119            }
13120        }
13121
13122        mRecreateDisplayList = false;
13123
13124        return more;
13125    }
13126
13127    /**
13128     * Manually render this view (and all of its children) to the given Canvas.
13129     * The view must have already done a full layout before this function is
13130     * called.  When implementing a view, implement
13131     * {@link #onDraw(android.graphics.Canvas)} instead of overriding this method.
13132     * If you do need to override this method, call the superclass version.
13133     *
13134     * @param canvas The Canvas to which the View is rendered.
13135     */
13136    public void draw(Canvas canvas) {
13137        if (ViewDebug.TRACE_HIERARCHY) {
13138            ViewDebug.trace(this, ViewDebug.HierarchyTraceType.DRAW);
13139        }
13140
13141        final int privateFlags = mPrivateFlags;
13142        final boolean dirtyOpaque = (privateFlags & DIRTY_MASK) == DIRTY_OPAQUE &&
13143                (mAttachInfo == null || !mAttachInfo.mIgnoreDirtyState);
13144        mPrivateFlags = (privateFlags & ~DIRTY_MASK) | DRAWN;
13145
13146        /*
13147         * Draw traversal performs several drawing steps which must be executed
13148         * in the appropriate order:
13149         *
13150         *      1. Draw the background
13151         *      2. If necessary, save the canvas' layers to prepare for fading
13152         *      3. Draw view's content
13153         *      4. Draw children
13154         *      5. If necessary, draw the fading edges and restore layers
13155         *      6. Draw decorations (scrollbars for instance)
13156         */
13157
13158        // Step 1, draw the background, if needed
13159        int saveCount;
13160
13161        if (!dirtyOpaque) {
13162            final Drawable background = mBackground;
13163            if (background != null) {
13164                final int scrollX = mScrollX;
13165                final int scrollY = mScrollY;
13166
13167                if (mBackgroundSizeChanged) {
13168                    background.setBounds(0, 0,  mRight - mLeft, mBottom - mTop);
13169                    mBackgroundSizeChanged = false;
13170                }
13171
13172                if ((scrollX | scrollY) == 0) {
13173                    background.draw(canvas);
13174                } else {
13175                    canvas.translate(scrollX, scrollY);
13176                    background.draw(canvas);
13177                    canvas.translate(-scrollX, -scrollY);
13178                }
13179            }
13180        }
13181
13182        // skip step 2 & 5 if possible (common case)
13183        final int viewFlags = mViewFlags;
13184        boolean horizontalEdges = (viewFlags & FADING_EDGE_HORIZONTAL) != 0;
13185        boolean verticalEdges = (viewFlags & FADING_EDGE_VERTICAL) != 0;
13186        if (!verticalEdges && !horizontalEdges) {
13187            // Step 3, draw the content
13188            if (!dirtyOpaque) onDraw(canvas);
13189
13190            // Step 4, draw the children
13191            dispatchDraw(canvas);
13192
13193            // Step 6, draw decorations (scrollbars)
13194            onDrawScrollBars(canvas);
13195
13196            // we're done...
13197            return;
13198        }
13199
13200        /*
13201         * Here we do the full fledged routine...
13202         * (this is an uncommon case where speed matters less,
13203         * this is why we repeat some of the tests that have been
13204         * done above)
13205         */
13206
13207        boolean drawTop = false;
13208        boolean drawBottom = false;
13209        boolean drawLeft = false;
13210        boolean drawRight = false;
13211
13212        float topFadeStrength = 0.0f;
13213        float bottomFadeStrength = 0.0f;
13214        float leftFadeStrength = 0.0f;
13215        float rightFadeStrength = 0.0f;
13216
13217        // Step 2, save the canvas' layers
13218        int paddingLeft = mPaddingLeft;
13219
13220        final boolean offsetRequired = isPaddingOffsetRequired();
13221        if (offsetRequired) {
13222            paddingLeft += getLeftPaddingOffset();
13223        }
13224
13225        int left = mScrollX + paddingLeft;
13226        int right = left + mRight - mLeft - mPaddingRight - paddingLeft;
13227        int top = mScrollY + getFadeTop(offsetRequired);
13228        int bottom = top + getFadeHeight(offsetRequired);
13229
13230        if (offsetRequired) {
13231            right += getRightPaddingOffset();
13232            bottom += getBottomPaddingOffset();
13233        }
13234
13235        final ScrollabilityCache scrollabilityCache = mScrollCache;
13236        final float fadeHeight = scrollabilityCache.fadingEdgeLength;
13237        int length = (int) fadeHeight;
13238
13239        // clip the fade length if top and bottom fades overlap
13240        // overlapping fades produce odd-looking artifacts
13241        if (verticalEdges && (top + length > bottom - length)) {
13242            length = (bottom - top) / 2;
13243        }
13244
13245        // also clip horizontal fades if necessary
13246        if (horizontalEdges && (left + length > right - length)) {
13247            length = (right - left) / 2;
13248        }
13249
13250        if (verticalEdges) {
13251            topFadeStrength = Math.max(0.0f, Math.min(1.0f, getTopFadingEdgeStrength()));
13252            drawTop = topFadeStrength * fadeHeight > 1.0f;
13253            bottomFadeStrength = Math.max(0.0f, Math.min(1.0f, getBottomFadingEdgeStrength()));
13254            drawBottom = bottomFadeStrength * fadeHeight > 1.0f;
13255        }
13256
13257        if (horizontalEdges) {
13258            leftFadeStrength = Math.max(0.0f, Math.min(1.0f, getLeftFadingEdgeStrength()));
13259            drawLeft = leftFadeStrength * fadeHeight > 1.0f;
13260            rightFadeStrength = Math.max(0.0f, Math.min(1.0f, getRightFadingEdgeStrength()));
13261            drawRight = rightFadeStrength * fadeHeight > 1.0f;
13262        }
13263
13264        saveCount = canvas.getSaveCount();
13265
13266        int solidColor = getSolidColor();
13267        if (solidColor == 0) {
13268            final int flags = Canvas.HAS_ALPHA_LAYER_SAVE_FLAG;
13269
13270            if (drawTop) {
13271                canvas.saveLayer(left, top, right, top + length, null, flags);
13272            }
13273
13274            if (drawBottom) {
13275                canvas.saveLayer(left, bottom - length, right, bottom, null, flags);
13276            }
13277
13278            if (drawLeft) {
13279                canvas.saveLayer(left, top, left + length, bottom, null, flags);
13280            }
13281
13282            if (drawRight) {
13283                canvas.saveLayer(right - length, top, right, bottom, null, flags);
13284            }
13285        } else {
13286            scrollabilityCache.setFadeColor(solidColor);
13287        }
13288
13289        // Step 3, draw the content
13290        if (!dirtyOpaque) onDraw(canvas);
13291
13292        // Step 4, draw the children
13293        dispatchDraw(canvas);
13294
13295        // Step 5, draw the fade effect and restore layers
13296        final Paint p = scrollabilityCache.paint;
13297        final Matrix matrix = scrollabilityCache.matrix;
13298        final Shader fade = scrollabilityCache.shader;
13299
13300        if (drawTop) {
13301            matrix.setScale(1, fadeHeight * topFadeStrength);
13302            matrix.postTranslate(left, top);
13303            fade.setLocalMatrix(matrix);
13304            canvas.drawRect(left, top, right, top + length, p);
13305        }
13306
13307        if (drawBottom) {
13308            matrix.setScale(1, fadeHeight * bottomFadeStrength);
13309            matrix.postRotate(180);
13310            matrix.postTranslate(left, bottom);
13311            fade.setLocalMatrix(matrix);
13312            canvas.drawRect(left, bottom - length, right, bottom, p);
13313        }
13314
13315        if (drawLeft) {
13316            matrix.setScale(1, fadeHeight * leftFadeStrength);
13317            matrix.postRotate(-90);
13318            matrix.postTranslate(left, top);
13319            fade.setLocalMatrix(matrix);
13320            canvas.drawRect(left, top, left + length, bottom, p);
13321        }
13322
13323        if (drawRight) {
13324            matrix.setScale(1, fadeHeight * rightFadeStrength);
13325            matrix.postRotate(90);
13326            matrix.postTranslate(right, top);
13327            fade.setLocalMatrix(matrix);
13328            canvas.drawRect(right - length, top, right, bottom, p);
13329        }
13330
13331        canvas.restoreToCount(saveCount);
13332
13333        // Step 6, draw decorations (scrollbars)
13334        onDrawScrollBars(canvas);
13335    }
13336
13337    /**
13338     * Override this if your view is known to always be drawn on top of a solid color background,
13339     * and needs to draw fading edges. Returning a non-zero color enables the view system to
13340     * optimize the drawing of the fading edges. If you do return a non-zero color, the alpha
13341     * should be set to 0xFF.
13342     *
13343     * @see #setVerticalFadingEdgeEnabled(boolean)
13344     * @see #setHorizontalFadingEdgeEnabled(boolean)
13345     *
13346     * @return The known solid color background for this view, or 0 if the color may vary
13347     */
13348    @ViewDebug.ExportedProperty(category = "drawing")
13349    public int getSolidColor() {
13350        return 0;
13351    }
13352
13353    /**
13354     * Build a human readable string representation of the specified view flags.
13355     *
13356     * @param flags the view flags to convert to a string
13357     * @return a String representing the supplied flags
13358     */
13359    private static String printFlags(int flags) {
13360        String output = "";
13361        int numFlags = 0;
13362        if ((flags & FOCUSABLE_MASK) == FOCUSABLE) {
13363            output += "TAKES_FOCUS";
13364            numFlags++;
13365        }
13366
13367        switch (flags & VISIBILITY_MASK) {
13368        case INVISIBLE:
13369            if (numFlags > 0) {
13370                output += " ";
13371            }
13372            output += "INVISIBLE";
13373            // USELESS HERE numFlags++;
13374            break;
13375        case GONE:
13376            if (numFlags > 0) {
13377                output += " ";
13378            }
13379            output += "GONE";
13380            // USELESS HERE numFlags++;
13381            break;
13382        default:
13383            break;
13384        }
13385        return output;
13386    }
13387
13388    /**
13389     * Build a human readable string representation of the specified private
13390     * view flags.
13391     *
13392     * @param privateFlags the private view flags to convert to a string
13393     * @return a String representing the supplied flags
13394     */
13395    private static String printPrivateFlags(int privateFlags) {
13396        String output = "";
13397        int numFlags = 0;
13398
13399        if ((privateFlags & WANTS_FOCUS) == WANTS_FOCUS) {
13400            output += "WANTS_FOCUS";
13401            numFlags++;
13402        }
13403
13404        if ((privateFlags & FOCUSED) == FOCUSED) {
13405            if (numFlags > 0) {
13406                output += " ";
13407            }
13408            output += "FOCUSED";
13409            numFlags++;
13410        }
13411
13412        if ((privateFlags & SELECTED) == SELECTED) {
13413            if (numFlags > 0) {
13414                output += " ";
13415            }
13416            output += "SELECTED";
13417            numFlags++;
13418        }
13419
13420        if ((privateFlags & IS_ROOT_NAMESPACE) == IS_ROOT_NAMESPACE) {
13421            if (numFlags > 0) {
13422                output += " ";
13423            }
13424            output += "IS_ROOT_NAMESPACE";
13425            numFlags++;
13426        }
13427
13428        if ((privateFlags & HAS_BOUNDS) == HAS_BOUNDS) {
13429            if (numFlags > 0) {
13430                output += " ";
13431            }
13432            output += "HAS_BOUNDS";
13433            numFlags++;
13434        }
13435
13436        if ((privateFlags & DRAWN) == DRAWN) {
13437            if (numFlags > 0) {
13438                output += " ";
13439            }
13440            output += "DRAWN";
13441            // USELESS HERE numFlags++;
13442        }
13443        return output;
13444    }
13445
13446    /**
13447     * <p>Indicates whether or not this view's layout will be requested during
13448     * the next hierarchy layout pass.</p>
13449     *
13450     * @return true if the layout will be forced during next layout pass
13451     */
13452    public boolean isLayoutRequested() {
13453        return (mPrivateFlags & FORCE_LAYOUT) == FORCE_LAYOUT;
13454    }
13455
13456    /**
13457     * Assign a size and position to a view and all of its
13458     * descendants
13459     *
13460     * <p>This is the second phase of the layout mechanism.
13461     * (The first is measuring). In this phase, each parent calls
13462     * layout on all of its children to position them.
13463     * This is typically done using the child measurements
13464     * that were stored in the measure pass().</p>
13465     *
13466     * <p>Derived classes should not override this method.
13467     * Derived classes with children should override
13468     * onLayout. In that method, they should
13469     * call layout on each of their children.</p>
13470     *
13471     * @param l Left position, relative to parent
13472     * @param t Top position, relative to parent
13473     * @param r Right position, relative to parent
13474     * @param b Bottom position, relative to parent
13475     */
13476    @SuppressWarnings({"unchecked"})
13477    public void layout(int l, int t, int r, int b) {
13478        int oldL = mLeft;
13479        int oldT = mTop;
13480        int oldB = mBottom;
13481        int oldR = mRight;
13482        boolean changed = setFrame(l, t, r, b);
13483        if (changed || (mPrivateFlags & LAYOUT_REQUIRED) == LAYOUT_REQUIRED) {
13484            if (ViewDebug.TRACE_HIERARCHY) {
13485                ViewDebug.trace(this, ViewDebug.HierarchyTraceType.ON_LAYOUT);
13486            }
13487
13488            onLayout(changed, l, t, r, b);
13489            mPrivateFlags &= ~LAYOUT_REQUIRED;
13490
13491            ListenerInfo li = mListenerInfo;
13492            if (li != null && li.mOnLayoutChangeListeners != null) {
13493                ArrayList<OnLayoutChangeListener> listenersCopy =
13494                        (ArrayList<OnLayoutChangeListener>)li.mOnLayoutChangeListeners.clone();
13495                int numListeners = listenersCopy.size();
13496                for (int i = 0; i < numListeners; ++i) {
13497                    listenersCopy.get(i).onLayoutChange(this, l, t, r, b, oldL, oldT, oldR, oldB);
13498                }
13499            }
13500        }
13501        mPrivateFlags &= ~FORCE_LAYOUT;
13502    }
13503
13504    /**
13505     * Called from layout when this view should
13506     * assign a size and position to each of its children.
13507     *
13508     * Derived classes with children should override
13509     * this method and call layout on each of
13510     * their children.
13511     * @param changed This is a new size or position for this view
13512     * @param left Left position, relative to parent
13513     * @param top Top position, relative to parent
13514     * @param right Right position, relative to parent
13515     * @param bottom Bottom position, relative to parent
13516     */
13517    protected void onLayout(boolean changed, int left, int top, int right, int bottom) {
13518    }
13519
13520    /**
13521     * Assign a size and position to this view.
13522     *
13523     * This is called from layout.
13524     *
13525     * @param left Left position, relative to parent
13526     * @param top Top position, relative to parent
13527     * @param right Right position, relative to parent
13528     * @param bottom Bottom position, relative to parent
13529     * @return true if the new size and position are different than the
13530     *         previous ones
13531     * {@hide}
13532     */
13533    protected boolean setFrame(int left, int top, int right, int bottom) {
13534        boolean changed = false;
13535
13536        if (DBG) {
13537            Log.d("View", this + " View.setFrame(" + left + "," + top + ","
13538                    + right + "," + bottom + ")");
13539        }
13540
13541        if (mLeft != left || mRight != right || mTop != top || mBottom != bottom) {
13542            changed = true;
13543
13544            // Remember our drawn bit
13545            int drawn = mPrivateFlags & DRAWN;
13546
13547            int oldWidth = mRight - mLeft;
13548            int oldHeight = mBottom - mTop;
13549            int newWidth = right - left;
13550            int newHeight = bottom - top;
13551            boolean sizeChanged = (newWidth != oldWidth) || (newHeight != oldHeight);
13552
13553            // Invalidate our old position
13554            invalidate(sizeChanged);
13555
13556            mLeft = left;
13557            mTop = top;
13558            mRight = right;
13559            mBottom = bottom;
13560            if (mDisplayList != null) {
13561                mDisplayList.setLeftTopRightBottom(mLeft, mTop, mRight, mBottom);
13562            }
13563
13564            mPrivateFlags |= HAS_BOUNDS;
13565
13566
13567            if (sizeChanged) {
13568                if ((mPrivateFlags & PIVOT_EXPLICITLY_SET) == 0) {
13569                    // A change in dimension means an auto-centered pivot point changes, too
13570                    if (mTransformationInfo != null) {
13571                        mTransformationInfo.mMatrixDirty = true;
13572                    }
13573                }
13574                onSizeChanged(newWidth, newHeight, oldWidth, oldHeight);
13575            }
13576
13577            if ((mViewFlags & VISIBILITY_MASK) == VISIBLE) {
13578                // If we are visible, force the DRAWN bit to on so that
13579                // this invalidate will go through (at least to our parent).
13580                // This is because someone may have invalidated this view
13581                // before this call to setFrame came in, thereby clearing
13582                // the DRAWN bit.
13583                mPrivateFlags |= DRAWN;
13584                invalidate(sizeChanged);
13585                // parent display list may need to be recreated based on a change in the bounds
13586                // of any child
13587                invalidateParentCaches();
13588            }
13589
13590            // Reset drawn bit to original value (invalidate turns it off)
13591            mPrivateFlags |= drawn;
13592
13593            mBackgroundSizeChanged = true;
13594        }
13595        return changed;
13596    }
13597
13598    /**
13599     * Finalize inflating a view from XML.  This is called as the last phase
13600     * of inflation, after all child views have been added.
13601     *
13602     * <p>Even if the subclass overrides onFinishInflate, they should always be
13603     * sure to call the super method, so that we get called.
13604     */
13605    protected void onFinishInflate() {
13606    }
13607
13608    /**
13609     * Returns the resources associated with this view.
13610     *
13611     * @return Resources object.
13612     */
13613    public Resources getResources() {
13614        return mResources;
13615    }
13616
13617    /**
13618     * Invalidates the specified Drawable.
13619     *
13620     * @param drawable the drawable to invalidate
13621     */
13622    public void invalidateDrawable(Drawable drawable) {
13623        if (verifyDrawable(drawable)) {
13624            final Rect dirty = drawable.getBounds();
13625            final int scrollX = mScrollX;
13626            final int scrollY = mScrollY;
13627
13628            invalidate(dirty.left + scrollX, dirty.top + scrollY,
13629                    dirty.right + scrollX, dirty.bottom + scrollY);
13630        }
13631    }
13632
13633    /**
13634     * Schedules an action on a drawable to occur at a specified time.
13635     *
13636     * @param who the recipient of the action
13637     * @param what the action to run on the drawable
13638     * @param when the time at which the action must occur. Uses the
13639     *        {@link SystemClock#uptimeMillis} timebase.
13640     */
13641    public void scheduleDrawable(Drawable who, Runnable what, long when) {
13642        if (verifyDrawable(who) && what != null) {
13643            final long delay = when - SystemClock.uptimeMillis();
13644            if (mAttachInfo != null) {
13645                mAttachInfo.mViewRootImpl.mChoreographer.postCallbackDelayed(
13646                        Choreographer.CALLBACK_ANIMATION, what, who,
13647                        Choreographer.subtractFrameDelay(delay));
13648            } else {
13649                ViewRootImpl.getRunQueue().postDelayed(what, delay);
13650            }
13651        }
13652    }
13653
13654    /**
13655     * Cancels a scheduled action on a drawable.
13656     *
13657     * @param who the recipient of the action
13658     * @param what the action to cancel
13659     */
13660    public void unscheduleDrawable(Drawable who, Runnable what) {
13661        if (verifyDrawable(who) && what != null) {
13662            if (mAttachInfo != null) {
13663                mAttachInfo.mViewRootImpl.mChoreographer.removeCallbacks(
13664                        Choreographer.CALLBACK_ANIMATION, what, who);
13665            } else {
13666                ViewRootImpl.getRunQueue().removeCallbacks(what);
13667            }
13668        }
13669    }
13670
13671    /**
13672     * Unschedule any events associated with the given Drawable.  This can be
13673     * used when selecting a new Drawable into a view, so that the previous
13674     * one is completely unscheduled.
13675     *
13676     * @param who The Drawable to unschedule.
13677     *
13678     * @see #drawableStateChanged
13679     */
13680    public void unscheduleDrawable(Drawable who) {
13681        if (mAttachInfo != null && who != null) {
13682            mAttachInfo.mViewRootImpl.mChoreographer.removeCallbacks(
13683                    Choreographer.CALLBACK_ANIMATION, null, who);
13684        }
13685    }
13686
13687    /**
13688    * Return the layout direction of a given Drawable.
13689    *
13690    * @param who the Drawable to query
13691    */
13692    public int getResolvedLayoutDirection(Drawable who) {
13693        return (who == mBackground) ? getResolvedLayoutDirection() : LAYOUT_DIRECTION_DEFAULT;
13694    }
13695
13696    /**
13697     * If your view subclass is displaying its own Drawable objects, it should
13698     * override this function and return true for any Drawable it is
13699     * displaying.  This allows animations for those drawables to be
13700     * scheduled.
13701     *
13702     * <p>Be sure to call through to the super class when overriding this
13703     * function.
13704     *
13705     * @param who The Drawable to verify.  Return true if it is one you are
13706     *            displaying, else return the result of calling through to the
13707     *            super class.
13708     *
13709     * @return boolean If true than the Drawable is being displayed in the
13710     *         view; else false and it is not allowed to animate.
13711     *
13712     * @see #unscheduleDrawable(android.graphics.drawable.Drawable)
13713     * @see #drawableStateChanged()
13714     */
13715    protected boolean verifyDrawable(Drawable who) {
13716        return who == mBackground;
13717    }
13718
13719    /**
13720     * This function is called whenever the state of the view changes in such
13721     * a way that it impacts the state of drawables being shown.
13722     *
13723     * <p>Be sure to call through to the superclass when overriding this
13724     * function.
13725     *
13726     * @see Drawable#setState(int[])
13727     */
13728    protected void drawableStateChanged() {
13729        Drawable d = mBackground;
13730        if (d != null && d.isStateful()) {
13731            d.setState(getDrawableState());
13732        }
13733    }
13734
13735    /**
13736     * Call this to force a view to update its drawable state. This will cause
13737     * drawableStateChanged to be called on this view. Views that are interested
13738     * in the new state should call getDrawableState.
13739     *
13740     * @see #drawableStateChanged
13741     * @see #getDrawableState
13742     */
13743    public void refreshDrawableState() {
13744        mPrivateFlags |= DRAWABLE_STATE_DIRTY;
13745        drawableStateChanged();
13746
13747        ViewParent parent = mParent;
13748        if (parent != null) {
13749            parent.childDrawableStateChanged(this);
13750        }
13751    }
13752
13753    /**
13754     * Return an array of resource IDs of the drawable states representing the
13755     * current state of the view.
13756     *
13757     * @return The current drawable state
13758     *
13759     * @see Drawable#setState(int[])
13760     * @see #drawableStateChanged()
13761     * @see #onCreateDrawableState(int)
13762     */
13763    public final int[] getDrawableState() {
13764        if ((mDrawableState != null) && ((mPrivateFlags & DRAWABLE_STATE_DIRTY) == 0)) {
13765            return mDrawableState;
13766        } else {
13767            mDrawableState = onCreateDrawableState(0);
13768            mPrivateFlags &= ~DRAWABLE_STATE_DIRTY;
13769            return mDrawableState;
13770        }
13771    }
13772
13773    /**
13774     * Generate the new {@link android.graphics.drawable.Drawable} state for
13775     * this view. This is called by the view
13776     * system when the cached Drawable state is determined to be invalid.  To
13777     * retrieve the current state, you should use {@link #getDrawableState}.
13778     *
13779     * @param extraSpace if non-zero, this is the number of extra entries you
13780     * would like in the returned array in which you can place your own
13781     * states.
13782     *
13783     * @return Returns an array holding the current {@link Drawable} state of
13784     * the view.
13785     *
13786     * @see #mergeDrawableStates(int[], int[])
13787     */
13788    protected int[] onCreateDrawableState(int extraSpace) {
13789        if ((mViewFlags & DUPLICATE_PARENT_STATE) == DUPLICATE_PARENT_STATE &&
13790                mParent instanceof View) {
13791            return ((View) mParent).onCreateDrawableState(extraSpace);
13792        }
13793
13794        int[] drawableState;
13795
13796        int privateFlags = mPrivateFlags;
13797
13798        int viewStateIndex = 0;
13799        if ((privateFlags & PRESSED) != 0) viewStateIndex |= VIEW_STATE_PRESSED;
13800        if ((mViewFlags & ENABLED_MASK) == ENABLED) viewStateIndex |= VIEW_STATE_ENABLED;
13801        if (isFocused()) viewStateIndex |= VIEW_STATE_FOCUSED;
13802        if ((privateFlags & SELECTED) != 0) viewStateIndex |= VIEW_STATE_SELECTED;
13803        if (hasWindowFocus()) viewStateIndex |= VIEW_STATE_WINDOW_FOCUSED;
13804        if ((privateFlags & ACTIVATED) != 0) viewStateIndex |= VIEW_STATE_ACTIVATED;
13805        if (mAttachInfo != null && mAttachInfo.mHardwareAccelerationRequested &&
13806                HardwareRenderer.isAvailable()) {
13807            // This is set if HW acceleration is requested, even if the current
13808            // process doesn't allow it.  This is just to allow app preview
13809            // windows to better match their app.
13810            viewStateIndex |= VIEW_STATE_ACCELERATED;
13811        }
13812        if ((privateFlags & HOVERED) != 0) viewStateIndex |= VIEW_STATE_HOVERED;
13813
13814        final int privateFlags2 = mPrivateFlags2;
13815        if ((privateFlags2 & DRAG_CAN_ACCEPT) != 0) viewStateIndex |= VIEW_STATE_DRAG_CAN_ACCEPT;
13816        if ((privateFlags2 & DRAG_HOVERED) != 0) viewStateIndex |= VIEW_STATE_DRAG_HOVERED;
13817
13818        drawableState = VIEW_STATE_SETS[viewStateIndex];
13819
13820        //noinspection ConstantIfStatement
13821        if (false) {
13822            Log.i("View", "drawableStateIndex=" + viewStateIndex);
13823            Log.i("View", toString()
13824                    + " pressed=" + ((privateFlags & PRESSED) != 0)
13825                    + " en=" + ((mViewFlags & ENABLED_MASK) == ENABLED)
13826                    + " fo=" + hasFocus()
13827                    + " sl=" + ((privateFlags & SELECTED) != 0)
13828                    + " wf=" + hasWindowFocus()
13829                    + ": " + Arrays.toString(drawableState));
13830        }
13831
13832        if (extraSpace == 0) {
13833            return drawableState;
13834        }
13835
13836        final int[] fullState;
13837        if (drawableState != null) {
13838            fullState = new int[drawableState.length + extraSpace];
13839            System.arraycopy(drawableState, 0, fullState, 0, drawableState.length);
13840        } else {
13841            fullState = new int[extraSpace];
13842        }
13843
13844        return fullState;
13845    }
13846
13847    /**
13848     * Merge your own state values in <var>additionalState</var> into the base
13849     * state values <var>baseState</var> that were returned by
13850     * {@link #onCreateDrawableState(int)}.
13851     *
13852     * @param baseState The base state values returned by
13853     * {@link #onCreateDrawableState(int)}, which will be modified to also hold your
13854     * own additional state values.
13855     *
13856     * @param additionalState The additional state values you would like
13857     * added to <var>baseState</var>; this array is not modified.
13858     *
13859     * @return As a convenience, the <var>baseState</var> array you originally
13860     * passed into the function is returned.
13861     *
13862     * @see #onCreateDrawableState(int)
13863     */
13864    protected static int[] mergeDrawableStates(int[] baseState, int[] additionalState) {
13865        final int N = baseState.length;
13866        int i = N - 1;
13867        while (i >= 0 && baseState[i] == 0) {
13868            i--;
13869        }
13870        System.arraycopy(additionalState, 0, baseState, i + 1, additionalState.length);
13871        return baseState;
13872    }
13873
13874    /**
13875     * Call {@link Drawable#jumpToCurrentState() Drawable.jumpToCurrentState()}
13876     * on all Drawable objects associated with this view.
13877     */
13878    public void jumpDrawablesToCurrentState() {
13879        if (mBackground != null) {
13880            mBackground.jumpToCurrentState();
13881        }
13882    }
13883
13884    /**
13885     * Sets the background color for this view.
13886     * @param color the color of the background
13887     */
13888    @RemotableViewMethod
13889    public void setBackgroundColor(int color) {
13890        if (mBackground instanceof ColorDrawable) {
13891            ((ColorDrawable) mBackground).setColor(color);
13892        } else {
13893            setBackground(new ColorDrawable(color));
13894        }
13895    }
13896
13897    /**
13898     * Set the background to a given resource. The resource should refer to
13899     * a Drawable object or 0 to remove the background.
13900     * @param resid The identifier of the resource.
13901     *
13902     * @attr ref android.R.styleable#View_background
13903     */
13904    @RemotableViewMethod
13905    public void setBackgroundResource(int resid) {
13906        if (resid != 0 && resid == mBackgroundResource) {
13907            return;
13908        }
13909
13910        Drawable d= null;
13911        if (resid != 0) {
13912            d = mResources.getDrawable(resid);
13913        }
13914        setBackground(d);
13915
13916        mBackgroundResource = resid;
13917    }
13918
13919    /**
13920     * Set the background to a given Drawable, or remove the background. If the
13921     * background has padding, this View's padding is set to the background's
13922     * padding. However, when a background is removed, this View's padding isn't
13923     * touched. If setting the padding is desired, please use
13924     * {@link #setPadding(int, int, int, int)}.
13925     *
13926     * @param background The Drawable to use as the background, or null to remove the
13927     *        background
13928     */
13929    public void setBackground(Drawable background) {
13930        //noinspection deprecation
13931        setBackgroundDrawable(background);
13932    }
13933
13934    /**
13935     * @deprecated use {@link #setBackground(Drawable)} instead
13936     */
13937    @Deprecated
13938    public void setBackgroundDrawable(Drawable background) {
13939        if (background == mBackground) {
13940            return;
13941        }
13942
13943        boolean requestLayout = false;
13944
13945        mBackgroundResource = 0;
13946
13947        /*
13948         * Regardless of whether we're setting a new background or not, we want
13949         * to clear the previous drawable.
13950         */
13951        if (mBackground != null) {
13952            mBackground.setCallback(null);
13953            unscheduleDrawable(mBackground);
13954        }
13955
13956        if (background != null) {
13957            Rect padding = sThreadLocal.get();
13958            if (padding == null) {
13959                padding = new Rect();
13960                sThreadLocal.set(padding);
13961            }
13962            if (background.getPadding(padding)) {
13963                switch (background.getResolvedLayoutDirectionSelf()) {
13964                    case LAYOUT_DIRECTION_RTL:
13965                        setPadding(padding.right, padding.top, padding.left, padding.bottom);
13966                        break;
13967                    case LAYOUT_DIRECTION_LTR:
13968                    default:
13969                        setPadding(padding.left, padding.top, padding.right, padding.bottom);
13970                }
13971            }
13972
13973            // Compare the minimum sizes of the old Drawable and the new.  If there isn't an old or
13974            // if it has a different minimum size, we should layout again
13975            if (mBackground == null || mBackground.getMinimumHeight() != background.getMinimumHeight() ||
13976                    mBackground.getMinimumWidth() != background.getMinimumWidth()) {
13977                requestLayout = true;
13978            }
13979
13980            background.setCallback(this);
13981            if (background.isStateful()) {
13982                background.setState(getDrawableState());
13983            }
13984            background.setVisible(getVisibility() == VISIBLE, false);
13985            mBackground = background;
13986
13987            if ((mPrivateFlags & SKIP_DRAW) != 0) {
13988                mPrivateFlags &= ~SKIP_DRAW;
13989                mPrivateFlags |= ONLY_DRAWS_BACKGROUND;
13990                requestLayout = true;
13991            }
13992        } else {
13993            /* Remove the background */
13994            mBackground = null;
13995
13996            if ((mPrivateFlags & ONLY_DRAWS_BACKGROUND) != 0) {
13997                /*
13998                 * This view ONLY drew the background before and we're removing
13999                 * the background, so now it won't draw anything
14000                 * (hence we SKIP_DRAW)
14001                 */
14002                mPrivateFlags &= ~ONLY_DRAWS_BACKGROUND;
14003                mPrivateFlags |= SKIP_DRAW;
14004            }
14005
14006            /*
14007             * When the background is set, we try to apply its padding to this
14008             * View. When the background is removed, we don't touch this View's
14009             * padding. This is noted in the Javadocs. Hence, we don't need to
14010             * requestLayout(), the invalidate() below is sufficient.
14011             */
14012
14013            // The old background's minimum size could have affected this
14014            // View's layout, so let's requestLayout
14015            requestLayout = true;
14016        }
14017
14018        computeOpaqueFlags();
14019
14020        if (requestLayout) {
14021            requestLayout();
14022        }
14023
14024        mBackgroundSizeChanged = true;
14025        invalidate(true);
14026    }
14027
14028    /**
14029     * Gets the background drawable
14030     *
14031     * @return The drawable used as the background for this view, if any.
14032     *
14033     * @see #setBackground(Drawable)
14034     *
14035     * @attr ref android.R.styleable#View_background
14036     */
14037    public Drawable getBackground() {
14038        return mBackground;
14039    }
14040
14041    /**
14042     * Sets the padding. The view may add on the space required to display
14043     * the scrollbars, depending on the style and visibility of the scrollbars.
14044     * So the values returned from {@link #getPaddingLeft}, {@link #getPaddingTop},
14045     * {@link #getPaddingRight} and {@link #getPaddingBottom} may be different
14046     * from the values set in this call.
14047     *
14048     * @attr ref android.R.styleable#View_padding
14049     * @attr ref android.R.styleable#View_paddingBottom
14050     * @attr ref android.R.styleable#View_paddingLeft
14051     * @attr ref android.R.styleable#View_paddingRight
14052     * @attr ref android.R.styleable#View_paddingTop
14053     * @param left the left padding in pixels
14054     * @param top the top padding in pixels
14055     * @param right the right padding in pixels
14056     * @param bottom the bottom padding in pixels
14057     */
14058    public void setPadding(int left, int top, int right, int bottom) {
14059        mUserPaddingStart = -1;
14060        mUserPaddingEnd = -1;
14061        mUserPaddingRelative = false;
14062
14063        internalSetPadding(left, top, right, bottom);
14064    }
14065
14066    private void internalSetPadding(int left, int top, int right, int bottom) {
14067        mUserPaddingLeft = left;
14068        mUserPaddingRight = right;
14069        mUserPaddingBottom = bottom;
14070
14071        final int viewFlags = mViewFlags;
14072        boolean changed = false;
14073
14074        // Common case is there are no scroll bars.
14075        if ((viewFlags & (SCROLLBARS_VERTICAL|SCROLLBARS_HORIZONTAL)) != 0) {
14076            if ((viewFlags & SCROLLBARS_VERTICAL) != 0) {
14077                final int offset = (viewFlags & SCROLLBARS_INSET_MASK) == 0
14078                        ? 0 : getVerticalScrollbarWidth();
14079                switch (mVerticalScrollbarPosition) {
14080                    case SCROLLBAR_POSITION_DEFAULT:
14081                        if (getResolvedLayoutDirection() == LAYOUT_DIRECTION_RTL) {
14082                            left += offset;
14083                        } else {
14084                            right += offset;
14085                        }
14086                        break;
14087                    case SCROLLBAR_POSITION_RIGHT:
14088                        right += offset;
14089                        break;
14090                    case SCROLLBAR_POSITION_LEFT:
14091                        left += offset;
14092                        break;
14093                }
14094            }
14095            if ((viewFlags & SCROLLBARS_HORIZONTAL) != 0) {
14096                bottom += (viewFlags & SCROLLBARS_INSET_MASK) == 0
14097                        ? 0 : getHorizontalScrollbarHeight();
14098            }
14099        }
14100
14101        if (mPaddingLeft != left) {
14102            changed = true;
14103            mPaddingLeft = left;
14104        }
14105        if (mPaddingTop != top) {
14106            changed = true;
14107            mPaddingTop = top;
14108        }
14109        if (mPaddingRight != right) {
14110            changed = true;
14111            mPaddingRight = right;
14112        }
14113        if (mPaddingBottom != bottom) {
14114            changed = true;
14115            mPaddingBottom = bottom;
14116        }
14117
14118        if (changed) {
14119            requestLayout();
14120        }
14121    }
14122
14123    /**
14124     * Sets the relative padding. The view may add on the space required to display
14125     * the scrollbars, depending on the style and visibility of the scrollbars.
14126     * So the values returned from {@link #getPaddingStart}, {@link #getPaddingTop},
14127     * {@link #getPaddingEnd} and {@link #getPaddingBottom} may be different
14128     * from the values set in this call.
14129     *
14130     * @attr ref android.R.styleable#View_padding
14131     * @attr ref android.R.styleable#View_paddingBottom
14132     * @attr ref android.R.styleable#View_paddingStart
14133     * @attr ref android.R.styleable#View_paddingEnd
14134     * @attr ref android.R.styleable#View_paddingTop
14135     * @param start the start padding in pixels
14136     * @param top the top padding in pixels
14137     * @param end the end padding in pixels
14138     * @param bottom the bottom padding in pixels
14139     */
14140    public void setPaddingRelative(int start, int top, int end, int bottom) {
14141        mUserPaddingStart = start;
14142        mUserPaddingEnd = end;
14143        mUserPaddingRelative = true;
14144
14145        switch(getResolvedLayoutDirection()) {
14146            case LAYOUT_DIRECTION_RTL:
14147                internalSetPadding(end, top, start, bottom);
14148                break;
14149            case LAYOUT_DIRECTION_LTR:
14150            default:
14151                internalSetPadding(start, top, end, bottom);
14152        }
14153    }
14154
14155    /**
14156     * Returns the top padding of this view.
14157     *
14158     * @return the top padding in pixels
14159     */
14160    public int getPaddingTop() {
14161        return mPaddingTop;
14162    }
14163
14164    /**
14165     * Returns the bottom padding of this view. If there are inset and enabled
14166     * scrollbars, this value may include the space required to display the
14167     * scrollbars as well.
14168     *
14169     * @return the bottom padding in pixels
14170     */
14171    public int getPaddingBottom() {
14172        return mPaddingBottom;
14173    }
14174
14175    /**
14176     * Returns the left padding of this view. If there are inset and enabled
14177     * scrollbars, this value may include the space required to display the
14178     * scrollbars as well.
14179     *
14180     * @return the left padding in pixels
14181     */
14182    public int getPaddingLeft() {
14183        return mPaddingLeft;
14184    }
14185
14186    /**
14187     * Returns the start padding of this view depending on its resolved layout direction.
14188     * If there are inset and enabled scrollbars, this value may include the space
14189     * required to display the scrollbars as well.
14190     *
14191     * @return the start padding in pixels
14192     */
14193    public int getPaddingStart() {
14194        return (getResolvedLayoutDirection() == LAYOUT_DIRECTION_RTL) ?
14195                mPaddingRight : mPaddingLeft;
14196    }
14197
14198    /**
14199     * Returns the right padding of this view. If there are inset and enabled
14200     * scrollbars, this value may include the space required to display the
14201     * scrollbars as well.
14202     *
14203     * @return the right padding in pixels
14204     */
14205    public int getPaddingRight() {
14206        return mPaddingRight;
14207    }
14208
14209    /**
14210     * Returns the end padding of this view depending on its resolved layout direction.
14211     * If there are inset and enabled scrollbars, this value may include the space
14212     * required to display the scrollbars as well.
14213     *
14214     * @return the end padding in pixels
14215     */
14216    public int getPaddingEnd() {
14217        return (getResolvedLayoutDirection() == LAYOUT_DIRECTION_RTL) ?
14218                mPaddingLeft : mPaddingRight;
14219    }
14220
14221    /**
14222     * Return if the padding as been set thru relative values
14223     * {@link #setPaddingRelative(int, int, int, int)} or thru
14224     * @attr ref android.R.styleable#View_paddingStart or
14225     * @attr ref android.R.styleable#View_paddingEnd
14226     *
14227     * @return true if the padding is relative or false if it is not.
14228     */
14229    public boolean isPaddingRelative() {
14230        return mUserPaddingRelative;
14231    }
14232
14233    /**
14234     * @hide
14235     */
14236    public Insets getOpticalInsets() {
14237        if (mLayoutInsets == null) {
14238            mLayoutInsets = (mBackground == null) ? Insets.NONE : mBackground.getLayoutInsets();
14239        }
14240        return mLayoutInsets;
14241    }
14242
14243    /**
14244     * @hide
14245     */
14246    public void setLayoutInsets(Insets layoutInsets) {
14247        mLayoutInsets = layoutInsets;
14248    }
14249
14250    /**
14251     * Changes the selection state of this view. A view can be selected or not.
14252     * Note that selection is not the same as focus. Views are typically
14253     * selected in the context of an AdapterView like ListView or GridView;
14254     * the selected view is the view that is highlighted.
14255     *
14256     * @param selected true if the view must be selected, false otherwise
14257     */
14258    public void setSelected(boolean selected) {
14259        if (((mPrivateFlags & SELECTED) != 0) != selected) {
14260            mPrivateFlags = (mPrivateFlags & ~SELECTED) | (selected ? SELECTED : 0);
14261            if (!selected) resetPressedState();
14262            invalidate(true);
14263            refreshDrawableState();
14264            dispatchSetSelected(selected);
14265            if (AccessibilityManager.getInstance(mContext).isEnabled()) {
14266                notifyAccessibilityStateChanged();
14267            }
14268        }
14269    }
14270
14271    /**
14272     * Dispatch setSelected to all of this View's children.
14273     *
14274     * @see #setSelected(boolean)
14275     *
14276     * @param selected The new selected state
14277     */
14278    protected void dispatchSetSelected(boolean selected) {
14279    }
14280
14281    /**
14282     * Indicates the selection state of this view.
14283     *
14284     * @return true if the view is selected, false otherwise
14285     */
14286    @ViewDebug.ExportedProperty
14287    public boolean isSelected() {
14288        return (mPrivateFlags & SELECTED) != 0;
14289    }
14290
14291    /**
14292     * Changes the activated state of this view. A view can be activated or not.
14293     * Note that activation is not the same as selection.  Selection is
14294     * a transient property, representing the view (hierarchy) the user is
14295     * currently interacting with.  Activation is a longer-term state that the
14296     * user can move views in and out of.  For example, in a list view with
14297     * single or multiple selection enabled, the views in the current selection
14298     * set are activated.  (Um, yeah, we are deeply sorry about the terminology
14299     * here.)  The activated state is propagated down to children of the view it
14300     * is set on.
14301     *
14302     * @param activated true if the view must be activated, false otherwise
14303     */
14304    public void setActivated(boolean activated) {
14305        if (((mPrivateFlags & ACTIVATED) != 0) != activated) {
14306            mPrivateFlags = (mPrivateFlags & ~ACTIVATED) | (activated ? ACTIVATED : 0);
14307            invalidate(true);
14308            refreshDrawableState();
14309            dispatchSetActivated(activated);
14310        }
14311    }
14312
14313    /**
14314     * Dispatch setActivated to all of this View's children.
14315     *
14316     * @see #setActivated(boolean)
14317     *
14318     * @param activated The new activated state
14319     */
14320    protected void dispatchSetActivated(boolean activated) {
14321    }
14322
14323    /**
14324     * Indicates the activation state of this view.
14325     *
14326     * @return true if the view is activated, false otherwise
14327     */
14328    @ViewDebug.ExportedProperty
14329    public boolean isActivated() {
14330        return (mPrivateFlags & ACTIVATED) != 0;
14331    }
14332
14333    /**
14334     * Returns the ViewTreeObserver for this view's hierarchy. The view tree
14335     * observer can be used to get notifications when global events, like
14336     * layout, happen.
14337     *
14338     * The returned ViewTreeObserver observer is not guaranteed to remain
14339     * valid for the lifetime of this View. If the caller of this method keeps
14340     * a long-lived reference to ViewTreeObserver, it should always check for
14341     * the return value of {@link ViewTreeObserver#isAlive()}.
14342     *
14343     * @return The ViewTreeObserver for this view's hierarchy.
14344     */
14345    public ViewTreeObserver getViewTreeObserver() {
14346        if (mAttachInfo != null) {
14347            return mAttachInfo.mTreeObserver;
14348        }
14349        if (mFloatingTreeObserver == null) {
14350            mFloatingTreeObserver = new ViewTreeObserver();
14351        }
14352        return mFloatingTreeObserver;
14353    }
14354
14355    /**
14356     * <p>Finds the topmost view in the current view hierarchy.</p>
14357     *
14358     * @return the topmost view containing this view
14359     */
14360    public View getRootView() {
14361        if (mAttachInfo != null) {
14362            final View v = mAttachInfo.mRootView;
14363            if (v != null) {
14364                return v;
14365            }
14366        }
14367
14368        View parent = this;
14369
14370        while (parent.mParent != null && parent.mParent instanceof View) {
14371            parent = (View) parent.mParent;
14372        }
14373
14374        return parent;
14375    }
14376
14377    /**
14378     * <p>Computes the coordinates of this view on the screen. The argument
14379     * must be an array of two integers. After the method returns, the array
14380     * contains the x and y location in that order.</p>
14381     *
14382     * @param location an array of two integers in which to hold the coordinates
14383     */
14384    public void getLocationOnScreen(int[] location) {
14385        getLocationInWindow(location);
14386
14387        final AttachInfo info = mAttachInfo;
14388        if (info != null) {
14389            location[0] += info.mWindowLeft;
14390            location[1] += info.mWindowTop;
14391        }
14392    }
14393
14394    /**
14395     * <p>Computes the coordinates of this view in its window. The argument
14396     * must be an array of two integers. After the method returns, the array
14397     * contains the x and y location in that order.</p>
14398     *
14399     * @param location an array of two integers in which to hold the coordinates
14400     */
14401    public void getLocationInWindow(int[] location) {
14402        if (location == null || location.length < 2) {
14403            throw new IllegalArgumentException("location must be an array of two integers");
14404        }
14405
14406        if (mAttachInfo == null) {
14407            // When the view is not attached to a window, this method does not make sense
14408            location[0] = location[1] = 0;
14409            return;
14410        }
14411
14412        float[] position = mAttachInfo.mTmpTransformLocation;
14413        position[0] = position[1] = 0.0f;
14414
14415        if (!hasIdentityMatrix()) {
14416            getMatrix().mapPoints(position);
14417        }
14418
14419        position[0] += mLeft;
14420        position[1] += mTop;
14421
14422        ViewParent viewParent = mParent;
14423        while (viewParent instanceof View) {
14424            final View view = (View) viewParent;
14425
14426            position[0] -= view.mScrollX;
14427            position[1] -= view.mScrollY;
14428
14429            if (!view.hasIdentityMatrix()) {
14430                view.getMatrix().mapPoints(position);
14431            }
14432
14433            position[0] += view.mLeft;
14434            position[1] += view.mTop;
14435
14436            viewParent = view.mParent;
14437         }
14438
14439        if (viewParent instanceof ViewRootImpl) {
14440            // *cough*
14441            final ViewRootImpl vr = (ViewRootImpl) viewParent;
14442            position[1] -= vr.mCurScrollY;
14443        }
14444
14445        location[0] = (int) (position[0] + 0.5f);
14446        location[1] = (int) (position[1] + 0.5f);
14447    }
14448
14449    /**
14450     * {@hide}
14451     * @param id the id of the view to be found
14452     * @return the view of the specified id, null if cannot be found
14453     */
14454    protected View findViewTraversal(int id) {
14455        if (id == mID) {
14456            return this;
14457        }
14458        return null;
14459    }
14460
14461    /**
14462     * {@hide}
14463     * @param tag the tag of the view to be found
14464     * @return the view of specified tag, null if cannot be found
14465     */
14466    protected View findViewWithTagTraversal(Object tag) {
14467        if (tag != null && tag.equals(mTag)) {
14468            return this;
14469        }
14470        return null;
14471    }
14472
14473    /**
14474     * {@hide}
14475     * @param predicate The predicate to evaluate.
14476     * @param childToSkip If not null, ignores this child during the recursive traversal.
14477     * @return The first view that matches the predicate or null.
14478     */
14479    protected View findViewByPredicateTraversal(Predicate<View> predicate, View childToSkip) {
14480        if (predicate.apply(this)) {
14481            return this;
14482        }
14483        return null;
14484    }
14485
14486    /**
14487     * Look for a child view with the given id.  If this view has the given
14488     * id, return this view.
14489     *
14490     * @param id The id to search for.
14491     * @return The view that has the given id in the hierarchy or null
14492     */
14493    public final View findViewById(int id) {
14494        if (id < 0) {
14495            return null;
14496        }
14497        return findViewTraversal(id);
14498    }
14499
14500    /**
14501     * Finds a view by its unuque and stable accessibility id.
14502     *
14503     * @param accessibilityId The searched accessibility id.
14504     * @return The found view.
14505     */
14506    final View findViewByAccessibilityId(int accessibilityId) {
14507        if (accessibilityId < 0) {
14508            return null;
14509        }
14510        return findViewByAccessibilityIdTraversal(accessibilityId);
14511    }
14512
14513    /**
14514     * Performs the traversal to find a view by its unuque and stable accessibility id.
14515     *
14516     * <strong>Note:</strong>This method does not stop at the root namespace
14517     * boundary since the user can touch the screen at an arbitrary location
14518     * potentially crossing the root namespace bounday which will send an
14519     * accessibility event to accessibility services and they should be able
14520     * to obtain the event source. Also accessibility ids are guaranteed to be
14521     * unique in the window.
14522     *
14523     * @param accessibilityId The accessibility id.
14524     * @return The found view.
14525     */
14526    View findViewByAccessibilityIdTraversal(int accessibilityId) {
14527        if (getAccessibilityViewId() == accessibilityId) {
14528            return this;
14529        }
14530        return null;
14531    }
14532
14533    /**
14534     * Look for a child view with the given tag.  If this view has the given
14535     * tag, return this view.
14536     *
14537     * @param tag The tag to search for, using "tag.equals(getTag())".
14538     * @return The View that has the given tag in the hierarchy or null
14539     */
14540    public final View findViewWithTag(Object tag) {
14541        if (tag == null) {
14542            return null;
14543        }
14544        return findViewWithTagTraversal(tag);
14545    }
14546
14547    /**
14548     * {@hide}
14549     * Look for a child view that matches the specified predicate.
14550     * If this view matches the predicate, return this view.
14551     *
14552     * @param predicate The predicate to evaluate.
14553     * @return The first view that matches the predicate or null.
14554     */
14555    public final View findViewByPredicate(Predicate<View> predicate) {
14556        return findViewByPredicateTraversal(predicate, null);
14557    }
14558
14559    /**
14560     * {@hide}
14561     * Look for a child view that matches the specified predicate,
14562     * starting with the specified view and its descendents and then
14563     * recusively searching the ancestors and siblings of that view
14564     * until this view is reached.
14565     *
14566     * This method is useful in cases where the predicate does not match
14567     * a single unique view (perhaps multiple views use the same id)
14568     * and we are trying to find the view that is "closest" in scope to the
14569     * starting view.
14570     *
14571     * @param start The view to start from.
14572     * @param predicate The predicate to evaluate.
14573     * @return The first view that matches the predicate or null.
14574     */
14575    public final View findViewByPredicateInsideOut(View start, Predicate<View> predicate) {
14576        View childToSkip = null;
14577        for (;;) {
14578            View view = start.findViewByPredicateTraversal(predicate, childToSkip);
14579            if (view != null || start == this) {
14580                return view;
14581            }
14582
14583            ViewParent parent = start.getParent();
14584            if (parent == null || !(parent instanceof View)) {
14585                return null;
14586            }
14587
14588            childToSkip = start;
14589            start = (View) parent;
14590        }
14591    }
14592
14593    /**
14594     * Sets the identifier for this view. The identifier does not have to be
14595     * unique in this view's hierarchy. The identifier should be a positive
14596     * number.
14597     *
14598     * @see #NO_ID
14599     * @see #getId()
14600     * @see #findViewById(int)
14601     *
14602     * @param id a number used to identify the view
14603     *
14604     * @attr ref android.R.styleable#View_id
14605     */
14606    public void setId(int id) {
14607        mID = id;
14608    }
14609
14610    /**
14611     * {@hide}
14612     *
14613     * @param isRoot true if the view belongs to the root namespace, false
14614     *        otherwise
14615     */
14616    public void setIsRootNamespace(boolean isRoot) {
14617        if (isRoot) {
14618            mPrivateFlags |= IS_ROOT_NAMESPACE;
14619        } else {
14620            mPrivateFlags &= ~IS_ROOT_NAMESPACE;
14621        }
14622    }
14623
14624    /**
14625     * {@hide}
14626     *
14627     * @return true if the view belongs to the root namespace, false otherwise
14628     */
14629    public boolean isRootNamespace() {
14630        return (mPrivateFlags&IS_ROOT_NAMESPACE) != 0;
14631    }
14632
14633    /**
14634     * Returns this view's identifier.
14635     *
14636     * @return a positive integer used to identify the view or {@link #NO_ID}
14637     *         if the view has no ID
14638     *
14639     * @see #setId(int)
14640     * @see #findViewById(int)
14641     * @attr ref android.R.styleable#View_id
14642     */
14643    @ViewDebug.CapturedViewProperty
14644    public int getId() {
14645        return mID;
14646    }
14647
14648    /**
14649     * Returns this view's tag.
14650     *
14651     * @return the Object stored in this view as a tag
14652     *
14653     * @see #setTag(Object)
14654     * @see #getTag(int)
14655     */
14656    @ViewDebug.ExportedProperty
14657    public Object getTag() {
14658        return mTag;
14659    }
14660
14661    /**
14662     * Sets the tag associated with this view. A tag can be used to mark
14663     * a view in its hierarchy and does not have to be unique within the
14664     * hierarchy. Tags can also be used to store data within a view without
14665     * resorting to another data structure.
14666     *
14667     * @param tag an Object to tag the view with
14668     *
14669     * @see #getTag()
14670     * @see #setTag(int, Object)
14671     */
14672    public void setTag(final Object tag) {
14673        mTag = tag;
14674    }
14675
14676    /**
14677     * Returns the tag associated with this view and the specified key.
14678     *
14679     * @param key The key identifying the tag
14680     *
14681     * @return the Object stored in this view as a tag
14682     *
14683     * @see #setTag(int, Object)
14684     * @see #getTag()
14685     */
14686    public Object getTag(int key) {
14687        if (mKeyedTags != null) return mKeyedTags.get(key);
14688        return null;
14689    }
14690
14691    /**
14692     * Sets a tag associated with this view and a key. A tag can be used
14693     * to mark a view in its hierarchy and does not have to be unique within
14694     * the hierarchy. Tags can also be used to store data within a view
14695     * without resorting to another data structure.
14696     *
14697     * The specified key should be an id declared in the resources of the
14698     * application to ensure it is unique (see the <a
14699     * href={@docRoot}guide/topics/resources/more-resources.html#Id">ID resource type</a>).
14700     * Keys identified as belonging to
14701     * the Android framework or not associated with any package will cause
14702     * an {@link IllegalArgumentException} to be thrown.
14703     *
14704     * @param key The key identifying the tag
14705     * @param tag An Object to tag the view with
14706     *
14707     * @throws IllegalArgumentException If they specified key is not valid
14708     *
14709     * @see #setTag(Object)
14710     * @see #getTag(int)
14711     */
14712    public void setTag(int key, final Object tag) {
14713        // If the package id is 0x00 or 0x01, it's either an undefined package
14714        // or a framework id
14715        if ((key >>> 24) < 2) {
14716            throw new IllegalArgumentException("The key must be an application-specific "
14717                    + "resource id.");
14718        }
14719
14720        setKeyedTag(key, tag);
14721    }
14722
14723    /**
14724     * Variation of {@link #setTag(int, Object)} that enforces the key to be a
14725     * framework id.
14726     *
14727     * @hide
14728     */
14729    public void setTagInternal(int key, Object tag) {
14730        if ((key >>> 24) != 0x1) {
14731            throw new IllegalArgumentException("The key must be a framework-specific "
14732                    + "resource id.");
14733        }
14734
14735        setKeyedTag(key, tag);
14736    }
14737
14738    private void setKeyedTag(int key, Object tag) {
14739        if (mKeyedTags == null) {
14740            mKeyedTags = new SparseArray<Object>();
14741        }
14742
14743        mKeyedTags.put(key, tag);
14744    }
14745
14746    /**
14747     * @param consistency The type of consistency. See ViewDebug for more information.
14748     *
14749     * @hide
14750     */
14751    protected boolean dispatchConsistencyCheck(int consistency) {
14752        return onConsistencyCheck(consistency);
14753    }
14754
14755    /**
14756     * Method that subclasses should implement to check their consistency. The type of
14757     * consistency check is indicated by the bit field passed as a parameter.
14758     *
14759     * @param consistency The type of consistency. See ViewDebug for more information.
14760     *
14761     * @throws IllegalStateException if the view is in an inconsistent state.
14762     *
14763     * @hide
14764     */
14765    protected boolean onConsistencyCheck(int consistency) {
14766        boolean result = true;
14767
14768        final boolean checkLayout = (consistency & ViewDebug.CONSISTENCY_LAYOUT) != 0;
14769        final boolean checkDrawing = (consistency & ViewDebug.CONSISTENCY_DRAWING) != 0;
14770
14771        if (checkLayout) {
14772            if (getParent() == null) {
14773                result = false;
14774                android.util.Log.d(ViewDebug.CONSISTENCY_LOG_TAG,
14775                        "View " + this + " does not have a parent.");
14776            }
14777
14778            if (mAttachInfo == null) {
14779                result = false;
14780                android.util.Log.d(ViewDebug.CONSISTENCY_LOG_TAG,
14781                        "View " + this + " is not attached to a window.");
14782            }
14783        }
14784
14785        if (checkDrawing) {
14786            // Do not check the DIRTY/DRAWN flags because views can call invalidate()
14787            // from their draw() method
14788
14789            if ((mPrivateFlags & DRAWN) != DRAWN &&
14790                    (mPrivateFlags & DRAWING_CACHE_VALID) == DRAWING_CACHE_VALID) {
14791                result = false;
14792                android.util.Log.d(ViewDebug.CONSISTENCY_LOG_TAG,
14793                        "View " + this + " was invalidated but its drawing cache is valid.");
14794            }
14795        }
14796
14797        return result;
14798    }
14799
14800    /**
14801     * Prints information about this view in the log output, with the tag
14802     * {@link #VIEW_LOG_TAG}.
14803     *
14804     * @hide
14805     */
14806    public void debug() {
14807        debug(0);
14808    }
14809
14810    /**
14811     * Prints information about this view in the log output, with the tag
14812     * {@link #VIEW_LOG_TAG}. Each line in the output is preceded with an
14813     * indentation defined by the <code>depth</code>.
14814     *
14815     * @param depth the indentation level
14816     *
14817     * @hide
14818     */
14819    protected void debug(int depth) {
14820        String output = debugIndent(depth - 1);
14821
14822        output += "+ " + this;
14823        int id = getId();
14824        if (id != -1) {
14825            output += " (id=" + id + ")";
14826        }
14827        Object tag = getTag();
14828        if (tag != null) {
14829            output += " (tag=" + tag + ")";
14830        }
14831        Log.d(VIEW_LOG_TAG, output);
14832
14833        if ((mPrivateFlags & FOCUSED) != 0) {
14834            output = debugIndent(depth) + " FOCUSED";
14835            Log.d(VIEW_LOG_TAG, output);
14836        }
14837
14838        output = debugIndent(depth);
14839        output += "frame={" + mLeft + ", " + mTop + ", " + mRight
14840                + ", " + mBottom + "} scroll={" + mScrollX + ", " + mScrollY
14841                + "} ";
14842        Log.d(VIEW_LOG_TAG, output);
14843
14844        if (mPaddingLeft != 0 || mPaddingTop != 0 || mPaddingRight != 0
14845                || mPaddingBottom != 0) {
14846            output = debugIndent(depth);
14847            output += "padding={" + mPaddingLeft + ", " + mPaddingTop
14848                    + ", " + mPaddingRight + ", " + mPaddingBottom + "}";
14849            Log.d(VIEW_LOG_TAG, output);
14850        }
14851
14852        output = debugIndent(depth);
14853        output += "mMeasureWidth=" + mMeasuredWidth +
14854                " mMeasureHeight=" + mMeasuredHeight;
14855        Log.d(VIEW_LOG_TAG, output);
14856
14857        output = debugIndent(depth);
14858        if (mLayoutParams == null) {
14859            output += "BAD! no layout params";
14860        } else {
14861            output = mLayoutParams.debug(output);
14862        }
14863        Log.d(VIEW_LOG_TAG, output);
14864
14865        output = debugIndent(depth);
14866        output += "flags={";
14867        output += View.printFlags(mViewFlags);
14868        output += "}";
14869        Log.d(VIEW_LOG_TAG, output);
14870
14871        output = debugIndent(depth);
14872        output += "privateFlags={";
14873        output += View.printPrivateFlags(mPrivateFlags);
14874        output += "}";
14875        Log.d(VIEW_LOG_TAG, output);
14876    }
14877
14878    /**
14879     * Creates a string of whitespaces used for indentation.
14880     *
14881     * @param depth the indentation level
14882     * @return a String containing (depth * 2 + 3) * 2 white spaces
14883     *
14884     * @hide
14885     */
14886    protected static String debugIndent(int depth) {
14887        StringBuilder spaces = new StringBuilder((depth * 2 + 3) * 2);
14888        for (int i = 0; i < (depth * 2) + 3; i++) {
14889            spaces.append(' ').append(' ');
14890        }
14891        return spaces.toString();
14892    }
14893
14894    /**
14895     * <p>Return the offset of the widget's text baseline from the widget's top
14896     * boundary. If this widget does not support baseline alignment, this
14897     * method returns -1. </p>
14898     *
14899     * @return the offset of the baseline within the widget's bounds or -1
14900     *         if baseline alignment is not supported
14901     */
14902    @ViewDebug.ExportedProperty(category = "layout")
14903    public int getBaseline() {
14904        return -1;
14905    }
14906
14907    /**
14908     * Call this when something has changed which has invalidated the
14909     * layout of this view. This will schedule a layout pass of the view
14910     * tree.
14911     */
14912    public void requestLayout() {
14913        if (ViewDebug.TRACE_HIERARCHY) {
14914            ViewDebug.trace(this, ViewDebug.HierarchyTraceType.REQUEST_LAYOUT);
14915        }
14916
14917        mPrivateFlags |= FORCE_LAYOUT;
14918        mPrivateFlags |= INVALIDATED;
14919
14920        if (mLayoutParams != null) {
14921            mLayoutParams.onResolveLayoutDirection(getResolvedLayoutDirection());
14922        }
14923
14924        if (mParent != null && !mParent.isLayoutRequested()) {
14925            mParent.requestLayout();
14926        }
14927    }
14928
14929    /**
14930     * Forces this view to be laid out during the next layout pass.
14931     * This method does not call requestLayout() or forceLayout()
14932     * on the parent.
14933     */
14934    public void forceLayout() {
14935        mPrivateFlags |= FORCE_LAYOUT;
14936        mPrivateFlags |= INVALIDATED;
14937    }
14938
14939    /**
14940     * <p>
14941     * This is called to find out how big a view should be. The parent
14942     * supplies constraint information in the width and height parameters.
14943     * </p>
14944     *
14945     * <p>
14946     * The actual measurement work of a view is performed in
14947     * {@link #onMeasure(int, int)}, called by this method. Therefore, only
14948     * {@link #onMeasure(int, int)} can and must be overridden by subclasses.
14949     * </p>
14950     *
14951     *
14952     * @param widthMeasureSpec Horizontal space requirements as imposed by the
14953     *        parent
14954     * @param heightMeasureSpec Vertical space requirements as imposed by the
14955     *        parent
14956     *
14957     * @see #onMeasure(int, int)
14958     */
14959    public final void measure(int widthMeasureSpec, int heightMeasureSpec) {
14960        if ((mPrivateFlags & FORCE_LAYOUT) == FORCE_LAYOUT ||
14961                widthMeasureSpec != mOldWidthMeasureSpec ||
14962                heightMeasureSpec != mOldHeightMeasureSpec) {
14963
14964            // first clears the measured dimension flag
14965            mPrivateFlags &= ~MEASURED_DIMENSION_SET;
14966
14967            if (ViewDebug.TRACE_HIERARCHY) {
14968                ViewDebug.trace(this, ViewDebug.HierarchyTraceType.ON_MEASURE);
14969            }
14970
14971            // measure ourselves, this should set the measured dimension flag back
14972            onMeasure(widthMeasureSpec, heightMeasureSpec);
14973
14974            // flag not set, setMeasuredDimension() was not invoked, we raise
14975            // an exception to warn the developer
14976            if ((mPrivateFlags & MEASURED_DIMENSION_SET) != MEASURED_DIMENSION_SET) {
14977                throw new IllegalStateException("onMeasure() did not set the"
14978                        + " measured dimension by calling"
14979                        + " setMeasuredDimension()");
14980            }
14981
14982            mPrivateFlags |= LAYOUT_REQUIRED;
14983        }
14984
14985        mOldWidthMeasureSpec = widthMeasureSpec;
14986        mOldHeightMeasureSpec = heightMeasureSpec;
14987    }
14988
14989    /**
14990     * <p>
14991     * Measure the view and its content to determine the measured width and the
14992     * measured height. This method is invoked by {@link #measure(int, int)} and
14993     * should be overriden by subclasses to provide accurate and efficient
14994     * measurement of their contents.
14995     * </p>
14996     *
14997     * <p>
14998     * <strong>CONTRACT:</strong> When overriding this method, you
14999     * <em>must</em> call {@link #setMeasuredDimension(int, int)} to store the
15000     * measured width and height of this view. Failure to do so will trigger an
15001     * <code>IllegalStateException</code>, thrown by
15002     * {@link #measure(int, int)}. Calling the superclass'
15003     * {@link #onMeasure(int, int)} is a valid use.
15004     * </p>
15005     *
15006     * <p>
15007     * The base class implementation of measure defaults to the background size,
15008     * unless a larger size is allowed by the MeasureSpec. Subclasses should
15009     * override {@link #onMeasure(int, int)} to provide better measurements of
15010     * their content.
15011     * </p>
15012     *
15013     * <p>
15014     * If this method is overridden, it is the subclass's responsibility to make
15015     * sure the measured height and width are at least the view's minimum height
15016     * and width ({@link #getSuggestedMinimumHeight()} and
15017     * {@link #getSuggestedMinimumWidth()}).
15018     * </p>
15019     *
15020     * @param widthMeasureSpec horizontal space requirements as imposed by the parent.
15021     *                         The requirements are encoded with
15022     *                         {@link android.view.View.MeasureSpec}.
15023     * @param heightMeasureSpec vertical space requirements as imposed by the parent.
15024     *                         The requirements are encoded with
15025     *                         {@link android.view.View.MeasureSpec}.
15026     *
15027     * @see #getMeasuredWidth()
15028     * @see #getMeasuredHeight()
15029     * @see #setMeasuredDimension(int, int)
15030     * @see #getSuggestedMinimumHeight()
15031     * @see #getSuggestedMinimumWidth()
15032     * @see android.view.View.MeasureSpec#getMode(int)
15033     * @see android.view.View.MeasureSpec#getSize(int)
15034     */
15035    protected void onMeasure(int widthMeasureSpec, int heightMeasureSpec) {
15036        setMeasuredDimension(getDefaultSize(getSuggestedMinimumWidth(), widthMeasureSpec),
15037                getDefaultSize(getSuggestedMinimumHeight(), heightMeasureSpec));
15038    }
15039
15040    /**
15041     * <p>This mehod must be called by {@link #onMeasure(int, int)} to store the
15042     * measured width and measured height. Failing to do so will trigger an
15043     * exception at measurement time.</p>
15044     *
15045     * @param measuredWidth The measured width of this view.  May be a complex
15046     * bit mask as defined by {@link #MEASURED_SIZE_MASK} and
15047     * {@link #MEASURED_STATE_TOO_SMALL}.
15048     * @param measuredHeight The measured height of this view.  May be a complex
15049     * bit mask as defined by {@link #MEASURED_SIZE_MASK} and
15050     * {@link #MEASURED_STATE_TOO_SMALL}.
15051     */
15052    protected final void setMeasuredDimension(int measuredWidth, int measuredHeight) {
15053        mMeasuredWidth = measuredWidth;
15054        mMeasuredHeight = measuredHeight;
15055
15056        mPrivateFlags |= MEASURED_DIMENSION_SET;
15057    }
15058
15059    /**
15060     * Merge two states as returned by {@link #getMeasuredState()}.
15061     * @param curState The current state as returned from a view or the result
15062     * of combining multiple views.
15063     * @param newState The new view state to combine.
15064     * @return Returns a new integer reflecting the combination of the two
15065     * states.
15066     */
15067    public static int combineMeasuredStates(int curState, int newState) {
15068        return curState | newState;
15069    }
15070
15071    /**
15072     * Version of {@link #resolveSizeAndState(int, int, int)}
15073     * returning only the {@link #MEASURED_SIZE_MASK} bits of the result.
15074     */
15075    public static int resolveSize(int size, int measureSpec) {
15076        return resolveSizeAndState(size, measureSpec, 0) & MEASURED_SIZE_MASK;
15077    }
15078
15079    /**
15080     * Utility to reconcile a desired size and state, with constraints imposed
15081     * by a MeasureSpec.  Will take the desired size, unless a different size
15082     * is imposed by the constraints.  The returned value is a compound integer,
15083     * with the resolved size in the {@link #MEASURED_SIZE_MASK} bits and
15084     * optionally the bit {@link #MEASURED_STATE_TOO_SMALL} set if the resulting
15085     * size is smaller than the size the view wants to be.
15086     *
15087     * @param size How big the view wants to be
15088     * @param measureSpec Constraints imposed by the parent
15089     * @return Size information bit mask as defined by
15090     * {@link #MEASURED_SIZE_MASK} and {@link #MEASURED_STATE_TOO_SMALL}.
15091     */
15092    public static int resolveSizeAndState(int size, int measureSpec, int childMeasuredState) {
15093        int result = size;
15094        int specMode = MeasureSpec.getMode(measureSpec);
15095        int specSize =  MeasureSpec.getSize(measureSpec);
15096        switch (specMode) {
15097        case MeasureSpec.UNSPECIFIED:
15098            result = size;
15099            break;
15100        case MeasureSpec.AT_MOST:
15101            if (specSize < size) {
15102                result = specSize | MEASURED_STATE_TOO_SMALL;
15103            } else {
15104                result = size;
15105            }
15106            break;
15107        case MeasureSpec.EXACTLY:
15108            result = specSize;
15109            break;
15110        }
15111        return result | (childMeasuredState&MEASURED_STATE_MASK);
15112    }
15113
15114    /**
15115     * Utility to return a default size. Uses the supplied size if the
15116     * MeasureSpec imposed no constraints. Will get larger if allowed
15117     * by the MeasureSpec.
15118     *
15119     * @param size Default size for this view
15120     * @param measureSpec Constraints imposed by the parent
15121     * @return The size this view should be.
15122     */
15123    public static int getDefaultSize(int size, int measureSpec) {
15124        int result = size;
15125        int specMode = MeasureSpec.getMode(measureSpec);
15126        int specSize = MeasureSpec.getSize(measureSpec);
15127
15128        switch (specMode) {
15129        case MeasureSpec.UNSPECIFIED:
15130            result = size;
15131            break;
15132        case MeasureSpec.AT_MOST:
15133        case MeasureSpec.EXACTLY:
15134            result = specSize;
15135            break;
15136        }
15137        return result;
15138    }
15139
15140    /**
15141     * Returns the suggested minimum height that the view should use. This
15142     * returns the maximum of the view's minimum height
15143     * and the background's minimum height
15144     * ({@link android.graphics.drawable.Drawable#getMinimumHeight()}).
15145     * <p>
15146     * When being used in {@link #onMeasure(int, int)}, the caller should still
15147     * ensure the returned height is within the requirements of the parent.
15148     *
15149     * @return The suggested minimum height of the view.
15150     */
15151    protected int getSuggestedMinimumHeight() {
15152        return (mBackground == null) ? mMinHeight : max(mMinHeight, mBackground.getMinimumHeight());
15153
15154    }
15155
15156    /**
15157     * Returns the suggested minimum width that the view should use. This
15158     * returns the maximum of the view's minimum width)
15159     * and the background's minimum width
15160     *  ({@link android.graphics.drawable.Drawable#getMinimumWidth()}).
15161     * <p>
15162     * When being used in {@link #onMeasure(int, int)}, the caller should still
15163     * ensure the returned width is within the requirements of the parent.
15164     *
15165     * @return The suggested minimum width of the view.
15166     */
15167    protected int getSuggestedMinimumWidth() {
15168        return (mBackground == null) ? mMinWidth : max(mMinWidth, mBackground.getMinimumWidth());
15169    }
15170
15171    /**
15172     * Returns the minimum height of the view.
15173     *
15174     * @return the minimum height the view will try to be.
15175     *
15176     * @see #setMinimumHeight(int)
15177     *
15178     * @attr ref android.R.styleable#View_minHeight
15179     */
15180    public int getMinimumHeight() {
15181        return mMinHeight;
15182    }
15183
15184    /**
15185     * Sets the minimum height of the view. It is not guaranteed the view will
15186     * be able to achieve this minimum height (for example, if its parent layout
15187     * constrains it with less available height).
15188     *
15189     * @param minHeight The minimum height the view will try to be.
15190     *
15191     * @see #getMinimumHeight()
15192     *
15193     * @attr ref android.R.styleable#View_minHeight
15194     */
15195    public void setMinimumHeight(int minHeight) {
15196        mMinHeight = minHeight;
15197        requestLayout();
15198    }
15199
15200    /**
15201     * Returns the minimum width of the view.
15202     *
15203     * @return the minimum width the view will try to be.
15204     *
15205     * @see #setMinimumWidth(int)
15206     *
15207     * @attr ref android.R.styleable#View_minWidth
15208     */
15209    public int getMinimumWidth() {
15210        return mMinWidth;
15211    }
15212
15213    /**
15214     * Sets the minimum width of the view. It is not guaranteed the view will
15215     * be able to achieve this minimum width (for example, if its parent layout
15216     * constrains it with less available width).
15217     *
15218     * @param minWidth The minimum width the view will try to be.
15219     *
15220     * @see #getMinimumWidth()
15221     *
15222     * @attr ref android.R.styleable#View_minWidth
15223     */
15224    public void setMinimumWidth(int minWidth) {
15225        mMinWidth = minWidth;
15226        requestLayout();
15227
15228    }
15229
15230    /**
15231     * Get the animation currently associated with this view.
15232     *
15233     * @return The animation that is currently playing or
15234     *         scheduled to play for this view.
15235     */
15236    public Animation getAnimation() {
15237        return mCurrentAnimation;
15238    }
15239
15240    /**
15241     * Start the specified animation now.
15242     *
15243     * @param animation the animation to start now
15244     */
15245    public void startAnimation(Animation animation) {
15246        animation.setStartTime(Animation.START_ON_FIRST_FRAME);
15247        setAnimation(animation);
15248        invalidateParentCaches();
15249        invalidate(true);
15250    }
15251
15252    /**
15253     * Cancels any animations for this view.
15254     */
15255    public void clearAnimation() {
15256        if (mCurrentAnimation != null) {
15257            mCurrentAnimation.detach();
15258        }
15259        mCurrentAnimation = null;
15260        invalidateParentIfNeeded();
15261    }
15262
15263    /**
15264     * Sets the next animation to play for this view.
15265     * If you want the animation to play immediately, use
15266     * {@link #startAnimation(android.view.animation.Animation)} instead.
15267     * This method provides allows fine-grained
15268     * control over the start time and invalidation, but you
15269     * must make sure that 1) the animation has a start time set, and
15270     * 2) the view's parent (which controls animations on its children)
15271     * will be invalidated when the animation is supposed to
15272     * start.
15273     *
15274     * @param animation The next animation, or null.
15275     */
15276    public void setAnimation(Animation animation) {
15277        mCurrentAnimation = animation;
15278
15279        if (animation != null) {
15280            // If the screen is off assume the animation start time is now instead of
15281            // the next frame we draw. Keeping the START_ON_FIRST_FRAME start time
15282            // would cause the animation to start when the screen turns back on
15283            if (mAttachInfo != null && !mAttachInfo.mScreenOn &&
15284                    animation.getStartTime() == Animation.START_ON_FIRST_FRAME) {
15285                animation.setStartTime(AnimationUtils.currentAnimationTimeMillis());
15286            }
15287            animation.reset();
15288        }
15289    }
15290
15291    /**
15292     * Invoked by a parent ViewGroup to notify the start of the animation
15293     * currently associated with this view. If you override this method,
15294     * always call super.onAnimationStart();
15295     *
15296     * @see #setAnimation(android.view.animation.Animation)
15297     * @see #getAnimation()
15298     */
15299    protected void onAnimationStart() {
15300        mPrivateFlags |= ANIMATION_STARTED;
15301    }
15302
15303    /**
15304     * Invoked by a parent ViewGroup to notify the end of the animation
15305     * currently associated with this view. If you override this method,
15306     * always call super.onAnimationEnd();
15307     *
15308     * @see #setAnimation(android.view.animation.Animation)
15309     * @see #getAnimation()
15310     */
15311    protected void onAnimationEnd() {
15312        mPrivateFlags &= ~ANIMATION_STARTED;
15313    }
15314
15315    /**
15316     * Invoked if there is a Transform that involves alpha. Subclass that can
15317     * draw themselves with the specified alpha should return true, and then
15318     * respect that alpha when their onDraw() is called. If this returns false
15319     * then the view may be redirected to draw into an offscreen buffer to
15320     * fulfill the request, which will look fine, but may be slower than if the
15321     * subclass handles it internally. The default implementation returns false.
15322     *
15323     * @param alpha The alpha (0..255) to apply to the view's drawing
15324     * @return true if the view can draw with the specified alpha.
15325     */
15326    protected boolean onSetAlpha(int alpha) {
15327        return false;
15328    }
15329
15330    /**
15331     * This is used by the RootView to perform an optimization when
15332     * the view hierarchy contains one or several SurfaceView.
15333     * SurfaceView is always considered transparent, but its children are not,
15334     * therefore all View objects remove themselves from the global transparent
15335     * region (passed as a parameter to this function).
15336     *
15337     * @param region The transparent region for this ViewAncestor (window).
15338     *
15339     * @return Returns true if the effective visibility of the view at this
15340     * point is opaque, regardless of the transparent region; returns false
15341     * if it is possible for underlying windows to be seen behind the view.
15342     *
15343     * {@hide}
15344     */
15345    public boolean gatherTransparentRegion(Region region) {
15346        final AttachInfo attachInfo = mAttachInfo;
15347        if (region != null && attachInfo != null) {
15348            final int pflags = mPrivateFlags;
15349            if ((pflags & SKIP_DRAW) == 0) {
15350                // The SKIP_DRAW flag IS NOT set, so this view draws. We need to
15351                // remove it from the transparent region.
15352                final int[] location = attachInfo.mTransparentLocation;
15353                getLocationInWindow(location);
15354                region.op(location[0], location[1], location[0] + mRight - mLeft,
15355                        location[1] + mBottom - mTop, Region.Op.DIFFERENCE);
15356            } else if ((pflags & ONLY_DRAWS_BACKGROUND) != 0 && mBackground != null) {
15357                // The ONLY_DRAWS_BACKGROUND flag IS set and the background drawable
15358                // exists, so we remove the background drawable's non-transparent
15359                // parts from this transparent region.
15360                applyDrawableToTransparentRegion(mBackground, region);
15361            }
15362        }
15363        return true;
15364    }
15365
15366    /**
15367     * Play a sound effect for this view.
15368     *
15369     * <p>The framework will play sound effects for some built in actions, such as
15370     * clicking, but you may wish to play these effects in your widget,
15371     * for instance, for internal navigation.
15372     *
15373     * <p>The sound effect will only be played if sound effects are enabled by the user, and
15374     * {@link #isSoundEffectsEnabled()} is true.
15375     *
15376     * @param soundConstant One of the constants defined in {@link SoundEffectConstants}
15377     */
15378    public void playSoundEffect(int soundConstant) {
15379        if (mAttachInfo == null || mAttachInfo.mRootCallbacks == null || !isSoundEffectsEnabled()) {
15380            return;
15381        }
15382        mAttachInfo.mRootCallbacks.playSoundEffect(soundConstant);
15383    }
15384
15385    /**
15386     * BZZZTT!!1!
15387     *
15388     * <p>Provide haptic feedback to the user for this view.
15389     *
15390     * <p>The framework will provide haptic feedback for some built in actions,
15391     * such as long presses, but you may wish to provide feedback for your
15392     * own widget.
15393     *
15394     * <p>The feedback will only be performed if
15395     * {@link #isHapticFeedbackEnabled()} is true.
15396     *
15397     * @param feedbackConstant One of the constants defined in
15398     * {@link HapticFeedbackConstants}
15399     */
15400    public boolean performHapticFeedback(int feedbackConstant) {
15401        return performHapticFeedback(feedbackConstant, 0);
15402    }
15403
15404    /**
15405     * BZZZTT!!1!
15406     *
15407     * <p>Like {@link #performHapticFeedback(int)}, with additional options.
15408     *
15409     * @param feedbackConstant One of the constants defined in
15410     * {@link HapticFeedbackConstants}
15411     * @param flags Additional flags as per {@link HapticFeedbackConstants}.
15412     */
15413    public boolean performHapticFeedback(int feedbackConstant, int flags) {
15414        if (mAttachInfo == null) {
15415            return false;
15416        }
15417        //noinspection SimplifiableIfStatement
15418        if ((flags & HapticFeedbackConstants.FLAG_IGNORE_VIEW_SETTING) == 0
15419                && !isHapticFeedbackEnabled()) {
15420            return false;
15421        }
15422        return mAttachInfo.mRootCallbacks.performHapticFeedback(feedbackConstant,
15423                (flags & HapticFeedbackConstants.FLAG_IGNORE_GLOBAL_SETTING) != 0);
15424    }
15425
15426    /**
15427     * Request that the visibility of the status bar or other screen/window
15428     * decorations be changed.
15429     *
15430     * <p>This method is used to put the over device UI into temporary modes
15431     * where the user's attention is focused more on the application content,
15432     * by dimming or hiding surrounding system affordances.  This is typically
15433     * used in conjunction with {@link Window#FEATURE_ACTION_BAR_OVERLAY
15434     * Window.FEATURE_ACTION_BAR_OVERLAY}, allowing the applications content
15435     * to be placed behind the action bar (and with these flags other system
15436     * affordances) so that smooth transitions between hiding and showing them
15437     * can be done.
15438     *
15439     * <p>Two representative examples of the use of system UI visibility is
15440     * implementing a content browsing application (like a magazine reader)
15441     * and a video playing application.
15442     *
15443     * <p>The first code shows a typical implementation of a View in a content
15444     * browsing application.  In this implementation, the application goes
15445     * into a content-oriented mode by hiding the status bar and action bar,
15446     * and putting the navigation elements into lights out mode.  The user can
15447     * then interact with content while in this mode.  Such an application should
15448     * provide an easy way for the user to toggle out of the mode (such as to
15449     * check information in the status bar or access notifications).  In the
15450     * implementation here, this is done simply by tapping on the content.
15451     *
15452     * {@sample development/samples/ApiDemos/src/com/example/android/apis/view/ContentBrowserActivity.java
15453     *      content}
15454     *
15455     * <p>This second code sample shows a typical implementation of a View
15456     * in a video playing application.  In this situation, while the video is
15457     * playing the application would like to go into a complete full-screen mode,
15458     * to use as much of the display as possible for the video.  When in this state
15459     * the user can not interact with the application; the system intercepts
15460     * touching on the screen to pop the UI out of full screen mode.  See
15461     * {@link #fitSystemWindows(Rect)} for a sample layout that goes with this code.
15462     *
15463     * {@sample development/samples/ApiDemos/src/com/example/android/apis/view/VideoPlayerActivity.java
15464     *      content}
15465     *
15466     * @param visibility  Bitwise-or of flags {@link #SYSTEM_UI_FLAG_LOW_PROFILE},
15467     * {@link #SYSTEM_UI_FLAG_HIDE_NAVIGATION}, {@link #SYSTEM_UI_FLAG_FULLSCREEN},
15468     * {@link #SYSTEM_UI_FLAG_LAYOUT_STABLE}, {@link #SYSTEM_UI_FLAG_LAYOUT_HIDE_NAVIGATION},
15469     * and {@link #SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN}.
15470     */
15471    public void setSystemUiVisibility(int visibility) {
15472        if (visibility != mSystemUiVisibility) {
15473            mSystemUiVisibility = visibility;
15474            if (mParent != null && mAttachInfo != null && !mAttachInfo.mRecomputeGlobalAttributes) {
15475                mParent.recomputeViewAttributes(this);
15476            }
15477        }
15478    }
15479
15480    /**
15481     * Returns the last {@link #setSystemUiVisibility(int) that this view has requested.
15482     * @return  Bitwise-or of flags {@link #SYSTEM_UI_FLAG_LOW_PROFILE},
15483     * {@link #SYSTEM_UI_FLAG_HIDE_NAVIGATION}, {@link #SYSTEM_UI_FLAG_FULLSCREEN},
15484     * {@link #SYSTEM_UI_FLAG_LAYOUT_STABLE}, {@link #SYSTEM_UI_FLAG_LAYOUT_HIDE_NAVIGATION},
15485     * and {@link #SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN}.
15486     */
15487    public int getSystemUiVisibility() {
15488        return mSystemUiVisibility;
15489    }
15490
15491    /**
15492     * Returns the current system UI visibility that is currently set for
15493     * the entire window.  This is the combination of the
15494     * {@link #setSystemUiVisibility(int)} values supplied by all of the
15495     * views in the window.
15496     */
15497    public int getWindowSystemUiVisibility() {
15498        return mAttachInfo != null ? mAttachInfo.mSystemUiVisibility : 0;
15499    }
15500
15501    /**
15502     * Override to find out when the window's requested system UI visibility
15503     * has changed, that is the value returned by {@link #getWindowSystemUiVisibility()}.
15504     * This is different from the callbacks recieved through
15505     * {@link #setOnSystemUiVisibilityChangeListener(OnSystemUiVisibilityChangeListener)}
15506     * in that this is only telling you about the local request of the window,
15507     * not the actual values applied by the system.
15508     */
15509    public void onWindowSystemUiVisibilityChanged(int visible) {
15510    }
15511
15512    /**
15513     * Dispatch callbacks to {@link #onWindowSystemUiVisibilityChanged(int)} down
15514     * the view hierarchy.
15515     */
15516    public void dispatchWindowSystemUiVisiblityChanged(int visible) {
15517        onWindowSystemUiVisibilityChanged(visible);
15518    }
15519
15520    /**
15521     * Set a listener to receive callbacks when the visibility of the system bar changes.
15522     * @param l  The {@link OnSystemUiVisibilityChangeListener} to receive callbacks.
15523     */
15524    public void setOnSystemUiVisibilityChangeListener(OnSystemUiVisibilityChangeListener l) {
15525        getListenerInfo().mOnSystemUiVisibilityChangeListener = l;
15526        if (mParent != null && mAttachInfo != null && !mAttachInfo.mRecomputeGlobalAttributes) {
15527            mParent.recomputeViewAttributes(this);
15528        }
15529    }
15530
15531    /**
15532     * Dispatch callbacks to {@link #setOnSystemUiVisibilityChangeListener} down
15533     * the view hierarchy.
15534     */
15535    public void dispatchSystemUiVisibilityChanged(int visibility) {
15536        ListenerInfo li = mListenerInfo;
15537        if (li != null && li.mOnSystemUiVisibilityChangeListener != null) {
15538            li.mOnSystemUiVisibilityChangeListener.onSystemUiVisibilityChange(
15539                    visibility & PUBLIC_STATUS_BAR_VISIBILITY_MASK);
15540        }
15541    }
15542
15543    boolean updateLocalSystemUiVisibility(int localValue, int localChanges) {
15544        int val = (mSystemUiVisibility&~localChanges) | (localValue&localChanges);
15545        if (val != mSystemUiVisibility) {
15546            setSystemUiVisibility(val);
15547            return true;
15548        }
15549        return false;
15550    }
15551
15552    /** @hide */
15553    public void setDisabledSystemUiVisibility(int flags) {
15554        if (mAttachInfo != null) {
15555            if (mAttachInfo.mDisabledSystemUiVisibility != flags) {
15556                mAttachInfo.mDisabledSystemUiVisibility = flags;
15557                if (mParent != null) {
15558                    mParent.recomputeViewAttributes(this);
15559                }
15560            }
15561        }
15562    }
15563
15564    /**
15565     * Creates an image that the system displays during the drag and drop
15566     * operation. This is called a &quot;drag shadow&quot;. The default implementation
15567     * for a DragShadowBuilder based on a View returns an image that has exactly the same
15568     * appearance as the given View. The default also positions the center of the drag shadow
15569     * directly under the touch point. If no View is provided (the constructor with no parameters
15570     * is used), and {@link #onProvideShadowMetrics(Point,Point) onProvideShadowMetrics()} and
15571     * {@link #onDrawShadow(Canvas) onDrawShadow()} are not overriden, then the
15572     * default is an invisible drag shadow.
15573     * <p>
15574     * You are not required to use the View you provide to the constructor as the basis of the
15575     * drag shadow. The {@link #onDrawShadow(Canvas) onDrawShadow()} method allows you to draw
15576     * anything you want as the drag shadow.
15577     * </p>
15578     * <p>
15579     *  You pass a DragShadowBuilder object to the system when you start the drag. The system
15580     *  calls {@link #onProvideShadowMetrics(Point,Point) onProvideShadowMetrics()} to get the
15581     *  size and position of the drag shadow. It uses this data to construct a
15582     *  {@link android.graphics.Canvas} object, then it calls {@link #onDrawShadow(Canvas) onDrawShadow()}
15583     *  so that your application can draw the shadow image in the Canvas.
15584     * </p>
15585     *
15586     * <div class="special reference">
15587     * <h3>Developer Guides</h3>
15588     * <p>For a guide to implementing drag and drop features, read the
15589     * <a href="{@docRoot}guide/topics/ui/drag-drop.html">Drag and Drop</a> developer guide.</p>
15590     * </div>
15591     */
15592    public static class DragShadowBuilder {
15593        private final WeakReference<View> mView;
15594
15595        /**
15596         * Constructs a shadow image builder based on a View. By default, the resulting drag
15597         * shadow will have the same appearance and dimensions as the View, with the touch point
15598         * over the center of the View.
15599         * @param view A View. Any View in scope can be used.
15600         */
15601        public DragShadowBuilder(View view) {
15602            mView = new WeakReference<View>(view);
15603        }
15604
15605        /**
15606         * Construct a shadow builder object with no associated View.  This
15607         * constructor variant is only useful when the {@link #onProvideShadowMetrics(Point, Point)}
15608         * and {@link #onDrawShadow(Canvas)} methods are also overridden in order
15609         * to supply the drag shadow's dimensions and appearance without
15610         * reference to any View object. If they are not overridden, then the result is an
15611         * invisible drag shadow.
15612         */
15613        public DragShadowBuilder() {
15614            mView = new WeakReference<View>(null);
15615        }
15616
15617        /**
15618         * Returns the View object that had been passed to the
15619         * {@link #View.DragShadowBuilder(View)}
15620         * constructor.  If that View parameter was {@code null} or if the
15621         * {@link #View.DragShadowBuilder()}
15622         * constructor was used to instantiate the builder object, this method will return
15623         * null.
15624         *
15625         * @return The View object associate with this builder object.
15626         */
15627        @SuppressWarnings({"JavadocReference"})
15628        final public View getView() {
15629            return mView.get();
15630        }
15631
15632        /**
15633         * Provides the metrics for the shadow image. These include the dimensions of
15634         * the shadow image, and the point within that shadow that should
15635         * be centered under the touch location while dragging.
15636         * <p>
15637         * The default implementation sets the dimensions of the shadow to be the
15638         * same as the dimensions of the View itself and centers the shadow under
15639         * the touch point.
15640         * </p>
15641         *
15642         * @param shadowSize A {@link android.graphics.Point} containing the width and height
15643         * of the shadow image. Your application must set {@link android.graphics.Point#x} to the
15644         * desired width and must set {@link android.graphics.Point#y} to the desired height of the
15645         * image.
15646         *
15647         * @param shadowTouchPoint A {@link android.graphics.Point} for the position within the
15648         * shadow image that should be underneath the touch point during the drag and drop
15649         * operation. Your application must set {@link android.graphics.Point#x} to the
15650         * X coordinate and {@link android.graphics.Point#y} to the Y coordinate of this position.
15651         */
15652        public void onProvideShadowMetrics(Point shadowSize, Point shadowTouchPoint) {
15653            final View view = mView.get();
15654            if (view != null) {
15655                shadowSize.set(view.getWidth(), view.getHeight());
15656                shadowTouchPoint.set(shadowSize.x / 2, shadowSize.y / 2);
15657            } else {
15658                Log.e(View.VIEW_LOG_TAG, "Asked for drag thumb metrics but no view");
15659            }
15660        }
15661
15662        /**
15663         * Draws the shadow image. The system creates the {@link android.graphics.Canvas} object
15664         * based on the dimensions it received from the
15665         * {@link #onProvideShadowMetrics(Point, Point)} callback.
15666         *
15667         * @param canvas A {@link android.graphics.Canvas} object in which to draw the shadow image.
15668         */
15669        public void onDrawShadow(Canvas canvas) {
15670            final View view = mView.get();
15671            if (view != null) {
15672                view.draw(canvas);
15673            } else {
15674                Log.e(View.VIEW_LOG_TAG, "Asked to draw drag shadow but no view");
15675            }
15676        }
15677    }
15678
15679    /**
15680     * Starts a drag and drop operation. When your application calls this method, it passes a
15681     * {@link android.view.View.DragShadowBuilder} object to the system. The
15682     * system calls this object's {@link DragShadowBuilder#onProvideShadowMetrics(Point, Point)}
15683     * to get metrics for the drag shadow, and then calls the object's
15684     * {@link DragShadowBuilder#onDrawShadow(Canvas)} to draw the drag shadow itself.
15685     * <p>
15686     *  Once the system has the drag shadow, it begins the drag and drop operation by sending
15687     *  drag events to all the View objects in your application that are currently visible. It does
15688     *  this either by calling the View object's drag listener (an implementation of
15689     *  {@link android.view.View.OnDragListener#onDrag(View,DragEvent) onDrag()} or by calling the
15690     *  View object's {@link android.view.View#onDragEvent(DragEvent) onDragEvent()} method.
15691     *  Both are passed a {@link android.view.DragEvent} object that has a
15692     *  {@link android.view.DragEvent#getAction()} value of
15693     *  {@link android.view.DragEvent#ACTION_DRAG_STARTED}.
15694     * </p>
15695     * <p>
15696     * Your application can invoke startDrag() on any attached View object. The View object does not
15697     * need to be the one used in {@link android.view.View.DragShadowBuilder}, nor does it need to
15698     * be related to the View the user selected for dragging.
15699     * </p>
15700     * @param data A {@link android.content.ClipData} object pointing to the data to be
15701     * transferred by the drag and drop operation.
15702     * @param shadowBuilder A {@link android.view.View.DragShadowBuilder} object for building the
15703     * drag shadow.
15704     * @param myLocalState An {@link java.lang.Object} containing local data about the drag and
15705     * drop operation. This Object is put into every DragEvent object sent by the system during the
15706     * current drag.
15707     * <p>
15708     * myLocalState is a lightweight mechanism for the sending information from the dragged View
15709     * to the target Views. For example, it can contain flags that differentiate between a
15710     * a copy operation and a move operation.
15711     * </p>
15712     * @param flags Flags that control the drag and drop operation. No flags are currently defined,
15713     * so the parameter should be set to 0.
15714     * @return {@code true} if the method completes successfully, or
15715     * {@code false} if it fails anywhere. Returning {@code false} means the system was unable to
15716     * do a drag, and so no drag operation is in progress.
15717     */
15718    public final boolean startDrag(ClipData data, DragShadowBuilder shadowBuilder,
15719            Object myLocalState, int flags) {
15720        if (ViewDebug.DEBUG_DRAG) {
15721            Log.d(VIEW_LOG_TAG, "startDrag: data=" + data + " flags=" + flags);
15722        }
15723        boolean okay = false;
15724
15725        Point shadowSize = new Point();
15726        Point shadowTouchPoint = new Point();
15727        shadowBuilder.onProvideShadowMetrics(shadowSize, shadowTouchPoint);
15728
15729        if ((shadowSize.x < 0) || (shadowSize.y < 0) ||
15730                (shadowTouchPoint.x < 0) || (shadowTouchPoint.y < 0)) {
15731            throw new IllegalStateException("Drag shadow dimensions must not be negative");
15732        }
15733
15734        if (ViewDebug.DEBUG_DRAG) {
15735            Log.d(VIEW_LOG_TAG, "drag shadow: width=" + shadowSize.x + " height=" + shadowSize.y
15736                    + " shadowX=" + shadowTouchPoint.x + " shadowY=" + shadowTouchPoint.y);
15737        }
15738        Surface surface = new Surface();
15739        try {
15740            IBinder token = mAttachInfo.mSession.prepareDrag(mAttachInfo.mWindow,
15741                    flags, shadowSize.x, shadowSize.y, surface);
15742            if (ViewDebug.DEBUG_DRAG) Log.d(VIEW_LOG_TAG, "prepareDrag returned token=" + token
15743                    + " surface=" + surface);
15744            if (token != null) {
15745                Canvas canvas = surface.lockCanvas(null);
15746                try {
15747                    canvas.drawColor(0, PorterDuff.Mode.CLEAR);
15748                    shadowBuilder.onDrawShadow(canvas);
15749                } finally {
15750                    surface.unlockCanvasAndPost(canvas);
15751                }
15752
15753                final ViewRootImpl root = getViewRootImpl();
15754
15755                // Cache the local state object for delivery with DragEvents
15756                root.setLocalDragState(myLocalState);
15757
15758                // repurpose 'shadowSize' for the last touch point
15759                root.getLastTouchPoint(shadowSize);
15760
15761                okay = mAttachInfo.mSession.performDrag(mAttachInfo.mWindow, token,
15762                        shadowSize.x, shadowSize.y,
15763                        shadowTouchPoint.x, shadowTouchPoint.y, data);
15764                if (ViewDebug.DEBUG_DRAG) Log.d(VIEW_LOG_TAG, "performDrag returned " + okay);
15765
15766                // Off and running!  Release our local surface instance; the drag
15767                // shadow surface is now managed by the system process.
15768                surface.release();
15769            }
15770        } catch (Exception e) {
15771            Log.e(VIEW_LOG_TAG, "Unable to initiate drag", e);
15772            surface.destroy();
15773        }
15774
15775        return okay;
15776    }
15777
15778    /**
15779     * Handles drag events sent by the system following a call to
15780     * {@link android.view.View#startDrag(ClipData,DragShadowBuilder,Object,int) startDrag()}.
15781     *<p>
15782     * When the system calls this method, it passes a
15783     * {@link android.view.DragEvent} object. A call to
15784     * {@link android.view.DragEvent#getAction()} returns one of the action type constants defined
15785     * in DragEvent. The method uses these to determine what is happening in the drag and drop
15786     * operation.
15787     * @param event The {@link android.view.DragEvent} sent by the system.
15788     * The {@link android.view.DragEvent#getAction()} method returns an action type constant defined
15789     * in DragEvent, indicating the type of drag event represented by this object.
15790     * @return {@code true} if the method was successful, otherwise {@code false}.
15791     * <p>
15792     *  The method should return {@code true} in response to an action type of
15793     *  {@link android.view.DragEvent#ACTION_DRAG_STARTED} to receive drag events for the current
15794     *  operation.
15795     * </p>
15796     * <p>
15797     *  The method should also return {@code true} in response to an action type of
15798     *  {@link android.view.DragEvent#ACTION_DROP} if it consumed the drop, or
15799     *  {@code false} if it didn't.
15800     * </p>
15801     */
15802    public boolean onDragEvent(DragEvent event) {
15803        return false;
15804    }
15805
15806    /**
15807     * Detects if this View is enabled and has a drag event listener.
15808     * If both are true, then it calls the drag event listener with the
15809     * {@link android.view.DragEvent} it received. If the drag event listener returns
15810     * {@code true}, then dispatchDragEvent() returns {@code true}.
15811     * <p>
15812     * For all other cases, the method calls the
15813     * {@link android.view.View#onDragEvent(DragEvent) onDragEvent()} drag event handler
15814     * method and returns its result.
15815     * </p>
15816     * <p>
15817     * This ensures that a drag event is always consumed, even if the View does not have a drag
15818     * event listener. However, if the View has a listener and the listener returns true, then
15819     * onDragEvent() is not called.
15820     * </p>
15821     */
15822    public boolean dispatchDragEvent(DragEvent event) {
15823        //noinspection SimplifiableIfStatement
15824        ListenerInfo li = mListenerInfo;
15825        if (li != null && li.mOnDragListener != null && (mViewFlags & ENABLED_MASK) == ENABLED
15826                && li.mOnDragListener.onDrag(this, event)) {
15827            return true;
15828        }
15829        return onDragEvent(event);
15830    }
15831
15832    boolean canAcceptDrag() {
15833        return (mPrivateFlags2 & DRAG_CAN_ACCEPT) != 0;
15834    }
15835
15836    /**
15837     * This needs to be a better API (NOT ON VIEW) before it is exposed.  If
15838     * it is ever exposed at all.
15839     * @hide
15840     */
15841    public void onCloseSystemDialogs(String reason) {
15842    }
15843
15844    /**
15845     * Given a Drawable whose bounds have been set to draw into this view,
15846     * update a Region being computed for
15847     * {@link #gatherTransparentRegion(android.graphics.Region)} so
15848     * that any non-transparent parts of the Drawable are removed from the
15849     * given transparent region.
15850     *
15851     * @param dr The Drawable whose transparency is to be applied to the region.
15852     * @param region A Region holding the current transparency information,
15853     * where any parts of the region that are set are considered to be
15854     * transparent.  On return, this region will be modified to have the
15855     * transparency information reduced by the corresponding parts of the
15856     * Drawable that are not transparent.
15857     * {@hide}
15858     */
15859    public void applyDrawableToTransparentRegion(Drawable dr, Region region) {
15860        if (DBG) {
15861            Log.i("View", "Getting transparent region for: " + this);
15862        }
15863        final Region r = dr.getTransparentRegion();
15864        final Rect db = dr.getBounds();
15865        final AttachInfo attachInfo = mAttachInfo;
15866        if (r != null && attachInfo != null) {
15867            final int w = getRight()-getLeft();
15868            final int h = getBottom()-getTop();
15869            if (db.left > 0) {
15870                //Log.i("VIEW", "Drawable left " + db.left + " > view 0");
15871                r.op(0, 0, db.left, h, Region.Op.UNION);
15872            }
15873            if (db.right < w) {
15874                //Log.i("VIEW", "Drawable right " + db.right + " < view " + w);
15875                r.op(db.right, 0, w, h, Region.Op.UNION);
15876            }
15877            if (db.top > 0) {
15878                //Log.i("VIEW", "Drawable top " + db.top + " > view 0");
15879                r.op(0, 0, w, db.top, Region.Op.UNION);
15880            }
15881            if (db.bottom < h) {
15882                //Log.i("VIEW", "Drawable bottom " + db.bottom + " < view " + h);
15883                r.op(0, db.bottom, w, h, Region.Op.UNION);
15884            }
15885            final int[] location = attachInfo.mTransparentLocation;
15886            getLocationInWindow(location);
15887            r.translate(location[0], location[1]);
15888            region.op(r, Region.Op.INTERSECT);
15889        } else {
15890            region.op(db, Region.Op.DIFFERENCE);
15891        }
15892    }
15893
15894    private void checkForLongClick(int delayOffset) {
15895        if ((mViewFlags & LONG_CLICKABLE) == LONG_CLICKABLE) {
15896            mHasPerformedLongPress = false;
15897
15898            if (mPendingCheckForLongPress == null) {
15899                mPendingCheckForLongPress = new CheckForLongPress();
15900            }
15901            mPendingCheckForLongPress.rememberWindowAttachCount();
15902            postDelayed(mPendingCheckForLongPress,
15903                    ViewConfiguration.getLongPressTimeout() - delayOffset);
15904        }
15905    }
15906
15907    /**
15908     * Inflate a view from an XML resource.  This convenience method wraps the {@link
15909     * LayoutInflater} class, which provides a full range of options for view inflation.
15910     *
15911     * @param context The Context object for your activity or application.
15912     * @param resource The resource ID to inflate
15913     * @param root A view group that will be the parent.  Used to properly inflate the
15914     * layout_* parameters.
15915     * @see LayoutInflater
15916     */
15917    public static View inflate(Context context, int resource, ViewGroup root) {
15918        LayoutInflater factory = LayoutInflater.from(context);
15919        return factory.inflate(resource, root);
15920    }
15921
15922    /**
15923     * Scroll the view with standard behavior for scrolling beyond the normal
15924     * content boundaries. Views that call this method should override
15925     * {@link #onOverScrolled(int, int, boolean, boolean)} to respond to the
15926     * results of an over-scroll operation.
15927     *
15928     * Views can use this method to handle any touch or fling-based scrolling.
15929     *
15930     * @param deltaX Change in X in pixels
15931     * @param deltaY Change in Y in pixels
15932     * @param scrollX Current X scroll value in pixels before applying deltaX
15933     * @param scrollY Current Y scroll value in pixels before applying deltaY
15934     * @param scrollRangeX Maximum content scroll range along the X axis
15935     * @param scrollRangeY Maximum content scroll range along the Y axis
15936     * @param maxOverScrollX Number of pixels to overscroll by in either direction
15937     *          along the X axis.
15938     * @param maxOverScrollY Number of pixels to overscroll by in either direction
15939     *          along the Y axis.
15940     * @param isTouchEvent true if this scroll operation is the result of a touch event.
15941     * @return true if scrolling was clamped to an over-scroll boundary along either
15942     *          axis, false otherwise.
15943     */
15944    @SuppressWarnings({"UnusedParameters"})
15945    protected boolean overScrollBy(int deltaX, int deltaY,
15946            int scrollX, int scrollY,
15947            int scrollRangeX, int scrollRangeY,
15948            int maxOverScrollX, int maxOverScrollY,
15949            boolean isTouchEvent) {
15950        final int overScrollMode = mOverScrollMode;
15951        final boolean canScrollHorizontal =
15952                computeHorizontalScrollRange() > computeHorizontalScrollExtent();
15953        final boolean canScrollVertical =
15954                computeVerticalScrollRange() > computeVerticalScrollExtent();
15955        final boolean overScrollHorizontal = overScrollMode == OVER_SCROLL_ALWAYS ||
15956                (overScrollMode == OVER_SCROLL_IF_CONTENT_SCROLLS && canScrollHorizontal);
15957        final boolean overScrollVertical = overScrollMode == OVER_SCROLL_ALWAYS ||
15958                (overScrollMode == OVER_SCROLL_IF_CONTENT_SCROLLS && canScrollVertical);
15959
15960        int newScrollX = scrollX + deltaX;
15961        if (!overScrollHorizontal) {
15962            maxOverScrollX = 0;
15963        }
15964
15965        int newScrollY = scrollY + deltaY;
15966        if (!overScrollVertical) {
15967            maxOverScrollY = 0;
15968        }
15969
15970        // Clamp values if at the limits and record
15971        final int left = -maxOverScrollX;
15972        final int right = maxOverScrollX + scrollRangeX;
15973        final int top = -maxOverScrollY;
15974        final int bottom = maxOverScrollY + scrollRangeY;
15975
15976        boolean clampedX = false;
15977        if (newScrollX > right) {
15978            newScrollX = right;
15979            clampedX = true;
15980        } else if (newScrollX < left) {
15981            newScrollX = left;
15982            clampedX = true;
15983        }
15984
15985        boolean clampedY = false;
15986        if (newScrollY > bottom) {
15987            newScrollY = bottom;
15988            clampedY = true;
15989        } else if (newScrollY < top) {
15990            newScrollY = top;
15991            clampedY = true;
15992        }
15993
15994        onOverScrolled(newScrollX, newScrollY, clampedX, clampedY);
15995
15996        return clampedX || clampedY;
15997    }
15998
15999    /**
16000     * Called by {@link #overScrollBy(int, int, int, int, int, int, int, int, boolean)} to
16001     * respond to the results of an over-scroll operation.
16002     *
16003     * @param scrollX New X scroll value in pixels
16004     * @param scrollY New Y scroll value in pixels
16005     * @param clampedX True if scrollX was clamped to an over-scroll boundary
16006     * @param clampedY True if scrollY was clamped to an over-scroll boundary
16007     */
16008    protected void onOverScrolled(int scrollX, int scrollY,
16009            boolean clampedX, boolean clampedY) {
16010        // Intentionally empty.
16011    }
16012
16013    /**
16014     * Returns the over-scroll mode for this view. The result will be
16015     * one of {@link #OVER_SCROLL_ALWAYS} (default), {@link #OVER_SCROLL_IF_CONTENT_SCROLLS}
16016     * (allow over-scrolling only if the view content is larger than the container),
16017     * or {@link #OVER_SCROLL_NEVER}.
16018     *
16019     * @return This view's over-scroll mode.
16020     */
16021    public int getOverScrollMode() {
16022        return mOverScrollMode;
16023    }
16024
16025    /**
16026     * Set the over-scroll mode for this view. Valid over-scroll modes are
16027     * {@link #OVER_SCROLL_ALWAYS} (default), {@link #OVER_SCROLL_IF_CONTENT_SCROLLS}
16028     * (allow over-scrolling only if the view content is larger than the container),
16029     * or {@link #OVER_SCROLL_NEVER}.
16030     *
16031     * Setting the over-scroll mode of a view will have an effect only if the
16032     * view is capable of scrolling.
16033     *
16034     * @param overScrollMode The new over-scroll mode for this view.
16035     */
16036    public void setOverScrollMode(int overScrollMode) {
16037        if (overScrollMode != OVER_SCROLL_ALWAYS &&
16038                overScrollMode != OVER_SCROLL_IF_CONTENT_SCROLLS &&
16039                overScrollMode != OVER_SCROLL_NEVER) {
16040            throw new IllegalArgumentException("Invalid overscroll mode " + overScrollMode);
16041        }
16042        mOverScrollMode = overScrollMode;
16043    }
16044
16045    /**
16046     * Gets a scale factor that determines the distance the view should scroll
16047     * vertically in response to {@link MotionEvent#ACTION_SCROLL}.
16048     * @return The vertical scroll scale factor.
16049     * @hide
16050     */
16051    protected float getVerticalScrollFactor() {
16052        if (mVerticalScrollFactor == 0) {
16053            TypedValue outValue = new TypedValue();
16054            if (!mContext.getTheme().resolveAttribute(
16055                    com.android.internal.R.attr.listPreferredItemHeight, outValue, true)) {
16056                throw new IllegalStateException(
16057                        "Expected theme to define listPreferredItemHeight.");
16058            }
16059            mVerticalScrollFactor = outValue.getDimension(
16060                    mContext.getResources().getDisplayMetrics());
16061        }
16062        return mVerticalScrollFactor;
16063    }
16064
16065    /**
16066     * Gets a scale factor that determines the distance the view should scroll
16067     * horizontally in response to {@link MotionEvent#ACTION_SCROLL}.
16068     * @return The horizontal scroll scale factor.
16069     * @hide
16070     */
16071    protected float getHorizontalScrollFactor() {
16072        // TODO: Should use something else.
16073        return getVerticalScrollFactor();
16074    }
16075
16076    /**
16077     * Return the value specifying the text direction or policy that was set with
16078     * {@link #setTextDirection(int)}.
16079     *
16080     * @return the defined text direction. It can be one of:
16081     *
16082     * {@link #TEXT_DIRECTION_INHERIT},
16083     * {@link #TEXT_DIRECTION_FIRST_STRONG}
16084     * {@link #TEXT_DIRECTION_ANY_RTL},
16085     * {@link #TEXT_DIRECTION_LTR},
16086     * {@link #TEXT_DIRECTION_RTL},
16087     * {@link #TEXT_DIRECTION_LOCALE}
16088     */
16089    @ViewDebug.ExportedProperty(category = "text", mapping = {
16090            @ViewDebug.IntToString(from = TEXT_DIRECTION_INHERIT, to = "INHERIT"),
16091            @ViewDebug.IntToString(from = TEXT_DIRECTION_FIRST_STRONG, to = "FIRST_STRONG"),
16092            @ViewDebug.IntToString(from = TEXT_DIRECTION_ANY_RTL, to = "ANY_RTL"),
16093            @ViewDebug.IntToString(from = TEXT_DIRECTION_LTR, to = "LTR"),
16094            @ViewDebug.IntToString(from = TEXT_DIRECTION_RTL, to = "RTL"),
16095            @ViewDebug.IntToString(from = TEXT_DIRECTION_LOCALE, to = "LOCALE")
16096    })
16097    public int getTextDirection() {
16098        return (mPrivateFlags2 & TEXT_DIRECTION_MASK) >> TEXT_DIRECTION_MASK_SHIFT;
16099    }
16100
16101    /**
16102     * Set the text direction.
16103     *
16104     * @param textDirection the direction to set. Should be one of:
16105     *
16106     * {@link #TEXT_DIRECTION_INHERIT},
16107     * {@link #TEXT_DIRECTION_FIRST_STRONG}
16108     * {@link #TEXT_DIRECTION_ANY_RTL},
16109     * {@link #TEXT_DIRECTION_LTR},
16110     * {@link #TEXT_DIRECTION_RTL},
16111     * {@link #TEXT_DIRECTION_LOCALE}
16112     */
16113    public void setTextDirection(int textDirection) {
16114        if (getTextDirection() != textDirection) {
16115            // Reset the current text direction and the resolved one
16116            mPrivateFlags2 &= ~TEXT_DIRECTION_MASK;
16117            resetResolvedTextDirection();
16118            // Set the new text direction
16119            mPrivateFlags2 |= ((textDirection << TEXT_DIRECTION_MASK_SHIFT) & TEXT_DIRECTION_MASK);
16120            // Refresh
16121            requestLayout();
16122            invalidate(true);
16123        }
16124    }
16125
16126    /**
16127     * Return the resolved text direction.
16128     *
16129     * This needs resolution if the value is TEXT_DIRECTION_INHERIT. The resolution matches
16130     * {@link #getTextDirection()}if it is not TEXT_DIRECTION_INHERIT, otherwise resolution proceeds
16131     * up the parent chain of the view. if there is no parent, then it will return the default
16132     * {@link #TEXT_DIRECTION_FIRST_STRONG}.
16133     *
16134     * @return the resolved text direction. Returns one of:
16135     *
16136     * {@link #TEXT_DIRECTION_FIRST_STRONG}
16137     * {@link #TEXT_DIRECTION_ANY_RTL},
16138     * {@link #TEXT_DIRECTION_LTR},
16139     * {@link #TEXT_DIRECTION_RTL},
16140     * {@link #TEXT_DIRECTION_LOCALE}
16141     */
16142    public int getResolvedTextDirection() {
16143        // The text direction will be resolved only if needed
16144        if ((mPrivateFlags2 & TEXT_DIRECTION_RESOLVED) != TEXT_DIRECTION_RESOLVED) {
16145            resolveTextDirection();
16146        }
16147        return (mPrivateFlags2 & TEXT_DIRECTION_RESOLVED_MASK) >> TEXT_DIRECTION_RESOLVED_MASK_SHIFT;
16148    }
16149
16150    /**
16151     * Resolve the text direction. Will call {@link View#onResolvedTextDirectionChanged} when
16152     * resolution is done.
16153     */
16154    public void resolveTextDirection() {
16155        // Reset any previous text direction resolution
16156        mPrivateFlags2 &= ~(TEXT_DIRECTION_RESOLVED | TEXT_DIRECTION_RESOLVED_MASK);
16157
16158        if (hasRtlSupport()) {
16159            // Set resolved text direction flag depending on text direction flag
16160            final int textDirection = getTextDirection();
16161            switch(textDirection) {
16162                case TEXT_DIRECTION_INHERIT:
16163                    if (canResolveTextDirection()) {
16164                        ViewGroup viewGroup = ((ViewGroup) mParent);
16165
16166                        // Set current resolved direction to the same value as the parent's one
16167                        final int parentResolvedDirection = viewGroup.getResolvedTextDirection();
16168                        switch (parentResolvedDirection) {
16169                            case TEXT_DIRECTION_FIRST_STRONG:
16170                            case TEXT_DIRECTION_ANY_RTL:
16171                            case TEXT_DIRECTION_LTR:
16172                            case TEXT_DIRECTION_RTL:
16173                            case TEXT_DIRECTION_LOCALE:
16174                                mPrivateFlags2 |=
16175                                        (parentResolvedDirection << TEXT_DIRECTION_RESOLVED_MASK_SHIFT);
16176                                break;
16177                            default:
16178                                // Default resolved direction is "first strong" heuristic
16179                                mPrivateFlags2 |= TEXT_DIRECTION_RESOLVED_DEFAULT;
16180                        }
16181                    } else {
16182                        // We cannot do the resolution if there is no parent, so use the default one
16183                        mPrivateFlags2 |= TEXT_DIRECTION_RESOLVED_DEFAULT;
16184                    }
16185                    break;
16186                case TEXT_DIRECTION_FIRST_STRONG:
16187                case TEXT_DIRECTION_ANY_RTL:
16188                case TEXT_DIRECTION_LTR:
16189                case TEXT_DIRECTION_RTL:
16190                case TEXT_DIRECTION_LOCALE:
16191                    // Resolved direction is the same as text direction
16192                    mPrivateFlags2 |= (textDirection << TEXT_DIRECTION_RESOLVED_MASK_SHIFT);
16193                    break;
16194                default:
16195                    // Default resolved direction is "first strong" heuristic
16196                    mPrivateFlags2 |= TEXT_DIRECTION_RESOLVED_DEFAULT;
16197            }
16198        } else {
16199            // Default resolved direction is "first strong" heuristic
16200            mPrivateFlags2 |= TEXT_DIRECTION_RESOLVED_DEFAULT;
16201        }
16202
16203        // Set to resolved
16204        mPrivateFlags2 |= TEXT_DIRECTION_RESOLVED;
16205        onResolvedTextDirectionChanged();
16206    }
16207
16208    /**
16209     * Called when text direction has been resolved. Subclasses that care about text direction
16210     * resolution should override this method.
16211     *
16212     * The default implementation does nothing.
16213     */
16214    public void onResolvedTextDirectionChanged() {
16215    }
16216
16217    /**
16218     * Check if text direction resolution can be done.
16219     *
16220     * @return true if text direction resolution can be done otherwise return false.
16221     */
16222    public boolean canResolveTextDirection() {
16223        switch (getTextDirection()) {
16224            case TEXT_DIRECTION_INHERIT:
16225                return (mParent != null) && (mParent instanceof ViewGroup);
16226            default:
16227                return true;
16228        }
16229    }
16230
16231    /**
16232     * Reset resolved text direction. Text direction can be resolved with a call to
16233     * getResolvedTextDirection(). Will call {@link View#onResolvedTextDirectionReset} when
16234     * reset is done.
16235     */
16236    public void resetResolvedTextDirection() {
16237        mPrivateFlags2 &= ~(TEXT_DIRECTION_RESOLVED | TEXT_DIRECTION_RESOLVED_MASK);
16238        onResolvedTextDirectionReset();
16239    }
16240
16241    /**
16242     * Called when text direction is reset. Subclasses that care about text direction reset should
16243     * override this method and do a reset of the text direction of their children. The default
16244     * implementation does nothing.
16245     */
16246    public void onResolvedTextDirectionReset() {
16247    }
16248
16249    /**
16250     * Return the value specifying the text alignment or policy that was set with
16251     * {@link #setTextAlignment(int)}.
16252     *
16253     * @return the defined text alignment. It can be one of:
16254     *
16255     * {@link #TEXT_ALIGNMENT_INHERIT},
16256     * {@link #TEXT_ALIGNMENT_GRAVITY},
16257     * {@link #TEXT_ALIGNMENT_CENTER},
16258     * {@link #TEXT_ALIGNMENT_TEXT_START},
16259     * {@link #TEXT_ALIGNMENT_TEXT_END},
16260     * {@link #TEXT_ALIGNMENT_VIEW_START},
16261     * {@link #TEXT_ALIGNMENT_VIEW_END}
16262     */
16263    @ViewDebug.ExportedProperty(category = "text", mapping = {
16264            @ViewDebug.IntToString(from = TEXT_ALIGNMENT_INHERIT, to = "INHERIT"),
16265            @ViewDebug.IntToString(from = TEXT_ALIGNMENT_GRAVITY, to = "GRAVITY"),
16266            @ViewDebug.IntToString(from = TEXT_ALIGNMENT_TEXT_START, to = "TEXT_START"),
16267            @ViewDebug.IntToString(from = TEXT_ALIGNMENT_TEXT_END, to = "TEXT_END"),
16268            @ViewDebug.IntToString(from = TEXT_ALIGNMENT_CENTER, to = "CENTER"),
16269            @ViewDebug.IntToString(from = TEXT_ALIGNMENT_VIEW_START, to = "VIEW_START"),
16270            @ViewDebug.IntToString(from = TEXT_ALIGNMENT_VIEW_END, to = "VIEW_END")
16271    })
16272    public int getTextAlignment() {
16273        return (mPrivateFlags2 & TEXT_ALIGNMENT_MASK) >> TEXT_ALIGNMENT_MASK_SHIFT;
16274    }
16275
16276    /**
16277     * Set the text alignment.
16278     *
16279     * @param textAlignment The text alignment to set. Should be one of
16280     *
16281     * {@link #TEXT_ALIGNMENT_INHERIT},
16282     * {@link #TEXT_ALIGNMENT_GRAVITY},
16283     * {@link #TEXT_ALIGNMENT_CENTER},
16284     * {@link #TEXT_ALIGNMENT_TEXT_START},
16285     * {@link #TEXT_ALIGNMENT_TEXT_END},
16286     * {@link #TEXT_ALIGNMENT_VIEW_START},
16287     * {@link #TEXT_ALIGNMENT_VIEW_END}
16288     *
16289     * @attr ref android.R.styleable#View_textAlignment
16290     */
16291    public void setTextAlignment(int textAlignment) {
16292        if (textAlignment != getTextAlignment()) {
16293            // Reset the current and resolved text alignment
16294            mPrivateFlags2 &= ~TEXT_ALIGNMENT_MASK;
16295            resetResolvedTextAlignment();
16296            // Set the new text alignment
16297            mPrivateFlags2 |= ((textAlignment << TEXT_ALIGNMENT_MASK_SHIFT) & TEXT_ALIGNMENT_MASK);
16298            // Refresh
16299            requestLayout();
16300            invalidate(true);
16301        }
16302    }
16303
16304    /**
16305     * Return the resolved text alignment.
16306     *
16307     * The resolved text alignment. This needs resolution if the value is
16308     * TEXT_ALIGNMENT_INHERIT. The resolution matches {@link #setTextAlignment(int)}  if it is
16309     * not TEXT_ALIGNMENT_INHERIT, otherwise resolution proceeds up the parent chain of the view.
16310     *
16311     * @return the resolved text alignment. Returns one of:
16312     *
16313     * {@link #TEXT_ALIGNMENT_GRAVITY},
16314     * {@link #TEXT_ALIGNMENT_CENTER},
16315     * {@link #TEXT_ALIGNMENT_TEXT_START},
16316     * {@link #TEXT_ALIGNMENT_TEXT_END},
16317     * {@link #TEXT_ALIGNMENT_VIEW_START},
16318     * {@link #TEXT_ALIGNMENT_VIEW_END}
16319     */
16320    @ViewDebug.ExportedProperty(category = "text", mapping = {
16321            @ViewDebug.IntToString(from = TEXT_ALIGNMENT_INHERIT, to = "INHERIT"),
16322            @ViewDebug.IntToString(from = TEXT_ALIGNMENT_GRAVITY, to = "GRAVITY"),
16323            @ViewDebug.IntToString(from = TEXT_ALIGNMENT_TEXT_START, to = "TEXT_START"),
16324            @ViewDebug.IntToString(from = TEXT_ALIGNMENT_TEXT_END, to = "TEXT_END"),
16325            @ViewDebug.IntToString(from = TEXT_ALIGNMENT_CENTER, to = "CENTER"),
16326            @ViewDebug.IntToString(from = TEXT_ALIGNMENT_VIEW_START, to = "VIEW_START"),
16327            @ViewDebug.IntToString(from = TEXT_ALIGNMENT_VIEW_END, to = "VIEW_END")
16328    })
16329    public int getResolvedTextAlignment() {
16330        // If text alignment is not resolved, then resolve it
16331        if ((mPrivateFlags2 & TEXT_ALIGNMENT_RESOLVED) != TEXT_ALIGNMENT_RESOLVED) {
16332            resolveTextAlignment();
16333        }
16334        return (mPrivateFlags2 & TEXT_ALIGNMENT_RESOLVED_MASK) >> TEXT_ALIGNMENT_RESOLVED_MASK_SHIFT;
16335    }
16336
16337    /**
16338     * Resolve the text alignment. Will call {@link View#onResolvedTextAlignmentChanged} when
16339     * resolution is done.
16340     */
16341    public void resolveTextAlignment() {
16342        // Reset any previous text alignment resolution
16343        mPrivateFlags2 &= ~(TEXT_ALIGNMENT_RESOLVED | TEXT_ALIGNMENT_RESOLVED_MASK);
16344
16345        if (hasRtlSupport()) {
16346            // Set resolved text alignment flag depending on text alignment flag
16347            final int textAlignment = getTextAlignment();
16348            switch (textAlignment) {
16349                case TEXT_ALIGNMENT_INHERIT:
16350                    // Check if we can resolve the text alignment
16351                    if (canResolveLayoutDirection() && mParent instanceof View) {
16352                        View view = (View) mParent;
16353
16354                        final int parentResolvedTextAlignment = view.getResolvedTextAlignment();
16355                        switch (parentResolvedTextAlignment) {
16356                            case TEXT_ALIGNMENT_GRAVITY:
16357                            case TEXT_ALIGNMENT_TEXT_START:
16358                            case TEXT_ALIGNMENT_TEXT_END:
16359                            case TEXT_ALIGNMENT_CENTER:
16360                            case TEXT_ALIGNMENT_VIEW_START:
16361                            case TEXT_ALIGNMENT_VIEW_END:
16362                                // Resolved text alignment is the same as the parent resolved
16363                                // text alignment
16364                                mPrivateFlags2 |=
16365                                        (parentResolvedTextAlignment << TEXT_ALIGNMENT_RESOLVED_MASK_SHIFT);
16366                                break;
16367                            default:
16368                                // Use default resolved text alignment
16369                                mPrivateFlags2 |= TEXT_ALIGNMENT_RESOLVED_DEFAULT;
16370                        }
16371                    }
16372                    else {
16373                        // We cannot do the resolution if there is no parent so use the default
16374                        mPrivateFlags2 |= TEXT_ALIGNMENT_RESOLVED_DEFAULT;
16375                    }
16376                    break;
16377                case TEXT_ALIGNMENT_GRAVITY:
16378                case TEXT_ALIGNMENT_TEXT_START:
16379                case TEXT_ALIGNMENT_TEXT_END:
16380                case TEXT_ALIGNMENT_CENTER:
16381                case TEXT_ALIGNMENT_VIEW_START:
16382                case TEXT_ALIGNMENT_VIEW_END:
16383                    // Resolved text alignment is the same as text alignment
16384                    mPrivateFlags2 |= (textAlignment << TEXT_ALIGNMENT_RESOLVED_MASK_SHIFT);
16385                    break;
16386                default:
16387                    // Use default resolved text alignment
16388                    mPrivateFlags2 |= TEXT_ALIGNMENT_RESOLVED_DEFAULT;
16389            }
16390        } else {
16391            // Use default resolved text alignment
16392            mPrivateFlags2 |= TEXT_ALIGNMENT_RESOLVED_DEFAULT;
16393        }
16394
16395        // Set the resolved
16396        mPrivateFlags2 |= TEXT_ALIGNMENT_RESOLVED;
16397        onResolvedTextAlignmentChanged();
16398    }
16399
16400    /**
16401     * Check if text alignment resolution can be done.
16402     *
16403     * @return true if text alignment resolution can be done otherwise return false.
16404     */
16405    public boolean canResolveTextAlignment() {
16406        switch (getTextAlignment()) {
16407            case TEXT_DIRECTION_INHERIT:
16408                return (mParent != null);
16409            default:
16410                return true;
16411        }
16412    }
16413
16414    /**
16415     * Called when text alignment has been resolved. Subclasses that care about text alignment
16416     * resolution should override this method.
16417     *
16418     * The default implementation does nothing.
16419     */
16420    public void onResolvedTextAlignmentChanged() {
16421    }
16422
16423    /**
16424     * Reset resolved text alignment. Text alignment can be resolved with a call to
16425     * getResolvedTextAlignment(). Will call {@link View#onResolvedTextAlignmentReset} when
16426     * reset is done.
16427     */
16428    public void resetResolvedTextAlignment() {
16429        // Reset any previous text alignment resolution
16430        mPrivateFlags2 &= ~(TEXT_ALIGNMENT_RESOLVED | TEXT_ALIGNMENT_RESOLVED_MASK);
16431        onResolvedTextAlignmentReset();
16432    }
16433
16434    /**
16435     * Called when text alignment is reset. Subclasses that care about text alignment reset should
16436     * override this method and do a reset of the text alignment of their children. The default
16437     * implementation does nothing.
16438     */
16439    public void onResolvedTextAlignmentReset() {
16440    }
16441
16442    //
16443    // Properties
16444    //
16445    /**
16446     * A Property wrapper around the <code>alpha</code> functionality handled by the
16447     * {@link View#setAlpha(float)} and {@link View#getAlpha()} methods.
16448     */
16449    public static final Property<View, Float> ALPHA = new FloatProperty<View>("alpha") {
16450        @Override
16451        public void setValue(View object, float value) {
16452            object.setAlpha(value);
16453        }
16454
16455        @Override
16456        public Float get(View object) {
16457            return object.getAlpha();
16458        }
16459    };
16460
16461    /**
16462     * A Property wrapper around the <code>translationX</code> functionality handled by the
16463     * {@link View#setTranslationX(float)} and {@link View#getTranslationX()} methods.
16464     */
16465    public static final Property<View, Float> TRANSLATION_X = new FloatProperty<View>("translationX") {
16466        @Override
16467        public void setValue(View object, float value) {
16468            object.setTranslationX(value);
16469        }
16470
16471                @Override
16472        public Float get(View object) {
16473            return object.getTranslationX();
16474        }
16475    };
16476
16477    /**
16478     * A Property wrapper around the <code>translationY</code> functionality handled by the
16479     * {@link View#setTranslationY(float)} and {@link View#getTranslationY()} methods.
16480     */
16481    public static final Property<View, Float> TRANSLATION_Y = new FloatProperty<View>("translationY") {
16482        @Override
16483        public void setValue(View object, float value) {
16484            object.setTranslationY(value);
16485        }
16486
16487        @Override
16488        public Float get(View object) {
16489            return object.getTranslationY();
16490        }
16491    };
16492
16493    /**
16494     * A Property wrapper around the <code>x</code> functionality handled by the
16495     * {@link View#setX(float)} and {@link View#getX()} methods.
16496     */
16497    public static final Property<View, Float> X = new FloatProperty<View>("x") {
16498        @Override
16499        public void setValue(View object, float value) {
16500            object.setX(value);
16501        }
16502
16503        @Override
16504        public Float get(View object) {
16505            return object.getX();
16506        }
16507    };
16508
16509    /**
16510     * A Property wrapper around the <code>y</code> functionality handled by the
16511     * {@link View#setY(float)} and {@link View#getY()} methods.
16512     */
16513    public static final Property<View, Float> Y = new FloatProperty<View>("y") {
16514        @Override
16515        public void setValue(View object, float value) {
16516            object.setY(value);
16517        }
16518
16519        @Override
16520        public Float get(View object) {
16521            return object.getY();
16522        }
16523    };
16524
16525    /**
16526     * A Property wrapper around the <code>rotation</code> functionality handled by the
16527     * {@link View#setRotation(float)} and {@link View#getRotation()} methods.
16528     */
16529    public static final Property<View, Float> ROTATION = new FloatProperty<View>("rotation") {
16530        @Override
16531        public void setValue(View object, float value) {
16532            object.setRotation(value);
16533        }
16534
16535        @Override
16536        public Float get(View object) {
16537            return object.getRotation();
16538        }
16539    };
16540
16541    /**
16542     * A Property wrapper around the <code>rotationX</code> functionality handled by the
16543     * {@link View#setRotationX(float)} and {@link View#getRotationX()} methods.
16544     */
16545    public static final Property<View, Float> ROTATION_X = new FloatProperty<View>("rotationX") {
16546        @Override
16547        public void setValue(View object, float value) {
16548            object.setRotationX(value);
16549        }
16550
16551        @Override
16552        public Float get(View object) {
16553            return object.getRotationX();
16554        }
16555    };
16556
16557    /**
16558     * A Property wrapper around the <code>rotationY</code> functionality handled by the
16559     * {@link View#setRotationY(float)} and {@link View#getRotationY()} methods.
16560     */
16561    public static final Property<View, Float> ROTATION_Y = new FloatProperty<View>("rotationY") {
16562        @Override
16563        public void setValue(View object, float value) {
16564            object.setRotationY(value);
16565        }
16566
16567        @Override
16568        public Float get(View object) {
16569            return object.getRotationY();
16570        }
16571    };
16572
16573    /**
16574     * A Property wrapper around the <code>scaleX</code> functionality handled by the
16575     * {@link View#setScaleX(float)} and {@link View#getScaleX()} methods.
16576     */
16577    public static final Property<View, Float> SCALE_X = new FloatProperty<View>("scaleX") {
16578        @Override
16579        public void setValue(View object, float value) {
16580            object.setScaleX(value);
16581        }
16582
16583        @Override
16584        public Float get(View object) {
16585            return object.getScaleX();
16586        }
16587    };
16588
16589    /**
16590     * A Property wrapper around the <code>scaleY</code> functionality handled by the
16591     * {@link View#setScaleY(float)} and {@link View#getScaleY()} methods.
16592     */
16593    public static final Property<View, Float> SCALE_Y = new FloatProperty<View>("scaleY") {
16594        @Override
16595        public void setValue(View object, float value) {
16596            object.setScaleY(value);
16597        }
16598
16599        @Override
16600        public Float get(View object) {
16601            return object.getScaleY();
16602        }
16603    };
16604
16605    /**
16606     * A MeasureSpec encapsulates the layout requirements passed from parent to child.
16607     * Each MeasureSpec represents a requirement for either the width or the height.
16608     * A MeasureSpec is comprised of a size and a mode. There are three possible
16609     * modes:
16610     * <dl>
16611     * <dt>UNSPECIFIED</dt>
16612     * <dd>
16613     * The parent has not imposed any constraint on the child. It can be whatever size
16614     * it wants.
16615     * </dd>
16616     *
16617     * <dt>EXACTLY</dt>
16618     * <dd>
16619     * The parent has determined an exact size for the child. The child is going to be
16620     * given those bounds regardless of how big it wants to be.
16621     * </dd>
16622     *
16623     * <dt>AT_MOST</dt>
16624     * <dd>
16625     * The child can be as large as it wants up to the specified size.
16626     * </dd>
16627     * </dl>
16628     *
16629     * MeasureSpecs are implemented as ints to reduce object allocation. This class
16630     * is provided to pack and unpack the &lt;size, mode&gt; tuple into the int.
16631     */
16632    public static class MeasureSpec {
16633        private static final int MODE_SHIFT = 30;
16634        private static final int MODE_MASK  = 0x3 << MODE_SHIFT;
16635
16636        /**
16637         * Measure specification mode: The parent has not imposed any constraint
16638         * on the child. It can be whatever size it wants.
16639         */
16640        public static final int UNSPECIFIED = 0 << MODE_SHIFT;
16641
16642        /**
16643         * Measure specification mode: The parent has determined an exact size
16644         * for the child. The child is going to be given those bounds regardless
16645         * of how big it wants to be.
16646         */
16647        public static final int EXACTLY     = 1 << MODE_SHIFT;
16648
16649        /**
16650         * Measure specification mode: The child can be as large as it wants up
16651         * to the specified size.
16652         */
16653        public static final int AT_MOST     = 2 << MODE_SHIFT;
16654
16655        /**
16656         * Creates a measure specification based on the supplied size and mode.
16657         *
16658         * The mode must always be one of the following:
16659         * <ul>
16660         *  <li>{@link android.view.View.MeasureSpec#UNSPECIFIED}</li>
16661         *  <li>{@link android.view.View.MeasureSpec#EXACTLY}</li>
16662         *  <li>{@link android.view.View.MeasureSpec#AT_MOST}</li>
16663         * </ul>
16664         *
16665         * @param size the size of the measure specification
16666         * @param mode the mode of the measure specification
16667         * @return the measure specification based on size and mode
16668         */
16669        public static int makeMeasureSpec(int size, int mode) {
16670            return size + mode;
16671        }
16672
16673        /**
16674         * Extracts the mode from the supplied measure specification.
16675         *
16676         * @param measureSpec the measure specification to extract the mode from
16677         * @return {@link android.view.View.MeasureSpec#UNSPECIFIED},
16678         *         {@link android.view.View.MeasureSpec#AT_MOST} or
16679         *         {@link android.view.View.MeasureSpec#EXACTLY}
16680         */
16681        public static int getMode(int measureSpec) {
16682            return (measureSpec & MODE_MASK);
16683        }
16684
16685        /**
16686         * Extracts the size from the supplied measure specification.
16687         *
16688         * @param measureSpec the measure specification to extract the size from
16689         * @return the size in pixels defined in the supplied measure specification
16690         */
16691        public static int getSize(int measureSpec) {
16692            return (measureSpec & ~MODE_MASK);
16693        }
16694
16695        /**
16696         * Returns a String representation of the specified measure
16697         * specification.
16698         *
16699         * @param measureSpec the measure specification to convert to a String
16700         * @return a String with the following format: "MeasureSpec: MODE SIZE"
16701         */
16702        public static String toString(int measureSpec) {
16703            int mode = getMode(measureSpec);
16704            int size = getSize(measureSpec);
16705
16706            StringBuilder sb = new StringBuilder("MeasureSpec: ");
16707
16708            if (mode == UNSPECIFIED)
16709                sb.append("UNSPECIFIED ");
16710            else if (mode == EXACTLY)
16711                sb.append("EXACTLY ");
16712            else if (mode == AT_MOST)
16713                sb.append("AT_MOST ");
16714            else
16715                sb.append(mode).append(" ");
16716
16717            sb.append(size);
16718            return sb.toString();
16719        }
16720    }
16721
16722    class CheckForLongPress implements Runnable {
16723
16724        private int mOriginalWindowAttachCount;
16725
16726        public void run() {
16727            if (isPressed() && (mParent != null)
16728                    && mOriginalWindowAttachCount == mWindowAttachCount) {
16729                if (performLongClick()) {
16730                    mHasPerformedLongPress = true;
16731                }
16732            }
16733        }
16734
16735        public void rememberWindowAttachCount() {
16736            mOriginalWindowAttachCount = mWindowAttachCount;
16737        }
16738    }
16739
16740    private final class CheckForTap implements Runnable {
16741        public void run() {
16742            mPrivateFlags &= ~PREPRESSED;
16743            setPressed(true);
16744            checkForLongClick(ViewConfiguration.getTapTimeout());
16745        }
16746    }
16747
16748    private final class PerformClick implements Runnable {
16749        public void run() {
16750            performClick();
16751        }
16752    }
16753
16754    /** @hide */
16755    public void hackTurnOffWindowResizeAnim(boolean off) {
16756        mAttachInfo.mTurnOffWindowResizeAnim = off;
16757    }
16758
16759    /**
16760     * This method returns a ViewPropertyAnimator object, which can be used to animate
16761     * specific properties on this View.
16762     *
16763     * @return ViewPropertyAnimator The ViewPropertyAnimator associated with this View.
16764     */
16765    public ViewPropertyAnimator animate() {
16766        if (mAnimator == null) {
16767            mAnimator = new ViewPropertyAnimator(this);
16768        }
16769        return mAnimator;
16770    }
16771
16772    /**
16773     * Interface definition for a callback to be invoked when a key event is
16774     * dispatched to this view. The callback will be invoked before the key
16775     * event is given to the view.
16776     */
16777    public interface OnKeyListener {
16778        /**
16779         * Called when a key is dispatched to a view. This allows listeners to
16780         * get a chance to respond before the target view.
16781         *
16782         * @param v The view the key has been dispatched to.
16783         * @param keyCode The code for the physical key that was pressed
16784         * @param event The KeyEvent object containing full information about
16785         *        the event.
16786         * @return True if the listener has consumed the event, false otherwise.
16787         */
16788        boolean onKey(View v, int keyCode, KeyEvent event);
16789    }
16790
16791    /**
16792     * Interface definition for a callback to be invoked when a touch event is
16793     * dispatched to this view. The callback will be invoked before the touch
16794     * event is given to the view.
16795     */
16796    public interface OnTouchListener {
16797        /**
16798         * Called when a touch event is dispatched to a view. This allows listeners to
16799         * get a chance to respond before the target view.
16800         *
16801         * @param v The view the touch event has been dispatched to.
16802         * @param event The MotionEvent object containing full information about
16803         *        the event.
16804         * @return True if the listener has consumed the event, false otherwise.
16805         */
16806        boolean onTouch(View v, MotionEvent event);
16807    }
16808
16809    /**
16810     * Interface definition for a callback to be invoked when a hover event is
16811     * dispatched to this view. The callback will be invoked before the hover
16812     * event is given to the view.
16813     */
16814    public interface OnHoverListener {
16815        /**
16816         * Called when a hover event is dispatched to a view. This allows listeners to
16817         * get a chance to respond before the target view.
16818         *
16819         * @param v The view the hover event has been dispatched to.
16820         * @param event The MotionEvent object containing full information about
16821         *        the event.
16822         * @return True if the listener has consumed the event, false otherwise.
16823         */
16824        boolean onHover(View v, MotionEvent event);
16825    }
16826
16827    /**
16828     * Interface definition for a callback to be invoked when a generic motion event is
16829     * dispatched to this view. The callback will be invoked before the generic motion
16830     * event is given to the view.
16831     */
16832    public interface OnGenericMotionListener {
16833        /**
16834         * Called when a generic motion event is dispatched to a view. This allows listeners to
16835         * get a chance to respond before the target view.
16836         *
16837         * @param v The view the generic motion event has been dispatched to.
16838         * @param event The MotionEvent object containing full information about
16839         *        the event.
16840         * @return True if the listener has consumed the event, false otherwise.
16841         */
16842        boolean onGenericMotion(View v, MotionEvent event);
16843    }
16844
16845    /**
16846     * Interface definition for a callback to be invoked when a view has been clicked and held.
16847     */
16848    public interface OnLongClickListener {
16849        /**
16850         * Called when a view has been clicked and held.
16851         *
16852         * @param v The view that was clicked and held.
16853         *
16854         * @return true if the callback consumed the long click, false otherwise.
16855         */
16856        boolean onLongClick(View v);
16857    }
16858
16859    /**
16860     * Interface definition for a callback to be invoked when a drag is being dispatched
16861     * to this view.  The callback will be invoked before the hosting view's own
16862     * onDrag(event) method.  If the listener wants to fall back to the hosting view's
16863     * onDrag(event) behavior, it should return 'false' from this callback.
16864     *
16865     * <div class="special reference">
16866     * <h3>Developer Guides</h3>
16867     * <p>For a guide to implementing drag and drop features, read the
16868     * <a href="{@docRoot}guide/topics/ui/drag-drop.html">Drag and Drop</a> developer guide.</p>
16869     * </div>
16870     */
16871    public interface OnDragListener {
16872        /**
16873         * Called when a drag event is dispatched to a view. This allows listeners
16874         * to get a chance to override base View behavior.
16875         *
16876         * @param v The View that received the drag event.
16877         * @param event The {@link android.view.DragEvent} object for the drag event.
16878         * @return {@code true} if the drag event was handled successfully, or {@code false}
16879         * if the drag event was not handled. Note that {@code false} will trigger the View
16880         * to call its {@link #onDragEvent(DragEvent) onDragEvent()} handler.
16881         */
16882        boolean onDrag(View v, DragEvent event);
16883    }
16884
16885    /**
16886     * Interface definition for a callback to be invoked when the focus state of
16887     * a view changed.
16888     */
16889    public interface OnFocusChangeListener {
16890        /**
16891         * Called when the focus state of a view has changed.
16892         *
16893         * @param v The view whose state has changed.
16894         * @param hasFocus The new focus state of v.
16895         */
16896        void onFocusChange(View v, boolean hasFocus);
16897    }
16898
16899    /**
16900     * Interface definition for a callback to be invoked when a view is clicked.
16901     */
16902    public interface OnClickListener {
16903        /**
16904         * Called when a view has been clicked.
16905         *
16906         * @param v The view that was clicked.
16907         */
16908        void onClick(View v);
16909    }
16910
16911    /**
16912     * Interface definition for a callback to be invoked when the context menu
16913     * for this view is being built.
16914     */
16915    public interface OnCreateContextMenuListener {
16916        /**
16917         * Called when the context menu for this view is being built. It is not
16918         * safe to hold onto the menu after this method returns.
16919         *
16920         * @param menu The context menu that is being built
16921         * @param v The view for which the context menu is being built
16922         * @param menuInfo Extra information about the item for which the
16923         *            context menu should be shown. This information will vary
16924         *            depending on the class of v.
16925         */
16926        void onCreateContextMenu(ContextMenu menu, View v, ContextMenuInfo menuInfo);
16927    }
16928
16929    /**
16930     * Interface definition for a callback to be invoked when the status bar changes
16931     * visibility.  This reports <strong>global</strong> changes to the system UI
16932     * state, not what the application is requesting.
16933     *
16934     * @see View#setOnSystemUiVisibilityChangeListener(android.view.View.OnSystemUiVisibilityChangeListener)
16935     */
16936    public interface OnSystemUiVisibilityChangeListener {
16937        /**
16938         * Called when the status bar changes visibility because of a call to
16939         * {@link View#setSystemUiVisibility(int)}.
16940         *
16941         * @param visibility  Bitwise-or of flags {@link #SYSTEM_UI_FLAG_LOW_PROFILE},
16942         * {@link #SYSTEM_UI_FLAG_HIDE_NAVIGATION}, and {@link #SYSTEM_UI_FLAG_FULLSCREEN}.
16943         * This tells you the <strong>global</strong> state of these UI visibility
16944         * flags, not what your app is currently applying.
16945         */
16946        public void onSystemUiVisibilityChange(int visibility);
16947    }
16948
16949    /**
16950     * Interface definition for a callback to be invoked when this view is attached
16951     * or detached from its window.
16952     */
16953    public interface OnAttachStateChangeListener {
16954        /**
16955         * Called when the view is attached to a window.
16956         * @param v The view that was attached
16957         */
16958        public void onViewAttachedToWindow(View v);
16959        /**
16960         * Called when the view is detached from a window.
16961         * @param v The view that was detached
16962         */
16963        public void onViewDetachedFromWindow(View v);
16964    }
16965
16966    private final class UnsetPressedState implements Runnable {
16967        public void run() {
16968            setPressed(false);
16969        }
16970    }
16971
16972    /**
16973     * Base class for derived classes that want to save and restore their own
16974     * state in {@link android.view.View#onSaveInstanceState()}.
16975     */
16976    public static class BaseSavedState extends AbsSavedState {
16977        /**
16978         * Constructor used when reading from a parcel. Reads the state of the superclass.
16979         *
16980         * @param source
16981         */
16982        public BaseSavedState(Parcel source) {
16983            super(source);
16984        }
16985
16986        /**
16987         * Constructor called by derived classes when creating their SavedState objects
16988         *
16989         * @param superState The state of the superclass of this view
16990         */
16991        public BaseSavedState(Parcelable superState) {
16992            super(superState);
16993        }
16994
16995        public static final Parcelable.Creator<BaseSavedState> CREATOR =
16996                new Parcelable.Creator<BaseSavedState>() {
16997            public BaseSavedState createFromParcel(Parcel in) {
16998                return new BaseSavedState(in);
16999            }
17000
17001            public BaseSavedState[] newArray(int size) {
17002                return new BaseSavedState[size];
17003            }
17004        };
17005    }
17006
17007    /**
17008     * A set of information given to a view when it is attached to its parent
17009     * window.
17010     */
17011    static class AttachInfo {
17012        interface Callbacks {
17013            void playSoundEffect(int effectId);
17014            boolean performHapticFeedback(int effectId, boolean always);
17015        }
17016
17017        /**
17018         * InvalidateInfo is used to post invalidate(int, int, int, int) messages
17019         * to a Handler. This class contains the target (View) to invalidate and
17020         * the coordinates of the dirty rectangle.
17021         *
17022         * For performance purposes, this class also implements a pool of up to
17023         * POOL_LIMIT objects that get reused. This reduces memory allocations
17024         * whenever possible.
17025         */
17026        static class InvalidateInfo implements Poolable<InvalidateInfo> {
17027            private static final int POOL_LIMIT = 10;
17028            private static final Pool<InvalidateInfo> sPool = Pools.synchronizedPool(
17029                    Pools.finitePool(new PoolableManager<InvalidateInfo>() {
17030                        public InvalidateInfo newInstance() {
17031                            return new InvalidateInfo();
17032                        }
17033
17034                        public void onAcquired(InvalidateInfo element) {
17035                        }
17036
17037                        public void onReleased(InvalidateInfo element) {
17038                            element.target = null;
17039                        }
17040                    }, POOL_LIMIT)
17041            );
17042
17043            private InvalidateInfo mNext;
17044            private boolean mIsPooled;
17045
17046            View target;
17047
17048            int left;
17049            int top;
17050            int right;
17051            int bottom;
17052
17053            public void setNextPoolable(InvalidateInfo element) {
17054                mNext = element;
17055            }
17056
17057            public InvalidateInfo getNextPoolable() {
17058                return mNext;
17059            }
17060
17061            static InvalidateInfo acquire() {
17062                return sPool.acquire();
17063            }
17064
17065            void release() {
17066                sPool.release(this);
17067            }
17068
17069            public boolean isPooled() {
17070                return mIsPooled;
17071            }
17072
17073            public void setPooled(boolean isPooled) {
17074                mIsPooled = isPooled;
17075            }
17076        }
17077
17078        final IWindowSession mSession;
17079
17080        final IWindow mWindow;
17081
17082        final IBinder mWindowToken;
17083
17084        final Callbacks mRootCallbacks;
17085
17086        HardwareCanvas mHardwareCanvas;
17087
17088        /**
17089         * The top view of the hierarchy.
17090         */
17091        View mRootView;
17092
17093        IBinder mPanelParentWindowToken;
17094        Surface mSurface;
17095
17096        boolean mHardwareAccelerated;
17097        boolean mHardwareAccelerationRequested;
17098        HardwareRenderer mHardwareRenderer;
17099
17100        boolean mScreenOn;
17101
17102        /**
17103         * Scale factor used by the compatibility mode
17104         */
17105        float mApplicationScale;
17106
17107        /**
17108         * Indicates whether the application is in compatibility mode
17109         */
17110        boolean mScalingRequired;
17111
17112        /**
17113         * If set, ViewAncestor doesn't use its lame animation for when the window resizes.
17114         */
17115        boolean mTurnOffWindowResizeAnim;
17116
17117        /**
17118         * Left position of this view's window
17119         */
17120        int mWindowLeft;
17121
17122        /**
17123         * Top position of this view's window
17124         */
17125        int mWindowTop;
17126
17127        /**
17128         * Indicates whether views need to use 32-bit drawing caches
17129         */
17130        boolean mUse32BitDrawingCache;
17131
17132        /**
17133         * For windows that are full-screen but using insets to layout inside
17134         * of the screen decorations, these are the current insets for the
17135         * content of the window.
17136         */
17137        final Rect mContentInsets = new Rect();
17138
17139        /**
17140         * For windows that are full-screen but using insets to layout inside
17141         * of the screen decorations, these are the current insets for the
17142         * actual visible parts of the window.
17143         */
17144        final Rect mVisibleInsets = new Rect();
17145
17146        /**
17147         * The internal insets given by this window.  This value is
17148         * supplied by the client (through
17149         * {@link ViewTreeObserver.OnComputeInternalInsetsListener}) and will
17150         * be given to the window manager when changed to be used in laying
17151         * out windows behind it.
17152         */
17153        final ViewTreeObserver.InternalInsetsInfo mGivenInternalInsets
17154                = new ViewTreeObserver.InternalInsetsInfo();
17155
17156        /**
17157         * All views in the window's hierarchy that serve as scroll containers,
17158         * used to determine if the window can be resized or must be panned
17159         * to adjust for a soft input area.
17160         */
17161        final ArrayList<View> mScrollContainers = new ArrayList<View>();
17162
17163        final KeyEvent.DispatcherState mKeyDispatchState
17164                = new KeyEvent.DispatcherState();
17165
17166        /**
17167         * Indicates whether the view's window currently has the focus.
17168         */
17169        boolean mHasWindowFocus;
17170
17171        /**
17172         * The current visibility of the window.
17173         */
17174        int mWindowVisibility;
17175
17176        /**
17177         * Indicates the time at which drawing started to occur.
17178         */
17179        long mDrawingTime;
17180
17181        /**
17182         * Indicates whether or not ignoring the DIRTY_MASK flags.
17183         */
17184        boolean mIgnoreDirtyState;
17185
17186        /**
17187         * This flag tracks when the mIgnoreDirtyState flag is set during draw(),
17188         * to avoid clearing that flag prematurely.
17189         */
17190        boolean mSetIgnoreDirtyState = false;
17191
17192        /**
17193         * Indicates whether the view's window is currently in touch mode.
17194         */
17195        boolean mInTouchMode;
17196
17197        /**
17198         * Indicates that ViewAncestor should trigger a global layout change
17199         * the next time it performs a traversal
17200         */
17201        boolean mRecomputeGlobalAttributes;
17202
17203        /**
17204         * Always report new attributes at next traversal.
17205         */
17206        boolean mForceReportNewAttributes;
17207
17208        /**
17209         * Set during a traveral if any views want to keep the screen on.
17210         */
17211        boolean mKeepScreenOn;
17212
17213        /**
17214         * Bitwise-or of all of the values that views have passed to setSystemUiVisibility().
17215         */
17216        int mSystemUiVisibility;
17217
17218        /**
17219         * Hack to force certain system UI visibility flags to be cleared.
17220         */
17221        int mDisabledSystemUiVisibility;
17222
17223        /**
17224         * Last global system UI visibility reported by the window manager.
17225         */
17226        int mGlobalSystemUiVisibility;
17227
17228        /**
17229         * True if a view in this hierarchy has an OnSystemUiVisibilityChangeListener
17230         * attached.
17231         */
17232        boolean mHasSystemUiListeners;
17233
17234        /**
17235         * Set if the visibility of any views has changed.
17236         */
17237        boolean mViewVisibilityChanged;
17238
17239        /**
17240         * Set to true if a view has been scrolled.
17241         */
17242        boolean mViewScrollChanged;
17243
17244        /**
17245         * Global to the view hierarchy used as a temporary for dealing with
17246         * x/y points in the transparent region computations.
17247         */
17248        final int[] mTransparentLocation = new int[2];
17249
17250        /**
17251         * Global to the view hierarchy used as a temporary for dealing with
17252         * x/y points in the ViewGroup.invalidateChild implementation.
17253         */
17254        final int[] mInvalidateChildLocation = new int[2];
17255
17256
17257        /**
17258         * Global to the view hierarchy used as a temporary for dealing with
17259         * x/y location when view is transformed.
17260         */
17261        final float[] mTmpTransformLocation = new float[2];
17262
17263        /**
17264         * The view tree observer used to dispatch global events like
17265         * layout, pre-draw, touch mode change, etc.
17266         */
17267        final ViewTreeObserver mTreeObserver = new ViewTreeObserver();
17268
17269        /**
17270         * A Canvas used by the view hierarchy to perform bitmap caching.
17271         */
17272        Canvas mCanvas;
17273
17274        /**
17275         * The view root impl.
17276         */
17277        final ViewRootImpl mViewRootImpl;
17278
17279        /**
17280         * A Handler supplied by a view's {@link android.view.ViewRootImpl}. This
17281         * handler can be used to pump events in the UI events queue.
17282         */
17283        final Handler mHandler;
17284
17285        /**
17286         * Temporary for use in computing invalidate rectangles while
17287         * calling up the hierarchy.
17288         */
17289        final Rect mTmpInvalRect = new Rect();
17290
17291        /**
17292         * Temporary for use in computing hit areas with transformed views
17293         */
17294        final RectF mTmpTransformRect = new RectF();
17295
17296        /**
17297         * Temporary list for use in collecting focusable descendents of a view.
17298         */
17299        final ArrayList<View> mTempArrayList = new ArrayList<View>(24);
17300
17301        /**
17302         * The id of the window for accessibility purposes.
17303         */
17304        int mAccessibilityWindowId = View.NO_ID;
17305
17306        /**
17307         * Whether to ingore not exposed for accessibility Views when
17308         * reporting the view tree to accessibility services.
17309         */
17310        boolean mIncludeNotImportantViews;
17311
17312        /**
17313         * The drawable for highlighting accessibility focus.
17314         */
17315        Drawable mAccessibilityFocusDrawable;
17316
17317        /**
17318         * Show where the margins, bounds and layout bounds are for each view.
17319         */
17320        boolean mDebugLayout = SystemProperties.getBoolean(DEBUG_LAYOUT_PROPERTY, false);
17321
17322        /**
17323         * Point used to compute visible regions.
17324         */
17325        final Point mPoint = new Point();
17326
17327        /**
17328         * Creates a new set of attachment information with the specified
17329         * events handler and thread.
17330         *
17331         * @param handler the events handler the view must use
17332         */
17333        AttachInfo(IWindowSession session, IWindow window,
17334                ViewRootImpl viewRootImpl, Handler handler, Callbacks effectPlayer) {
17335            mSession = session;
17336            mWindow = window;
17337            mWindowToken = window.asBinder();
17338            mViewRootImpl = viewRootImpl;
17339            mHandler = handler;
17340            mRootCallbacks = effectPlayer;
17341        }
17342    }
17343
17344    /**
17345     * <p>ScrollabilityCache holds various fields used by a View when scrolling
17346     * is supported. This avoids keeping too many unused fields in most
17347     * instances of View.</p>
17348     */
17349    private static class ScrollabilityCache implements Runnable {
17350
17351        /**
17352         * Scrollbars are not visible
17353         */
17354        public static final int OFF = 0;
17355
17356        /**
17357         * Scrollbars are visible
17358         */
17359        public static final int ON = 1;
17360
17361        /**
17362         * Scrollbars are fading away
17363         */
17364        public static final int FADING = 2;
17365
17366        public boolean fadeScrollBars;
17367
17368        public int fadingEdgeLength;
17369        public int scrollBarDefaultDelayBeforeFade;
17370        public int scrollBarFadeDuration;
17371
17372        public int scrollBarSize;
17373        public ScrollBarDrawable scrollBar;
17374        public float[] interpolatorValues;
17375        public View host;
17376
17377        public final Paint paint;
17378        public final Matrix matrix;
17379        public Shader shader;
17380
17381        public final Interpolator scrollBarInterpolator = new Interpolator(1, 2);
17382
17383        private static final float[] OPAQUE = { 255 };
17384        private static final float[] TRANSPARENT = { 0.0f };
17385
17386        /**
17387         * When fading should start. This time moves into the future every time
17388         * a new scroll happens. Measured based on SystemClock.uptimeMillis()
17389         */
17390        public long fadeStartTime;
17391
17392
17393        /**
17394         * The current state of the scrollbars: ON, OFF, or FADING
17395         */
17396        public int state = OFF;
17397
17398        private int mLastColor;
17399
17400        public ScrollabilityCache(ViewConfiguration configuration, View host) {
17401            fadingEdgeLength = configuration.getScaledFadingEdgeLength();
17402            scrollBarSize = configuration.getScaledScrollBarSize();
17403            scrollBarDefaultDelayBeforeFade = ViewConfiguration.getScrollDefaultDelay();
17404            scrollBarFadeDuration = ViewConfiguration.getScrollBarFadeDuration();
17405
17406            paint = new Paint();
17407            matrix = new Matrix();
17408            // use use a height of 1, and then wack the matrix each time we
17409            // actually use it.
17410            shader = new LinearGradient(0, 0, 0, 1, 0xFF000000, 0, Shader.TileMode.CLAMP);
17411
17412            paint.setShader(shader);
17413            paint.setXfermode(new PorterDuffXfermode(PorterDuff.Mode.DST_OUT));
17414            this.host = host;
17415        }
17416
17417        public void setFadeColor(int color) {
17418            if (color != 0 && color != mLastColor) {
17419                mLastColor = color;
17420                color |= 0xFF000000;
17421
17422                shader = new LinearGradient(0, 0, 0, 1, color | 0xFF000000,
17423                        color & 0x00FFFFFF, Shader.TileMode.CLAMP);
17424
17425                paint.setShader(shader);
17426                // Restore the default transfer mode (src_over)
17427                paint.setXfermode(null);
17428            }
17429        }
17430
17431        public void run() {
17432            long now = AnimationUtils.currentAnimationTimeMillis();
17433            if (now >= fadeStartTime) {
17434
17435                // the animation fades the scrollbars out by changing
17436                // the opacity (alpha) from fully opaque to fully
17437                // transparent
17438                int nextFrame = (int) now;
17439                int framesCount = 0;
17440
17441                Interpolator interpolator = scrollBarInterpolator;
17442
17443                // Start opaque
17444                interpolator.setKeyFrame(framesCount++, nextFrame, OPAQUE);
17445
17446                // End transparent
17447                nextFrame += scrollBarFadeDuration;
17448                interpolator.setKeyFrame(framesCount, nextFrame, TRANSPARENT);
17449
17450                state = FADING;
17451
17452                // Kick off the fade animation
17453                host.invalidate(true);
17454            }
17455        }
17456    }
17457
17458    /**
17459     * Resuable callback for sending
17460     * {@link AccessibilityEvent#TYPE_VIEW_SCROLLED} accessibility event.
17461     */
17462    private class SendViewScrolledAccessibilityEvent implements Runnable {
17463        public volatile boolean mIsPending;
17464
17465        public void run() {
17466            sendAccessibilityEvent(AccessibilityEvent.TYPE_VIEW_SCROLLED);
17467            mIsPending = false;
17468        }
17469    }
17470
17471    /**
17472     * <p>
17473     * This class represents a delegate that can be registered in a {@link View}
17474     * to enhance accessibility support via composition rather via inheritance.
17475     * It is specifically targeted to widget developers that extend basic View
17476     * classes i.e. classes in package android.view, that would like their
17477     * applications to be backwards compatible.
17478     * </p>
17479     * <div class="special reference">
17480     * <h3>Developer Guides</h3>
17481     * <p>For more information about making applications accessible, read the
17482     * <a href="{@docRoot}guide/topics/ui/accessibility/index.html">Accessibility</a>
17483     * developer guide.</p>
17484     * </div>
17485     * <p>
17486     * A scenario in which a developer would like to use an accessibility delegate
17487     * is overriding a method introduced in a later API version then the minimal API
17488     * version supported by the application. For example, the method
17489     * {@link View#onInitializeAccessibilityNodeInfo(AccessibilityNodeInfo)} is not available
17490     * in API version 4 when the accessibility APIs were first introduced. If a
17491     * developer would like his application to run on API version 4 devices (assuming
17492     * all other APIs used by the application are version 4 or lower) and take advantage
17493     * of this method, instead of overriding the method which would break the application's
17494     * backwards compatibility, he can override the corresponding method in this
17495     * delegate and register the delegate in the target View if the API version of
17496     * the system is high enough i.e. the API version is same or higher to the API
17497     * version that introduced
17498     * {@link View#onInitializeAccessibilityNodeInfo(AccessibilityNodeInfo)}.
17499     * </p>
17500     * <p>
17501     * Here is an example implementation:
17502     * </p>
17503     * <code><pre><p>
17504     * if (Build.VERSION.SDK_INT >= 14) {
17505     *     // If the API version is equal of higher than the version in
17506     *     // which onInitializeAccessibilityNodeInfo was introduced we
17507     *     // register a delegate with a customized implementation.
17508     *     View view = findViewById(R.id.view_id);
17509     *     view.setAccessibilityDelegate(new AccessibilityDelegate() {
17510     *         public void onInitializeAccessibilityNodeInfo(View host,
17511     *                 AccessibilityNodeInfo info) {
17512     *             // Let the default implementation populate the info.
17513     *             super.onInitializeAccessibilityNodeInfo(host, info);
17514     *             // Set some other information.
17515     *             info.setEnabled(host.isEnabled());
17516     *         }
17517     *     });
17518     * }
17519     * </code></pre></p>
17520     * <p>
17521     * This delegate contains methods that correspond to the accessibility methods
17522     * in View. If a delegate has been specified the implementation in View hands
17523     * off handling to the corresponding method in this delegate. The default
17524     * implementation the delegate methods behaves exactly as the corresponding
17525     * method in View for the case of no accessibility delegate been set. Hence,
17526     * to customize the behavior of a View method, clients can override only the
17527     * corresponding delegate method without altering the behavior of the rest
17528     * accessibility related methods of the host view.
17529     * </p>
17530     */
17531    public static class AccessibilityDelegate {
17532
17533        /**
17534         * Sends an accessibility event of the given type. If accessibility is not
17535         * enabled this method has no effect.
17536         * <p>
17537         * The default implementation behaves as {@link View#sendAccessibilityEvent(int)
17538         *  View#sendAccessibilityEvent(int)} for the case of no accessibility delegate
17539         * been set.
17540         * </p>
17541         *
17542         * @param host The View hosting the delegate.
17543         * @param eventType The type of the event to send.
17544         *
17545         * @see View#sendAccessibilityEvent(int) View#sendAccessibilityEvent(int)
17546         */
17547        public void sendAccessibilityEvent(View host, int eventType) {
17548            host.sendAccessibilityEventInternal(eventType);
17549        }
17550
17551        /**
17552         * Performs the specified accessibility action on the view. For
17553         * possible accessibility actions look at {@link AccessibilityNodeInfo}.
17554         * <p>
17555         * The default implementation behaves as
17556         * {@link View#performAccessibilityAction(int, Bundle)
17557         *  View#performAccessibilityAction(int, Bundle)} for the case of
17558         *  no accessibility delegate been set.
17559         * </p>
17560         *
17561         * @param action The action to perform.
17562         * @return Whether the action was performed.
17563         *
17564         * @see View#performAccessibilityAction(int, Bundle)
17565         *      View#performAccessibilityAction(int, Bundle)
17566         */
17567        public boolean performAccessibilityAction(View host, int action, Bundle args) {
17568            return host.performAccessibilityActionInternal(action, args);
17569        }
17570
17571        /**
17572         * Sends an accessibility event. This method behaves exactly as
17573         * {@link #sendAccessibilityEvent(View, int)} but takes as an argument an
17574         * empty {@link AccessibilityEvent} and does not perform a check whether
17575         * accessibility is enabled.
17576         * <p>
17577         * The default implementation behaves as
17578         * {@link View#sendAccessibilityEventUnchecked(AccessibilityEvent)
17579         *  View#sendAccessibilityEventUnchecked(AccessibilityEvent)} for
17580         * the case of no accessibility delegate been set.
17581         * </p>
17582         *
17583         * @param host The View hosting the delegate.
17584         * @param event The event to send.
17585         *
17586         * @see View#sendAccessibilityEventUnchecked(AccessibilityEvent)
17587         *      View#sendAccessibilityEventUnchecked(AccessibilityEvent)
17588         */
17589        public void sendAccessibilityEventUnchecked(View host, AccessibilityEvent event) {
17590            host.sendAccessibilityEventUncheckedInternal(event);
17591        }
17592
17593        /**
17594         * Dispatches an {@link AccessibilityEvent} to the host {@link View} first and then
17595         * to its children for adding their text content to the event.
17596         * <p>
17597         * The default implementation behaves as
17598         * {@link View#dispatchPopulateAccessibilityEvent(AccessibilityEvent)
17599         *  View#dispatchPopulateAccessibilityEvent(AccessibilityEvent)} for
17600         * the case of no accessibility delegate been set.
17601         * </p>
17602         *
17603         * @param host The View hosting the delegate.
17604         * @param event The event.
17605         * @return True if the event population was completed.
17606         *
17607         * @see View#dispatchPopulateAccessibilityEvent(AccessibilityEvent)
17608         *      View#dispatchPopulateAccessibilityEvent(AccessibilityEvent)
17609         */
17610        public boolean dispatchPopulateAccessibilityEvent(View host, AccessibilityEvent event) {
17611            return host.dispatchPopulateAccessibilityEventInternal(event);
17612        }
17613
17614        /**
17615         * Gives a chance to the host View to populate the accessibility event with its
17616         * text content.
17617         * <p>
17618         * The default implementation behaves as
17619         * {@link View#onPopulateAccessibilityEvent(AccessibilityEvent)
17620         *  View#onPopulateAccessibilityEvent(AccessibilityEvent)} for
17621         * the case of no accessibility delegate been set.
17622         * </p>
17623         *
17624         * @param host The View hosting the delegate.
17625         * @param event The accessibility event which to populate.
17626         *
17627         * @see View#onPopulateAccessibilityEvent(AccessibilityEvent)
17628         *      View#onPopulateAccessibilityEvent(AccessibilityEvent)
17629         */
17630        public void onPopulateAccessibilityEvent(View host, AccessibilityEvent event) {
17631            host.onPopulateAccessibilityEventInternal(event);
17632        }
17633
17634        /**
17635         * Initializes an {@link AccessibilityEvent} with information about the
17636         * the host View which is the event source.
17637         * <p>
17638         * The default implementation behaves as
17639         * {@link View#onInitializeAccessibilityEvent(AccessibilityEvent)
17640         *  View#onInitializeAccessibilityEvent(AccessibilityEvent)} for
17641         * the case of no accessibility delegate been set.
17642         * </p>
17643         *
17644         * @param host The View hosting the delegate.
17645         * @param event The event to initialize.
17646         *
17647         * @see View#onInitializeAccessibilityEvent(AccessibilityEvent)
17648         *      View#onInitializeAccessibilityEvent(AccessibilityEvent)
17649         */
17650        public void onInitializeAccessibilityEvent(View host, AccessibilityEvent event) {
17651            host.onInitializeAccessibilityEventInternal(event);
17652        }
17653
17654        /**
17655         * Initializes an {@link AccessibilityNodeInfo} with information about the host view.
17656         * <p>
17657         * The default implementation behaves as
17658         * {@link View#onInitializeAccessibilityNodeInfo(AccessibilityNodeInfo)
17659         *  View#onInitializeAccessibilityNodeInfo(AccessibilityNodeInfo)} for
17660         * the case of no accessibility delegate been set.
17661         * </p>
17662         *
17663         * @param host The View hosting the delegate.
17664         * @param info The instance to initialize.
17665         *
17666         * @see View#onInitializeAccessibilityNodeInfo(AccessibilityNodeInfo)
17667         *      View#onInitializeAccessibilityNodeInfo(AccessibilityNodeInfo)
17668         */
17669        public void onInitializeAccessibilityNodeInfo(View host, AccessibilityNodeInfo info) {
17670            host.onInitializeAccessibilityNodeInfoInternal(info);
17671        }
17672
17673        /**
17674         * Called when a child of the host View has requested sending an
17675         * {@link AccessibilityEvent} and gives an opportunity to the parent (the host)
17676         * to augment the event.
17677         * <p>
17678         * The default implementation behaves as
17679         * {@link ViewGroup#onRequestSendAccessibilityEvent(View, AccessibilityEvent)
17680         *  ViewGroup#onRequestSendAccessibilityEvent(View, AccessibilityEvent)} for
17681         * the case of no accessibility delegate been set.
17682         * </p>
17683         *
17684         * @param host The View hosting the delegate.
17685         * @param child The child which requests sending the event.
17686         * @param event The event to be sent.
17687         * @return True if the event should be sent
17688         *
17689         * @see ViewGroup#onRequestSendAccessibilityEvent(View, AccessibilityEvent)
17690         *      ViewGroup#onRequestSendAccessibilityEvent(View, AccessibilityEvent)
17691         */
17692        public boolean onRequestSendAccessibilityEvent(ViewGroup host, View child,
17693                AccessibilityEvent event) {
17694            return host.onRequestSendAccessibilityEventInternal(child, event);
17695        }
17696
17697        /**
17698         * Gets the provider for managing a virtual view hierarchy rooted at this View
17699         * and reported to {@link android.accessibilityservice.AccessibilityService}s
17700         * that explore the window content.
17701         * <p>
17702         * The default implementation behaves as
17703         * {@link View#getAccessibilityNodeProvider() View#getAccessibilityNodeProvider()} for
17704         * the case of no accessibility delegate been set.
17705         * </p>
17706         *
17707         * @return The provider.
17708         *
17709         * @see AccessibilityNodeProvider
17710         */
17711        public AccessibilityNodeProvider getAccessibilityNodeProvider(View host) {
17712            return null;
17713        }
17714    }
17715}
17716