Android/frameworks_base
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

am 91d08fe5: am 2d9063bc: docs: Add a few links and small edits to a couple layout guides

Browse Source 
* commit '91d08fe51ab43980aed3ba6c89c0611e5319c51d':
  docs: Add a few links and small edits to a couple layout guides
This commit is contained in:
Scott Main
2012-08-15 15:39:07 -07:00
committed by Android Git Automerger
parent 7ef6c20dbc 91d08fe51a
commit ccd7f59c0d
3 changed files with 21 additions and 16 deletions
Download Patch File Download Diff File Expand all files Collapse all files

26
docs/html/guide/topics/ui/declaring-layout.jd
View File

@@ -32,12 +32,17 @@ parent.link=index.html
<li>{@link android.view.ViewGroup}</li> <li>{@link android.view.ViewGroup}</li>
<li>{@link android.view.ViewGroup.LayoutParams}</li> <li>{@link android.view.ViewGroup.LayoutParams}</li>
</ol> </ol>
</div>
<h2>See also</h2>
<ol>
<li><a href="{@docRoot}training/basics/firstapp/building-ui.html">Building a Simple User
Interface</a></li> </div>
</div> </div>
<p>Your layout is the architecture for the user interface in an Activity. <p>A layout defines the visual structure for a user interface, such as the UI for an <a
It defines the layout structure and holds all the elements that appear to the user. href="{@docRoot}guide/components/activities.html">activity</a> or <a
You can declare your layout in two ways:</p> href="{@docRoot}guide/topics/appwidgets/index.html">app widget</a>.
You can declare a layout in two ways:</p>
<ul> <ul>
<li><strong>Declare UI elements in XML</strong>. Android provides a straightforward XML <li><strong>Declare UI elements in XML</strong>. Android provides a straightforward XML
vocabulary that corresponds to the View classes and subclasses, such as those for widgets and layouts.</li> vocabulary that corresponds to the View classes and subclasses, such as those for widgets and layouts.</li>
@@ -77,16 +82,6 @@ Layout Objects</a>. There are also a collection of tutorials on building various
<h2 id="write">Write the XML</h2> <h2 id="write">Write the XML</h2>
<div class="sidebox-wrapper">
<div class="sidebox">
<p>For your convenience, the API reference documentation for UI related classes
lists the available XML attributes that correspond to the class methods, including inherited
attributes.</p>
<p>To learn more about the available XML elements and attributes, as well as the format of the XML file, see <a
href="{@docRoot}guide/topics/resources/available-resources.html#layoutresources">Layout Resources</a>.</p>
</div>
</div>
<p>Using Android's XML vocabulary, you can quickly design UI layouts and the screen elements they contain, in the same way you create web pages in HTML &mdash; with a series of nested elements. </p> <p>Using Android's XML vocabulary, you can quickly design UI layouts and the screen elements they contain, in the same way you create web pages in HTML &mdash; with a series of nested elements. </p>
<p>Each layout file must contain exactly one root element, which must be a View or ViewGroup object. Once you've defined the root element, you can add additional layout objects or widgets as child elements to gradually build a View hierarchy that defines your layout. For example, here's an XML layout that uses a vertical {@link android.widget.LinearLayout} <p>Each layout file must contain exactly one root element, which must be a View or ViewGroup object. Once you've defined the root element, you can add additional layout objects or widgets as child elements to gradually build a View hierarchy that defines your layout. For example, here's an XML layout that uses a vertical {@link android.widget.LinearLayout}
@@ -111,7 +106,8 @@ to hold a {@link android.widget.TextView} and a {@link android.widget.Button}:</
<p>After you've declared your layout in XML, save the file with the <code>.xml</code> extension, <p>After you've declared your layout in XML, save the file with the <code>.xml</code> extension,
in your Android project's <code>res/layout/</code> directory, so it will properly compile. </p> in your Android project's <code>res/layout/</code> directory, so it will properly compile. </p>
<p>We'll discuss each of the attributes shown here a little later.</p> <p>More information about the syntax for a layout XML file is available in the <a
href="{@docRoot}guide/topics/resources/layout-resource.html">Layout Resources</a> document.</p>
<h2 id="load">Load the XML Resource</h2> <h2 id="load">Load the XML Resource</h2>

5
docs/html/guide/topics/ui/layout/gridview.jd
View File

@@ -22,10 +22,15 @@ two-dimensional,
scrollable grid. The grid items are automatically inserted to the layout using a {@link scrollable grid. The grid items are automatically inserted to the layout using a {@link
android.widget.ListAdapter}.</p> android.widget.ListAdapter}.</p>
<p>For an introduction to how you can dynamically insert views using an adapter, read
<a href="{@docRoot}guide/topics/ui/declaring-layout.html#AdapterViews">Building Layouts with
an Adapter</a>.</p>
<img src="{@docRoot}images/ui/gridview.png" alt="" /> <img src="{@docRoot}images/ui/gridview.png" alt="" />
<h2 id="example">Example</h2> <h2 id="example">Example</h2>
<p>In this tutorial, you'll create a grid of image thumbnails. When an item is selected, a <p>In this tutorial, you'll create a grid of image thumbnails. When an item is selected, a
toast message will display the position of the image.</p> toast message will display the position of the image.</p>

6
docs/html/guide/topics/ui/layout/listview.jd
View File

@@ -28,6 +28,10 @@ scrollable items. The list items are automatically inserted to the list using an
android.widget.Adapter} that pulls content from a source such as an array or database query and android.widget.Adapter} that pulls content from a source such as an array or database query and
converts each item result into a view that's placed into the list.</p> converts each item result into a view that's placed into the list.</p>
<p>For an introduction to how you can dynamically insert views using an adapter, read
<a href="{@docRoot}guide/topics/ui/declaring-layout.html#AdapterViews">Building Layouts with
an Adapter</a>.</p>
<img src="{@docRoot}images/ui/listview.png" alt="" /> <img src="{@docRoot}images/ui/listview.png" alt="" />
<h2 id="Loader">Using a Loader</h2> <h2 id="Loader">Using a Loader</h2>
@@ -147,5 +151,5 @@ href="{@docRoot}guide/topics/providers/contacts-provider.html">Contacts
Provider</a>, if you want to Provider</a>, if you want to
try this code, your app must request the {@link android.Manifest.permission#READ_CONTACTS} try this code, your app must request the {@link android.Manifest.permission#READ_CONTACTS}
permission in the manifest file:<br/> permission in the manifest file:<br/>
<code>&lt;uses-permission android:name="android.permission.READ_CONTACTS" /></p> <code>&lt;uses-permission android:name="android.permission.READ_CONTACTS" /></code></p>