Skip to content

Most visited

Recently visited

navigation

ViewStructure

public abstract class ViewStructure
extends Object

java.lang.Object
   ↳ android.view.ViewStructure


Container for storing additional per-view data generated by View.onProvideStructure and View.onProvideAutoFillStructure.

Summary

Public constructors

ViewStructure()

Public methods

abstract int addChildCount(int num)

Add to this view's child count.

abstract void asyncCommit()

Call when done populating a ViewStructure returned by asyncNewChild(int).

abstract ViewStructure asyncNewChild(int index, int virtualId, int flags)

Like asyncNewChild(int), but providing a virtualId to the child so it can be auto-filled by autoFillVirtual(int, AutoFillValue).

abstract ViewStructure asyncNewChild(int index)

Like newChild(int), but allows the caller to asynchronously populate the returned child.

abstract int getChildCount()

Return the child count as set by setChildCount(int).

abstract Bundle getExtras()

Get extra data associated with this view structure; the returned Bundle is mutable, allowing you to view and modify its contents.

abstract CharSequence getHint()

Retrieve the last hint set by setHint(CharSequence).

abstract CharSequence getText()

Retrieve the last setText(CharSequence).

abstract int getTextSelectionEnd()

Retrieve the last selection end set by setText(CharSequence, int, int).

abstract int getTextSelectionStart()

Retrieve the last selection start set by setText(CharSequence, int, int).

abstract boolean hasExtras()

Returns true if getExtras() has been used to create extra content.

abstract ViewStructure newChild(int index)

Create a new child ViewStructure in this view, putting into the list of children at index.

abstract ViewStructure newChild(int index, int virtualId, int flags)

Like newChild(int), but providing a virtualId to the child so it can be auto-filled by autoFillVirtual(int, AutoFillValue).

abstract void setAccessibilityFocused(boolean state)

Set the accessibility focused state of this view, as per View.isAccessibilityFocused().

abstract void setActivated(boolean state)

Set the activated state of this view, as per View.isActivated().

abstract void setAlpha(float alpha)

Set an alpha transformation that is applied to this view, as per View.getAlpha().

abstract void setAutoFillOptions(String[] options)

Sets the options that can be used to auto-fill this node.

abstract void setAutoFillType(AutoFillType info)

Sets the AutoFillType that can be used to auto-fill this node.

abstract void setAutoFillValue(AutoFillValue value)

Sets the AutoFillValue representing the current value of this node.

abstract void setCheckable(boolean state)

Set the checkable state of this view, such as whether it implements the Checkable interface.

abstract void setChecked(boolean state)

Set the checked state of this view, such as Checkable.isChecked().

abstract void setChildCount(int num)

Set the number of children of this view, which defines the range of indices you can use with newChild(int) and asyncNewChild(int).

abstract void setClassName(String className)

Set the class name of the view, as per View.getAccessibilityClassName().

abstract void setClickable(boolean state)

Set the clickable state of this view, as per View.isClickable().

abstract void setContentDescription(CharSequence contentDescription)

Set the content description of the view, as per View.getContentDescription().

abstract void setContextClickable(boolean state)

Set the context clickable state of this view, as per View.isContextClickable().

abstract void setDimens(int left, int top, int scrollX, int scrollY, int width, int height)

Set the basic dimensions of this view.

abstract void setElevation(float elevation)

Set the visual elevation (shadow) of the view, as per View.getZ().

abstract void setEnabled(boolean state)

Set the enabled state of this view, as per View.isEnabled().

abstract void setFocusable(boolean state)

Set the focusable state of this view, as per View.isFocusable().

abstract void setFocused(boolean state)

Set the focused state of this view, as per View.isFocused().

abstract void setHint(CharSequence hint)

Set optional hint text associated with this view; this is for example the text that is shown by an EditText when it is empty to indicate to the user the kind of text to input.

abstract void setId(int id, String packageName, String typeName, String entryName)

