メニュー項目

MenuItem コントロールは、MenuまたはContextMenu内で選択可能な個々の項目を表します。 MenuItem は、WPF アプリケーションのメニューシステムの基本的な構成要素であり、ユーザーがクリックまたは選択してアクションを実行する対話型要素を提供します。

メニューの使用例については、「メニュー: Exmaples」を参照してください。

Menuは、MenuItem オブジェクトのコンテナーとして機能し、次のような親子関係を確立します。

この階層関係により、単純なフラットメニューから深く入れ子になったサブメニューシステムまで、複雑なナビゲーション構造を作成できます。

MenuItem の型と動作

MenuItems では、いくつかの異なる種類の動作がサポートされています。

コマンド項目: クリックされたときに特定のコマンドを実行する MenuItems。これらは通常、 ファイル > 開く 、 またはコピー > 編集などのアクションに使用されます。

チェック可能な項目: チェックボックスと同様に、オンとオフを切り替えることができる MenuItems。この動作を有効にするには、 IsCheckable プロパティを true に設定します。

区切り記号項目: メニュー内の Separator コントロールを使用して、関連する MenuItem を視覚的にグループ化します。

サブメニュー項目: 他の MenuItem を子として含む MenuItem。クリックまたはホバーすると、サブメニューに追加のオプションが表示されます。

MenuItem の主なプロパティは次のとおりです。

重要なイベントには、 Click、 Checked、および Uncheckedが含まれます。

既定の ControlTemplate を変更して、 MenuItem コントロールに一意の外観を与えることができます。詳細については、「スタイルとテンプレートとは」および「コントロールのテンプレートを作成する方法」を参照してください。

このコントロールでは、コンテンツプロパティは定義されません。

次の表に、 MenuItem コントロールの名前付きパーツを示します。

要素	タイプ	Description
PART_Popup	Popup	サブメニュー項目を含むポップアップ。

ControlTemplateのMenuItemを作成する際に、テンプレートにはItemsPresenterがScrollViewer内に含まれている場合がある可能性があります。 ItemsPresenterは、MenuItem内の各項目を表示します。ScrollViewerはコントロール内をスクロールできるようにします。 ItemsPresenterがScrollViewerの直接の子でない場合は、ItemsPresenterItemsPresenter名前を指定する必要があります。

次の表に、 MenuItem コントロールの表示状態を示します。

VisualState 名称	VisualStateGroupの名前	Description
有効	検証状態	コントロールは有効であり、検証エラーはありません。
無効フォーカス	検証状態	コントロールに検証エラーがあり、キーボードフォーカスがあります。
フォーカスが外れた無効状態	検証状態	コントロールに検証エラーがありますが、キーボードフォーカスがありません。

このページはお役に立ちましたか?