MockResources
public
class
MockResources
extends Resources
This class was deprecated
in API level 24.
Use a mocking framework like Mockito.
New tests should be written using the
Android Testing Support Library.
A mock Resources
class. All methods are non-functional and throw
UnsupportedOperationException
. Override it to provide the operations that you
need.
Summary
Public methods |
XmlResourceParser
|
getAnimation(int id)
Return an XmlResourceParser through which you can read an animation
description for the given resource ID.
|
int
|
getColor(int id)
This method is deprecated.
Use getColor(int, Theme) instead.
|
ColorStateList
|
getColorStateList(int id)
This method is deprecated.
Use getColorStateList(int, Theme) instead.
|
Configuration
|
getConfiguration()
Return the current configuration that is in effect for this resource
object.
|
float
|
getDimension(int id)
Retrieve a dimensional for a particular resource ID.
|
int
|
getDimensionPixelOffset(int id)
Retrieve a dimensional for a particular resource ID for use
as an offset in raw pixels.
|
int
|
getDimensionPixelSize(int id)
Retrieve a dimensional for a particular resource ID for use
as a size in raw pixels.
|
DisplayMetrics
|
getDisplayMetrics()
Return the current display metrics that are in effect for this resource
object.
|
Drawable
|
getDrawable(int id)
This method is deprecated.
Use getDrawable(int, Theme) instead.
|
int
|
getIdentifier(String name, String defType, String defPackage)
Return a resource identifier for the given resource name.
|
int[]
|
getIntArray(int id)
Return the int array associated with a particular resource ID.
|
int
|
getInteger(int id)
Return an integer associated with a particular resource ID.
|
XmlResourceParser
|
getLayout(int id)
Return an XmlResourceParser through which you can read a view layout
description for the given resource ID.
|
Movie
|
getMovie(int id)
Return a movie object associated with the particular resource ID.
|
String
|
getQuantityString(int id, int quantity, Object... formatArgs)
Formats the string necessary for grammatically correct pluralization
of the given resource ID for the given quantity, using the given arguments.
|
String
|
getQuantityString(int id, int quantity)
Returns the string necessary for grammatically correct pluralization
of the given resource ID for the given quantity.
|
CharSequence
|
getQuantityText(int id, int quantity)
Returns the character sequence necessary for grammatically correct pluralization
of the given resource ID for the given quantity.
|
String
|
getResourceEntryName(int resid)
Return the entry name for a given resource identifier.
|
String
|
getResourceName(int resid)
Return the full name for a given resource identifier.
|
String
|
getResourcePackageName(int resid)
Return the package name for a given resource identifier.
|
String
|
getResourceTypeName(int resid)
Return the type name for a given resource identifier.
|
String
|
getString(int id)
Return the string value associated with a particular resource ID. It
will be stripped of any styled text information.
|
String
|
getString(int id, Object... formatArgs)
Return the string value associated with a particular resource ID,
substituting the format arguments as defined in Formatter
and format(String, Object...) . It will be stripped of any styled text
information.
|
String[]
|
getStringArray(int id)
Return the string array associated with a particular resource ID.
|
CharSequence
|
getText(int id, CharSequence def)
Return the string value associated with a particular resource ID.
|
CharSequence
|
getText(int id)
Return the string value associated with a particular resource ID. The
returned object will be a String if this is a plain string; it will be
some other type of CharSequence if it is styled.
|
CharSequence[]
|
getTextArray(int id)
Return the styled text array associated with a particular resource ID.
|
void
|
getValue(String name, TypedValue outValue, boolean resolveRefs)
Return the raw data associated with a particular resource ID.
|
void
|
getValue(int id, TypedValue outValue, boolean resolveRefs)
Return the raw data associated with a particular resource ID.
|
XmlResourceParser
|
getXml(int id)
Return an XmlResourceParser through which you can read a generic XML
resource for the given resource ID.
|
TypedArray
|
obtainAttributes(AttributeSet set, int[] attrs)
Retrieve a set of basic attribute values from an AttributeSet, not
performing styling of them using a theme and/or style resources.
|
TypedArray
|
obtainTypedArray(int id)
Return an array of heterogeneous values.
|
InputStream
|
openRawResource(int id)
Open a data stream for reading a raw resource.
|
AssetFileDescriptor
|
openRawResourceFd(int id)
Open a file descriptor for reading a raw resource.
|
void
|
updateConfiguration(Configuration config, DisplayMetrics metrics)
Store the newly updated configuration.
|
Inherited methods |
From
class
android.content.res.Resources
final
void
|
finishPreloading()
Called by zygote when it is done preloading resources, to change back
to normal Resources operation.
|
final
void
|
flushLayoutCache()
Call this to remove all cached loaded layout resources from the
Resources object.
|
XmlResourceParser
|
getAnimation(int id)
Return an XmlResourceParser through which you can read an animation
description for the given resource ID.
|
final
AssetManager
|
getAssets()
Retrieve underlying AssetManager storage for these resources.
|
boolean
|
getBoolean(int id)
Return a boolean associated with a particular resource ID.
|
int
|
getColor(int id)
This method was deprecated
in API level 23.
Use getColor(int, Theme) instead.
|
int
|
getColor(int id, Resources.Theme theme)
Returns a themed color integer associated with a particular resource ID.
|
ColorStateList
|
getColorStateList(int id, Resources.Theme theme)
Returns a themed color state list associated with a particular resource
ID.
|
ColorStateList
|
getColorStateList(int id)
This method was deprecated
in API level 23.
Use getColorStateList(int, Theme) instead.
|
Configuration
|
getConfiguration()
Return the current configuration that is in effect for this resource
object.
|
float
|
getDimension(int id)
Retrieve a dimensional for a particular resource ID.
|
int
|
getDimensionPixelOffset(int id)
Retrieve a dimensional for a particular resource ID for use
as an offset in raw pixels.
|
int
|
getDimensionPixelSize(int id)
Retrieve a dimensional for a particular resource ID for use
as a size in raw pixels.
|
DisplayMetrics
|
getDisplayMetrics()
Return the current display metrics that are in effect for this resource
object.
|
Drawable
|
getDrawable(int id, Resources.Theme theme)
Return a drawable object associated with a particular resource ID and
styled for the specified theme.
|
Drawable
|
getDrawable(int id)
This method was deprecated
in API level 22.
Use getDrawable(int, Theme) instead.
|
Drawable
|
getDrawableForDensity(int id, int density)
This method was deprecated
in API level 22.
Use getDrawableForDensity(int, int, Theme) instead.
|
Drawable
|
getDrawableForDensity(int id, int density, Resources.Theme theme)
Return a drawable object associated with a particular resource ID for the
given screen density in DPI and styled for the specified theme.
|
float
|
getFraction(int id, int base, int pbase)
Retrieve a fractional unit for a particular resource ID.
|
int
|
getIdentifier(String name, String defType, String defPackage)
Return a resource identifier for the given resource name.
|
int[]
|
getIntArray(int id)
Return the int array associated with a particular resource ID.
|
int
|
getInteger(int id)
Return an integer associated with a particular resource ID.
|
XmlResourceParser
|
getLayout(int id)
Return an XmlResourceParser through which you can read a view layout
description for the given resource ID.
|
Movie
|
getMovie(int id)
Return a movie object associated with the particular resource ID.
|
String
|
getQuantityString(int id, int quantity)
Returns the string necessary for grammatically correct pluralization
of the given resource ID for the given quantity.
|
String
|
getQuantityString(int id, int quantity, Object... formatArgs)
Formats the string necessary for grammatically correct pluralization
of the given resource ID for the given quantity, using the given arguments.
|
CharSequence
|
getQuantityText(int id, int quantity)
Returns the character sequence necessary for grammatically correct pluralization
of the given resource ID for the given quantity.
|
String
|
getResourceEntryName(int resid)
Return the entry name for a given resource identifier.
|
String
|
getResourceName(int resid)
Return the full name for a given resource identifier.
|
String
|
getResourcePackageName(int resid)
Return the package name for a given resource identifier.
|
String
|
getResourceTypeName(int resid)
Return the type name for a given resource identifier.
|
String
|
getString(int id, Object... formatArgs)
Return the string value associated with a particular resource ID,
substituting the format arguments as defined in Formatter
and format(String, Object...) . It will be stripped of any styled text
information.
|
String
|
getString(int id)
Return the string value associated with a particular resource ID. It
will be stripped of any styled text information.
|
String[]
|
getStringArray(int id)
Return the string array associated with a particular resource ID.
|
static
Resources
|
getSystem()
Return a global shared Resources object that provides access to only
system resources (no application resources), and is not configured for
the current screen (can not use dimension units, does not change based
on orientation, etc).
|
CharSequence
|
getText(int id, CharSequence def)
Return the string value associated with a particular resource ID.
|
CharSequence
|
getText(int id)
Return the string value associated with a particular resource ID. The
returned object will be a String if this is a plain string; it will be
some other type of CharSequence if it is styled.
|
CharSequence[]
|
getTextArray(int id)
Return the styled text array associated with a particular resource ID.
|
void
|
getValue(String name, TypedValue outValue, boolean resolveRefs)
Return the raw data associated with a particular resource ID.
|
void
|
getValue(int id, TypedValue outValue, boolean resolveRefs)
Return the raw data associated with a particular resource ID.
|
void
|
getValueForDensity(int id, int density, TypedValue outValue, boolean resolveRefs)
Get the raw value associated with a resource with associated density.
|
XmlResourceParser
|
getXml(int id)
Return an XmlResourceParser through which you can read a generic XML
resource for the given resource ID.
|
final
Resources.Theme
|
newTheme()
Generate a new Theme object for this set of Resources.
|
TypedArray
|
obtainAttributes(AttributeSet set, int[] attrs)
Retrieve a set of basic attribute values from an AttributeSet, not
performing styling of them using a theme and/or style resources.
|
TypedArray
|
obtainTypedArray(int id)
Return an array of heterogeneous values.
|
InputStream
|
openRawResource(int id, TypedValue value)
Open a data stream for reading a raw resource.
|
InputStream
|
openRawResource(int id)
Open a data stream for reading a raw resource.
|
AssetFileDescriptor
|
openRawResourceFd(int id)
Open a file descriptor for reading a raw resource.
|
void
|
parseBundleExtra(String tagName, AttributeSet attrs, Bundle outBundle)
Parse a name/value pair out of an XML tag holding that data.
|
void
|
parseBundleExtras(XmlResourceParser parser, Bundle outBundle)
Parse a series of <extra> tags from
an XML file.
|
void
|
updateConfiguration(Configuration config, DisplayMetrics metrics)
Store the newly updated configuration.
|
|
From
class
java.lang.Object
Object
|
clone()
Creates and returns a copy of this object.
|
boolean
|
equals(Object obj)
Indicates whether some other object is "equal to" this one.
|
void
|
finalize()
Called by the garbage collector on an object when garbage collection
determines that there are no more references to the object.
|
final
Class<?>
|
getClass()
Returns the runtime class of this Object .
|
int
|
hashCode()
Returns a hash code value for the object.
|
final
void
|
notify()
Wakes up a single thread that is waiting on this object's
monitor.
|
final
void
|
notifyAll()
Wakes up all threads that are waiting on this object's monitor.
|
String
|
toString()
Returns a string representation of the object.
|
final
void
|
wait(long millis, int nanos)
Causes the current thread to wait until another thread invokes the
notify() method or the
notifyAll() method for this object, or
some other thread interrupts the current thread, or a certain
amount of real time has elapsed.
|
final
void
|
wait(long millis)
Causes the current thread to wait until either another thread invokes the
notify() method or the
notifyAll() method for this object, or a
specified amount of time has elapsed.
|
final
void
|
wait()
Causes the current thread to wait until another thread invokes the
notify() method or the
notifyAll() method for this object.
|
|
Public constructors
MockResources
MockResources ()
Public methods
getAnimation
XmlResourceParser getAnimation (int id)
Return an XmlResourceParser through which you can read an animation
description for the given resource ID. This parser has limited
functionality -- in particular, you can't change its input, and only
the high-level events are available.
This function is really a simple wrapper for calling
getXml(int)
with an animation resource.
Parameters |
id |
int :
The desired resource identifier, as generated by the aapt
tool. This integer encodes the package, type, and resource
entry. The value 0 is an invalid identifier. |
Returns |
XmlResourceParser |
A new parser object through which you can read
the XML data. |
getColor
int getColor (int id)
This method is deprecated.
Use getColor(int, Theme)
instead.
Returns a color integer associated with a particular resource ID. If the
resource holds a complex ColorStateList
, then the default color
from the set is returned.
Parameters |
id |
int :
The desired resource identifier, as generated by the aapt
tool. This integer encodes the package, type, and resource
entry. The value 0 is an invalid identifier. |
Returns |
int |
A single color value in the form 0xAARRGGBB. |
getColorStateList
ColorStateList getColorStateList (int id)
This method is deprecated.
Use getColorStateList(int, Theme)
instead.
Returns a color state list associated with a particular resource ID. The
resource may contain either a single raw color value or a complex
ColorStateList
holding multiple possible colors.
Parameters |
id |
int :
The desired resource identifier of a ColorStateList ,
as generated by the aapt tool. This integer encodes the
package, type, and resource entry. The value 0 is an invalid
identifier. |
Returns |
ColorStateList |
A ColorStateList object containing either a single solid color
or multiple colors that can be selected based on a state. |
getConfiguration
Configuration getConfiguration ()
Return the current configuration that is in effect for this resource
object. The returned object should be treated as read-only.
getDimension
float getDimension (int id)
Retrieve a dimensional for a particular resource ID. Unit
conversions are based on the current DisplayMetrics
associated
with the resources.
Parameters |
id |
int :
The desired resource identifier, as generated by the aapt
tool. This integer encodes the package, type, and resource
entry. The value 0 is an invalid identifier. |
Returns |
float |
Resource dimension value multiplied by the appropriate
metric. |
getDimensionPixelOffset
int getDimensionPixelOffset (int id)
Retrieve a dimensional for a particular resource ID for use
as an offset in raw pixels. This is the same as
getDimension(int)
, except the returned value is converted to
integer pixels for you. An offset conversion involves simply
truncating the base value to an integer.
Parameters |
id |
int :
The desired resource identifier, as generated by the aapt
tool. This integer encodes the package, type, and resource
entry. The value 0 is an invalid identifier. |
Returns |
int |
Resource dimension value multiplied by the appropriate
metric and truncated to integer pixels. |
getDimensionPixelSize
int getDimensionPixelSize (int id)
Retrieve a dimensional for a particular resource ID for use
as a size in raw pixels. This is the same as
getDimension(int)
, except the returned value is converted to
integer pixels for use as a size. A size conversion involves
rounding the base value, and ensuring that a non-zero base value
is at least one pixel in size.
Parameters |
id |
int :
The desired resource identifier, as generated by the aapt
tool. This integer encodes the package, type, and resource
entry. The value 0 is an invalid identifier. |
Returns |
int |
Resource dimension value multiplied by the appropriate
metric and truncated to integer pixels. |
getDisplayMetrics
DisplayMetrics getDisplayMetrics ()
Return the current display metrics that are in effect for this resource
object. The returned object should be treated as read-only.
getDrawable
Drawable getDrawable (int id)
This method is deprecated.
Use getDrawable(int, Theme)
instead.
Return a drawable object associated with a particular resource ID.
Various types of objects will be returned depending on the underlying
resource -- for example, a solid color, PNG image, scalable image, etc.
The Drawable API hides these implementation details.
Note: Prior to
JELLY_BEAN
, this function
would not correctly retrieve the final configuration density when
the resource ID passed here is an alias to another Drawable resource.
This means that if the density configuration of the alias resource
is different than the actual resource, the density of the returned
Drawable would be incorrect, resulting in bad scaling. To work
around this, you can instead manually resolve the aliased reference
by using getValue(int, TypedValue, boolean)
and passing
true
for resolveRefs
. The resulting
resourceId
value may be passed to this method.
Note: To obtain a themed drawable, use
Context.getDrawable(int)
or getDrawable(int, Theme)
passing the desired theme.
Parameters |
id |
int :
The desired resource identifier, as generated by the aapt
tool. This integer encodes the package, type, and resource
entry. The value 0 is an invalid identifier. |
Returns |
Drawable |
Drawable An object that can be used to draw this resource. |
getIdentifier
int getIdentifier (String name,
String defType,
String defPackage)
Return a resource identifier for the given resource name. A fully
qualified resource name is of the form "package:type/entry". The first
two components (package and type) are optional if defType and
defPackage, respectively, are specified here.
Note: use of this function is discouraged. It is much more
efficient to retrieve resources by identifier than by name.
Parameters |
name |
String :
The name of the desired resource. |
defType |
String :
Optional default resource type to find, if "type/" is
not included in the name. Can be null to require an
explicit type. |
defPackage |
String :
Optional default package to find, if "package:" is
not included in the name. Can be null to require an
explicit package. |
Returns |
int |
int The associated resource identifier. Returns 0 if no such
resource was found. (0 is not a valid resource ID.)
|
getIntArray
int[] getIntArray (int id)
Return the int array associated with a particular resource ID.
Parameters |
id |
int :
The desired resource identifier, as generated by the aapt
tool. This integer encodes the package, type, and resource
entry. The value 0 is an invalid identifier. |
Returns |
int[] |
The int array associated with the resource.
|
getInteger
int getInteger (int id)
Return an integer associated with a particular resource ID.
Parameters |
id |
int :
The desired resource identifier, as generated by the aapt
tool. This integer encodes the package, type, and resource
entry. The value 0 is an invalid identifier. |
Returns |
int |
Returns the integer value contained in the resource.
|
getLayout
XmlResourceParser getLayout (int id)
Return an XmlResourceParser through which you can read a view layout
description for the given resource ID. This parser has limited
functionality -- in particular, you can't change its input, and only
the high-level events are available.
This function is really a simple wrapper for calling
getXml(int)
with a layout resource.
Parameters |
id |
int :
The desired resource identifier, as generated by the aapt
tool. This integer encodes the package, type, and resource
entry. The value 0 is an invalid identifier. |
Returns |
XmlResourceParser |
A new parser object through which you can read
the XML data. |
getMovie
Movie getMovie (int id)
Return a movie object associated with the particular resource ID.
Parameters |
id |
int :
The desired resource identifier, as generated by the aapt
tool. This integer encodes the package, type, and resource
entry. The value 0 is an invalid identifier. |
getQuantityString
String getQuantityString (int id,
int quantity,
Object... formatArgs)
Formats the string necessary for grammatically correct pluralization
of the given resource ID for the given quantity, using the given arguments.
Note that the string is selected based solely on grammatical necessity,
and that such rules differ between languages. Do not assume you know which string
will be returned for a given quantity. See
String Resources
for more detail.
Substitution of format arguments works as if using
Formatter
and format(String, Object...)
.
The resulting string will be stripped of any styled text information.
Parameters |
id |
int :
The desired resource identifier, as generated by the aapt
tool. This integer encodes the package, type, and resource
entry. The value 0 is an invalid identifier. |
quantity |
int :
The number used to get the correct string for the current language's
plural rules. |
formatArgs |
Object :
The format arguments that will be used for substitution. |
Returns |
String |
String The string data associated with the resource,
stripped of styled text information.
|
getQuantityString
String getQuantityString (int id,
int quantity)
Returns the string necessary for grammatically correct pluralization
of the given resource ID for the given quantity.
Note that the string is selected based solely on grammatical necessity,
and that such rules differ between languages. Do not assume you know which string
will be returned for a given quantity. See
String Resources
for more detail.
Parameters |
id |
int :
The desired resource identifier, as generated by the aapt
tool. This integer encodes the package, type, and resource
entry. The value 0 is an invalid identifier. |
quantity |
int :
The number used to get the correct string for the current language's
plural rules. |
Returns |
String |
String The string data associated with the resource,
stripped of styled text information.
|
getQuantityText
CharSequence getQuantityText (int id,
int quantity)
Returns the character sequence necessary for grammatically correct pluralization
of the given resource ID for the given quantity.
Note that the character sequence is selected based solely on grammatical necessity,
and that such rules differ between languages. Do not assume you know which string
will be returned for a given quantity. See
String Resources
for more detail.
Parameters |
id |
int :
The desired resource identifier, as generated by the aapt
tool. This integer encodes the package, type, and resource
entry. The value 0 is an invalid identifier. |
quantity |
int :
The number used to get the correct string for the current language's
plural rules. |
Returns |
CharSequence |
CharSequence The string data associated with the resource, plus
possibly styled text information.
|
getResourceEntryName
String getResourceEntryName (int resid)
Return the entry name for a given resource identifier.
Parameters |
resid |
int :
The resource identifier whose entry name is to be
retrieved. |
Returns |
String |
A string holding the entry name of the resource. |
getResourceName
String getResourceName (int resid)
Return the full name for a given resource identifier. This name is
a single string of the form "package:type/entry".
Parameters |
resid |
int :
The resource identifier whose name is to be retrieved. |
Returns |
String |
A string holding the name of the resource. |
getResourcePackageName
String getResourcePackageName (int resid)
Return the package name for a given resource identifier.
Parameters |
resid |
int :
The resource identifier whose package name is to be
retrieved. |
Returns |
String |
A string holding the package name of the resource. |
getResourceTypeName
String getResourceTypeName (int resid)
Return the type name for a given resource identifier.
Parameters |
resid |
int :
The resource identifier whose type name is to be
retrieved. |
Returns |
String |
A string holding the type name of the resource. |
getString
String getString (int id)
Return the string value associated with a particular resource ID. It
will be stripped of any styled text information.
Parameters |
id |
int :
The desired resource identifier, as generated by the aapt
tool. This integer encodes the package, type, and resource
entry. The value 0 is an invalid identifier. |
Returns |
String |
String The string data associated with the resource,
stripped of styled text information.
|
getString
String getString (int id,
Object... formatArgs)
Return the string value associated with a particular resource ID,
substituting the format arguments as defined in Formatter
and format(String, Object...)
. It will be stripped of any styled text
information.
Parameters |
id |
int :
The desired resource identifier, as generated by the aapt
tool. This integer encodes the package, type, and resource
entry. The value 0 is an invalid identifier. |
formatArgs |
Object :
The format arguments that will be used for substitution. |
Returns |
String |
String The string data associated with the resource,
stripped of styled text information.
|
getStringArray
String[] getStringArray (int id)
Return the string array associated with a particular resource ID.
Parameters |
id |
int :
The desired resource identifier, as generated by the aapt
tool. This integer encodes the package, type, and resource
entry. The value 0 is an invalid identifier. |
Returns |
String[] |
The string array associated with the resource.
|
getText
CharSequence getText (int id,
CharSequence def)
Return the string value associated with a particular resource ID. The
returned object will be a String if this is a plain string; it will be
some other type of CharSequence if it is styled.
Parameters |
id |
int :
The desired resource identifier, as generated by the aapt
tool. This integer encodes the package, type, and resource
entry. The value 0 is an invalid identifier. |
def |
CharSequence :
The default CharSequence to return. |
Returns |
CharSequence |
CharSequence The string data associated with the resource, plus
possibly styled text information, or def if id is 0 or not found.
|
getText
CharSequence getText (int id)
Return the string value associated with a particular resource ID. The
returned object will be a String if this is a plain string; it will be
some other type of CharSequence if it is styled.
Parameters |
id |
int :
The desired resource identifier, as generated by the aapt
tool. This integer encodes the package, type, and resource
entry. The value 0 is an invalid identifier. |
Returns |
CharSequence |
CharSequence The string data associated with the resource, plus
possibly styled text information.
|
getTextArray
CharSequence[] getTextArray (int id)
Return the styled text array associated with a particular resource ID.
Parameters |
id |
int :
The desired resource identifier, as generated by the aapt
tool. This integer encodes the package, type, and resource
entry. The value 0 is an invalid identifier. |
Returns |
CharSequence[] |
The styled text array associated with the resource.
|
getValue
void getValue (String name,
TypedValue outValue,
boolean resolveRefs)
Return the raw data associated with a particular resource ID.
See getIdentifier() for information on how names are mapped to resource
IDs, and getString(int) for information on how string resources are
retrieved.
Note: use of this function is discouraged. It is much more
efficient to retrieve resources by identifier than by name.
Parameters |
name |
String :
The name of the desired resource. This is passed to
getIdentifier() with a default type of "string". |
outValue |
TypedValue :
Object in which to place the resource data. |
resolveRefs |
boolean :
If true, a resource that is a reference to another
resource will be followed so that you receive the
actual final resource data. If false, the TypedValue
will be filled in with the reference itself. |
getValue
void getValue (int id,
TypedValue outValue,
boolean resolveRefs)
Return the raw data associated with a particular resource ID.
Parameters |
id |
int :
The desired resource identifier, as generated by the aapt
tool. This integer encodes the package, type, and resource
entry. The value 0 is an invalid identifier. |
outValue |
TypedValue :
Object in which to place the resource data. |
resolveRefs |
boolean :
If true, a resource that is a reference to another
resource will be followed so that you receive the
actual final resource data. If false, the TypedValue
will be filled in with the reference itself. |
getXml
XmlResourceParser getXml (int id)
Return an XmlResourceParser through which you can read a generic XML
resource for the given resource ID.
The XmlPullParser implementation returned here has some limited
functionality. In particular, you can't change its input, and only
high-level parsing events are available (since the document was
pre-parsed for you at build time, which involved merging text and
stripping comments).
Parameters |
id |
int :
The desired resource identifier, as generated by the aapt
tool. This integer encodes the package, type, and resource
entry. The value 0 is an invalid identifier. |
Returns |
XmlResourceParser |
A new parser object through which you can read
the XML data. |
obtainAttributes
TypedArray obtainAttributes (AttributeSet set,
int[] attrs)
Retrieve a set of basic attribute values from an AttributeSet, not
performing styling of them using a theme and/or style resources.
Parameters |
set |
AttributeSet :
The current attribute values to retrieve. |
attrs |
int :
The specific attributes to be retrieved. |
obtainTypedArray
TypedArray obtainTypedArray (int id)
Return an array of heterogeneous values.
Parameters |
id |
int :
The desired resource identifier, as generated by the aapt
tool. This integer encodes the package, type, and resource
entry. The value 0 is an invalid identifier. |
openRawResource
InputStream openRawResource (int id)
Open a data stream for reading a raw resource. This can only be used
with resources whose value is the name of an asset files -- that is, it can be
used to open drawable, sound, and raw resources; it will fail on string
and color resources.
Parameters |
id |
int :
The resource identifier to open, as generated by the appt
tool. |
Returns |
InputStream |
InputStream Access to the resource data. |
openRawResourceFd
AssetFileDescriptor openRawResourceFd (int id)
Open a file descriptor for reading a raw resource. This can only be used
with resources whose value is the name of an asset files -- that is, it can be
used to open drawable, sound, and raw resources; it will fail on string
and color resources.
This function only works for resources that are stored in the package
as uncompressed data, which typically includes things like mp3 files
and png images.
Parameters |
id |
int :
The resource identifier to open, as generated by the appt
tool. |
Returns |
AssetFileDescriptor |
AssetFileDescriptor A new file descriptor you can use to read
the resource. This includes the file descriptor itself, as well as the
offset and length of data where the resource appears in the file. A
null is returned if the file exists but is compressed. |
updateConfiguration
void updateConfiguration (Configuration config,
DisplayMetrics metrics)
Store the newly updated configuration.
Parameters |
config |
Configuration
|
metrics |
DisplayMetrics
|