attrs.xml revision 77f3ab5ca8b392cebdb565c7c2062b122d80db96
1974a07824642fabd896930f20c7b176fd2333e31George Mount<?xml version="1.0" encoding="utf-8"?>
2974a07824642fabd896930f20c7b176fd2333e31George Mount<!-- Copyright (C) 2012 The Android Open Source Project
3974a07824642fabd896930f20c7b176fd2333e31George Mount
4974a07824642fabd896930f20c7b176fd2333e31George Mount     Licensed under the Apache License, Version 2.0 (the "License");
5974a07824642fabd896930f20c7b176fd2333e31George Mount     you may not use this file except in compliance with the License.
6974a07824642fabd896930f20c7b176fd2333e31George Mount     You may obtain a copy of the License at
7974a07824642fabd896930f20c7b176fd2333e31George Mount
8974a07824642fabd896930f20c7b176fd2333e31George Mount          http://www.apache.org/licenses/LICENSE-2.0
9974a07824642fabd896930f20c7b176fd2333e31George Mount
10974a07824642fabd896930f20c7b176fd2333e31George Mount     Unless required by applicable law or agreed to in writing, software
11974a07824642fabd896930f20c7b176fd2333e31George Mount     distributed under the License is distributed on an "AS IS" BASIS,
12974a07824642fabd896930f20c7b176fd2333e31George Mount     WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13974a07824642fabd896930f20c7b176fd2333e31George Mount     See the License for the specific language governing permissions and
14974a07824642fabd896930f20c7b176fd2333e31George Mount     limitations under the License.
15974a07824642fabd896930f20c7b176fd2333e31George Mount-->
16fead9ca09b117136b35bc5bf137340a754f9edddGeorge Mount
17974a07824642fabd896930f20c7b176fd2333e31George Mount<resources>
18fead9ca09b117136b35bc5bf137340a754f9edddGeorge Mount    <!-- Many app-specific attributes are declared in this file.
19fead9ca09b117136b35bc5bf137340a754f9edddGeorge Mount         Unless otherwise specified, they are intended to be set within
20fead9ca09b117136b35bc5bf137340a754f9edddGeorge Mount         the context of a theme declaration.
21974a07824642fabd896930f20c7b176fd2333e31George Mount
22974a07824642fabd896930f20c7b176fd2333e31George Mount         Each cluster of attributes below states whether it is meant to
23974a07824642fabd896930f20c7b176fd2333e31George Mount         be set by the app and read by the system, or set by the system and
24c619d8f69127c1200103d8119101c5f0675661d0George Mount         read by the app. -->
25c619d8f69127c1200103d8119101c5f0675661d0George Mount    <eat-comment/>
26c619d8f69127c1200103d8119101c5f0675661d0George Mount
27c619d8f69127c1200103d8119101c5f0675661d0George Mount
28974a07824642fabd896930f20c7b176fd2333e31George Mount    <attr name="title" format="string"/>
29974a07824642fabd896930f20c7b176fd2333e31George Mount    <attr name="height" format="dimension"/>
30974a07824642fabd896930f20c7b176fd2333e31George Mount    <!-- Specifies whether the theme is light, otherwise it is dark. -->
31974a07824642fabd896930f20c7b176fd2333e31George Mount    <attr name="isLightTheme" format="boolean" />
32974a07824642fabd896930f20c7b176fd2333e31George Mount
33974a07824642fabd896930f20c7b176fd2333e31George Mount    <!-- These are the standard attributes that make up a complete theme. -->
34974a07824642fabd896930f20c7b176fd2333e31George Mount    <declare-styleable name="Theme">
35974a07824642fabd896930f20c7b176fd2333e31George Mount
36974a07824642fabd896930f20c7b176fd2333e31George Mount        <!-- ============= -->
37974a07824642fabd896930f20c7b176fd2333e31George Mount        <!-- Window styles -->
38974a07824642fabd896930f20c7b176fd2333e31George Mount        <!-- ============= -->
39974a07824642fabd896930f20c7b176fd2333e31George Mount        <eat-comment />
40974a07824642fabd896930f20c7b176fd2333e31George Mount
41974a07824642fabd896930f20c7b176fd2333e31George Mount        <!-- Flag indicating whether this window should have an Action Bar
42974a07824642fabd896930f20c7b176fd2333e31George Mount             in place of the usual title bar. -->
43974a07824642fabd896930f20c7b176fd2333e31George Mount        <attr name="windowActionBar" format="boolean" />
44974a07824642fabd896930f20c7b176fd2333e31George Mount
45974a07824642fabd896930f20c7b176fd2333e31George Mount        <!-- Flag indicating whether this window's Action Bar should overlay
46974a07824642fabd896930f20c7b176fd2333e31George Mount             application content. Does nothing if the window would not
47974a07824642fabd896930f20c7b176fd2333e31George Mount             have an Action Bar. -->
48974a07824642fabd896930f20c7b176fd2333e31George Mount        <attr name="windowActionBarOverlay" format="boolean" />
49974a07824642fabd896930f20c7b176fd2333e31George Mount
50974a07824642fabd896930f20c7b176fd2333e31George Mount        <!-- A fixed width for the window along the major axis of the screen,
51974a07824642fabd896930f20c7b176fd2333e31George Mount             that is, when in landscape. Can be either an absolute dimension
52974a07824642fabd896930f20c7b176fd2333e31George Mount             or a fraction of the screen size in that dimension. -->
53974a07824642fabd896930f20c7b176fd2333e31George Mount        <attr name="windowFixedWidthMajor" format="dimension|fraction" />
54974a07824642fabd896930f20c7b176fd2333e31George Mount        <!-- A fixed height for the window along the minor axis of the screen,
55974a07824642fabd896930f20c7b176fd2333e31George Mount             that is, when in landscape. Can be either an absolute dimension
56974a07824642fabd896930f20c7b176fd2333e31George Mount             or a fraction of the screen size in that dimension. -->
57974a07824642fabd896930f20c7b176fd2333e31George Mount        <attr name="windowFixedHeightMinor" format="dimension|fraction" />
58974a07824642fabd896930f20c7b176fd2333e31George Mount
59974a07824642fabd896930f20c7b176fd2333e31George Mount        <!-- A fixed width for the window along the minor axis of the screen,
60974a07824642fabd896930f20c7b176fd2333e31George Mount             that is, when in portrait. Can be either an absolute dimension
61974a07824642fabd896930f20c7b176fd2333e31George Mount             or a fraction of the screen size in that dimension. -->
62974a07824642fabd896930f20c7b176fd2333e31George Mount        <attr name="windowFixedWidthMinor" format="dimension|fraction" />
63974a07824642fabd896930f20c7b176fd2333e31George Mount        <!-- A fixed height for the window along the major axis of the screen,
64974a07824642fabd896930f20c7b176fd2333e31George Mount             that is, when in portrait. Can be either an absolute dimension
65974a07824642fabd896930f20c7b176fd2333e31George Mount             or a fraction of the screen size in that dimension. -->
66974a07824642fabd896930f20c7b176fd2333e31George Mount        <attr name="windowFixedHeightMajor" format="dimension|fraction" />
67974a07824642fabd896930f20c7b176fd2333e31George Mount
68        <attr name="android:windowIsFloating" />
69
70        <!-- =================== -->
71        <!-- Action bar styles   -->
72        <!-- =================== -->
73        <eat-comment />
74        <!-- Default style for tabs within an action bar -->
75        <attr name="actionBarTabStyle" format="reference" />
76        <attr name="actionBarTabBarStyle" format="reference" />
77        <attr name="actionBarTabTextStyle" format="reference" />
78        <attr name="actionOverflowButtonStyle" format="reference" />
79        <attr name="actionOverflowMenuStyle" format="reference" />
80        <!-- Reference to a theme that should be used to inflate popups
81             shown by widgets in the action bar. -->
82        <attr name="actionBarPopupTheme" format="reference" />
83        <!-- Reference to a style for the Action Bar -->
84        <attr name="actionBarStyle" format="reference" />
85        <!-- Reference to a style for the split Action Bar. This style
86             controls the split component that holds the menu/action
87             buttons. actionBarStyle is still used for the primary
88             bar. -->
89        <attr name="actionBarSplitStyle" format="reference" />
90        <!-- Reference to a theme that should be used to inflate the
91             action bar. This will be inherited by any widget inflated
92             into the action bar. -->
93        <attr name="actionBarTheme" format="reference" />
94        <!-- Reference to a theme that should be used to inflate widgets
95             and layouts destined for the action bar. Most of the time
96             this will be a reference to the current theme, but when
97             the action bar has a significantly different contrast
98             profile than the rest of the activity the difference
99             can become important. If this is set to @null the current
100             theme will be used.-->
101        <attr name="actionBarWidgetTheme" format="reference" />
102        <!-- Size of the Action Bar, including the contextual
103             bar used to present Action Modes. -->
104        <attr name="actionBarSize" format="dimension" >
105            <enum name="wrap_content" value="0" />
106        </attr>
107        <!-- Custom divider drawable to use for elements in the action bar. -->
108        <attr name="actionBarDivider" format="reference" />
109        <!-- Custom item state list drawable background for action bar items. -->
110        <attr name="actionBarItemBackground" format="reference" />
111        <!-- TextAppearance style that will be applied to text that
112             appears within action menu items. -->
113        <attr name="actionMenuTextAppearance" format="reference" />
114        <!-- Color for text that appears within action menu items. -->
115        <!-- Color for text that appears within action menu items. -->
116        <attr name="actionMenuTextColor" format="color|reference"/>
117
118
119        <!-- =================== -->
120        <!-- Action mode styles  -->
121        <!-- =================== -->
122        <eat-comment/>
123        <attr name="actionModeStyle" format="reference"/>
124        <attr name="actionModeCloseButtonStyle" format="reference"/>
125        <!-- Background drawable to use for action mode UI -->
126        <attr name="actionModeBackground" format="reference"/>
127        <!-- Background drawable to use for action mode UI in the lower split bar -->
128        <attr name="actionModeSplitBackground" format="reference"/>
129        <!-- Drawable to use for the close action mode button -->
130        <attr name="actionModeCloseDrawable" format="reference"/>
131        <!-- Drawable to use for the Cut action button in Contextual Action Bar -->
132        <attr name="actionModeCutDrawable" format="reference"/>
133        <!-- Drawable to use for the Copy action button in Contextual Action Bar -->
134        <attr name="actionModeCopyDrawable" format="reference"/>
135        <!-- Drawable to use for the Paste action button in Contextual Action Bar -->
136        <attr name="actionModePasteDrawable" format="reference"/>
137        <!-- Drawable to use for the Select all action button in Contextual Action Bar -->
138        <attr name="actionModeSelectAllDrawable" format="reference"/>
139        <!-- Drawable to use for the Share action button in WebView selection action modes -->
140        <attr name="actionModeShareDrawable" format="reference"/>
141        <!-- Drawable to use for the Find action button in WebView selection action modes -->
142        <attr name="actionModeFindDrawable" format="reference"/>
143        <!-- Drawable to use for the Web Search action button in WebView selection action modes -->
144        <attr name="actionModeWebSearchDrawable" format="reference"/>
145
146        <!-- PopupWindow style to use for action modes when showing as a window overlay. -->
147        <attr name="actionModePopupWindowStyle" format="reference"/>
148
149
150        <!-- =================== -->
151        <!-- Text styles -->
152        <!-- =================== -->
153        <eat-comment />
154        <!-- Text color, typeface, size, and style for the text inside of a popup menu. -->
155        <attr name="textAppearanceLargePopupMenu" format="reference"/>
156        <!-- Text color, typeface, size, and style for small text inside of a popup menu. -->
157        <attr name="textAppearanceSmallPopupMenu" format="reference"/>
158
159
160        <!-- =================== -->
161        <!-- Other widget styles -->
162        <!-- =================== -->
163        <eat-comment />
164
165        <!-- Default ActionBar dropdown style. -->
166        <attr name="actionDropDownStyle" format="reference"/>
167        <!-- The preferred item height for dropdown lists. -->
168        <attr name="dropdownListPreferredItemHeight" format="dimension"/>
169
170        <!-- Default Spinner style. -->
171        <attr name="spinnerStyle" format="reference" />
172        <!-- Default Spinner style. -->
173        <attr name="spinnerDropDownItemStyle" format="reference" />
174        <!-- Specifies a drawable to use for the 'home as up' indicator. -->
175        <attr name="homeAsUpIndicator" format="reference"/>
176
177        <!-- Default action button style. -->
178        <attr name="actionButtonStyle" format="reference"/>
179
180        <!-- A style that may be applied to horizontal LinearLayouts
181         to form a button bar. -->
182        <attr name="buttonBarStyle" format="reference"/>
183        <!-- A style that may be applied to Buttons placed within a
184             LinearLayout with the style buttonBarStyle to form a button bar. -->
185        <attr name="buttonBarButtonStyle" format="reference"/>
186        <!-- A style that may be applied to buttons or other selectable items
187             that should react to pressed and focus states, but that do not
188             have a clear visual border along the edges. -->
189        <attr name="selectableItemBackground" format="reference"/>
190        <!-- A drawable that may be used as a vertical divider between visual elements. -->
191        <attr name="dividerVertical" format="reference"/>
192        <!-- A drawable that may be used as a horizontal divider between visual elements. -->
193        <attr name="dividerHorizontal" format="reference"/>
194        <!-- Default ActivityChooserView style. -->
195        <attr name="activityChooserViewStyle" format="reference" />
196
197        <!-- Default Toolbar style. -->
198        <attr name="toolbarStyle" format="reference" />
199        <!-- Default Toolar NavigationButtonStyle -->
200        <attr name="toolbarNavigationButtonStyle" format="reference" />
201
202        <!-- Default PopupMenu style. -->
203        <attr name="popupMenuStyle" format="reference"/>
204        <!-- Default PopupWindow style. -->
205        <attr name="popupWindowStyle" format="reference" />
206
207        <!-- EditText text foreground color. -->
208        <attr name="editTextColor" format="reference|color" />
209        <!-- EditText background drawable. -->
210        <attr name="editTextBackground" format="reference" />
211
212        <!-- ============================ -->
213        <!-- SearchView styles and assets -->
214        <!-- ============================ -->
215        <eat-comment />
216        <!-- Text color, typeface, size, and style for system search result title. Defaults to primary inverse text color. -->
217        <attr name="textAppearanceSearchResultTitle" format="reference" />
218        <!-- Text color, typeface, size, and style for system search result subtitle. Defaults to primary inverse text color. -->
219        <attr name="textAppearanceSearchResultSubtitle" format="reference" />
220        <!-- Text color for urls in search suggestions, used by things like global search -->
221        <attr name="textColorSearchUrl" format="reference|color" />
222        <!-- Style for the search query widget. -->
223        <attr name="searchViewStyle" format="reference" />
224
225        <!-- =========== -->
226        <!-- List styles -->
227        <!-- =========== -->
228        <eat-comment />
229
230        <!-- The preferred list item height. -->
231        <attr name="listPreferredItemHeight" format="dimension"/>
232        <!-- A smaller, sleeker list item height. -->
233        <attr name="listPreferredItemHeightSmall" format="dimension"/>
234        <!-- A larger, more robust list item height. -->
235        <attr name="listPreferredItemHeightLarge" format="dimension"/>
236
237        <!-- The preferred padding along the left edge of list items. -->
238        <attr name="listPreferredItemPaddingLeft" format="dimension"/>
239        <!-- The preferred padding along the right edge of list items. -->
240        <attr name="listPreferredItemPaddingRight" format="dimension"/>
241
242        <!-- ListPopupWindow compatibility -->
243        <attr name="dropDownListViewStyle" format="reference"/>
244        <attr name="listPopupWindowStyle" format="reference"/>
245
246        <!-- The preferred TextAppearance for the primary text of list items. -->
247        <attr name="textAppearanceListItem" format="reference"/>
248        <!-- The preferred TextAppearance for the primary text of small list items. -->
249        <attr name="textAppearanceListItemSmall" format="reference"/>
250
251
252        <!-- ============ -->
253        <!-- Panel styles -->
254        <!-- ============ -->
255        <eat-comment />
256
257        <!-- Default Panel Menu width. -->
258        <attr name="panelMenuListWidth" format="dimension" />
259
260        <!-- Default Panel Menu style. -->
261        <attr name="panelMenuListTheme" format="reference" />
262
263        <!-- Drawable used as a background for selected list items. -->
264        <attr name="listChoiceBackgroundIndicator" format="reference" />
265
266        <!-- ============= -->
267        <!-- Color palette -->
268        <!-- ============= -->
269        <eat-comment />
270
271        <!-- The primary branding color for the app. By default, this is the color applied to the
272             action bar background. -->
273        <attr name="colorPrimary" format="color" />
274
275        <!-- Dark variant of the primary branding color. By default, this is the color applied to
276             the status bar (via statusBarColor) and navigation bar (via navigationBarColor). -->
277        <attr name="colorPrimaryDark" format="color" />
278
279        <!-- Bright complement to the primary branding color. By default, this is the color applied
280             to framework controls (via colorControlActivated). -->
281        <attr name="colorAccent" format="color" />
282
283        <!-- The color applied to framework controls in their normal state. -->
284        <attr name="colorControlNormal" format="color" />
285
286        <!-- The color applied to framework controls in their activated (ex. checked) state. -->
287        <attr name="colorControlActivated" format="color" />
288
289        <!-- The color applied to framework control highlights (ex. ripples, list selectors). -->
290        <attr name="colorControlHighlight" format="color" />
291
292        <!-- The color applied to framework buttons in their normal state. -->
293        <attr name="colorButtonNormal" format="color" />
294
295    </declare-styleable>
296
297
298    <!-- ============================================ -->
299
300    <!-- Attributes used to style the Action Bar.
301         These should be set on your theme; the default actionBarStyle will
302         propagate them to the correct elements as needed.
303
304         Please Note: when overriding attributes for an ActionBar style
305         you must specify each attribute twice: once with the "android:"
306         namespace prefix and once without. -->
307    <declare-styleable name="ActionBar">
308        <!-- The type of navigation to use. -->
309        <attr name="navigationMode">
310            <!-- Normal static title text -->
311            <enum name="normal" value="0"/>
312            <!-- The action bar will use a selection list for navigation. -->
313            <enum name="listMode" value="1"/>
314            <!-- The action bar will use a series of horizontal tabs for navigation. -->
315            <enum name="tabMode" value="2"/>
316        </attr>
317        <!-- Options affecting how the action bar is displayed. -->
318        <attr name="displayOptions">
319            <flag name="none" value="0" />
320            <flag name="useLogo" value="0x1"/>
321            <flag name="showHome" value="0x2"/>
322            <flag name="homeAsUp" value="0x4"/>
323            <flag name="showTitle" value="0x8"/>
324            <flag name="showCustom" value="0x10"/>
325            <flag name="disableHome" value="0x20"/>
326        </attr>
327        <!-- Specifies title text used for navigationMode="normal" -->
328        <attr name="title"/>
329        <!-- Specifies subtitle text used for navigationMode="normal" -->
330        <attr name="subtitle" format="string"/>
331        <!-- Specifies a style to use for title text. -->
332        <attr name="titleTextStyle" format="reference"/>
333        <!-- Specifies a style to use for subtitle text. -->
334        <attr name="subtitleTextStyle" format="reference"/>
335        <!-- Specifies the drawable used for the application icon. -->
336        <attr name="icon" format="reference"/>
337        <!-- Specifies the drawable used for the application logo. -->
338        <attr name="logo" format="reference"/>
339        <!-- Specifies the drawable used for item dividers. -->
340        <attr name="divider" format="reference"/>
341        <!-- Specifies a background drawable for the action bar. -->
342        <attr name="background" format="reference"/>
343        <!-- Specifies a background drawable for a second stacked row of the action bar. -->
344        <attr name="backgroundStacked" format="reference|color"/>
345        <!-- Specifies a background drawable for the bottom component of a split action bar. -->
346        <attr name="backgroundSplit" format="reference|color"/>
347        <!-- Specifies a layout for custom navigation. Overrides navigationMode. -->
348        <attr name="customNavigationLayout" format="reference"/>
349        <!-- Specifies a fixed height. -->
350        <attr name="height"/>
351        <!-- Specifies a layout to use for the "home" section of the action bar. -->
352        <attr name="homeLayout" format="reference"/>
353        <!-- Specifies a style resource to use for an embedded progress bar. -->
354        <attr name="progressBarStyle" format="reference"/>
355        <!-- Specifies a style resource to use for an indeterminate progress spinner. -->
356        <attr name="indeterminateProgressStyle" format="reference"/>
357        <!-- Specifies the horizontal padding on either end for an embedded progress bar. -->
358        <attr name="progressBarPadding" format="dimension"/>
359        <!-- Up navigation glyph -->
360        <attr name="homeAsUpIndicator" />
361        <!-- Specifies padding that should be applied to the left and right sides of
362             system-provided items in the bar. -->
363        <attr name="itemPadding" format="dimension"/>
364        <!-- Set true to hide the action bar on a vertical nested scroll of content. -->
365        <attr name="hideOnContentScroll" format="boolean"/>
366        <!-- Minimum inset for content views within a bar. Navigation buttons and
367             menu views are excepted. Only valid for some themes and configurations. -->
368        <attr name="contentInsetStart" format="dimension"/>
369        <!-- Minimum inset for content views within a bar. Navigation buttons and
370             menu views are excepted. Only valid for some themes and configurations. -->
371        <attr name="contentInsetEnd" format="dimension"/>
372        <!-- Minimum inset for content views within a bar. Navigation buttons and
373             menu views are excepted. Only valid for some themes and configurations. -->
374        <attr name="contentInsetLeft" format="dimension"/>
375        <!-- Minimum inset for content views within a bar. Navigation buttons and
376             menu views are excepted. Only valid for some themes and configurations. -->
377        <attr name="contentInsetRight" format="dimension"/>
378        <!-- Elevation for the action bar itself -->
379        <attr name="elevation" format="dimension" />
380        <!-- Reference to a theme that should be used to inflate popups
381             shown by widgets in the action bar. -->
382        <attr name="popupTheme" format="reference" />
383    </declare-styleable>
384
385    <!-- Valid LayoutParams for views placed in the action bar as custom views. -->
386    <declare-styleable name="ActionBarLayout">
387        <attr name="android:layout_gravity"/>
388    </declare-styleable>
389
390    <declare-styleable name="ActionMenuItemView">
391        <attr name="android:minWidth"/>
392    </declare-styleable>
393
394    <declare-styleable name="ActionMode">
395        <!-- Specifies a style to use for title text. -->
396        <attr name="titleTextStyle"/>
397        <!-- Specifies a style to use for subtitle text. -->
398        <attr name="subtitleTextStyle"/>
399        <!-- Specifies a background for the action mode bar. -->
400        <attr name="background"/>
401        <!-- Specifies a background for the split action mode bar. -->
402        <attr name="backgroundSplit"/>
403        <!-- Specifies a fixed height for the action mode bar. -->
404        <attr name="height"/>
405    </declare-styleable>
406
407    <declare-styleable name="View">
408        <!-- Sets the padding, in pixels, of the start edge; see {@link android.R.attr#padding}. -->
409        <attr name="paddingStart" format="dimension"/>
410        <!-- Sets the padding, in pixels, of the end edge; see {@link android.R.attr#padding}. -->
411        <attr name="paddingEnd" format="dimension"/>
412
413        <!-- Boolean that controls whether a view can take focus.  By default the user can not
414             move focus to a view; by setting this attribute to true the view is
415             allowed to take focus.  This value does not impact the behavior of
416             directly calling {@link android.view.View#requestFocus}, which will
417             always request focus regardless of this view.  It only impacts where
418             focus navigation will try to move focus. -->
419        <attr name="android:focusable" />
420    </declare-styleable>
421
422    <declare-styleable name="MenuView">
423        <!-- Default appearance of menu item text. -->
424        <attr name="android:itemTextAppearance"/>
425        <!-- Default horizontal divider between rows of menu items. -->
426        <attr name="android:horizontalDivider"/>
427        <!-- Default vertical divider between menu items. -->
428        <attr name="android:verticalDivider"/>
429        <!-- Default background for the menu header. -->
430        <attr name="android:headerBackground"/>
431        <!-- Default background for each menu item. -->
432        <attr name="android:itemBackground"/>
433        <!-- Default animations for the menu. -->
434        <attr name="android:windowAnimationStyle"/>
435        <!-- Default disabled icon alpha for each menu item that shows an icon. -->
436        <attr name="android:itemIconDisabledAlpha"/>
437        <!-- Whether space should be reserved in layout when an icon is missing. -->
438        <attr name="android:preserveIconSpacing"/>
439    </declare-styleable>
440    <declare-styleable name="ActionMenuView">
441        <!-- Size of padding on either end of a divider. -->
442    </declare-styleable>
443
444    <!-- Base attributes that are available to all groups. -->
445    <declare-styleable name="MenuGroup">
446
447        <!-- The ID of the group. -->
448        <attr name="android:id" />
449
450        <!-- The category applied to all items within this group.
451             (This will be or'ed with the orderInCategory attribute.) -->
452        <attr name="android:menuCategory" />
453
454        <!-- The order within the category applied to all items within this group.
455             (This will be or'ed with the category attribute.) -->
456        <attr name="android:orderInCategory" />
457
458        <!-- Whether the items are capable of displaying a check mark. -->
459        <attr name="android:checkableBehavior" />
460
461        <!-- Whether the items are shown/visible. -->
462        <attr name="android:visible" />
463
464        <!-- Whether the items are enabled. -->
465        <attr name="android:enabled" />
466
467    </declare-styleable>
468
469    <!-- Base attributes that are available to all Item objects. -->
470    <declare-styleable name="MenuItem">
471
472        <!-- The ID of the item. -->
473        <attr name="android:id" />
474
475        <!-- The category applied to the item.
476             (This will be or'ed with the orderInCategory attribute.) -->
477        <attr name="android:menuCategory" />
478
479        <!-- The order within the category applied to the item.
480             (This will be or'ed with the category attribute.) -->
481        <attr name="android:orderInCategory" />
482
483        <!-- The title associated with the item. -->
484        <attr name="android:title" />
485
486        <!-- The condensed title associated with the item.  This is used in situations where the
487             normal title may be too long to be displayed. -->
488        <attr name="android:titleCondensed" />
489
490        <!-- The icon associated with this item.  This icon will not always be shown, so
491             the title should be sufficient in describing this item. -->
492        <attr name="android:icon" />
493
494        <!-- The alphabetic shortcut key.  This is the shortcut when using a keyboard
495             with alphabetic keys. -->
496        <attr name="android:alphabeticShortcut" />
497
498        <!-- The numeric shortcut key.  This is the shortcut when using a numeric (e.g., 12-key)
499             keyboard. -->
500        <attr name="android:numericShortcut" />
501
502        <!-- Whether the item is capable of displaying a check mark. -->
503        <attr name="android:checkable" />
504
505        <!-- Whether the item is checked.  Note that you must first have enabled checking with
506             the checkable attribute or else the check mark will not appear. -->
507        <attr name="android:checked"  />
508
509        <!-- Whether the item is shown/visible. -->
510        <attr name="android:visible" />
511
512        <!-- Whether the item is enabled. -->
513        <attr name="android:enabled" />
514
515        <!-- Name of a method on the Context used to inflate the menu that will be
516             called when the item is clicked. -->
517        <attr name="android:onClick" />
518
519        <!-- How this item should display in the Action Bar, if present. -->
520        <attr name="showAsAction">
521            <!-- Never show this item in an action bar, show it in the overflow menu instead.
522                 Mutually exclusive with "ifRoom" and "always". -->
523            <flag name="never" value="0" />
524            <!-- Show this item in an action bar if there is room for it as determined
525                 by the system. Favor this option over "always" where possible.
526                 Mutually exclusive with "never" and "always". -->
527            <flag name="ifRoom" value="1" />
528            <!-- Always show this item in an actionbar, even if it would override
529                 the system's limits of how much stuff to put there. This may make
530                 your action bar look bad on some screens. In most cases you should
531                 use "ifRoom" instead. Mutually exclusive with "ifRoom" and "never". -->
532            <flag name="always" value="2" />
533            <!-- When this item is shown as an action in the action bar, show a text
534                 label with it even if it has an icon representation. -->
535            <flag name="withText" value="4" />
536            <!-- This item's action view collapses to a normal menu
537                 item. When expanded, the action view takes over a
538                 larger segment of its container. -->
539            <flag name="collapseActionView" value="8" />
540        </attr>
541
542        <!-- An optional layout to be used as an action view.
543             See {@link android.view.MenuItem#setActionView(android.view.View)}
544             for more info. -->
545        <attr name="actionLayout" format="reference" />
546
547        <!-- The name of an optional View class to instantiate and use as an
548             action view. See {@link android.view.MenuItem#setActionView(android.view.View)}
549             for more info. -->
550        <attr name="actionViewClass" format="string" />
551
552        <!-- The name of an optional ActionProvider class to instantiate an action view
553             and perform operations such as default action for that menu item.
554             See {@link android.view.MenuItem#setActionProvider(android.view.ActionProvider)}
555             for more info. -->
556        <attr name="actionProviderClass" format="string" />
557
558    </declare-styleable>
559
560    <declare-styleable name="Spinner">
561        <!-- The prompt to display when the spinner's dialog is shown. -->
562        <attr name="prompt" format="reference" />
563        <!-- Display mode for spinner options. -->
564        <attr name="spinnerMode" format="enum">
565            <!-- Spinner options will be presented to the user as a dialog window. -->
566            <enum name="dialog" value="0" />
567            <!-- Spinner options will be presented to the user as an inline dropdown
568                 anchored to the spinner widget itself. -->
569            <enum name="dropdown" value="1" />
570        </attr>
571        <!-- List selector to use for spinnerMode="dropdown" display. -->
572        <attr name="android:dropDownSelector" />
573        <!-- Background drawable to use for the dropdown in spinnerMode="dropdown". -->
574        <attr name="android:popupBackground" />
575        <!-- Vertical offset from the spinner widget for positioning the dropdown in
576             spinnerMode="dropdown". -->
577        <attr name="android:dropDownVerticalOffset" />
578        <!-- Horizontal offset from the spinner widget for positioning the dropdown
579             in spinnerMode="dropdown". -->
580        <attr name="android:dropDownHorizontalOffset" />
581        <!-- Width of the dropdown in spinnerMode="dropdown". -->
582        <attr name="android:dropDownWidth" />
583        <!-- Reference to a layout to use for displaying a prompt in the dropdown for
584             spinnerMode="dropdown". This layout must contain a TextView with the id
585             {@code @android:id/text1} to be populated with the prompt text. -->
586        <attr name="popupPromptView" format="reference" />
587        <!-- Gravity setting for positioning the currently selected item. -->
588        <attr name="android:gravity" />
589        <!-- Whether this spinner should mark child views as enabled/disabled when
590             the spinner itself is enabled/disabled. -->
591        <attr name="disableChildrenWhenDisabled" format="boolean" />
592    </declare-styleable>
593
594    <declare-styleable name="SearchView">
595        <!-- The layout to use for the search view. -->
596        <attr name="layout" format="reference" />
597        <!-- The default state of the SearchView. If true, it will be iconified when not in
598             use and expanded when clicked. -->
599        <attr name="iconifiedByDefault" format="boolean" />
600        <!-- An optional maximum width of the SearchView. -->
601        <attr name="android:maxWidth" />
602        <!-- An optional query hint string to be displayed in the empty query field. -->
603        <attr name="queryHint" format="string" />
604        <!-- The IME options to set on the query text field. -->
605        <attr name="android:imeOptions" />
606        <!-- The input type to set on the query text field. -->
607        <attr name="android:inputType" />
608        <!-- Close button icon -->
609        <attr name="closeIcon" format="reference" />
610        <!-- Go button icon -->
611        <attr name="goIcon" format="reference" />
612        <!-- Search icon -->
613        <attr name="searchIcon" format="reference" />
614        <!-- Voice button icon -->
615        <attr name="voiceIcon" format="reference" />
616        <!-- Commit icon shown in the query suggestion row -->
617        <attr name="commitIcon" format="reference" />
618        <!-- Layout for query suggestion rows -->
619        <attr name="suggestionRowLayout" format="reference" />
620        <!-- Background for the section containing the search query -->
621        <attr name="queryBackground" format="reference" />
622        <!-- Background for the section containing the action (e.g. voice search) -->
623        <attr name="submitBackground" format="reference" />
624    </declare-styleable>
625
626    <!-- Attrbitutes for a ActivityChooserView. -->
627    <declare-styleable name="ActivityChooserView">
628        <!-- The maximal number of items initially shown in the activity list. -->
629        <attr name="initialActivityCount" format="string" />
630        <!-- The drawable to show in the button for expanding the activities overflow popup.
631             <strong>Note:</strong> Clients would like to set this drawable
632             as a clue about the action the chosen activity will perform. For
633             example, if share activity is to be chosen the drawable should
634             give a clue that sharing is to be performed.
635         -->
636        <attr name="expandActivityOverflowButtonDrawable" format="reference" />
637    </declare-styleable>
638
639    <declare-styleable name="CompatTextView">
640        <!-- Present the text in ALL CAPS. This may use a small-caps form when available. -->
641        <attr name="textAllCaps" format="reference|boolean" />
642    </declare-styleable>
643
644    <declare-styleable name="LinearLayoutCompat">
645        <!-- Should the layout be a column or a row?  Use "horizontal"
646             for a row, "vertical" for a column.  The default is
647             horizontal. -->
648        <attr name="android:orientation" />
649        <attr name="android:gravity" />
650        <!-- When set to false, prevents the layout from aligning its children's
651             baselines. This attribute is particularly useful when the children
652             use different values for gravity. The default value is true. -->
653        <attr name="android:baselineAligned" />
654        <!-- When a linear layout is part of another layout that is baseline
655          aligned, it can specify which of its children to baseline align to
656          (that is, which child TextView).-->
657        <attr name="android:baselineAlignedChildIndex" />
658        <!-- Defines the maximum weight sum. If unspecified, the sum is computed
659             by adding the layout_weight of all of the children. This can be
660             used for instance to give a single child 50% of the total available
661             space by giving it a layout_weight of 0.5 and setting the weightSum
662             to 1.0. -->
663        <attr name="android:weightSum" />
664        <!-- When set to true, all children with a weight will be considered having
665             the minimum size of the largest child. If false, all children are
666             measured normally. -->
667        <attr name="measureWithLargestChild" format="boolean" />
668        <!-- Drawable to use as a vertical divider between buttons. -->
669        <attr name="divider" />
670        <!-- Setting for which dividers to show. -->
671        <attr name="showDividers">
672            <flag name="none" value="0" />
673            <flag name="beginning" value="1" />
674            <flag name="middle" value="2" />
675            <flag name="end" value="4" />
676        </attr>
677        <!-- Size of padding on either end of a divider. -->
678        <attr name="dividerPadding" format="dimension" />
679    </declare-styleable>
680
681    <declare-styleable name="LinearLayoutCompat_Layout">
682        <attr name="android:layout_width" />
683        <attr name="android:layout_height" />
684        <attr name="android:layout_weight" />
685        <attr name="android:layout_gravity" />
686    </declare-styleable>
687
688    <declare-styleable name="Toolbar">
689        <attr name="titleTextAppearance" format="reference" />
690        <attr name="subtitleTextAppearance" format="reference" />
691        <attr name="title" />
692        <attr name="subtitle" />
693        <attr name="android:gravity" />
694        <attr name="titleMargins" format="dimension" />
695        <attr name="titleMarginStart" format="dimension" />
696        <attr name="titleMarginEnd" format="dimension" />
697        <attr name="titleMarginTop" format="dimension" />
698        <attr name="titleMarginBottom" format="dimension" />
699        <attr name="contentInsetStart" />
700        <attr name="contentInsetEnd" />
701        <attr name="contentInsetLeft" />
702        <attr name="contentInsetRight" />
703        <attr name="maxButtonHeight" format="dimension" />
704
705        <!-- Use Theme toolbarNavigationButtonStyle instead -->
706        <!-- <attr name="navigationButtonStyle" format="reference" /> -->
707
708        <attr name="buttonGravity">
709            <!-- Push object to the top of its container, not changing its size. -->
710            <flag name="top" value="0x30" />
711            <!-- Push object to the bottom of its container, not changing its size. -->
712            <flag name="bottom" value="0x50" />
713        </attr>
714        <attr name="collapseIcon" format="reference" />
715        <!-- Reference to a theme that should be used to inflate popups
716             shown by widgets in the toolbar. -->
717        <attr name="popupTheme" />
718    </declare-styleable>
719
720    <declare-styleable name="PopupWindowBackgroundState">
721        <!-- State identifier indicating the popup will be above the anchor. -->
722        <attr name="state_above_anchor" format="boolean" />
723    </declare-styleable>
724
725</resources>
726