Set the identifier for this view.

abstract void setLongClickable(boolean state)

Set the long clickable state of this view, as per View.isLongClickable().

abstract void setSanitized(boolean sanitized)

Marks this node as sanitized so its content are sent on onFillRequest(android.app.assist.AssistStructure, Bundle, android.os.CancellationSignal, android.service.autofill.FillCallback).

abstract void setSelected(boolean state)

Set the selected state of this view, as per View.isSelected().

abstract void setText(CharSequence text)

Set the text that is associated with this view.

abstract void setText(CharSequence text, int selectionStart, int selectionEnd)

Like setText(CharSequence) but with an active selection extending from selectionStart through selectionEnd.

abstract void setTextLines(int[] charOffsets, int[] baselines)

Set line information for test that was previously supplied through setText(CharSequence).

abstract void setTextStyle(float size, int fgColor, int bgColor, int style)

Explicitly set default global style information for text that was previously set with setText(CharSequence).

abstract void setTransformation(Matrix matrix)

Set the transformation matrix associated with this view, as per View.getMatrix(), or null if there is none.

abstract void setUrl(String url)

Sets the URL represented by this node.

abstract void setVisibility(int visibility)

Set the visibility state of this view, as per View.getVisibility().

Inherited methods

From class java.lang.Object

Public constructors

ViewStructure

added in API level 23
ViewStructure ()

Public methods

addChildCount

added in API level 23
int addChildCount (int num)

Add to this view's child count. This increases the current child count by num children beyond what was last set by setChildCount(int) or addChildCount(int). The index at which the new child starts in the child array is returned.

Parameters
num int: The number of new children to add.
Returns
int Returns the index in the child array at which the new children start.

asyncCommit

added in API level 23
void asyncCommit ()

Call when done populating a ViewStructure returned by asyncNewChild(int).

asyncNewChild

ViewStructure asyncNewChild (int index, 
                int virtualId, 
                int flags)

Like asyncNewChild(int), but providing a virtualId to the child so it can be auto-filled by autoFillVirtual(int, AutoFillValue).

Parameters
index int: child index
virtualId int: id identifying the virtual child inside the custom view.
flags int: currently 0.
Returns
ViewStructure

asyncNewChild

added in API level 23
ViewStructure asyncNewChild (int index)

Like newChild(int), but allows the caller to asynchronously populate the returned child. It can transfer the returned ViewStructure to another thread for it to build its content (and children etc). Once done, some thread must call asyncCommit() to tell the containing ViewStructure that the async population is done.

Parameters
index int
Returns
ViewStructure Returns an fresh ViewStructure ready to be filled in.

getChildCount

added in API level 23
int getChildCount ()

Return the child count as set by setChildCount(int).

Returns
int

getExtras

added in API level 23
Bundle getExtras ()

Get extra data associated with this view structure; the returned Bundle is mutable, allowing you to view and modify its contents. Keys placed in the Bundle should use an appropriate namespace prefix (such as com.google.MY_KEY) to avoid conflicts.

Returns
Bundle

getHint

added in API level 23
CharSequence getHint ()

Retrieve the last hint set by setHint(CharSequence).

Returns
CharSequence

getText

added in API level 23
CharSequence getText ()

Retrieve the last setText(CharSequence).

Returns
CharSequence

getTextSelectionEnd

added in API level 23
int getTextSelectionEnd ()

Retrieve the last selection end set by setText(CharSequence, int, int).

Returns
int

getTextSelectionStart

added in API level 23
int getTextSelectionStart ()

Retrieve the last selection start set by setText(CharSequence, int, int).

Returns
int

hasExtras

added in API level 23
boolean hasExtras ()

Returns true if getExtras() has been used to create extra content.

Returns
boolean

newChild

added in API level 23
ViewStructure newChild (int index)

Create a new child ViewStructure in this view, putting into the list of children at index.

