diff options
Diffstat (limited to 'docs/html/guide/topics/resources/style-resource.jd')
| -rw-r--r-- | docs/html/guide/topics/resources/style-resource.jd | 128 |
1 files changed, 128 insertions, 0 deletions
diff --git a/docs/html/guide/topics/resources/style-resource.jd b/docs/html/guide/topics/resources/style-resource.jd new file mode 100644 index 0000000..def727c --- /dev/null +++ b/docs/html/guide/topics/resources/style-resource.jd @@ -0,0 +1,128 @@ +page.title=Style Resource +parent.title=Resource Types +parent.link=available-resources.html +@jd:body + +<div id="qv-wrapper"> + <div id="qv"> + <h2>See also</h2> + <ol> + <li><a href="{@docRoot}guide/topics/ui/themes.html">Applying Styles and Themes</a></li> + </ol> + </div> +</div> + + +<p>A style resource defines the format and look for a UI. +A style can be applied to an individual {@link android.view.View} (from within a layout file) or to +an entire {@link android.app.Activity} or application (from within the manifest file).</p> + +<p>For more information about creating and applying styles, please read +<a href="{@docRoot}guide/topics/ui/themes.html">Applying Styles and Themes</a>.</p> + +<p class="note"><strong>Note:</strong> A style is a simple resource that is referenced +using the value provided in the {@code name} attribute (not the name of the XML file). As +such, you can combine style resources with other simple resources in the one XML file, +under one {@code <resources>} element.</p> + +<dl class="xml"> + +<dt>file location:</dt> +<dd><code>res/values/<em>filename</em>.xml</code><br/> +The filename is arbitrary. The element's {@code name} will be used as the resource ID.</dd> + +<dt>resource reference:</dt> +<dd> +In XML: <code>@[package:]style/<em>style_name</em></code> +</dd> + +<dt>syntax:</dt> +<dd> +<pre class="stx"> +<?xml version="1.0" encoding="utf-8"?> +<<a href="#resources-element">resources</a>> + <<a href="#style-element">style</a> + name="<em>style_name</em>" + parent="@[package:]style/<em>style_to_inherit</em>"> + <<a href="#item-element">item</a> + name="<em>[package:]style_property_name</em>" + ><em>style_value</em></item> + </style> +</resources> +</pre> +</dd> + +<dt>elements:</dt> +<dd> +<dl class="tag-list"> + + <dt id="resources-element"><code><resources></code></dt> + <dd><strong>Required.</strong> This must be the root node. + <p>No attributes.</p> + </dd> + <dt id="style-element"><code><style></code></dt> + <dd>Defines a single style. Contains {@code <item>} elements. + <p class="caps">attributes:</p> + <dl class="atn-list"> + <dt><code>name</code></dt> + <dd><em>String</em>. <strong>Required</strong>. A name for the style, which is used as the +resource ID to apply the style to a View, Activity, or application. + </dd> + <dt><code>parent</code></dt> + <dd><em>Style resource</em>. Reference to a style from which this +style should inherit style properties. + </dd> + </dl> + + </dd> + <dt id="item-element"><code><item></code></dt> + <dd>Defines a single property for the style. Must be a child of a + <code><style></code> element.</p> + <p class="caps">attributes:</p> + <dl class="atn-list"> + <dt><code>name</code></dt> + <dd><em>Attribute resource</em>. <strong>Required</strong>. The name of the style property +to be defined, with a package prefix if necessary (for example {@code android:textColor}). + </dd> + </dl> + </dd> + +</dl> +</dd> <!-- end elements and attributes --> + +<dt>example:</dt> +<dd> + <dl> + + <dt>XML file for the style (saved in <code>res/values/</code>):</dt> + <dd> +<pre> +<?xml version="1.0" encoding="utf-8"?> +<resources> + <style name="CustomText" parent="@style/Text"> + <item name="android:textSize">20sp</item> + <item name="android:textColor">#008</item> + </style> +</resources> +</pre> + </dd> + + <dt>XML file that applies the style to a {@link android.widget.TextView} + (saved in <code>res/layout/</code>):</dt> + <dd> +<pre> +<?xml version="1.0" encoding="utf-8"?> +<EditText + style="@style/CustomText" + android:layout_width="fill_parent" + android:layout_height="wrap_content" + android:text="Hello, World!" /> +</pre> + </dd> + + </dl> +</dd> <!-- end example --> + +</dl> + + |