Menu resource

メニューリソースは、MenuInflater.

で膨らませることができるアプリケーションメニュー(オプションメニュー、コンテキストメニュー、またはサブメニュー)を定義しています。res/menu/filename.xml
ファイル名はリソース ID として使用されます。 コンパイルされたリソースのデータ型。Menu(またはサブクラス) リソースへのリソースポインタ。 リソース参照。 JavaではR.menu.filename
XML の場合。@menu.filename構文:要素。<menu>必須。 これはルートノードでなければならない。<item>または<group>要素を含む。

attributes:

xmlns:androidXML名前空間。 必須。 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:iconDrawableリソース。 メニューアイテムアイコンとして使用される画像。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:actionLayoutLayout 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:numericModifiersKeywordを参照してください。 メニュー項目の数字ショートカットの修飾子です。 デフォルト値は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:checkableBoolean を参照してください。 項目がチェック可能な場合、”true” を指定します。android:checkedブール値。 項目がデフォルトでチェックされる場合、”true” となります。android:visibleBoolean。 項目がデフォルトで表示されている場合、”true” となります。android:enabledBoolean。 デフォルトで項目が有効な場合、”true” となります。android:menuCategoryキーワード。MenuCATEGORY_*定数に対応する値で、アイテムの優先順位を定義します。 有効な値です。

Value Description
container コンテナの一部であるアイテムについて。
secondary ユーザーが提供するセカンダリ (使用頻度の低い) オプションの項目。
alternative 現在表示しているデータに対する代替動作の項目。 グループ内での、項目の「重要度」の順序。 <group> メニューグループ (表示可能か、有効か、チェック可能かなどの特徴を共有する項目のコレクションを作成する)。 1つ以上の<item>要素が含まれます。 <menu> 要素の子である必要があります。

attributes:

android:id リソースID。 一意のリソースID。 この項目の新しいリソースIDを作成するには、:"@+id/name"の形式を使用します。 プラス記号は、これが新しいIDとして作成されるべきであることを示します。 android:checkableBehavior キーワード グループのチェック可能な動作の種類を指定します。 有効な値です。

Value Description
none チェックできません
all すべての項目がチェックできます。 チェック可能(チェックボックスを使用)
single 1項目のみチェック可能(ラジオボタンを使用)

android:visible ブール値です。 グループが表示されている場合、”true” となります。 android:enabled Boolean。 グループが有効な場合、”true” となります。 android:menuCategory キーワード。 Menu CATEGORY_* 定数に対応する値で、グループの優先順位を定義します。 有効な値です。

Value Description
container コンテナの一部であるグループ用。
secondary ユーザーが提供する二次 (頻繁に使用しない) オプションのグループ。
alternative 現在表示しているデータに対する代替措置のグループ。 カテゴリ内のアイテムのデフォルトの順序です。 res/menu/example_menu.xml に保存されたXMLファイル。

次のアプリケーション コードは、onCreateOptionsMenu(Menu) コールバックからメニューを展開し、2 つのアイテムの on-click コールバックを宣言します。

コメントを残す

メールアドレスが公開されることはありません。