Parameters
index int
Returns
ViewStructure Returns an fresh ViewStructure ready to be filled in.

newChild

ViewStructure newChild (int index, 
                int virtualId, 
                int flags)

Like newChild(int), but providing a virtualId to the child so it can be auto-filled by autoFillVirtual(int, AutoFillValue).

Parameters
index int: child index
virtualId int: id identifying the virtual child inside the custom view.
flags int: currently 0.
Returns
ViewStructure

setAccessibilityFocused

added in API level 23
void setAccessibilityFocused (boolean state)

Set the accessibility focused state of this view, as per View.isAccessibilityFocused().

Parameters
state boolean

setActivated

added in API level 23
void setActivated (boolean state)

Set the activated state of this view, as per View.isActivated().

Parameters
state boolean

setAlpha

added in API level 23
void setAlpha (float alpha)

Set an alpha transformation that is applied to this view, as per View.getAlpha(). Value ranges from 0 (completely transparent) to 1 (completely opaque); the default is 1, which means no transformation.

Parameters
alpha float

setAutoFillOptions

void setAutoFillOptions (String[] options)

Sets the options that can be used to auto-fill this node.

Typically used by nodes whose AutoFillType is a list to indicate the meaning of each possible value in the list.

Parameters
options String

setAutoFillType

void setAutoFillType (AutoFillType info)

Sets the AutoFillType that can be used to auto-fill this node.

Parameters
info AutoFillType

setAutoFillValue

void setAutoFillValue (AutoFillValue value)

Sets the AutoFillValue representing the current value of this node.

Parameters
value AutoFillValue

setCheckable

added in API level 23
void setCheckable (boolean state)

Set the checkable state of this view, such as whether it implements the Checkable interface.

Parameters
state boolean

setChecked

added in API level 23
void setChecked (boolean state)

Set the checked state of this view, such as Checkable.isChecked().

Parameters
state boolean

setChildCount

added in API level 23
void setChildCount (int num)

Set the number of children of this view, which defines the range of indices you can use with newChild(int) and asyncNewChild(int). Calling this method again resets all of the child state of the view, removing any children that had previously been added.

Parameters
num int

setClassName

added in API level 23
void setClassName (String className)

Set the class name of the view, as per View.getAccessibilityClassName().

Parameters
className String

setClickable

added in API level 23
void setClickable (boolean state)

Set the clickable state of this view, as per View.isClickable().

Parameters
state boolean

setContentDescription

added in API level 23
void setContentDescription (CharSequence contentDescription)

Set the content description of the view, as per View.getContentDescription().

Parameters
contentDescription CharSequence

setContextClickable

added in API level 23
void setContextClickable (boolean state)

Set the context clickable state of this view, as per View.isContextClickable().

Parameters
state boolean

setDimens

added in API level 23
void setDimens (int left, 
                int top, 
                int scrollX, 
                int scrollY, 
                int width, 
                int height)

Set the basic dimensions of this view.

Parameters
left int: The view's left position, in pixels relative to its parent's left edge.
top int: The view's top position, in pixels relative to its parent's top edge.
scrollX int: How much the view's x coordinate space has been scrolled, in pixels.
scrollY int: How much the view's y coordinate space has been scrolled, in pixels.
width int: The view's visible width, in pixels. This is the width visible on screen, not the total data width of a scrollable view.
height int: The view's visible height, in pixels. This is the height visible on screen, not the total data height of a scrollable view.

setElevation

added in API level 23
void setElevation (float elevation)

Set the visual elevation (shadow) of the view, as per View.getZ(). Note this is not related to the physical Z-ordering of this view relative to its other siblings (that is how they overlap when drawing), it is only the visual representation for shadowing.

Parameters
elevation float

setEnabled

added in API level 23
void setEnabled (boolean state)

Set the enabled state of this view, as per View.isEnabled().

Parameters
state boolean

setFocusable

added in API level 23
void setFocusable (boolean state)

