| java.lang.Object | |
| ↳ | android.view.View |
Known Direct Subclasses
|
Known Indirect Subclasses
|
This class represents the basic building block for user interface components. A View
occupies a rectangular area on the screen and is responsible for drawing and
event handling. View is the base class for widgets, which are
used to create interactive UI components (buttons, text fields, etc.). The
ViewGroup subclass is the base class for layouts, which
are invisible containers that hold other Views (or other ViewGroups) and define
their layout properties.
For information about using this class to develop your application's user interface, read the User Interface developer guide.
All of the views in a window are arranged in a single tree. You can add views either from code or by specifying a tree of views in one or more XML layout files. There are many specialized subclasses of views that act as controls or are capable of displaying text, images, or other content.
Once you have created a tree of views, there are typically a few types of common operations you may wish to perform:
TextView. The available properties and the methods
that set them will vary among the different subclasses of views. Note that
properties that are known at build time can be set in the XML layout
files.requestFocus().setOnFocusChangeListener(android.view.View.OnFocusChangeListener).
Other view subclasses offer more specialized listeners. For example, a Button
exposes a listener to notify clients when the button is clicked.setVisibility(int).
Note: The Android framework is responsible for measuring, laying out and
drawing views. You should not call methods that perform these actions on
views yourself unless you are actually implementing a
ViewGroup.
To implement a custom view, you will usually begin by providing overrides for
some of the standard methods that the framework calls on all views. You do
not need to override all of these methods. In fact, you can start by just
overriding onDraw(android.graphics.Canvas).
| Category | Methods | Description |
|---|---|---|
| Creation | Constructors | There is a form of the constructor that are called when the view is created from code and a form that is called when the view is inflated from a layout file. The second form should parse and apply any attributes defined in the layout file. |
|
Called after a view and all of its children has been inflated from XML. | |
| Layout | |
Called to determine the size requirements for this view and all of its children. |
|
Called when this view should assign a size and position to all of its children. | |
|
Called when the size of this view has changed. | |
| Drawing | |
Called when the view should render its content. |
| Event processing | |
Called when a new key event occurs. |
|
Called when a key up event occurs. | |
|
Called when a trackball motion event occurs. | |
|
Called when a touch screen motion event occurs. | |
| Focus | |
Called when the view gains or loses focus. |
|
Called when the window containing the view gains or loses focus. | |
| Attaching | |
Called when the view is attached to a window. |
|
Called when the view is detached from its window. | |
|
Called when the visibility of the window containing the view has changed. |
<Button
android:id="@+id/my_button"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="@string/my_button_text"/>
Button myButton = (Button) findViewById(R.id.my_button);
View IDs need not be unique throughout the tree, but it is good practice to ensure that they are at least unique within the part of the tree you are searching.
The geometry of a view is that of a rectangle. A view has a location, expressed as a pair of left and top coordinates, and two dimensions, expressed as a width and a height. The unit for location and dimensions is the pixel.
It is possible to retrieve the location of a view by invoking the methods
getLeft() and getTop(). The former returns the left, or X,
coordinate of the rectangle representing the view. The latter returns the
top, or Y, coordinate of the rectangle representing the view. These methods
both return the location of the view relative to its parent. For instance,
when getLeft() returns 20, that means the view is located 20 pixels to the
right of the left edge of its direct parent.
In addition, several convenience methods are offered to avoid unnecessary
computations, namely getRight() and getBottom().
These methods return the coordinates of the right and bottom edges of the
rectangle representing the view. For instance, calling getRight()
is similar to the following computation: getLeft() + getWidth()
(see Size for more information about the width.)
The size of a view is expressed with a width and a height. A view actually possess two pairs of width and height values.
The first pair is known as measured width and
measured height. These dimensions define how big a view wants to be
within its parent (see Layout for more details.) The
measured dimensions can be obtained by calling getMeasuredWidth()
and getMeasuredHeight().
The second pair is simply known as width and height, or
sometimes drawing width and drawing height. These
dimensions define the actual size of the view on screen, at drawing time and
after layout. These values may, but do not have to, be different from the
measured width and height. The width and height can be obtained by calling
getWidth() and getHeight().
To measure its dimensions, a view takes into account its padding. The padding
is expressed in pixels for the left, top, right and bottom parts of the view.
Padding can be used to offset the content of the view by a specific amount of
pixels. For instance, a left padding of 2 will push the view's content by
2 pixels to the right of the left edge. Padding can be set using the
setPadding(int, int, int, int) method and queried by calling
getPaddingLeft(), getPaddingTop(),
getPaddingRight(), getPaddingBottom().
Even though a view can define a padding, it does not provide any support for
margins. However, view groups provide such a support. Refer to
ViewGroup and
ViewGroup.MarginLayoutParams for further information.
Layout is a two pass process: a measure pass and a layout pass. The measuring
pass is implemented in measure(int, int) and is a top-down traversal
of the view tree. Each view pushes dimension specifications down the tree
during the recursion. At the end of the measure pass, every view has stored
its measurements. The second pass happens in
layout(int, int, int, int) and is also top-down. During
this pass each parent is responsible for positioning all of its children
using the sizes computed in the measure pass.
When a view's measure() method returns, its getMeasuredWidth() and
getMeasuredHeight() values must be set, along with those for all of
that view's descendants. A view's measured width and measured height values
must respect the constraints imposed by the view's parents. This guarantees
that at the end of the measure pass, all parents accept all of their
children's measurements. A parent view may call measure() more than once on
its children. For example, the parent may measure each child once with
unspecified dimensions to find out how big they want to be, then call
measure() on them again with actual numbers if the sum of all the children's
unconstrained sizes is too big or too small.
The measure pass uses two classes to communicate dimensions. The
View.MeasureSpec class is used by views to tell their parents how they
want to be measured and positioned. The base LayoutParams class just
describes how big the view wants to be for both width and height. For each
dimension, it can specify one of:
MeasureSpecs are used to push requirements down the tree from parent to child. A MeasureSpec can be in one of three modes:
To intiate a layout, call requestLayout(). This method is typically
called by a view on itself when it believes that is can no longer fit within
its current bounds.
Drawing is handled by walking the tree and rendering each view that
intersects the invalid region. Because the tree is traversed in-order,
this means that parents will draw before (i.e., behind) their children, with
siblings drawn in the order they appear in the tree.
If you set a background drawable for a View, then the View will draw it for you
before calling back to its onDraw() method.
Note that the framework will not draw views that are not in the invalid region.
To force a view to draw, call invalidate().
The basic cycle of a view is as follows:
requestLayout().invalidate().requestLayout() or invalidate() were called,
the framework will take care of measuring, laying out, and drawing the tree
as appropriate.Note: The entire view tree is single threaded. You must always be on
the UI thread when calling any method on any view.
If you are doing work on other threads and want to update the state of a view
from that thread, you should use a Handler.
The framework will handle routine focus movement in response to user input.
This includes changing the focus as views are removed or hidden, or as new
views become available. Views indicate their willingness to take focus
through the isFocusable() method. To change whether a view can take
focus, call setFocusable(boolean). When in touch mode (see notes below)
views indicate whether they still would like focus via isFocusableInTouchMode()
and can change this via setFocusableInTouchMode(boolean).
Focus movement is based on an algorithm which finds the nearest neighbor in a given direction. In rare cases, the default algorithm may not match the intended behavior of the developer. In these situations, you can provide explicit overrides by using these XML attributes in the layout file:
nextFocusDown nextFocusLeft nextFocusRight nextFocusUp
To get a particular view to take focus, call requestFocus().
When a user is navigating a user interface via directional keys such as a D-pad, it is necessary to give focus to actionable items such as buttons so the user can see what will take input. If the device has touch capabilities, however, and the user begins interacting with the interface by touching it, it is no longer necessary to always highlight, or give focus to, a particular view. This motivates a mode for interaction named 'touch mode'.
For a touch capable device, once the user touches the screen, the device
will enter touch mode. From this point onward, only views for which
isFocusableInTouchMode() is true will be focusable, such as text editing widgets.
Other views that are touchable, like buttons, will not take focus when touched; they will
only fire the on click listeners.
Any time a user hits a directional key, such as a D-pad direction, the view device will exit touch mode, and find a view to take focus, so that the user may resume interacting with the user interface without touching the screen again.
The touch mode state is maintained across Activitys. Call
isInTouchMode() to see whether the device is currently in touch mode.
The framework provides basic support for views that wish to internally
scroll their content. This includes keeping track of the X and Y scroll
offset as well as mechanisms for drawing scrollbars. See
scrollBy(int, int), scrollTo(int, int), and
awakenScrollBars() for more details.
Unlike IDs, tags are not used to identify views. Tags are essentially an extra piece of information that can be associated with a view. They are most often used as a convenience to store data related to views in the views themselves rather than by putting them in a separate structure.
You can attach an Animation object to a view using
setAnimation(Animation) or
startAnimation(Animation). The animation can alter the scale,
rotation, translation and alpha of a view over time. If the animation is
attached to a view that has children, the animation will affect the entire
subtree rooted by that node. When an animation is started, the framework will
take care of redrawing the appropriate views until the animation completes.
Starting with Android 3.0, the preferred way of animating views is to use the
android.animation package APIs.
Sometimes it is essential that an application be able to verify that an action is being performed with the full knowledge and consent of the user, such as granting a permission request, making a purchase or clicking on an advertisement. Unfortunately, a malicious application could try to spoof the user into performing these actions, unaware, by concealing the intended purpose of the view. As a remedy, the framework offers a touch filtering mechanism that can be used to improve the security of views that provide access to sensitive functionality.
To enable touch filtering, call setFilterTouchesWhenObscured(boolean) or set the
android:filterTouchesWhenObscured layout attribute to true. When enabled, the framework
will discard touches that are received whenever the view's window is obscured by
another visible window. As a result, the view will not receive touches whenever a
toast, dialog or other window appears above the view's window.
For more fine-grained control over security, consider overriding the
onFilterTouchEventForSecurity(MotionEvent) method to implement your own
security policy. See also FLAG_WINDOW_IS_OBSCURED.
| Nested Classes | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| View.AccessibilityDelegate |
This class represents a delegate that can be registered in a |
||||||||||
| View.BaseSavedState | Base class for derived classes that want to save and restore their own
state in onSaveInstanceState(). |
||||||||||
| View.DragShadowBuilder | Creates an image that the system displays during the drag and drop operation. | ||||||||||
| View.MeasureSpec | A MeasureSpec encapsulates the layout requirements passed from parent to child. | ||||||||||
| View.OnAttachStateChangeListener | Interface definition for a callback to be invoked when this view is attached or detached from its window. | ||||||||||
| View.OnClickListener | Interface definition for a callback to be invoked when a view is clicked. | ||||||||||
| View.OnCreateContextMenuListener | Interface definition for a callback to be invoked when the context menu for this view is being built. | ||||||||||
| View.OnDragListener | Interface definition for a callback to be invoked when a drag is being dispatched to this view. | ||||||||||
| View.OnFocusChangeListener | Interface definition for a callback to be invoked when the focus state of a view changed. | ||||||||||
| View.OnGenericMotionListener | Interface definition for a callback to be invoked when a generic motion event is dispatched to this view. | ||||||||||
| View.OnHoverListener | Interface definition for a callback to be invoked when a hover event is dispatched to this view. | ||||||||||
| View.OnKeyListener | Interface definition for a callback to be invoked when a key event is dispatched to this view. | ||||||||||
| View.OnLayoutChangeListener | Interface definition for a callback to be invoked when the layout bounds of a view changes due to layout processing. | ||||||||||
| View.OnLongClickListener | Interface definition for a callback to be invoked when a view has been clicked and held. | ||||||||||
| View.OnSystemUiVisibilityChangeListener | Interface definition for a callback to be invoked when the status bar changes visibility. | ||||||||||
| View.OnTouchListener | Interface definition for a callback to be invoked when a touch event is dispatched to this view. | ||||||||||
| XML Attributes | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| android:alpha | setAlpha(float) | alpha property of the view, as a value between 0 (completely transparent) and 1 (completely opaque). | |||||||||
| android:background | setBackgroundResource(int) | A drawable to use as the background. | |||||||||
| android:clickable | setClickable(boolean) | Defines whether this view reacts to click events. | |||||||||
| android:contentDescription | setContentDescription(CharSequence) | Defines text that briefly describes content of the view. | |||||||||
| android:drawingCacheQuality | setDrawingCacheQuality(int) | Defines the quality of translucent drawing caches. | |||||||||
| android:duplicateParentState | When this attribute is set to true, the view gets its drawable state (focused, pressed, etc.) from its direct parent rather than from itself. | ||||||||||
| android:fadingEdgeLength | getVerticalFadingEdgeLength() | Defines the length of the fading edges. | |||||||||
| android:filterTouchesWhenObscured | setFilterTouchesWhenObscured(boolean) | Specifies whether to filter touches when the view's window is obscured by another visible window. | |||||||||
| android:fitsSystemWindows | setFitsSystemWindows(boolean) | Boolean internal attribute to adjust view layout based on system windows such as the status bar. | |||||||||
| android:focusable | setFocusable(boolean) | Boolean that controls whether a view can take focus. | |||||||||
| android:focusableInTouchMode | setFocusableInTouchMode(boolean) | Boolean that controls whether a view can take focus while in touch mode. | |||||||||
| android:hapticFeedbackEnabled | setHapticFeedbackEnabled(boolean) | Boolean that controls whether a view should have haptic feedback enabled for events such as long presses. | |||||||||
| android:id | setId(int) | Supply an identifier name for this view, to later retrieve it
with View.findViewById() or
Activity.findViewById(). |
|||||||||
| android:isScrollContainer | Set this if the view will serve as a scrolling container, meaing that it can be resized to shrink its overall window so that there will be space for an input method. | ||||||||||
| android:keepScreenOn | setKeepScreenOn(boolean) | Controls whether the view's window should keep the screen on while visible. | |||||||||
| android:layerType | setLayerType(int,Paint) | Specifies the type of layer backing this view. | |||||||||
| android:longClickable | setLongClickable(boolean) | Defines whether this view reacts to long click events. | |||||||||
| android:minHeight | Defines the minimum height of the view. | ||||||||||
| android:minWidth | Defines the minimum width of the view. | ||||||||||
| android:nextFocusDown | setNextFocusDownId(int) | Defines the next view to give focus to when the next focus is
FOCUS_DOWN
If the reference refers to a view that does not exist or is part
of a hierarchy that is invisible, a RuntimeException
will result when the reference is accessed. |
|||||||||
| android:nextFocusForward | setNextFocusForwardId(int) | Defines the next view to give focus to when the next focus is
FOCUS_FORWARD
If the reference refers to a view that does not exist or is part
of a hierarchy that is invisible, a RuntimeException
will result when the reference is accessed. |
|||||||||
| android:nextFocusLeft | setNextFocusLeftId(int) | Defines the next view to give focus to when the next focus is
FOCUS_LEFT. |
|||||||||
| android:nextFocusRight | setNextFocusRightId(int) | Defines the next view to give focus to when the next focus is
FOCUS_RIGHT
If the reference refers to a view that does not exist or is part
of a hierarchy that is invisible, a RuntimeException
will result when the reference is accessed. |
|||||||||
| android:nextFocusUp | setNextFocusUpId(int) | Defines the next view to give focus to when the next focus is
FOCUS_UP
If the reference refers to a view that does not exist or is part
of a hierarchy that is invisible, a RuntimeException
will result when the reference is accessed. |
|||||||||
| android:onClick | Name of the method in this View's context to invoke when the view is clicked. | ||||||||||
| android:padding | setPadding(int,int,int,int) | Sets the padding, in pixels, of all four edges. | |||||||||
| android:paddingBottom | setPadding(int,int,int,int) | Sets the padding, in pixels, of the bottom edge; see padding. |
|||||||||
| android:paddingLeft | setPadding(int,int,int,int) | Sets the padding, in pixels, of the left edge; see padding. |
|||||||||
| android:paddingRight | setPadding(int,int,int,int) | Sets the padding, in pixels, of the right edge; see padding. |
|||||||||
| android:paddingTop | setPadding(int,int,int,int) | Sets the padding, in pixels, of the top edge; see padding. |
|||||||||
| android:requiresFadingEdge | setVerticalFadingEdgeEnabled(boolean) | Defines which edges should be faded on scrolling. | |||||||||
| android:rotation | setRotation(float) | rotation of the view, in degrees. | |||||||||
| android:rotationX | setRotationX(float) | rotation of the view around the x axis, in degrees. | |||||||||
| android:rotationY | setRotationY(float) | rotation of the view around the y axis, in degrees. | |||||||||
| android:saveEnabled | setSaveEnabled(boolean) | If unset, no state will be saved for this view when it is being frozen. | |||||||||
| android:scaleX | setScaleX(float) | scale of the view in the x direction. | |||||||||
| android:scaleY | setScaleY(float) | scale of the view in the y direction. | |||||||||
| android:scrollX | The initial horizontal scroll offset, in pixels. | ||||||||||
| android:scrollY | The initial vertical scroll offset, in pixels. | ||||||||||
| android:scrollbarAlwaysDrawHorizontalTrack | Defines whether the horizontal scrollbar track should always be drawn. | ||||||||||
| android:scrollbarAlwaysDrawVerticalTrack | Defines whether the vertical scrollbar track should always be drawn. | ||||||||||
| android:scrollbarDefaultDelayBeforeFade | Defines the delay in milliseconds that a scrollbar waits before fade out. | ||||||||||
| android:scrollbarFadeDuration | Defines the delay in milliseconds that a scrollbar takes to fade out. | ||||||||||
| android:scrollbarSize | Sets the width of vertical scrollbars and height of horizontal scrollbars. | ||||||||||
| android:scrollbarStyle | Controls the scrollbar style and position. | ||||||||||
| android:scrollbarThumbHorizontal | Defines the horizontal scrollbar thumb drawable. | ||||||||||
| android:scrollbarThumbVertical | Defines the vertical scrollbar thumb drawable. | ||||||||||
| android:scrollbarTrackHorizontal | Defines the horizontal scrollbar track drawable. | ||||||||||
| android:scrollbarTrackVertical | Defines the vertical scrollbar track drawable. | ||||||||||
| android:scrollbars | Defines which scrollbars should be displayed on scrolling or not. | ||||||||||
| android:soundEffectsEnabled | setSoundEffectsEnabled(boolean) | Boolean that controls whether a view should have sound effects enabled for events such as clicking and touching. | |||||||||
| android:tag | Supply a tag for this view containing a String, to be retrieved
later with View.getTag() or
searched for with View.findViewWithTag(). |
||||||||||
| android:transformPivotX | setPivotX(float) | x location of the pivot point around which the view will rotate and scale. | |||||||||
| android:transformPivotY | setPivotY(float) | y location of the pivot point around which the view will rotate and scale. | |||||||||
| android:translationX | setTranslationX(float) | translation in x of the view. | |||||||||
| android:translationY | setTranslationY(float) | translation in y of the view. | |||||||||
| android:visibility | setVisibility(int) | Controls the initial visibility of the view. | |||||||||
| Constants | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| int | DRAWING_CACHE_QUALITY_AUTO | Enables automatic quality mode for the drawing cache. |
|||||||||
| int | DRAWING_CACHE_QUALITY_HIGH | Enables high quality mode for the drawing cache. |
|||||||||
| int | DRAWING_CACHE_QUALITY_LOW | Enables low quality mode for the drawing cache. |
|||||||||
| int | FIND_VIEWS_WITH_CONTENT_DESCRIPTION | Find find views that contain the specified content description. | |||||||||
| int | FIND_VIEWS_WITH_TEXT | Find views that render the specified text. | |||||||||
| int | FOCUSABLES_ALL | View flag indicating whether addFocusables(ArrayList, int, int)
should add all focusable Views regardless if they are focusable in touch mode. |
|||||||||
| int | FOCUSABLES_TOUCH_MODE | View flag indicating whether addFocusables(ArrayList, int, int)
should add only Views focusable in touch mode. |
|||||||||
| int | FOCUS_BACKWARD | Use with focusSearch(int). |
|||||||||
| int | FOCUS_DOWN | Use with focusSearch(int). |
|||||||||
| int | FOCUS_FORWARD | Use with focusSearch(int). |
|||||||||
| int | FOCUS_LEFT | Use with focusSearch(int). |
|||||||||
| int | FOCUS_RIGHT | Use with focusSearch(int). |
|||||||||
| int | FOCUS_UP | Use with focusSearch(int). |
|||||||||
| int | GONE | This view is invisible, and it doesn't take any space for layout purposes. | |||||||||
| int | HAPTIC_FEEDBACK_ENABLED | View flag indicating whether this view should have haptic feedback enabled for events such as long presses. | |||||||||
| int | INVISIBLE | This view is invisible, but it still takes up space for layout purposes. | |||||||||
| int | KEEP_SCREEN_ON | View flag indicating that the screen should remain on while the window containing this view is visible to the user. | |||||||||
| int | LAYER_TYPE_HARDWARE | Indicates that the view has a hardware layer. |
|||||||||
| int | LAYER_TYPE_NONE | Indicates that the view does not have a layer. | |||||||||
| int | LAYER_TYPE_SOFTWARE | Indicates that the view has a software layer. |
|||||||||
| int | MEASURED_HEIGHT_STATE_SHIFT | Bit shift of MEASURED_STATE_MASK to get to the height bits
for functions that combine both width and height into a single int,
such as getMeasuredState() and the childState argument of
resolveSizeAndState(int, int, int). |
|||||||||
| int | MEASURED_SIZE_MASK | Bits of getMeasuredWidthAndState() and
getMeasuredWidthAndState() that provide the actual measured size. |
|||||||||
| int | MEASURED_STATE_MASK | Bits of getMeasuredWidthAndState() and
getMeasuredWidthAndState() that provide the additional state bits. |
|||||||||
| int | MEASURED_STATE_TOO_SMALL | Bit of getMeasuredWidthAndState() and
getMeasuredWidthAndState() that indicates the measured size
is smaller that the space the view would like to have. |
|||||||||
| int | NO_ID | Used to mark a View that has no ID. | |||||||||
| int | OVER_SCROLL_ALWAYS | Always allow a user to over-scroll this view, provided it is a view that can scroll. | |||||||||
| int | OVER_SCROLL_IF_CONTENT_SCROLLS | Allow a user to over-scroll this view only if the content is large enough to meaningfully scroll, provided it is a view that can scroll. | |||||||||
| int | OVER_SCROLL_NEVER | Never allow a user to over-scroll this view. | |||||||||
| int | SCROLLBARS_INSIDE_INSET | The scrollbar style to display the scrollbars inside the padded area, increasing the padding of the view. | |||||||||
| int | SCROLLBARS_INSIDE_OVERLAY | The scrollbar style to display the scrollbars inside the content area, without increasing the padding. | |||||||||
| int | SCROLLBARS_OUTSIDE_INSET | The scrollbar style to display the scrollbars at the edge of the view, increasing the padding of the view. | |||||||||
| int | SCROLLBARS_OUTSIDE_OVERLAY | The scrollbar style to display the scrollbars at the edge of the view, without increasing the padding. | |||||||||
| int | SCROLLBAR_POSITION_DEFAULT | Position the scroll bar at the default position as determined by the system. | |||||||||
| int | SCROLLBAR_POSITION_LEFT | Position the scroll bar along the left edge. | |||||||||
| int | SCROLLBAR_POSITION_RIGHT | Position the scroll bar along the right edge. | |||||||||
| int | SOUND_EFFECTS_ENABLED | View flag indicating whether this view should have sound effects enabled for events such as clicking and touching. | |||||||||
| int | STATUS_BAR_HIDDEN |
This constant is deprecated.
Use SYSTEM_UI_FLAG_LOW_PROFILE instead.
|
|||||||||
| int | STATUS_BAR_VISIBLE |
This constant is deprecated.
Use SYSTEM_UI_FLAG_VISIBLE instead.
|
|||||||||
| int | SYSTEM_UI_FLAG_HIDE_NAVIGATION | View has requested that the system navigation be temporarily hidden. | |||||||||
| int | SYSTEM_UI_FLAG_LOW_PROFILE | View has requested the system UI to enter an unobtrusive "low profile" mode. | |||||||||
| int | SYSTEM_UI_FLAG_VISIBLE | View has requested the system UI (status bar) to be visible (the default). | |||||||||
| String | VIEW_LOG_TAG | The logging tag used by this class with android.util.Log. | |||||||||
| int | VISIBLE | This view is visible. | |||||||||
| Fields | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| ALPHA | A Property wrapper around the alpha functionality handled by the
setAlpha(float) and getAlpha() methods. |
||||||||||
| EMPTY_STATE_SET | Indicates the view has no states set. | ||||||||||
| ENABLED_FOCUSED_SELECTED_STATE_SET | Indicates the view is enabled, focused and selected. | ||||||||||
| ENABLED_FOCUSED_SELECTED_WINDOW_FOCUSED_STATE_SET | Indicates the view is enabled, focused, selected and its window has the focus. | ||||||||||
| ENABLED_FOCUSED_STATE_SET | Indicates the view is enabled and has the focus. | ||||||||||
| ENABLED_FOCUSED_WINDOW_FOCUSED_STATE_SET | Indicates the view is enabled, focused and its window has the focus. | ||||||||||
| ENABLED_SELECTED_STATE_SET | Indicates the view is enabled and selected. | ||||||||||
| ENABLED_SELECTED_WINDOW_FOCUSED_STATE_SET | Indicates the view is enabled, selected and its window has the focus. | ||||||||||
| ENABLED_STATE_SET | Indicates the view is enabled. | ||||||||||
| ENABLED_WINDOW_FOCUSED_STATE_SET | Indicates the view is enabled and that its window has focus. | ||||||||||
| FOCUSED_SELECTED_STATE_SET | Indicates the view is focused and selected. | ||||||||||
| FOCUSED_SELECTED_WINDOW_FOCUSED_STATE_SET | Indicates the view is focused, selected and its window has the focus. | ||||||||||
| FOCUSED_STATE_SET | Indicates the view is focused. | ||||||||||
| FOCUSED_WINDOW_FOCUSED_STATE_SET | Indicates the view has the focus and that its window has the focus. | ||||||||||
| PRESSED_ENABLED_FOCUSED_SELECTED_STATE_SET | Indicates the view is pressed, enabled, focused and selected. | ||||||||||
| PRESSED_ENABLED_FOCUSED_SELECTED_WINDOW_FOCUSED_STATE_SET | Indicates the view is pressed, enabled, focused, selected and its window has the focus. | ||||||||||
| PRESSED_ENABLED_FOCUSED_STATE_SET | Indicates the view is pressed, enabled and focused. | ||||||||||
| PRESSED_ENABLED_FOCUSED_WINDOW_FOCUSED_STATE_SET | Indicates the view is pressed, enabled, focused and its window has the focus. | ||||||||||
| PRESSED_ENABLED_SELECTED_STATE_SET | Indicates the view is pressed, enabled and selected. | ||||||||||
| PRESSED_ENABLED_SELECTED_WINDOW_FOCUSED_STATE_SET | Indicates the view is pressed, enabled, selected and its window has the focus. | ||||||||||
| PRESSED_ENABLED_STATE_SET | Indicates the view is pressed and enabled. | ||||||||||
| PRESSED_ENABLED_WINDOW_FOCUSED_STATE_SET | Indicates the view is pressed, enabled and its window has the focus. | ||||||||||
| PRESSED_FOCUSED_SELECTED_STATE_SET | Indicates the view is pressed, focused and selected. | ||||||||||
| PRESSED_FOCUSED_SELECTED_WINDOW_FOCUSED_STATE_SET | Indicates the view is pressed, focused, selected and its window has the focus. | ||||||||||
| PRESSED_FOCUSED_STATE_SET | Indicates the view is pressed and focused. | ||||||||||
| PRESSED_FOCUSED_WINDOW_FOCUSED_STATE_SET | Indicates the view is pressed, focused and its window has the focus. | ||||||||||
| PRESSED_SELECTED_STATE_SET | Indicates the view is pressed and selected. | ||||||||||
| PRESSED_SELECTED_WINDOW_FOCUSED_STATE_SET | Indicates the view is pressed, selected and its window has the focus. | ||||||||||
| PRESSED_WINDOW_FOCUSED_STATE_SET | Indicates the view is pressed and its window has the focus. | ||||||||||
| ROTATION | A Property wrapper around the rotation functionality handled by the
setRotation(float) and getRotation() methods. |
||||||||||
| ROTATION_X | A Property wrapper around the rotationX functionality handled by the
setRotationX(float) and getRotationX() methods. |
||||||||||
| ROTATION_Y | A Property wrapper around the rotationY functionality handled by the
setRotationY(float) and getRotationY() methods. |
||||||||||
| SCALE_X | A Property wrapper around the scaleX functionality handled by the
setScaleX(float) and getScaleX() methods. |
||||||||||
| SCALE_Y | A Property wrapper around the scaleY functionality handled by the
setScaleY(float) and getScaleY() methods. |
||||||||||
| SELECTED_STATE_SET | Indicates the view is selected. | ||||||||||
| SELECTED_WINDOW_FOCUSED_STATE_SET | Indicates the view is selected and that its window has the focus. | ||||||||||
| TRANSLATION_X | A Property wrapper around the translationX functionality handled by the
setTranslationX(float) and getTranslationX() methods. |
||||||||||
| TRANSLATION_Y | A Property wrapper around the translationY functionality handled by the
setTranslationY(float) and getTranslationY() methods. |
||||||||||
| WINDOW_FOCUSED_STATE_SET | Indicates the view's window has focus. | ||||||||||
| X | A Property wrapper around the x functionality handled by the
setX(float) and getX() methods. |
||||||||||
| Y | A Property wrapper around the y functionality handled by the
setY(float) and getY() methods. |
||||||||||
| Public Constructors | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
Simple constructor to use when creating a view from code.
| |||||||||||
Constructor that is called when inflating a view from XML.
| |||||||||||
Perform inflation from XML and apply a class-specific base style.
| |||||||||||
| Public Methods | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
Add any focusable views that are descendants of this view (possibly
including this view if it is focusable itself) to views.
| |||||||||||
Adds any focusable views that are descendants of this view (possibly
including this view if it is focusable itself) to views.
| |||||||||||
Add a listener for attach state changes.
| |||||||||||
Add a listener that will be called when the bounds of the view change due to
layout processing.
| |||||||||||
Add any touchable views that are descendants of this view (possibly
including this view if it is touchable itself) to views.
| |||||||||||
This method returns a ViewPropertyAnimator object, which can be used to animate
specific properties on this View.
| |||||||||||
Change the view's z order in the tree, so it's on top of other sibling
views
| |||||||||||
Forces the drawing cache to be built if the drawing cache is invalid. | |||||||||||
Calling this method is equivalent to calling | |||||||||||
Forces this view's layer to be created and this view to be rendered
into its layer.
| |||||||||||
Directly call any attached OnClickListener.
| |||||||||||
Check if this view can be scrolled horizontally in a certain direction.
| |||||||||||
Check if this view can be scrolled vertically in a certain direction.
| |||||||||||
Cancels a pending long press.
| |||||||||||
Called by the
InputMethodManager
when a view who is not the current
input connection target is trying to make a call on the manager. | |||||||||||
Cancels any animations for this view.
| |||||||||||
Called when this view wants to give up focus.
| |||||||||||
Merge two states as returned by
getMeasuredState(). | |||||||||||
Called by a parent to request that a child update its values for mScrollX
and mScrollY if necessary.
| |||||||||||
Returns an
AccessibilityNodeInfo representing this view from the
point of view of an AccessibilityService. | |||||||||||
Show the context menu for this view.
| |||||||||||
Frees the resources used by the drawing cache. | |||||||||||
Dispatch a notification about a resource configuration change down
the view hierarchy.
| |||||||||||
Dispatch a hint about whether this view is displayed.
| |||||||||||
Detects if this View is enabled and has a drag event listener.
| |||||||||||
Dispatch a generic motion event.
| |||||||||||
Dispatch a key event to the next view on the focus path.
| |||||||||||
Dispatch a key event before it is processed by any input method
associated with the view hierarchy.
| |||||||||||
Dispatches a key shortcut event.
| |||||||||||
Dispatches an
AccessibilityEvent to the View first and then
to its children for adding their text content to the event. | |||||||||||
Dispatch callbacks to
setOnSystemUiVisibilityChangeListener(View.OnSystemUiVisibilityChangeListener) down
the view hierarchy. | |||||||||||
Pass the touch screen motion event down to the target view, or this
view if it is the target.
| |||||||||||
Pass a trackball motion event down to the focused view.
| |||||||||||
This method is the last chance for the focused view and its ancestors to
respond to an arrow key.
| |||||||||||
Called when the window containing this view gains or loses window focus.
| |||||||||||
Dispatch a window visibility change down the view hierarchy.
| |||||||||||
Manually render this view (and all of its children) to the given Canvas.
| |||||||||||
Find the view in the hierarchy rooted at this view that currently has
focus.
| |||||||||||
Look for a child view with the given id.
| |||||||||||
Look for a child view with the given tag.
| |||||||||||
Finds the Views that contain given text.
| |||||||||||
Check for the FITS_SYSTEM_WINDOWS flag.
| |||||||||||
Find the nearest view in the specified direction that can take focus.
| |||||||||||
Forces this view to be laid out during the next layout pass.
| |||||||||||
The opacity of the view.
| |||||||||||
Get the animation currently associated with this view.
| |||||||||||
Retrieve a unique token identifying the top-level "real" window of
the window that this view is attached to.
| |||||||||||
Gets the background drawable
| |||||||||||
Return the offset of the widget's text baseline from the widget's top boundary. | |||||||||||
Bottom position of this view relative to its parent.
| |||||||||||
Gets the
View description. | |||||||||||
Returns the context the view is running in, through which it can
access the current theme, resources, etc.
| |||||||||||
Utility to return a default size.
| |||||||||||
Return an array of resource IDs of the drawable states representing the
current state of the view.
| |||||||||||
Returns the bitmap in which this view drawing is cached. | |||||||||||
Calling this method is equivalent to calling | |||||||||||
Returns the quality of the drawing cache.
| |||||||||||
Return the visible drawing bounds of your view.
| |||||||||||
Return the time at which the drawing of the view hierarchy started. | |||||||||||
Gets whether the framework should discard touches when the view's
window is obscured by another visible window.
| |||||||||||
Find and return all focusable views that are descendants of this view,
possibly including this view if it is focusable itself.
| |||||||||||
When a view has focus and the user navigates away from it, the next view is searched for
starting from the rectangle filled in by this method.
| |||||||||||
If some part of this view is not clipped by any of its parents, then
return that area in r in global (root) coordinates.
| |||||||||||
Return the height of your view.
| |||||||||||
Hit rectangle in parent's coordinates
| |||||||||||
Returns the size of the horizontal faded edges used to indicate that more
content in this view is visible.
| |||||||||||
Returns this view's identifier.
| |||||||||||
Returns whether the screen should remain on, corresponding to the current
value of
KEEP_SCREEN_ON. | |||||||||||
Return the global
KeyEvent.DispatcherState
for this view's window. | |||||||||||
Indicates what type of layer is currently associated with this view.
| |||||||||||
Get the LayoutParams associated with this view.
| |||||||||||
Left position of this view relative to its parent.
| |||||||||||
Computes the coordinates of this view in its window. | |||||||||||
Computes the coordinates of this view on the screen. | |||||||||||
The transform matrix of this view, which is calculated based on the current
roation, scale, and pivot properties.
| |||||||||||
Like
getMeasuredHeightAndState(), but only returns the
raw width component (that is the result is masked by
MEASURED_SIZE_MASK). | |||||||||||
Return the full height measurement information for this view as computed
by the most recent call to
measure(int, int). | |||||||||||
Return only the state bits of
getMeasuredWidthAndState()
and getMeasuredHeightAndState(), combined into one integer. | |||||||||||
Like
getMeasuredWidthAndState(), but only returns the
raw width component (that is the result is masked by
MEASURED_SIZE_MASK). | |||||||||||
Return the full width measurement information for this view as computed
by the most recent call to
measure(int, int). | |||||||||||
Gets the id of the view to use when the next focus is
FOCUS_DOWN. | |||||||||||
Gets the id of the view to use when the next focus is
FOCUS_FORWARD. | |||||||||||
Gets the id of the view to use when the next focus is
FOCUS_LEFT. | |||||||||||
Gets the id of the view to use when the next focus is
FOCUS_RIGHT. | |||||||||||
Gets the id of the view to use when the next focus is
FOCUS_UP. | |||||||||||
Returns the focus-change callback registered for this view.
| |||||||||||
Returns the over-scroll mode for this view.
| |||||||||||
Returns the bottom padding of this view.
| |||||||||||
Returns the left padding of this view.
| |||||||||||
Returns the right padding of this view.
| |||||||||||
Returns the top padding of this view.
| |||||||||||
Gets the parent of this view.
| |||||||||||
A Drawable can call this to get the resolved layout direction of the who.
| |||||||||||
Returns the resources associated with this view.
| |||||||||||
Right position of this view relative to its parent.
| |||||||||||
Finds the topmost view in the current view hierarchy. | |||||||||||
The degrees that the view is rotated around the pivot point.
| |||||||||||
The degrees that the view is rotated around the horizontal axis through the pivot point.
| |||||||||||
The degrees that the view is rotated around the vertical axis through the pivot point.
| |||||||||||
The amount that the view is scaled in x around the pivot point, as a proportion of
the view's unscaled width.
| |||||||||||
The amount that the view is scaled in y around the pivot point, as a proportion of
the view's unscaled height.
| |||||||||||
Returns the current scrollbar style. | |||||||||||
Return the scrolled left position of this view.
| |||||||||||
Return the scrolled top position of this view.
| |||||||||||
Override this if your view is known to always be drawn on top of a solid color background,
and needs to draw fading edges.
| |||||||||||
Returns the status bar visibility that this view has requested.
| |||||||||||
Returns the tag associated with this view and the specified key.
| |||||||||||
Returns this view's tag.
| |||||||||||
Top position of this view relative to its parent.
| |||||||||||
Gets the TouchDelegate for this View.
| |||||||||||
Find and return all touchable views that are descendants of this view,
possibly including this view if it is touchable itself.
| |||||||||||
The horizontal location of this view relative to its
left position. | |||||||||||
The horizontal location of this view relative to its
top position. | |||||||||||
Returns the size of the vertical faded edges used to indicate that more
content in this view is visible.
| |||||||||||
Returns the width of the vertical scrollbar.
| |||||||||||
Returns the ViewTreeObserver for this view's hierarchy.
| |||||||||||
Returns the visibility status for this view.
| |||||||||||
Return the width of the your view.
| |||||||||||
Retrieve a unique token identifying the window this view is attached to.
| |||||||||||
Retrieve the overall visible display size in which the window this view is
attached to has been positioned in.
| |||||||||||
The visual x position of this view, in pixels.
| |||||||||||
The visual y position of this view, in pixels.
| |||||||||||
Returns true if this view has focus iteself, or is the ancestor of the
view that has focus.
| |||||||||||
Returns true if this view is focusable or if it contains a reachable View
for which
hasFocusable() returns true. | |||||||||||
Return whether this view has an attached OnClickListener.
| |||||||||||
Returns true if this view is in a window that currently has window focus.
| |||||||||||
Inflate a view from an XML resource.
| |||||||||||
Mark the area defined by dirty as needing to be drawn.
| |||||||||||
Mark the area defined by the rect (l,t,r,b) as needing to be drawn.
| |||||||||||
Invalidate the whole view.
| |||||||||||
Invalidates the specified Drawable.
| |||||||||||
Indicates the activation state of this view.
| |||||||||||
Indicates whether this view reacts to click events or not.
| |||||||||||
True if this view has changed since the last time being drawn.
| |||||||||||
Indicates whether the drawing cache is enabled for this view. | |||||||||||
Indicates whether this duplicates its drawable state from its parent. | |||||||||||
Returns the enabled status for this view.
| |||||||||||
Returns whether this View is able to take focus.
| |||||||||||
When a view is focusable, it may not want to take focus when in touch mode.
| |||||||||||
Returns true if this view has focus
| |||||||||||
Indicates whether this view is attached to an hardware accelerated window or not. | |||||||||||
Indicate whether the horizontal edges are faded when the view is scrolled horizontally. | |||||||||||
Indicate whether the horizontal scrollbar should be drawn or not. | |||||||||||
Returns true if the view is currently hovered.
| |||||||||||
Indicates whether this View is currently in edit mode.
| |||||||||||
Returns whether the device is currently in touch mode.
| |||||||||||
Indicates whether or not this view's layout will be requested during the next hierarchy layout pass. | |||||||||||
Indicates whether this view reacts to long click events or not.
| |||||||||||
Indicates whether this View is opaque.
| |||||||||||
Indicates whether the view is currently in pressed state.
| |||||||||||
Indicates whether this view will save its state (that is,
whether its
onSaveInstanceState() method will be called). | |||||||||||
Indicates whether the entire hierarchy under this view will save its
state when a state saving traversal occurs from its parent.
| |||||||||||
Returns true if scrollbars will fade when this view is not scrolling
| |||||||||||
Indicates the selection state of this view.
| |||||||||||
Returns the visibility of this view and all of its ancestors
| |||||||||||
Indicate whether the vertical edges are faded when the view is scrolled horizontally. | |||||||||||
Indicate whether the vertical scrollbar should be drawn or not. | |||||||||||
Call
Drawable.jumpToCurrentState()
on all Drawable objects associated with this view. | |||||||||||
Assign a size and position to a view and all of its
descendants
This is the second phase of the layout mechanism. | |||||||||||
This is called to find out how big a view should be. | |||||||||||
Offset this view's horizontal location by the specified amount of pixels.
| |||||||||||
Offset this view's vertical location by the specified number of pixels.
| |||||||||||
Check whether the called view is a text editor, in which case it
would make sense to automatically display a soft input window for
it.
| |||||||||||
Create a new InputConnection for an InputMethod to interact
with the view.
| |||||||||||
Handles drag events sent by the system following a call to
startDrag(). | |||||||||||
Filter the touch event to apply security policies.
| |||||||||||
Called after
onStartTemporaryDetach() when the container is done
changing the view. | |||||||||||
Implement this method to handle generic motion events.
| |||||||||||
Implement this method to handle hover state changes.
| |||||||||||
Implement this method to handle hover events.
| |||||||||||
Initializes an
AccessibilityEvent with information about
this View which is the event source. | |||||||||||
Initializes an
AccessibilityNodeInfo with information about this view. | |||||||||||
Default implementation of
KeyEvent.Callback.onKeyDown(): perform press of the view
when KEYCODE_DPAD_CENTER or KEYCODE_ENTER
is released, if the view is enabled and clickable. | |||||||||||
Default implementation of
KeyEvent.Callback.onKeyLongPress(): always returns false (doesn't handle
the event). | |||||||||||
Default implementation of
KeyEvent.Callback.onKeyMultiple(): always returns false (doesn't handle
the event). | |||||||||||
Handle a key event before it is processed by any input method
associated with the view hierarchy.
| |||||||||||
Called on the focused view when a key shortcut event is not handled.
| |||||||||||
Default implementation of
KeyEvent.Callback.onKeyUp(): perform clicking of the view
when KEYCODE_DPAD_CENTER or
KEYCODE_ENTER is released. | |||||||||||
Called from
dispatchPopulateAccessibilityEvent(AccessibilityEvent)
giving a chance to this View to populate the accessibility event with its
text content. | |||||||||||
This is called when a container is going to temporarily detach a child, with
ViewGroup.detachViewFromParent. | |||||||||||
Implement this method to handle touch screen motion events.
| |||||||||||
Implement this method to handle trackball motion events.
| |||||||||||
Called when the window containing this view gains or loses focus.
| |||||||||||
Call this view's OnClickListener, if it is defined.
| |||||||||||
BZZZTT!!1!
Like | |||||||||||
BZZZTT!!1!
Provide haptic feedback to the user for this view. | |||||||||||
Call this view's OnLongClickListener, if it is defined.
| |||||||||||
Play a sound effect for this view.
| |||||||||||
Causes the Runnable to be added to the message queue. | |||||||||||
Causes the Runnable to be added to the message queue, to be run after the specified amount of time elapses. | |||||||||||
Cause an invalidate of the specified area to happen on a subsequent cycle through the event loop. | |||||||||||
Cause an invalidate to happen on a subsequent cycle through the event loop. | |||||||||||
Cause an invalidate of the specified area to happen on a subsequent cycle through the event loop. | |||||||||||
Cause an invalidate to happen on a subsequent cycle through the event loop. | |||||||||||
Call this to force a view to update its drawable state.
| |||||||||||
Removes the specified Runnable from the message queue. | |||||||||||
Remove a listener for attach state changes.
| |||||||||||
Remove a listener for layout changes.
| |||||||||||
Call this to try to give focus to a specific view or to one of its descendants
and give it hints about the direction and a specific rectangle that the focus
is coming from.
| |||||||||||
Call this to try to give focus to a specific view or to one of its
descendants and give it a hint about what direction focus is heading.
| |||||||||||
Call this to try to give focus to a specific view or to one of its
descendants.
| |||||||||||
Call this to try to give focus to a specific view or to one of its descendants.
| |||||||||||
Call this when something has changed which has invalidated the
layout of this view.
| |||||||||||
Request that a rectangle of this view be visible on the screen,
scrolling if necessary just enough.
| |||||||||||
Request that a rectangle of this view be visible on the screen,
scrolling if necessary just enough.
| |||||||||||
Version of
resolveSizeAndState(int, int, int)
returning only the MEASURED_SIZE_MASK bits of the result. | |||||||||||
Utility to reconcile a desired size and state, with constraints imposed
by a MeasureSpec.
| |||||||||||
Restore this view hierarchy's frozen state from the given container.
| |||||||||||
Store this view hierarchy's frozen state into the given container.
| |||||||||||
Schedules an action on a drawable to occur at a specified time.
| |||||||||||
Move the scrolled position of your view.
| |||||||||||
Set the scrolled position of your view.
| |||||||||||
Sends an accessibility event of the given type.
| |||||||||||
This method behaves exactly as
sendAccessibilityEvent(int) but
takes as an argument an empty AccessibilityEvent and does not
perform a check whether accessibility is enabled. | |||||||||||
Sets a delegate for implementing accessibility support via compositon as
opposed to inheritance.
| |||||||||||
Changes the activated state of this view.
| |||||||||||
Sets the opacity of the view. | |||||||||||
Sets the next animation to play for this view.
| |||||||||||
Sets the background color for this view.
| |||||||||||
Set the background to a given Drawable, or remove the background.
| |||||||||||
Set the background to a given resource.
| |||||||||||
Sets the bottom position of this view relative to its parent.
| |||||||||||
Sets the distance along the Z axis (orthogonal to the X/Y plane on which views are drawn) from the camera to this view. | |||||||||||
Enables or disables click events for this view.
| |||||||||||
Sets the
View description. | |||||||||||
Setting a solid background color for the drawing cache's bitmaps will improve
performance and memory usage.
| |||||||||||
Enables or disables the drawing cache. | |||||||||||
Set the drawing cache quality of this view.
| |||||||||||
Enables or disables the duplication of the parent's state into this view. | |||||||||||
Set the enabled state of this view.
| |||||||||||
Set the size of the faded edge used to indicate that more content in this
view is available.
| |||||||||||
Sets whether the framework should discard touches when the view's
window is obscured by another visible window.
| |||||||||||
Set whether or not this view should account for system screen decorations
such as the status bar and inset its content.
| |||||||||||
Set whether this view can receive the focus.
| |||||||||||
Set whether this view can receive focus while in touch mode.
| |||||||||||
Set whether this view should have haptic feedback for events such as
long presses.
| |||||||||||
Define whether the horizontal edges should be faded when this view is scrolled horizontally. | |||||||||||
Define whether the horizontal scrollbar should be drawn or not. | |||||||||||
Sets whether the view is currently hovered.
| |||||||||||
Sets the identifier for this view.
| |||||||||||
Controls whether the screen should remain on, modifying the
value of
KEEP_SCREEN_ON. | |||||||||||
Specifies the type of layer backing this view. | |||||||||||
Set the layout parameters associated with this view.
| |||||||||||
Sets the left position of this view relative to its parent.
| |||||||||||
Enables or disables long click events for this view.
| |||||||||||
Sets the minimum height of the view.
| |||||||||||
Sets the minimum width of the view.
| |||||||||||
Sets the id of the view to use when the next focus is
FOCUS_DOWN. | |||||||||||
Sets the id of the view to use when the next focus is
FOCUS_FORWARD. | |||||||||||
Sets the id of the view to use when the next focus is
FOCUS_LEFT. | |||||||||||
Sets the id of the view to use when the next focus is
FOCUS_RIGHT. | |||||||||||
Sets the id of the view to use when the next focus is
FOCUS_UP. | |||||||||||
Register a callback to be invoked when this view is clicked.
| |||||||||||
Register a callback to be invoked when the context menu for this view is
being built.
| |||||||||||
Register a drag event listener callback object for this View.
| |||||||||||
Register a callback to be invoked when focus of this view changed.
| |||||||||||
Register a callback to be invoked when a generic motion event is sent to this view.
| |||||||||||
Register a callback to be invoked when a hover event is sent to this view.
| |||||||||||
Register a callback to be invoked when a key is pressed in this view.
| |||||||||||
Register a callback to be invoked when this view is clicked and held.
| |||||||||||
Set a listener to receive callbacks when the visibility of the system bar changes.
| |||||||||||
Register a callback to be invoked when a touch event is sent to this view.
| |||||||||||
Set the over-scroll mode for this view.
| |||||||||||
Sets the padding.
| |||||||||||
Sets the pressed state for this view.
| |||||||||||
Sets the right position of this view relative to its parent.
| |||||||||||
Sets the degrees that the view is rotated around the pivot point.
| |||||||||||
Sets the degrees that the view is rotated around the horizontal axis through the pivot point.
| |||||||||||
Sets the degrees that the view is rotated around the vertical axis through the pivot point.
| |||||||||||
Controls whether the saving of this view's state is
enabled (that is, whether its
onSaveInstanceState() method
will be called). | |||||||||||
Controls whether the entire hierarchy under this view will save its
state when a state saving traversal occurs from its parent.
| |||||||||||
Sets the amount that the view is scaled in x around the pivot point, as a proportion of
the view's unscaled width.
| |||||||||||
Sets the amount that the view is scaled in Y around the pivot point, as a proportion of
the view's unscaled width.
| |||||||||||
Specify the style of the scrollbars. | |||||||||||
Change whether this view is one of the set of scrollable containers in
its window.
| |||||||||||
Set the horizontal scrolled position of your view.
| |||||||||||
Set the vertical scrolled position of your view.
| |||||||||||
Define whether scrollbars will fade when the view is not scrolling.
| |||||||||||
Changes the selection state of this view.
| |||||||||||
Set whether this view should have sound effects enabled for events such as
clicking and touching.
| |||||||||||
Request that the visibility of the status bar be changed.
| |||||||||||
Sets a tag associated with this view and a key.
| |||||||||||
Sets the tag associated with this view.
| |||||||||||
Sets the top position of this view relative to its parent.
| |||||||||||
Sets the TouchDelegate for this View.
| |||||||||||
Sets the horizontal location of this view relative to its
left position. | |||||||||||
Sets the vertical location of this view relative to its
top position. | |||||||||||
Define whether the vertical edges should be faded when this view is scrolled vertically. | |||||||||||
Define whether the vertical scrollbar should be drawn or not. | |||||||||||
Set the position of the vertical scroll bar.
| |||||||||||
Set the enabled state of this view.
| |||||||||||
When a View's drawing cache is enabled, drawing is redirected to an
offscreen bitmap.
| |||||||||||
If this view doesn't do any drawing on its own, set this flag to
allow further optimizations.
| |||||||||||
Sets the visual x position of this view, in pixels.
| |||||||||||
Sets the visual y position of this view, in pixels.
| |||||||||||
Bring up the context menu for this view.
| |||||||||||
Start an action mode.
| |||||||||||
Start the specified animation now.
| |||||||||||
Starts a drag and drop operation.
| |||||||||||
Unschedule any events associated with the given Drawable.
| |||||||||||
Cancels a scheduled action on a drawable.
| |||||||||||
Returns whether or not this View can cache its drawing or not.
| |||||||||||
Returns whether or not this View draws on its own.
| |||||||||||
| Protected Methods | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
Trigger the scrollbars to draw. | |||||||||||
Trigger the scrollbars to draw. | |||||||||||
Trigger the scrollbars to draw. | |||||||||||
Compute the horizontal extent of the horizontal scrollbar's thumb within the horizontal range. | |||||||||||
Compute the horizontal offset of the horizontal scrollbar's thumb within the horizontal range. | |||||||||||
Compute the horizontal range that the horizontal scrollbar represents. | |||||||||||
Compute the vertical extent of the horizontal scrollbar's thumb within the vertical range. | |||||||||||
Compute the vertical offset of the vertical scrollbar's thumb within the horizontal range. | |||||||||||
Compute the vertical range that the vertical scrollbar represents. | |||||||||||
Called by draw to draw the child views.
| |||||||||||
Dispatch a generic motion event to the currently focused view.
| |||||||||||
Dispatch a generic motion event to the view under the first pointer.
| |||||||||||
Dispatch a hover event.
| |||||||||||
Called by
restoreHierarchyState(android.util.SparseArray) to retrieve the
state for this view and its children. | |||||||||||
Called by
saveHierarchyState(android.util.SparseArray) to store the state for
this view and its children. | |||||||||||
Dispatch setActivated to all of this View's children.
| |||||||||||
Dispatch setPressed to all of this View's children.
| |||||||||||
Dispatch setSelected to all of this View's children.
| |||||||||||
Dispatch a view visibility change down the view hierarchy.
| |||||||||||
This function is called whenever the state of the view changes in such
a way that it impacts the state of drawables being shown.
| |||||||||||
Apply the insets for system windows to this view, if the FITS_SYSTEM_WINDOWS flag
is set
| |||||||||||
Returns the strength, or intensity, of the bottom faded edge.
| |||||||||||
Amount by which to extend the bottom fading region.
| |||||||||||
Views should implement this if they have extra information to associate
with the context menu.
| |||||||||||
Returns the height of the horizontal scrollbar.
| |||||||||||
Returns the strength, or intensity, of the left faded edge.
| |||||||||||
Amount by which to extend the left fading region.
| |||||||||||
Returns the strength, or intensity, of the right faded edge.
| |||||||||||
Amount by which to extend the right fading region.
| |||||||||||
Returns the suggested minimum height that the view should use.
| |||||||||||
Returns the suggested minimum width that the view should use.
| |||||||||||
Returns the strength, or intensity, of the top faded edge.
| |||||||||||
Amount by which to extend the top fading region.
| |||||||||||
Initializes the fading edges from a given set of styled attributes. | |||||||||||
Initializes the scrollbars from a given set of styled attributes. | |||||||||||
If the View draws content inside its padding and enables fading edges,
it needs to support padding offsets.
| |||||||||||
Merge your own state values in additionalState into the base
state values baseState that were returned by
onCreateDrawableState(int). | |||||||||||
Invoked by a parent ViewGroup to notify the end of the animation
currently associated with this view.
| |||||||||||
Invoked by a parent ViewGroup to notify the start of the animation
currently associated with this view.
| |||||||||||
This is called when the view is attached to a window.
| |||||||||||
Called when the current configuration of the resources being used
by the application have changed.
| |||||||||||
Views should implement this if the view itself is going to add items to
the context menu.
| |||||||||||
Generate the new
Drawable state for
this view. | |||||||||||
This is called when the view is detached from a window.
| |||||||||||
Gives this view a hint about whether is displayed or not.
| |||||||||||
Implement this to do your drawing.
| |||||||||||
Request the drawing of the horizontal and the vertical scrollbar. | |||||||||||
Finalize inflating a view from XML.
| |||||||||||
Called by the view system when the focus state of this view changes.
| |||||||||||
Called from layout when this view should
assign a size and position to each of its children.
| |||||||||||
Measure the view and its content to determine the measured width and the measured height. | |||||||||||
Called by
overScrollBy(int, int, int, int, int, int, int, int, boolean) to
respond to the results of an over-scroll operation. | |||||||||||
Hook allowing a view to re-apply a representation of its internal state that had previously
been generated by
onSaveInstanceState(). | |||||||||||
Hook allowing a view to generate a representation of its internal state
that can later be used to create a new instance with that same state.
| |||||||||||
This is called in response to an internal scroll in this view (i.e., the
view scrolled its own contents).
| |||||||||||
Invoked if there is a Transform that involves alpha.
| |||||||||||
This is called during layout when the size of this view has changed.
| |||||||||||
Called when the visibility of the view or an ancestor of the view is changed.
| |||||||||||
Scroll the view with standard behavior for scrolling beyond the normal
content boundaries.
| |||||||||||
This mehod must be called by | |||||||||||
If your view subclass is displaying its own Drawable objects, it should
override this function and return true for any Drawable it is
displaying.
| |||||||||||
|
[Expand]
Inherited Methods | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
From class
java.lang.Object
| |||||||||||
From interface
android.graphics.drawable.Drawable.Callback
| |||||||||||
From interface
android.view.KeyEvent.Callback
| |||||||||||
From interface
android.view.accessibility.AccessibilityEventSource
| |||||||||||
alpha property of the view, as a value between 0 (completely transparent) and 1 (completely opaque).
Must be a floating point value, such as "1.2".
This may also be a reference to a resource (in the form
"@[package:]type:name") or
theme attribute (in the form
"?[package:][type:]name")
containing a value of this type.
This corresponds to the global attribute resource symbol alpha.
A drawable to use as the background. This can be either a reference to a full drawable resource (such as a PNG image, 9-patch, XML state list description, etc), or a solid color such as "#ff000000" (black).
May be a reference to another resource, in the form "@[+][package:]type:name"
or to a theme attribute in the form "?[package:][type:]name".
May be a color value, in the form of "#rgb", "#argb",
"#rrggbb", or "#aarrggbb".
This corresponds to the global attribute resource symbol background.
Defines whether this view reacts to click events.
Must be a boolean value, either "true" or "false".
This may also be a reference to a resource (in the form
"@[package:]type:name") or
theme attribute (in the form
"?[package:][type:]name")
containing a value of this type.
This corresponds to the global attribute resource symbol clickable.
Defines text that briefly describes content of the view. This property is used primarily for accessibility. Since some views do not have textual representation this attribute can be used for providing such.
Must be a string value, using '\\;' to escape characters such as '\\n' or '\\uxxxx' for a unicode character.
This may also be a reference to a resource (in the form
"@[package:]type:name") or
theme attribute (in the form
"?[package:][type:]name")
containing a value of this type.
This corresponds to the global attribute resource symbol contentDescription.
Defines the quality of translucent drawing caches. This property is used only when the drawing cache is enabled and translucent. The default value is auto.
Must be one of the following constant values.
| Constant | Value | Description |
|---|---|---|
auto | 0 | Lets the framework decide what quality level should be used for the drawing cache. |
low | 1 | Low quality. When set to low quality, the drawing cache uses a lower color depth, thus losing precision in rendering gradients, but uses less memory. |
high | 2 | High quality. When set to high quality, the drawing cache uses a higher color depth but uses more memory. |
This corresponds to the global attribute resource symbol drawingCacheQuality.
When this attribute is set to true, the view gets its drawable state (focused, pressed, etc.) from its direct parent rather than from itself.
Must be a boolean value, either "true" or "false".
This may also be a reference to a resource (in the form
"@[package:]type:name") or
theme attribute (in the form
"?[package:][type:]name")
containing a value of this type.
This corresponds to the global attribute resource symbol duplicateParentState.
Defines the length of the fading edges.
Must be a dimension value, which is a floating point number appended with a unit such as "14.5sp".
Available units are: px (pixels), dp (density-independent pixels), sp (scaled pixels based on preferred font size),
in (inches), mm (millimeters).
This may also be a reference to a resource (in the form
"@[package:]type:name") or
theme attribute (in the form
"?[package:][type:]name")
containing a value of this type.
This corresponds to the global attribute resource symbol fadingEdgeLength.
Specifies whether to filter touches when the view's window is obscured by
another visible window. When set to true, the view will not receive touches
whenever a toast, dialog or other window appears above the view's window.
Refer to the View security documentation for more details.
Must be a boolean value, either "true" or "false".
This may also be a reference to a resource (in the form
"@[package:]type:name") or
theme attribute (in the form
"?[package:][type:]name")
containing a value of this type.
This corresponds to the global attribute resource symbol filterTouchesWhenObscured.
Boolean internal attribute to adjust view layout based on system windows such as the status bar. If true, adjusts the padding of this view to leave space for the system windows. Will only take effect if this view is in a non-embedded activity.
Must be a boolean value, either "true" or "false".
This may also be a reference to a resource (in the form
"@[package:]type:name") or
theme attribute (in the form
"?[package:][type:]name")
containing a value of this type.
This corresponds to the global attribute resource symbol fitsSystemWindows.
Boolean that controls whether a view can take focus. By default the user can not
move focus to a view; by setting this attribute to true the view is
allowed to take focus. This value does not impact the behavior of
directly calling requestFocus(), which will
always request focus regardless of this view. It only impacts where
focus navigation will try to move focus.
Must be a boolean value, either "true" or "false".
This may also be a reference to a resource (in the form
"@[package:]type:name") or
theme attribute (in the form
"?[package:][type:]name")
containing a value of this type.
This corresponds to the global attribute resource symbol focusable.
Boolean that controls whether a view can take focus while in touch mode. If this is true for a view, that view can gain focus when clicked on, and can keep focus if another view is clicked on that doesn't have this attribute set to true.
Must be a boolean value, either "true" or "false".
This may also be a reference to a resource (in the form
"@[package:]type:name") or
theme attribute (in the form
"?[package:][type:]name")
containing a value of this type.
This corresponds to the global attribute resource symbol focusableInTouchMode.
Boolean that controls whether a view should have haptic feedback enabled for events such as long presses.
Must be a boolean value, either "true" or "false".
This may also be a reference to a resource (in the form
"@[package:]type:name") or
theme attribute (in the form
"?[package:][type:]name")
containing a value of this type.
This corresponds to the global attribute resource symbol hapticFeedbackEnabled.
Supply an identifier name for this view, to later retrieve it
with View.findViewById() or
Activity.findViewById().
This must be a
resource reference; typically you set this using the
@+ syntax to create a new ID resources.
For example: android:id="@+id/my_id" which
allows you to later retrieve the view
with findViewById(R.id.my_id).
Must be a reference to another resource, in the form "@[+][package:]type:name"
or to a theme attribute in the form "?[package:][type:]name".
This corresponds to the global attribute resource symbol id.
Set this if the view will serve as a scrolling container, meaing that it can be resized to shrink its overall window so that there will be space for an input method. If not set, the default value will be true if "scrollbars" has the vertical scrollbar set, else it will be false.
Must be a boolean value, either "true" or "false".
This may also be a reference to a resource (in the form
"@[package:]type:name") or
theme attribute (in the form
"?[package:][type:]name")
containing a value of this type.
This corresponds to the global attribute resource symbol isScrollContainer.
Controls whether the view's window should keep the screen on while visible.
Must be a boolean value, either "true" or "false".
This may also be a reference to a resource (in the form
"@[package:]type:name") or
theme attribute (in the form
"?[package:][type:]name")
containing a value of this type.
This corresponds to the global attribute resource symbol keepScreenOn.
Specifies the type of layer backing this view. The default value is none.
Refer to setLayerType(int, android.graphics.Paint)
for more information.
Must be one of the following constant values.
| Constant | Value | Description |
|---|---|---|
none | 0 | Don't use a layer. |
software | 1 | Use a software layer. Refer to
for
more information. |
hardware | 2 | Use a hardware layer. Refer to {@link android.view.View#setLayerType(int, android.graphics.Paint) for more information. |
This corresponds to the global attribute resource symbol {@link android.R.attr#layerType.
Defines whether this view reacts to long click events.
Must be a boolean value, either "true" or "false".
This may also be a reference to a resource (in the form
"@[package:]type:name") or
theme attribute (in the form
"?[package:][type:]name")
containing a value of this type.
This corresponds to the global attribute resource symbol longClickable.
Defines the minimum height of the view. It is not guaranteed the view will be able to achieve this minimum height (for example, if its parent layout constrains it with less available height).
Must be a dimension value, which is a floating point number appended with a unit such as "14.5sp".
Available units are: px (pixels), dp (density-independent pixels), sp (scaled pixels based on preferred font size),
in (inches), mm (millimeters).
This may also be a reference to a resource (in the form
"@[package:]type:name") or
theme attribute (in the form
"?[package:][type:]name")
containing a value of this type.
This corresponds to the global attribute resource symbol minHeight.
Defines the minimum width of the view. It is not guaranteed the view will be able to achieve this minimum width (for example, if its parent layout constrains it with less available width).
Must be a dimension value, which is a floating point number appended with a unit such as "14.5sp".
Available units are: px (pixels), dp (density-independent pixels), sp (scaled pixels based on preferred font size),
in (inches), mm (millimeters).
This may also be a reference to a resource (in the form
"@[package:]type:name") or
theme attribute (in the form
"?[package:][type:]name")
containing a value of this type.
This corresponds to the global attribute resource symbol minWidth.
Defines the next view to give focus to when the next focus is
FOCUS_DOWN
If the reference refers to a view that does not exist or is part
of a hierarchy that is invisible, a RuntimeException
will result when the reference is accessed.
Must be a reference to another resource, in the form "@[+][package:]type:name"
or to a theme attribute in the form "?[package:][type:]name".
This corresponds to the global attribute resource symbol nextFocusDown.
Defines the next view to give focus to when the next focus is
FOCUS_FORWARD
If the reference refers to a view that does not exist or is part
of a hierarchy that is invisible, a RuntimeException
will result when the reference is accessed.
Must be a reference to another resource, in the form "@[+][package:]type:name"
or to a theme attribute in the form "?[package:][type:]name".
This corresponds to the global attribute resource symbol nextFocusForward.
Defines the next view to give focus to when the next focus is
FOCUS_LEFT.
If the reference refers to a view that does not exist or is part
of a hierarchy that is invisible, a RuntimeException
will result when the reference is accessed.
Must be a reference to another resource, in the form "@[+][package:]type:name"
or to a theme attribute in the form "?[package:][type:]name".
This corresponds to the global attribute resource symbol nextFocusLeft.
Defines the next view to give focus to when the next focus is
FOCUS_RIGHT
If the reference refers to a view that does not exist or is part
of a hierarchy that is invisible, a RuntimeException
will result when the reference is accessed.
Must be a reference to another resource, in the form "@[+][package:]type:name"
or to a theme attribute in the form "?[package:][type:]name".
This corresponds to the global attribute resource symbol nextFocusRight.
Defines the next view to give focus to when the next focus is
FOCUS_UP
If the reference refers to a view that does not exist or is part
of a hierarchy that is invisible, a RuntimeException
will result when the reference is accessed.
Must be a reference to another resource, in the form "@[+][package:]type:name"
or to a theme attribute in the form "?[package:][type:]name".
This corresponds to the global attribute resource symbol nextFocusUp.
Name of the method in this View's context to invoke when the view is
clicked. This name must correspond to a public method that takes
exactly one parameter of type View. For instance, if you specify
android:onClick="sayHello", you must declare a
public void sayHello(View v) method of your context
(typically, your Activity).
Must be a string value, using '\\;' to escape characters such as '\\n' or '\\uxxxx' for a unicode character.
This may also be a reference to a resource (in the form
"@[package:]type:name") or
theme attribute (in the form
"?[package:][type:]name")
containing a value of this type.
This corresponds to the global attribute resource symbol onClick.
Sets the padding, in pixels, of all four edges. Padding is defined as
space between the edges of the view and the view's content. A views size
will include it's padding. If a background
is provided, the padding will initially be set to that (0 if the
drawable does not have padding). Explicitly setting a padding value
will override the corresponding padding found in the background.
Must be a dimension value, which is a floating point number appended with a unit such as "14.5sp".
Available units are: px (pixels), dp (density-independent pixels), sp (scaled pixels based on preferred font size),
in (inches), mm (millimeters).
This may also be a reference to a resource (in the form
"@[package:]type:name") or
theme attribute (in the form
"?[package:][type:]name")
containing a value of this type.
This corresponds to the global attribute resource symbol padding.
Sets the padding, in pixels, of the bottom edge; see padding.
Must be a dimension value, which is a floating point number appended with a unit such as "14.5sp".
Available units are: px (pixels), dp (density-independent pixels), sp (scaled pixels based on preferred font size),
in (inches), mm (millimeters).
This may also be a reference to a resource (in the form
"@[package:]type:name") or
theme attribute (in the form
"?[package:][type:]name")
containing a value of this type.
This corresponds to the global attribute resource symbol paddingBottom.
Sets the padding, in pixels, of the left edge; see padding.
Must be a dimension value, which is a floating point number appended with a unit such as "14.5sp".
Available units are: px (pixels), dp (density-independent pixels), sp (scaled pixels based on preferred font size),
in (inches), mm (millimeters).
This may also be a reference to a resource (in the form
"@[package:]type:name") or
theme attribute (in the form
"?[package:][type:]name")
containing a value of this type.
This corresponds to the global attribute resource symbol paddingLeft.
Sets the padding, in pixels, of the right edge; see padding.
Must be a dimension value, which is a floating point number appended with a unit such as "14.5sp".
Available units are: px (pixels), dp (density-independent pixels), sp (scaled pixels based on preferred font size),
in (inches), mm (millimeters).
This may also be a reference to a resource (in the form
"@[package:]type:name") or
theme attribute (in the form
"?[package:][type:]name")
containing a value of this type.
This corresponds to the global attribute resource symbol paddingRight.
Sets the padding, in pixels, of the top edge; see padding.
Must be a dimension value, which is a floating point number appended with a unit such as "14.5sp".
Available units are: px (pixels), dp (density-independent pixels), sp (scaled pixels based on preferred font size),
in (inches), mm (millimeters).
This may also be a reference to a resource (in the form
"@[package:]type:name") or
theme attribute (in the form
"?[package:][type:]name")
containing a value of this type.
This corresponds to the global attribute resource symbol paddingTop.
Defines which edges should be faded on scrolling.
Must be one or more (separated by '|') of the following constant values.
| Constant | Value | Description |
|---|---|---|
none | 0x00000000 | No edge is faded. |
horizontal | 0x00001000 | Fades horizontal edges only. |
vertical | 0x00002000 | Fades vertical edges only. |
This corresponds to the global attribute resource symbol requiresFadingEdge.
rotation of the view, in degrees.
Must be a floating point value, such as "1.2".
This may also be a reference to a resource (in the form
"@[package:]type:name") or
theme attribute (in the form
"?[package:][type:]name")
containing a value of this type.
This corresponds to the global attribute resource symbol rotation.
rotation of the view around the x axis, in degrees.
Must be a floating point value, such as "1.2".
This may also be a reference to a resource (in the form
"@[package:]type:name") or
theme attribute (in the form
"?[package:][type:]name")
containing a value of this type.
This corresponds to the global attribute resource symbol rotationX.
rotation of the view around the y axis, in degrees.
Must be a floating point value, such as "1.2".
This may also be a reference to a resource (in the form
"@[package:]type:name") or
theme attribute (in the form
"?[package:][type:]name")
containing a value of this type.
This corresponds to the global attribute resource symbol rotationY.
If unset, no state will be saved for this view when it is being frozen. The default is true, allowing the view to be saved (however it also must have an ID assigned to it for its state to be saved). Setting this to false only disables the state for this view, not for its children which may still be saved.
Must be a boolean value, either "true" or "false".
This may also be a reference to a resource (in the form
"@[package:]type:name") or
theme attribute (in the form
"?[package:][type:]name")
containing a value of this type.
This corresponds to the global attribute resource symbol saveEnabled.
scale of the view in the x direction.
Must be a floating point value, such as "1.2".
This may also be a reference to a resource (in the form
"@[package:]type:name") or
theme attribute (in the form
"?[package:][type:]name")
containing a value of this type.
This corresponds to the global attribute resource symbol scaleX.
scale of the view in the y direction.
Must be a floating point value, such as "1.2".
This may also be a reference to a resource (in the form
"@[package:]type:name") or
theme attribute (in the form
"?[package:][type:]name")
containing a value of this type.
This corresponds to the global attribute resource symbol scaleY.
The initial horizontal scroll offset, in pixels.
Must be a dimension value, which is a floating point number appended with a unit such as "14.5sp".
Available units are: px (pixels), dp (density-independent pixels), sp (scaled pixels based on preferred font size),
in (inches), mm (millimeters).
This may also be a reference to a resource (in the form
"@[package:]type:name") or
theme attribute (in the form
"?[package:][type:]name")
containing a value of this type.
This corresponds to the global attribute resource symbol scrollX.
The initial vertical scroll offset, in pixels.
Must be a dimension value, which is a floating point number appended with a unit such as "14.5sp".
Available units are: px (pixels), dp (density-independent pixels), sp (scaled pixels based on preferred font size),
in (inches), mm (millimeters).
This may also be a reference to a resource (in the form
"@[package:]type:name") or
theme attribute (in the form
"?[package:][type:]name")
containing a value of this type.
This corresponds to the global attribute resource symbol scrollY.
Defines whether the horizontal scrollbar track should always be drawn.
Must be a boolean value, either "true" or "false".
This may also be a reference to a resource (in the form
"@[package:]type:name") or
theme attribute (in the form
"?[package:][type:]name")
containing a value of this type.
This corresponds to the global attribute resource symbol scrollbarAlwaysDrawHorizontalTrack.
Defines whether the vertical scrollbar track should always be drawn.
Must be a boolean value, either "true" or "false".
This may also be a reference to a resource (in the form
"@[package:]type:name") or
theme attribute (in the form
"?[package:][type:]name")
containing a value of this type.
This corresponds to the global attribute resource symbol scrollbarAlwaysDrawVerticalTrack.
Defines the delay in milliseconds that a scrollbar waits before fade out.
Must be an integer value, such as "100".
This may also be a reference to a resource (in the form
"@[package:]type:name") or
theme attribute (in the form
"?[package:][type:]name")
containing a value of this type.
This corresponds to the global attribute resource symbol scrollbarDefaultDelayBeforeFade.
Defines the delay in milliseconds that a scrollbar takes to fade out.
Must be an integer value, such as "100".
This may also be a reference to a resource (in the form
"@[package:]type:name") or
theme attribute (in the form
"?[package:][type:]name")
containing a value of this type.
This corresponds to the global attribute resource symbol scrollbarFadeDuration.
Sets the width of vertical scrollbars and height of horizontal scrollbars.
Must be a dimension value, which is a floating point number appended with a unit such as "14.5sp".
Available units are: px (pixels), dp (density-independent pixels), sp (scaled pixels based on preferred font size),
in (inches), mm (millimeters).
This may also be a reference to a resource (in the form
"@[package:]type:name") or
theme attribute (in the form
"?[package:][type:]name")
containing a value of this type.
This corresponds to the global attribute resource symbol scrollbarSize.
Controls the scrollbar style and position. The scrollbars can be overlaid or inset. When inset, they add to the padding of the view. And the scrollbars can be drawn inside the padding area or on the edge of the view. For example, if a view has a background drawable and you want to draw the scrollbars inside the padding specified by the drawable, you can use insideOverlay or insideInset. If you want them to appear at the edge of the view, ignoring the padding, then you can use outsideOverlay or outsideInset.
Must be one of the following constant values.
| Constant | Value | Description |
|---|---|---|
insideOverlay | 0x0 | Inside the padding and overlaid |
insideInset | 0x01000000 | Inside the padding and inset |
outsideOverlay | 0x02000000 | Edge of the view and overlaid |
outsideInset | 0x03000000 | Edge of the view and inset |
This corresponds to the global attribute resource symbol scrollbarStyle.
Defines the horizontal scrollbar thumb drawable.
Must be a reference to another resource, in the form "@[+][package:]type:name"
or to a theme attribute in the form "?[package:][type:]name".
This corresponds to the global attribute resource symbol scrollbarThumbHorizontal.
Defines the vertical scrollbar thumb drawable.
Must be a reference to another resource, in the form "@[+][package:]type:name"
or to a theme attribute in the form "?[package:][type:]name".
This corresponds to the global attribute resource symbol scrollbarThumbVertical.
Defines the horizontal scrollbar track drawable.
Must be a reference to another resource, in the form "@[+][package:]type:name"
or to a theme attribute in the form "?[package:][type:]name".
This corresponds to the global attribute resource symbol scrollbarTrackHorizontal.
Defines the vertical scrollbar track drawable.
Must be a reference to another resource, in the form "@[+][package:]type:name"
or to a theme attribute in the form "?[package:][type:]name".
This corresponds to the global attribute resource symbol scrollbarTrackVertical.
Defines which scrollbars should be displayed on scrolling or not.
Must be one or more (separated by '|') of the following constant values.
| Constant | Value | Description |
|---|---|---|
none | 0x00000000 | No scrollbar is displayed. |
horizontal | 0x00000100 | Displays horizontal scrollbar only. |
vertical | 0x00000200 | Displays vertical scrollbar only. |
This corresponds to the global attribute resource symbol scrollbars.
Boolean that controls whether a view should have sound effects enabled for events such as clicking and touching.
Must be a boolean value, either "true" or "false".
This may also be a reference to a resource (in the form
"@[package:]type:name") or
theme attribute (in the form
"?[package:][type:]name")
containing a value of this type.
This corresponds to the global attribute resource symbol soundEffectsEnabled.
Supply a tag for this view containing a String, to be retrieved
later with View.getTag() or
searched for with View.findViewWithTag(). It is generally preferable to use
IDs (through the android:id attribute) instead of tags because
they are faster and allow for compile-time type checking.
Must be a string value, using '\\;' to escape characters such as '\\n' or '\\uxxxx' for a unicode character.
This may also be a reference to a resource (in the form
"@[package:]type:name") or
theme attribute (in the form
"?[package:][type:]name")
containing a value of this type.
This corresponds to the global attribute resource symbol tag.
x location of the pivot point around which the view will rotate and scale. This xml attribute sets the pivotX property of the View.
Must be a dimension value, which is a floating point number appended with a unit such as "14.5sp".
Available units are: px (pixels), dp (density-independent pixels), sp (scaled pixels based on preferred font size),
in (inches), mm (millimeters).
This may also be a reference to a resource (in the form
"@[package:]type:name") or
theme attribute (in the form
"?[package:][type:]name")
containing a value of this type.
This corresponds to the global attribute resource symbol transformPivotX.
y location of the pivot point around which the view will rotate and scale. This xml attribute sets the pivotY property of the View.
Must be a dimension value, which is a floating point number appended with a unit such as "14.5sp".
Available units are: px (pixels), dp (density-independent pixels), sp (scaled pixels based on preferred font size),
in (inches), mm (millimeters).
This may also be a reference to a resource (in the form
"@[package:]type:name") or
theme attribute (in the form
"?[package:][type:]name")
containing a value of this type.
This corresponds to the global attribute resource symbol transformPivotY.
translation in x of the view. This value is added post-layout to the left property of the view, which is set by its layout.
Must be a dimension value, which is a floating point number appended with a unit such as "14.5sp".
Available units are: px (pixels), dp (density-independent pixels), sp (scaled pixels based on preferred font size),
in (inches), mm (millimeters).
This may also be a reference to a resource (in the form
"@[package:]type:name") or
theme attribute (in the form
"?[package:][type:]name")
containing a value of this type.
This corresponds to the global attribute resource symbol translationX.
translation in y of the view. This value is added post-layout to the left property of the view, which is set by its layout.
Must be a dimension value, which is a floating point number appended with a unit such as "14.5sp".
Available units are: px (pixels), dp (density-independent pixels), sp (scaled pixels based on preferred font size),
in (inches), mm (millimeters).
This may also be a reference to a resource (in the form
"@[package:]type:name") or
theme attribute (in the form
"?[package:][type:]name")
containing a value of this type.
This corresponds to the global attribute resource symbol translationY.
Controls the initial visibility of the view.
Must be one of the following constant values.
| Constant | Value | Description |
|---|---|---|
visible | 0 | Visible on screen; the default value. |
invisible | 1 | Not displayed, but taken into account during layout (space is left for it). |
gone | 2 | Completely hidden, as if the view had not been added. |
This corresponds to the global attribute resource symbol visibility.
Enables automatic quality mode for the drawing cache.
Enables high quality mode for the drawing cache.
Enables low quality mode for the drawing cache.
Find find views that contain the specified content description.
Find views that render the specified text.
View flag indicating whether addFocusables(ArrayList, int, int)
should add all focusable Views regardless if they are focusable in touch mode.
View flag indicating whether addFocusables(ArrayList, int, int)
should add only Views focusable in touch mode.
Use with focusSearch(int). Move focus to the previous selectable
item.
Use with focusSearch(int). Move focus down.
Use with focusSearch(int). Move focus to the next selectable
item.
Use with focusSearch(int). Move focus to the left.
Use with focusSearch(int). Move focus to the right.
Use with focusSearch(int). Move focus up.
This view is invisible, and it doesn't take any space for layout
purposes. Use with setVisibility(int) and android:visibility.
View flag indicating whether this view should have haptic feedback enabled for events such as long presses.
This view is invisible, but it still takes up space for layout purposes.
Use with setVisibility(int) and android:visibility.
View flag indicating that the screen should remain on while the
window containing this view is visible to the user. This effectively
takes care of automatically setting the WindowManager's
FLAG_KEEP_SCREEN_ON.
Indicates that the view has a hardware layer. A hardware layer is backed
by a hardware specific texture (generally Frame Buffer Objects or FBO on
OpenGL hardware) and causes the view to be rendered using Android's hardware
rendering pipeline, but only if hardware acceleration is turned on for the
view hierarchy. When hardware acceleration is turned off, hardware layers
behave exactly as software layers.
A hardware layer is useful to apply a specific color filter and/or blending mode and/or translucency to a view and all its children.
A hardware layer can be used to cache a complex view tree into a texture and reduce the complexity of drawing operations. For instance, when animating a complex view tree with a translation, a hardware layer can be used to render the view tree only once.
A hardware layer can also be used to increase the rendering quality when rotation transformations are applied on a view. It can also be used to prevent potential clipping issues when applying 3D transforms on a view.
Indicates that the view does not have a layer.
Indicates that the view has a software layer. A software layer is backed by a bitmap and causes the view to be rendered using Android's software rendering pipeline, even if hardware acceleration is enabled.
Software layers have various usages:
When the application is not using hardware acceleration, a software layer is useful to apply a specific color filter and/or blending mode and/or translucency to a view and all its children.
When the application is using hardware acceleration, a software layer is useful to render drawing primitives not supported by the hardware accelerated pipeline. It can also be used to cache a complex view tree into a texture and reduce the complexity of drawing operations. For instance, when animating a complex view tree with a translation, a software layer can be used to render the view tree only once.
Software layers should be avoided when the affected view tree updates often. Every update will require to re-render the software layer, which can potentially be slow (particularly when hardware acceleration is turned on since the layer will have to be uploaded into a hardware texture after every update.)
Bit shift of MEASURED_STATE_MASK to get to the height bits
for functions that combine both width and height into a single int,
such as getMeasuredState() and the childState argument of
resolveSizeAndState(int, int, int).
Bits of getMeasuredWidthAndState() and
getMeasuredWidthAndState() that provide the actual measured size.
Bits of getMeasuredWidthAndState() and
getMeasuredWidthAndState() that provide the additional state bits.
Bit of getMeasuredWidthAndState() and
getMeasuredWidthAndState() that indicates the measured size
is smaller that the space the view would like to have.
Used to mark a View that has no ID.
Always allow a user to over-scroll this view, provided it is a view that can scroll.
Allow a user to over-scroll this view only if the content is large enough to meaningfully scroll, provided it is a view that can scroll.
Never allow a user to over-scroll this view.
The scrollbar style to display the scrollbars inside the padded area, increasing the padding of the view. The scrollbars will not overlap the content area of the view.
The scrollbar style to display the scrollbars inside the content area, without increasing the padding. The scrollbars will be overlaid with translucency on the view's content.
The scrollbar style to display the scrollbars at the edge of the view, increasing the padding of the view. The scrollbars will only overlap the background, if any.
The scrollbar style to display the scrollbars at the edge of the view, without increasing the padding. The scrollbars will be overlaid with translucency.
Position the scroll bar at the default position as determined by the system.
Position the scroll bar along the left edge.
Position the scroll bar along the right edge.
View flag indicating whether this view should have sound effects enabled for events such as clicking and touching.
View has requested that the system navigation be temporarily hidden.
This is an even less obtrusive state than that called for by
SYSTEM_UI_FLAG_LOW_PROFILE; on devices that draw essential navigation controls
(Home, Back, and the like) on screen, SYSTEM_UI_FLAG_HIDE_NAVIGATION will cause
those to disappear. This is useful (in conjunction with the
FLAG_FULLSCREEN and
FLAG_LAYOUT_IN_SCREEN
window flags) for displaying content using every last pixel on the display.
There is a limitation: because navigation controls are so important, the least user
interaction will cause them to reappear immediately.
View has requested the system UI to enter an unobtrusive "low profile" mode. This is for use in games, book readers, video players, or any other "immersive" application where the usual system chrome is deemed too distracting. In low profile mode, the status bar and/or navigation icons may dim.
View has requested the system UI (status bar) to be visible (the default).