diff options
Diffstat (limited to 'docs/html/guide/topics/manifest/action-element.jd')
-rw-r--r-- | docs/html/guide/topics/manifest/action-element.jd | 46 |
1 files changed, 46 insertions, 0 deletions
diff --git a/docs/html/guide/topics/manifest/action-element.jd b/docs/html/guide/topics/manifest/action-element.jd new file mode 100644 index 0000000..bc2e1d3 --- /dev/null +++ b/docs/html/guide/topics/manifest/action-element.jd @@ -0,0 +1,46 @@ +page.title=<action> +@jd:body + +<dl class="xml"> +<dt>syntax:</dt> +<dd><pre class="stx"><action android:<a href="#nm">name</a>="<i>string</i>" /></pre></dd> + +<dt>contained in:</dt> +<dd><code><a href="{@docRoot}guide/topics/manifest/intent-filter-element.html"><intent-filter></a></code></dd> + +<p> +<dt>description:</dt> +<dd>Adds an action to an intent filter. +An <code><a href="{@docRoot}guide/topics/manifest/intent-filter-element.html"><intent-filter></a></code> element must contain +one or more {@code <action>} elements. If it doesn't contain any, no +Intent objects will get through the filter. See +<a href="{@docRoot}guide/topics/intents/intents-filters.html">Intents and +Intent Filters</a> for details on intent filters and the role of action +specifications within a filter. +</dd> + +<dt>attributes:</dt> +<dd><dl class="attr"> +<dt><a name="nm"></a>{@code android:name}</dt> +<dd>The name of the action. Some standard actions are defined in the +{@link android.content.Intent#ACTION_CHOOSER Intent} class as +{@code ACTION_<i>string</i>} constants. To assign one of these actions to +this attribute, prepend "{@code android.intent.action.}" to the +{@code <i>string</i>} that follows {@code ACTION_}. +For example, for {@code ACTION_MAIN}, use "{@code android.intent.action.MAIN}" +and for {@code ACTION_WEB_SEARCH}, use "{@code android.intent.action.WEB_SEARCH}". + +<p> +For actions you define, it's best to use the package name as a prefix to +ensure uniqueness. For example, a {@code TRANSMOGRIFY} action might be specified +as follows: +</p> + +<pre><action android:name="com.example.project.TRANSMOGRIFY" /></pre> +</dd> +</dl></dd> + +<dt>see also:</dt> +<dd><code><a href="{@docRoot}guide/topics/manifest/intent-filter-element.html"><intent-filter></a></code></dd> + +</dl>
\ No newline at end of file |