メニューリソースは、MenuInflater
.
で膨らませることができるアプリケーションメニュー(オプションメニュー、コンテキストメニュー、またはサブメニュー)を定義しています。res/menu/filename.xml
ファイル名はリソース ID として使用されます。 コンパイルされたリソースのデータ型。Menu
(またはサブクラス) リソースへのリソースポインタ。 リソース参照。 JavaではR.menu.filename
XML の場合。@menu.filename
構文:要素。<menu>
必須。 これはルートノードでなければならない。<item>
または<group>
要素を含む。
attributes:
xmlns:android
XML名前空間。 必須。 XML 名前空間を定義します("http://schemas.android.com/apk/res/android"
である必要があります)。<item>
メニュー項目です。<menu>
要素を含むことができます (サブメニューの場合)。<menu>
または<group>
要素の子である必要があります。
attributes:
android:id
リソースID。 一意のリソースID。 この項目に対して新しいリソースIDを作成するには、form:"@+id/name"
を使用します。 プラス記号は、これがnewIDとして作成されるべきものであることを示します。android:title
文字列リソース 文字列リソースまたは生の文字列としてのメニュータイトル。android:titleCondensed
文字列リソース。 文字列リソースまたは生の文字列としての凝縮されたタイトル。 このタイトルは、通常のタイトルが長すぎる場合に使用される。android:icon
Drawableリソース。 メニューアイテムアイコンとして使用される画像。android:onClick
メソッド名。 メニュー項目がクリックされたときに呼び出されるメソッド。 メソッドはアクティビティ内で public として宣言され、クリックされた項目を示すMenuItem
を唯一のパラメータとして受け入れなければなりません。 このメソッドは、onOptionsItemSelected()
への標準コールバックより優先されます。 最下部の例を参照してください。
Warning: ProGuard (または同様のツール) を使用してコードを難読化する場合、この属性で指定するメソッドを名前の変更から除外することを確認してください。 この項目は、いつ、どのようにアプリバーにアクションアイテムとして表示されるべきかを指定します。 メニュー項目は、アクティビティにアプリバーが含まれている場合にのみ、アクションアイテムとして表示することができます。 有効な値です。
Value | Description |
---|---|
ifRoom |
Only place this item in the app bar if there is a room for it. "ifRoom" とマークされたすべての項目のためのスペースがない場合、最も低い orderInCategory 値の項目がアクションとして表示され、残りの項目はオーバーフロー メニューに表示されます。 |
withText |
アクション項目にはタイトル テキスト (android:title で定義) も含めてください。 パイプ | で区切ることにより、フラグ セットとして他の値と一緒にこの値を含めることができます。 |
never |
このアイテムをアプリ バーに配置しないでください。 |
always |
Always place this item in the app bar.Except this using its item always appear in the actionbar.If it is critical than the item is always in the actionbar. |
collapseActionView |
The action view associated with this action item (as declared by android:actionLayout orandroid:actionViewClass ) iscollapsible.The action viewは、常にアクション アイテムとして現れるよう設定することで、アプリ バーの他の UI と重なることがあります。Introduced in API Level 14. |
Adding the App Bar training class for more information.
Introduced in API Level 11.
android:actionLayout
Layout resource.Layoutを参照してください。 アクションビューとして使用するレイアウトです。
詳細はアクションビューとアクションプロバイダを参照してください。
Introduced in API Level 11.
android:actionViewClass
クラス名. アクション ビューとして使用するView
の完全修飾クラス名です。 例えば、SearchView
をアクションビューとして使用するには、"android.widget.SearchView"
とします。
詳細については、「アクション ビューおよびアクション プロバイダ」を参照してください。
警告。 ProGuard (または同様のツール) を使用してコードを難読化する場合、この属性で指定するクラスを名前の変更から除外することを確認してください。 アクションアイテムの代わりに使用する ActionProvider
の完全修飾クラス名です。 例えば、"android.widget.ShareActionProvider"
はShareActionProvider
を使用します。
詳細については、アクション ビューおよびアクション プロバイダーを参照してください。
警告。 ProGuard (または同様のツール) を使用してコードを難読化する場合、この属性で指定するクラスを名前の変更から除外することを確認してください。 アルファベットのショートカットキーに対応する文字です。 android:numericShortcut
整数。 数字ショートカットキーに対応する数字。 android:alphabeticModifiers
Keyword. メニュー項目のアルファベットショートカットの修飾語。 初期値はControlキーに相当します。 有効な値です。
値 | 説明 |
---|---|
META |
メタ・メタ・キー |
CTRL | Control メタキーに対応 |
ALT | Alt メタキーに対応 メタキー |
SHIFT | Shiftメタキー |
SYM | 対応 Symメタキー |
FUNCTION | Functionメタキー |
に対応するものです。 1つの属性に複数のキーワードを指定することができます。 たとえば、android:alphabeticModifiers="CTRL|SHIFT"
は、対応するメニュー項目をトリガーするには、ユーザーはショートカットと共に Control および Shift メタキーの両方を押す必要があることを示します。
プログラムで属性値を設定するには、setAlphabeticShortcut()
メソッドを使用できます。 alphabeticModifier
属性の詳細については、alphabeticModifiers
.
android:numericModifiers
Keywordを参照してください。 メニュー項目の数字ショートカットの修飾子です。 デフォルト値はControlキーに相当します。 有効な値です。
値 | 説明 |
---|---|
META | メタ・キー |
CTRL | Control メタキーに対応 |
ALT | Alt メタキーに対応 |
SHIFT | Shift メタキーに対応 |
SYM | Corresponding the key. Symメタキー |
FUNCTION | Functionメタキー |
に対応するものです。 1つの属性に複数のキーワードを指定することができます。 たとえば、android:numericModifiers="CTRL|SHIFT"
は、対応するメニュー項目をトリガーするには、ユーザーはショートカットと一緒に Control および Shift メタキーの両方を押す必要があることを示します。
プログラムで属性値を設定するには、setNumericShortcut()
メソッドを使用できます。 numericModifier
属性の詳細については、numericModifiers
.
android:checkable
Boolean を参照してください。 項目がチェック可能な場合、”true” を指定します。android:checked
ブール値。 項目がデフォルトでチェックされる場合、”true” となります。android:visible
Boolean。 項目がデフォルトで表示されている場合、”true” となります。android:enabled
Boolean。 デフォルトで項目が有効な場合、”true” となります。android:menuCategory
キーワード。Menu
CATEGORY_*
定数に対応する値で、アイテムの優先順位を定義します。 有効な値です。
Value | Description | ||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
container |
コンテナの一部であるアイテムについて。 | ||||||||||||||||
secondary |
ユーザーが提供するセカンダリ (使用頻度の低い) オプションの項目。 | ||||||||||||||||
alternative |
現在表示しているデータに対する代替動作の項目。 グループ内での、項目の「重要度」の順序。 <group> メニューグループ (表示可能か、有効か、チェック可能かなどの特徴を共有する項目のコレクションを作成する)。 1つ以上の<item> 要素が含まれます。 <menu> 要素の子である必要があります。
attributes:
|