Set the focusable state of this view, as per View.isFocusable().

Parameters
state boolean

setFocused

added in API level 23
void setFocused (boolean state)

Set the focused state of this view, as per View.isFocused().

Parameters
state boolean

setHint

added in API level 23
void setHint (CharSequence hint)

Set optional hint text associated with this view; this is for example the text that is shown by an EditText when it is empty to indicate to the user the kind of text to input.

Parameters
hint CharSequence

setId

added in API level 23
void setId (int id, 
                String packageName, 
                String typeName, 
                String entryName)

Set the identifier for this view.

Parameters
id int: The view's identifier, as per View.getId().
packageName String: The package name of the view's identifier, or null if there is none.
typeName String: The type name of the view's identifier, or null if there is none.
entryName String: The entry name of the view's identifier, or null if there is none.

setLongClickable

added in API level 23
void setLongClickable (boolean state)

Set the long clickable state of this view, as per View.isLongClickable().

Parameters
state boolean

setSanitized

void setSanitized (boolean sanitized)

Marks this node as sanitized so its content are sent on onFillRequest(android.app.assist.AssistStructure, Bundle, android.os.CancellationSignal, android.service.autofill.FillCallback).

Only nodes that does not have PII (Personally Identifiable Information - sensitive data such as email addresses, credit card numbers, passwords, etc...) should be marked as sanitized; a good rule of thumb is to mark as sanitized nodes whose value were statically set from resources.

Should only be set when the node is used for AutoFill purposes - it will be ignored when used for Assist.

Parameters
sanitized boolean

setSelected

added in API level 23
void setSelected (boolean state)

Set the selected state of this view, as per View.isSelected().

Parameters
state boolean

setText

added in API level 23
void setText (CharSequence text)

Set the text that is associated with this view. There is no selection associated with the text. The text may have style spans to supply additional display and semantic information.

Parameters
text CharSequence

setText

added in API level 23
void setText (CharSequence text, 
                int selectionStart, 
                int selectionEnd)

Like setText(CharSequence) but with an active selection extending from selectionStart through selectionEnd.

Parameters
text CharSequence
selectionStart int
selectionEnd int

setTextLines

added in API level 23
void setTextLines (int[] charOffsets, 
                int[] baselines)

Set line information for test that was previously supplied through setText(CharSequence). This provides the line breaking of the text as it is shown on screen. This function takes ownership of the provided arrays; you should not make further modification to them.

Parameters
charOffsets int: The offset in to setText(CharSequence) where a line starts.
baselines int: The baseline where the line is drawn on screen.

setTextStyle

added in API level 23
void setTextStyle (float size, 
                int fgColor, 
                int bgColor, 
                int style)

Explicitly set default global style information for text that was previously set with setText(CharSequence).

Parameters
size float: The size, in pixels, of the text.
fgColor int: The foreground color, packed as 0xAARRGGBB.
bgColor int: The background color, packed as 0xAARRGGBB.
style int: Style flags, as defined by AssistStructure.ViewNode.

setTransformation

added in API level 23
void setTransformation (Matrix matrix)

Set the transformation matrix associated with this view, as per View.getMatrix(), or null if there is none.

Parameters
matrix Matrix

setUrl

void setUrl (String url)

Sets the URL represented by this node.

Typically used in the following situations:

  1. In a getRootViewNode(), to set up the main URL of an HTML page.
  2. On child nodes represening hyperlinks.

Parameters
url String

setVisibility

added in API level 23
void setVisibility (int visibility)

Set the visibility state of this view, as per View.getVisibility().

Parameters
visibility int
This site uses cookies to store your preferences for site-specific language and display options.

Hooray!

This class requires API level or higher

This doc is hidden because your selected API level for the documentation is . You can change the documentation API level with the selector above the left navigation.

For more information about specifying the API level your app requires, read Supporting Different Platform Versions.

Take a one-minute survey?
Help us improve Android tools and documentation.