19066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/* 29066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Copyright (C) 2006 The Android Open Source Project 39066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 49066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Licensed under the Apache License, Version 2.0 (the "License"); 59066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * you may not use this file except in compliance with the License. 69066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * You may obtain a copy of the License at 79066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 89066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * http://www.apache.org/licenses/LICENSE-2.0 99066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Unless required by applicable law or agreed to in writing, software 119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * distributed under the License is distributed on an "AS IS" BASIS, 129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * See the License for the specific language governing permissions and 149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * limitations under the License. 159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpackage android.util; 189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2012ff37162752c5af43795abbf43dac11a2ef5df0Dianne Hackbornimport org.xmlpull.v1.XmlPullParser; 2112ff37162752c5af43795abbf43dac11a2ef5df0Dianne Hackborn 229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/** 239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * A collection of attributes, as found associated with a tag in an XML 249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * document. Often you will not want to use this interface directly, instead 259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * passing it to {@link android.content.res.Resources.Theme#obtainStyledAttributes(AttributeSet, int[], int, int) 269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Resources.Theme.obtainStyledAttributes()} 279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * which will take care of parsing the attributes for you. In particular, 289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the Resources API will convert resource references (attribute values such as 299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * "@string/my_label" in the original XML) to the desired type 309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * for you; if you use AttributeSet directly then you will need to manually 319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * check for resource references 329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * (with {@link #getAttributeResourceValue(int, int)}) and do the resource 339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * lookup yourself if needed. Direct use of AttributeSet also prevents the 349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * application of themes and styles when retrieving attribute values. 359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>This interface provides an efficient mechanism for retrieving 379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * data from compiled XML files, which can be retrieved for a particular 389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * XmlPullParser through {@link Xml#asAttributeSet 396b13bc043e715b5415b701e93141daa0d49fa364Dirk Dougherty * Xml.asAttributeSet()}. Normally this will return an implementation 409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * of the interface that works on top of a generic XmlPullParser, however it 419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is more useful in conjunction with compiled XML resources: 429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <pre> 44d430753cba09acb07af8b313286f247c78a41a32Chet Haase * XmlPullParser parser = resources.getXml(myResource); 456b13bc043e715b5415b701e93141daa0d49fa364Dirk Dougherty * AttributeSet attributes = Xml.asAttributeSet(parser);</pre> 469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>The implementation returned here, unlike using 489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the implementation on top of a generic XmlPullParser, 499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is highly optimized by retrieving pre-computed information that was 509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * generated by aapt when compiling your resources. For example, 519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the {@link #getAttributeFloatValue(int, float)} method returns a floating 529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * point number previous stored in the compiled resource instead of parsing 539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * at runtime the string originally in the XML file. 549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>This interface also provides additional information contained in the 569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * compiled XML resource that is not available in a normal XML file, such 579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * as {@link #getAttributeNameResource(int)} which returns the resource 589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * identifier associated with a particular XML attribute name. 5912ff37162752c5af43795abbf43dac11a2ef5df0Dianne Hackborn * 6012ff37162752c5af43795abbf43dac11a2ef5df0Dianne Hackborn * @see XmlPullParser 619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpublic interface AttributeSet { 63d379d53a5ed3b1cb487f952bbc5614022d47384cRomain Guy /** 64d379d53a5ed3b1cb487f952bbc5614022d47384cRomain Guy * Returns the number of attributes available in the set. 6512ff37162752c5af43795abbf43dac11a2ef5df0Dianne Hackborn * 6612ff37162752c5af43795abbf43dac11a2ef5df0Dianne Hackborn * <p>See also {@link XmlPullParser#getAttributeCount XmlPullParser.getAttributeCount()}, 6712ff37162752c5af43795abbf43dac11a2ef5df0Dianne Hackborn * which this method corresponds to when parsing a compiled XML file.</p> 6812ff37162752c5af43795abbf43dac11a2ef5df0Dianne Hackborn * 69d379d53a5ed3b1cb487f952bbc5614022d47384cRomain Guy * @return A positive integer, or 0 if the set is empty. 70d379d53a5ed3b1cb487f952bbc5614022d47384cRomain Guy */ 719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getAttributeCount(); 72d379d53a5ed3b1cb487f952bbc5614022d47384cRomain Guy 73d379d53a5ed3b1cb487f952bbc5614022d47384cRomain Guy /** 7412ff37162752c5af43795abbf43dac11a2ef5df0Dianne Hackborn * Returns the namespace of the specified attribute. 7512ff37162752c5af43795abbf43dac11a2ef5df0Dianne Hackborn * 7612ff37162752c5af43795abbf43dac11a2ef5df0Dianne Hackborn * <p>See also {@link XmlPullParser#getAttributeNamespace XmlPullParser.getAttributeNamespace()}, 7712ff37162752c5af43795abbf43dac11a2ef5df0Dianne Hackborn * which this method corresponds to when parsing a compiled XML file.</p> 7812ff37162752c5af43795abbf43dac11a2ef5df0Dianne Hackborn * 7912ff37162752c5af43795abbf43dac11a2ef5df0Dianne Hackborn * @param index Index of the desired attribute, 0...count-1. 8012ff37162752c5af43795abbf43dac11a2ef5df0Dianne Hackborn * 8112ff37162752c5af43795abbf43dac11a2ef5df0Dianne Hackborn * @return A String containing the namespace of the attribute, or null if th 8212ff37162752c5af43795abbf43dac11a2ef5df0Dianne Hackborn * attribute cannot be found. 8312ff37162752c5af43795abbf43dac11a2ef5df0Dianne Hackborn */ 8412ff37162752c5af43795abbf43dac11a2ef5df0Dianne Hackborn default String getAttributeNamespace (int index) { 8512ff37162752c5af43795abbf43dac11a2ef5df0Dianne Hackborn // This is a new method since the first interface definition, so add stub impl. 8612ff37162752c5af43795abbf43dac11a2ef5df0Dianne Hackborn return null; 8712ff37162752c5af43795abbf43dac11a2ef5df0Dianne Hackborn } 8812ff37162752c5af43795abbf43dac11a2ef5df0Dianne Hackborn 8912ff37162752c5af43795abbf43dac11a2ef5df0Dianne Hackborn /** 90d379d53a5ed3b1cb487f952bbc5614022d47384cRomain Guy * Returns the name of the specified attribute. 9112ff37162752c5af43795abbf43dac11a2ef5df0Dianne Hackborn * 9212ff37162752c5af43795abbf43dac11a2ef5df0Dianne Hackborn * <p>See also {@link XmlPullParser#getAttributeName XmlPullParser.getAttributeName()}, 9312ff37162752c5af43795abbf43dac11a2ef5df0Dianne Hackborn * which this method corresponds to when parsing a compiled XML file.</p> 9412ff37162752c5af43795abbf43dac11a2ef5df0Dianne Hackborn * 95d379d53a5ed3b1cb487f952bbc5614022d47384cRomain Guy * @param index Index of the desired attribute, 0...count-1. 96d379d53a5ed3b1cb487f952bbc5614022d47384cRomain Guy * 97d379d53a5ed3b1cb487f952bbc5614022d47384cRomain Guy * @return A String containing the name of the attribute, or null if the 98d379d53a5ed3b1cb487f952bbc5614022d47384cRomain Guy * attribute cannot be found. 99d379d53a5ed3b1cb487f952bbc5614022d47384cRomain Guy */ 1009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public String getAttributeName(int index); 101d379d53a5ed3b1cb487f952bbc5614022d47384cRomain Guy 102d379d53a5ed3b1cb487f952bbc5614022d47384cRomain Guy /** 103d379d53a5ed3b1cb487f952bbc5614022d47384cRomain Guy * Returns the value of the specified attribute as a string representation. 104d379d53a5ed3b1cb487f952bbc5614022d47384cRomain Guy * 105d379d53a5ed3b1cb487f952bbc5614022d47384cRomain Guy * @param index Index of the desired attribute, 0...count-1. 106d379d53a5ed3b1cb487f952bbc5614022d47384cRomain Guy * 107d379d53a5ed3b1cb487f952bbc5614022d47384cRomain Guy * @return A String containing the value of the attribute, or null if the 108d379d53a5ed3b1cb487f952bbc5614022d47384cRomain Guy * attribute cannot be found. 109d379d53a5ed3b1cb487f952bbc5614022d47384cRomain Guy */ 1109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public String getAttributeValue(int index); 111d379d53a5ed3b1cb487f952bbc5614022d47384cRomain Guy 112d379d53a5ed3b1cb487f952bbc5614022d47384cRomain Guy /** 113d379d53a5ed3b1cb487f952bbc5614022d47384cRomain Guy * Returns the value of the specified attribute as a string representation. 114d379d53a5ed3b1cb487f952bbc5614022d47384cRomain Guy * The lookup is performed using the attribute name. 115d379d53a5ed3b1cb487f952bbc5614022d47384cRomain Guy * 116d379d53a5ed3b1cb487f952bbc5614022d47384cRomain Guy * @param namespace The namespace of the attribute to get the value from. 117d379d53a5ed3b1cb487f952bbc5614022d47384cRomain Guy * @param name The name of the attribute to get the value from. 118d379d53a5ed3b1cb487f952bbc5614022d47384cRomain Guy * 119d379d53a5ed3b1cb487f952bbc5614022d47384cRomain Guy * @return A String containing the value of the attribute, or null if the 120d379d53a5ed3b1cb487f952bbc5614022d47384cRomain Guy * attribute cannot be found. 121d379d53a5ed3b1cb487f952bbc5614022d47384cRomain Guy */ 1229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public String getAttributeValue(String namespace, String name); 123d379d53a5ed3b1cb487f952bbc5614022d47384cRomain Guy 124d379d53a5ed3b1cb487f952bbc5614022d47384cRomain Guy /** 125d379d53a5ed3b1cb487f952bbc5614022d47384cRomain Guy * Returns a description of the current position of the attribute set. 126d379d53a5ed3b1cb487f952bbc5614022d47384cRomain Guy * For instance, if the attribute set is loaded from an XML document, 127d379d53a5ed3b1cb487f952bbc5614022d47384cRomain Guy * the position description could indicate the current line number. 128d379d53a5ed3b1cb487f952bbc5614022d47384cRomain Guy * 129d379d53a5ed3b1cb487f952bbc5614022d47384cRomain Guy * @return A string representation of the current position in the set, 130d379d53a5ed3b1cb487f952bbc5614022d47384cRomain Guy * may be null. 131d379d53a5ed3b1cb487f952bbc5614022d47384cRomain Guy */ 1329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public String getPositionDescription(); 1339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return the resource ID associated with the given attribute name. This 1369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * will be the identifier for an attribute resource, which can be used by 1379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * styles. Returns 0 if there is no resource associated with this 1389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * attribute. 1399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>Note that this is different than {@link #getAttributeResourceValue} 1419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * in that it returns a resource identifier for the attribute name; the 1429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * other method returns this attribute's value as a resource identifier. 1439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param index Index of the desired attribute, 0...count-1. 1459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return The resource identifier, 0 if none. 1479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getAttributeNameResource(int index); 1499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return the index of the value of 'attribute' in the list 'options'. 152d379d53a5ed3b1cb487f952bbc5614022d47384cRomain Guy * 153d379d53a5ed3b1cb487f952bbc5614022d47384cRomain Guy * @param namespace Namespace of attribute to retrieve. 1549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param attribute Name of attribute to retrieve. 1559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param options List of strings whose values we are checking against. 1569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param defaultValue Value returned if attribute doesn't exist or no 1579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * match is found. 1589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Index in to 'options' or defaultValue. 1609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getAttributeListValue(String namespace, String attribute, 1629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String[] options, int defaultValue); 1639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return the boolean value of 'attribute'. 1669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 167d379d53a5ed3b1cb487f952bbc5614022d47384cRomain Guy * @param namespace Namespace of attribute to retrieve. 1689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param attribute The attribute to retrieve. 1699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param defaultValue What to return if the attribute isn't found. 1709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Resulting value. 1729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean getAttributeBooleanValue(String namespace, String attribute, 1749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project boolean defaultValue); 1759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return the value of 'attribute' as a resource identifier. 1789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>Note that this is different than {@link #getAttributeNameResource} 18050e27c813522e1772e3bd406c5e0d6d7dee14cc0kmccormick * in that it returns the value contained in this attribute as a 1819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * resource identifier (i.e., a value originally of the form 1829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * "@package:type/resource"); the other method returns a resource 1839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * identifier that identifies the name of the attribute. 1849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 185d379d53a5ed3b1cb487f952bbc5614022d47384cRomain Guy * @param namespace Namespace of attribute to retrieve. 1869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param attribute The attribute to retrieve. 1879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param defaultValue What to return if the attribute isn't found. 1889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Resulting value. 1909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getAttributeResourceValue(String namespace, String attribute, 1929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int defaultValue); 1939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return the integer value of 'attribute'. 1969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 197d379d53a5ed3b1cb487f952bbc5614022d47384cRomain Guy * @param namespace Namespace of attribute to retrieve. 1989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param attribute The attribute to retrieve. 1999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param defaultValue What to return if the attribute isn't found. 2009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Resulting value. 2029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getAttributeIntValue(String namespace, String attribute, 2049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int defaultValue); 2059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return the boolean value of 'attribute' that is formatted as an 2089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * unsigned value. In particular, the formats 0xn...n and #n...n are 2099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * handled. 2109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 211d379d53a5ed3b1cb487f952bbc5614022d47384cRomain Guy * @param namespace Namespace of attribute to retrieve. 2129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param attribute The attribute to retrieve. 2139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param defaultValue What to return if the attribute isn't found. 2149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Resulting value. 2169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getAttributeUnsignedIntValue(String namespace, String attribute, 2189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int defaultValue); 2199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return the float value of 'attribute'. 2229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 223d379d53a5ed3b1cb487f952bbc5614022d47384cRomain Guy * @param namespace Namespace of attribute to retrieve. 2249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param attribute The attribute to retrieve. 2259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param defaultValue What to return if the attribute isn't found. 2269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Resulting value. 2289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public float getAttributeFloatValue(String namespace, String attribute, 2309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float defaultValue); 2319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return the index of the value of attribute at 'index' in the list 2349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 'options'. 2359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param index Index of the desired attribute, 0...count-1. 2379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param options List of strings whose values we are checking against. 2389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param defaultValue Value returned if attribute doesn't exist or no 2399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * match is found. 2409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Index in to 'options' or defaultValue. 2429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 243d379d53a5ed3b1cb487f952bbc5614022d47384cRomain Guy public int getAttributeListValue(int index, String[] options, int defaultValue); 2449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return the boolean value of attribute at 'index'. 2479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param index Index of the desired attribute, 0...count-1. 2499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param defaultValue What to return if the attribute isn't found. 2509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Resulting value. 2529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 253d379d53a5ed3b1cb487f952bbc5614022d47384cRomain Guy public boolean getAttributeBooleanValue(int index, boolean defaultValue); 2549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return the value of attribute at 'index' as a resource identifier. 2579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>Note that this is different than {@link #getAttributeNameResource} 25950e27c813522e1772e3bd406c5e0d6d7dee14cc0kmccormick * in that it returns the value contained in this attribute as a 2609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * resource identifier (i.e., a value originally of the form 2619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * "@package:type/resource"); the other method returns a resource 2629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * identifier that identifies the name of the attribute. 2639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param index Index of the desired attribute, 0...count-1. 2659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param defaultValue What to return if the attribute isn't found. 2669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Resulting value. 2689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 269d379d53a5ed3b1cb487f952bbc5614022d47384cRomain Guy public int getAttributeResourceValue(int index, int defaultValue); 2709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return the integer value of attribute at 'index'. 2739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param index Index of the desired attribute, 0...count-1. 2759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param defaultValue What to return if the attribute isn't found. 2769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Resulting value. 2789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 279d379d53a5ed3b1cb487f952bbc5614022d47384cRomain Guy public int getAttributeIntValue(int index, int defaultValue); 2809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return the integer value of attribute at 'index' that is formatted as an 2839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * unsigned value. In particular, the formats 0xn...n and #n...n are 2849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * handled. 2859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param index Index of the desired attribute, 0...count-1. 2879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param defaultValue What to return if the attribute isn't found. 2889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Resulting value. 2909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 291d379d53a5ed3b1cb487f952bbc5614022d47384cRomain Guy public int getAttributeUnsignedIntValue(int index, int defaultValue); 2929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return the float value of attribute at 'index'. 2959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param index Index of the desired attribute, 0...count-1. 2979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param defaultValue What to return if the attribute isn't found. 2989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Resulting value. 3009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 301d379d53a5ed3b1cb487f952bbc5614022d47384cRomain Guy public float getAttributeFloatValue(int index, float defaultValue); 3029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return the value of the "id" attribute or null if there is not one. 3059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Equivalent to getAttributeValue(null, "id"). 3069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return The id attribute's value or null. 3089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public String getIdAttribute(); 3109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return the value of the "class" attribute or null if there is not one. 3139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Equivalent to getAttributeValue(null, "class"). 3149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return The class attribute's value or null. 3169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public String getClassAttribute(); 3189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return the integer value of the "id" attribute or defaultValue if there 3219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is none. 3229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Equivalent to getAttributeResourceValue(null, "id", defaultValue); 3239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param defaultValue What to return if the "id" attribute isn't found. 3259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return int Resulting value. 3269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getIdAttributeResourceValue(int defaultValue); 3289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return the value of the "style" attribute or 0 if there is not one. 3329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Equivalent to getAttributeResourceValue(null, "style"). 3339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return The style attribute's resource identifier or 0. 3359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getStyleAttribute(); 3379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project} 338