Andy De George
da363692ff
* Reset branch for WPF changes * Convert BMP to PNG; fix link-out-of-scope err * Add snippets for WPF... 6794 files!!!! * Add missing snippets * update file updated between migration * Fix paths to include * update breadcrumb and toc * fix index links * fix index links * fix index links * fix markdown
5.7 KiB
title, description, ms.date, helpviewer_keywords, ms.assetid
| title | description | ms.date | helpviewer_keywords | ms.assetid | ||||||
|---|---|---|---|---|---|---|---|---|---|---|
| Menu Styles and Templates | Learn about styles and templates for the Windows Presentation Foundation the Menu control. Modify the ControlTemplate to give the control a unique appearance. | 03/30/2017 |
|
b89da183-9b87-42c6-ac53-731a42c7b09e |
Menu Styles and Templates
This topic describes the styles and templates for the xref:System.Windows.Controls.Menu control. You can modify the default xref:System.Windows.Controls.ControlTemplate to give the control a unique appearance. For more information, see Create a template for a control.
Menu Parts
The xref:System.Windows.Controls.Menu control does not have any named parts.
When you create a xref:System.Windows.Controls.ControlTemplate for a xref:System.Windows.Controls.Menu, your template might contain an xref:System.Windows.Controls.ItemsPresenter within a xref:System.Windows.Controls.ScrollViewer. (The xref:System.Windows.Controls.ItemsPresenter displays each item in the xref:System.Windows.Controls.Menu; the xref:System.Windows.Controls.ScrollViewer enables scrolling within the control). If the xref:System.Windows.Controls.ItemsPresenter is not the direct child of the xref:System.Windows.Controls.ScrollViewer, you must give the xref:System.Windows.Controls.ItemsPresenter the name, ItemsPresenter.
Menu States
The following table lists the visual states for the xref:System.Windows.Controls.Menu control.
| VisualState Name | VisualStateGroup Name | Description |
|---|---|---|
| Valid | ValidationStates | The control uses the xref:System.Windows.Controls.Validation class and the xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=nameWithType attached property is false. |
| InvalidFocused | ValidationStates | The xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=nameWithType attached property is true has the control has focus. |
| InvalidUnfocused | ValidationStates | The xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=nameWithType attached property is true has the control does not have focus. |
MenuItem Parts
The following table lists the named parts for the xref:System.Windows.Controls.Menu control.
| Part | Type | Description |
|---|---|---|
| PART_Popup | xref:System.Windows.Controls.Primitives.Popup | The area for the submenu. |
When you create a xref:System.Windows.Controls.ControlTemplate for a xref:System.Windows.Controls.MenuItem, your template might contain an xref:System.Windows.Controls.ItemsPresenter within a xref:System.Windows.Controls.ScrollViewer. (The xref:System.Windows.Controls.ItemsPresenter displays each item in the xref:System.Windows.Controls.MenuItem; the xref:System.Windows.Controls.ScrollViewer enables scrolling within the control). If the xref:System.Windows.Controls.ItemsPresenter is not the direct child of the xref:System.Windows.Controls.ScrollViewer, you must give the xref:System.Windows.Controls.ItemsPresenter the name, ItemsPresenter.
MenuItem States
The following table lists the visual states for the xref:System.Windows.Controls.MenuItem control.
| VisualState Name | VisualStateGroup Name | Description |
|---|---|---|
| Valid | ValidationStates | The control uses the xref:System.Windows.Controls.Validation class and the xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=nameWithType attached property is false. |
| InvalidFocused | ValidationStates | The xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=nameWithType attached property is true has the control has focus. |
| InvalidUnfocused | ValidationStates | The xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=nameWithType attached property is true has the control does not have focus. |
Menu and MenuItem ControlTemplate Example
The following example shows how to define a xref:System.Windows.Controls.ControlTemplate for the xref:System.Windows.Controls.Menu control.
[!code-xamlControlTemplateExamples#Menu]
The following example shows how to define a xref:System.Windows.Controls.ControlTemplate for the xref:System.Windows.Controls.MenuItem control.
[!code-xamlControlTemplateExamples#MenuItem]
The following example defines the MenuScrollViewer, which is used in the previous example.
[!code-xamlControlTemplateExamples#MenuScrollViewer]
The xref:System.Windows.Controls.ControlTemplate examples use one or more of the following resources.
[!code-xamlControlTemplateExamples#Resources]
For the complete sample, see Styling with ControlTemplates Sample.