ContextMenuService Класс

Определение

Предоставляет системную реализацию для отображения объекта ContextMenu.Provides the system implementation for displaying a ContextMenu.

public ref class ContextMenuService abstract sealed
public static class ContextMenuService
type ContextMenuService = class
Public Class ContextMenuService
Наследование
ContextMenuService

Примеры

В следующем примере один и тот же ContextMenu назначается двум кнопкам и устанавливаются свойства HasDropShadow, Placement, PlacementRectangle, HorizontalOffsetи VerticalOffset, чтобы задать для ContextMenu различные позиции для каждой кнопки.The following example assigns the same ContextMenu to two buttons and sets the HasDropShadow, Placement, PlacementRectangle, HorizontalOffset, and VerticalOffset properties to set the ContextMenu to different positions for each button.

<StackPanel>
  <StackPanel.Resources>
    <ContextMenu x:Key="myContextMenu">
      <MenuItem Header="Item"/>
    </ContextMenu>
  </StackPanel.Resources>

  <!--Both buttons use the same ContextMenu but use the
    properties on ContextMenuService to position them
    differently.-->
  <Button ContextMenu="{StaticResource myContextMenu}" 
          ContextMenuService.HasDropShadow="False" 
          ContextMenuService.Placement="Relative"
          ContextMenuService.HorizontalOffset="50"
          ContextMenuService.VerticalOffset="-10">
    button 1
  </Button>

  <Button ContextMenu="{StaticResource myContextMenu}" 
          ContextMenuService.HasDropShadow="True"
          ContextMenuService.Placement="Right"
          ContextMenuService.PlacementRectangle="0,0,30,30">
    button 2
  </Button>
</StackPanel>

В следующем примере показано, как использовать службу для отображения ContextMenu на отключенной кнопке.The following example shows how to use the service to display a ContextMenu on a disabled button. Обратите внимание, что свойство ShowOnDisabled задается на кнопке, которая является родителем контекстного меню.Notice that you set the ShowOnDisabled property on the button that is the parent of the context menu.

<Button Height="30" Content="Disabled Button" IsEnabled="False" 
     ContextMenuService.ShowOnDisabled="True">
  <Button.ContextMenu>
    <ContextMenu>
      <MenuItem Header="Item 1"/>
      <MenuItem Header="Item 2"/>
      <MenuItem Header="Item 3"/>
    </ContextMenu>
  </Button.ContextMenu>
</Button>

Комментарии

Класс ContextMenuService предоставляет вложенные свойства, которые можно использовать для указания внешнего вида и расположения контекстного меню.The ContextMenuService class provides attached properties that can be used to specify the appearance and position of a context menu. Многие свойства класса ContextMenuService также определяются ContextMenu.Many of the properties in the ContextMenuService class are also defined by the ContextMenu. Иногда удобнее устанавливать свойства с помощью класса ContextMenuService, чем устанавливать свойства ContextMenu.Sometimes it is more convenient to set the properties by using the ContextMenuService class than by setting the properties on a ContextMenu. Например, можно создать ContextMenu, который будет совместно использоваться несколькими элементами, но используйте класс ContextMenuService, чтобы указать другое расположение ContextMenu для каждого элемента.For example, you can create a ContextMenu to be shared by multiple elements, but use the ContextMenuService class to specify a different position of the ContextMenu for each element. Следующие свойства определяются классами ContextMenu и ContextMenuService.The following properties are defined by the ContextMenu and ContextMenuService classes. Если какое-либо из этих свойств задано как для ContextMenu, так и для ContextMenuService, используется значение свойства ContextMenuService.If any of these properties are set on both ContextMenu and the ContextMenuService, the property value from the ContextMenuService is used.

Можно также использовать ContextMenuService для показа меню в отключенных элементах.You can also use the ContextMenuService to display menus on disabled items.

Поля

ContextMenuClosingEvent

Идентифицирует направленное событие ContextMenuClosing.Identifies the ContextMenuClosing routed event.

ContextMenuOpeningEvent

Идентифицирует присоединенное событие ContextMenuOpening.Identifies the ContextMenuOpening attached event.

ContextMenuProperty

Идентифицирует присоединенное свойство ContextMenu.Identifies the ContextMenu attached property.

HasDropShadowProperty

Идентифицирует присоединенное свойство HasDropShadow.Identifies the HasDropShadow attached property.

HorizontalOffsetProperty

Идентифицирует присоединенное свойство HorizontalOffset.Identifies the HorizontalOffset attached property.

IsEnabledProperty

Идентифицирует присоединенное свойство IsEnabled.Identifies the IsEnabled attached property.

PlacementProperty

Идентифицирует присоединенное свойство Placement.Identifies the Placement attached property.

PlacementRectangleProperty

Идентифицирует присоединенное свойство PlacementRectangle.Identifies the PlacementRectangle attached property.

PlacementTargetProperty

Идентифицирует присоединенное свойство PlacementTarget.Identifies the PlacementTarget attached property.

ShowOnDisabledProperty

Идентифицирует присоединенное свойство ShowOnDisabled.Identifies the ShowOnDisabled attached property.

VerticalOffsetProperty

Идентифицирует присоединенное свойство VerticalOffset.Identifies the VerticalOffset attached property.

Присоединенные свойства

ContextMenu

Получает или задает содержимое объекта ContextMenu.Gets or sets the content of a ContextMenu.

HasDropShadow

Получает или задает значение, показывающее, включен ли для объекта ContextMenu эффект тени.Gets or sets a value that indicates whether the ContextMenu has the drop shadow effect enabled.

HorizontalOffset

Получает или задает значение, показывающее, где располагается объект ContextMenu вдоль x-направления по отношению к родительскому элементу управления.Gets or sets a value that indicates where along the x-direction to place the ContextMenu with respect to the parent control.

IsEnabled

Получает или задает значение, указывающее, может ли отображаться объект ContextMenu.Gets or sets a value that indicates whether the ContextMenu can be shown.

Placement

Получает или задает значение, показывающее расположение объекта ContextMenu относительно PlacementTarget или PlacementRectangle.Gets or sets a value that specifies the placement of the ContextMenu relative to the PlacementTarget or PlacementRectangle.

PlacementRectangle

Получает или задает область, относительно которой позиционируется контекстное меню при открытии.Gets or sets the area relative to which the context menu is positioned when it opens.

PlacementTarget

Получает или задает родительский элемент управления для объекта ContextMenu.Gets or sets the parent control of the ContextMenu.

ShowOnDisabled

Получает или задает значение, показывающее, должен ли отображаться объект ContextMenu, когда его родительский элемент становится недоступным.Gets or sets a value that indicates whether the ContextMenu should be shown when its parent is grayed out.

VerticalOffset

Получает или задает значение, показывающее, где располагается объект ContextMenu вдоль y-направления по отношению к родительскому элементу управления.Gets or sets a value that indicates where along the y-direction to place the ContextMenu with respect to the parent control.

Методы

AddContextMenuClosingHandler(DependencyObject, ContextMenuEventHandler)

Добавляет обработчик для вложенного события ContextMenuClosing.Adds a handler for the ContextMenuClosing attached event.

AddContextMenuOpeningHandler(DependencyObject, ContextMenuEventHandler)

Добавляет обработчик для вложенного события ContextMenuOpening.Adds a handler for the ContextMenuOpening attached event.

GetContextMenu(DependencyObject)

Возвращает значение свойства ContextMenu указанного объекта.Gets the value of the ContextMenu property of the specified object.

GetHasDropShadow(DependencyObject)

Получает значение, показывающее, имеет ли объект ContextMenu тень.Gets a value that indicates whether the ContextMenu has a drop shadow.

GetHorizontalOffset(DependencyObject)

Возвращает значение свойства HorizontalOffset указанного объекта.Gets the value of the HorizontalOffset property of the specified object.

GetIsEnabled(DependencyObject)

Возвращает значение свойства IsEnabled указанного объекта.Gets the value of the IsEnabled property of the specified object.

GetPlacement(DependencyObject)

Возвращает значение свойства Placement указанного объекта.Gets the value of the Placement property of the specified object.

GetPlacementRectangle(DependencyObject)

Возвращает значение свойства PlacementRectangle указанного объекта.Gets the value of the PlacementRectangle property of the specified object.

GetPlacementTarget(DependencyObject)

Возвращает значение свойства PlacementTarget указанного объекта.Gets the value of the PlacementTarget property of the specified object.

GetShowOnDisabled(DependencyObject)

Возвращает значение свойства ShowOnDisabled указанного объекта.Gets the value of the ShowOnDisabled property of the specified object.

GetVerticalOffset(DependencyObject)

Возвращает значение свойства VerticalOffset указанного объекта.Gets the value of the VerticalOffset property of the specified object.

RemoveContextMenuClosingHandler(DependencyObject, ContextMenuEventHandler)

Удаляет обработчик присоединенного события ContextMenuClosing .Removes a handler for the ContextMenuClosing attached event.

RemoveContextMenuOpeningHandler(DependencyObject, ContextMenuEventHandler)

Удаляет обработчик для вложенного события ContextMenuOpening.Removes a handler for the ContextMenuOpening attached event.

SetContextMenu(DependencyObject, ContextMenu)

Задает значение свойства ContextMenu указанного объекта.Sets the value of the ContextMenu property of the specified object.

SetHasDropShadow(DependencyObject, Boolean)

Задает значение, показывающее, имеет ли объект ContextMenu тень.Sets a value that indicates whether the ContextMenu has a drop shadow.

SetHorizontalOffset(DependencyObject, Double)

Задает значение свойства HorizontalOffset указанного объекта.Sets the value of the HorizontalOffset property of the specified object.

SetIsEnabled(DependencyObject, Boolean)

Задает значение свойства IsEnabled указанного объекта.Sets the value of the IsEnabled property of the specified object.

SetPlacement(DependencyObject, PlacementMode)

Задает значение свойства Placement указанного объекта.Sets the value of the Placement property of the specified object.

SetPlacementRectangle(DependencyObject, Rect)

Задает значение свойства PlacementRectangle указанного объекта.Sets the value of the PlacementRectangle property of the specified object.

SetPlacementTarget(DependencyObject, UIElement)

Задает значение свойства PlacementTarget указанного объекта.Sets the value of the PlacementTarget property of the specified object.

SetShowOnDisabled(DependencyObject, Boolean)

Задает значение свойства ShowOnDisabled указанного объекта.Sets the value of the ShowOnDisabled property of the specified object.

SetVerticalOffset(DependencyObject, Double)

Задает значение свойства VerticalOffset указанного объекта.Sets the value of the VerticalOffset property of the specified object.

Присоединенные события

ContextMenuClosing

Происходит при закрытии элемента ContextMenu.Occurs when the ContextMenu closes.

ContextMenuOpening

Возникает при открытии ContextMenu.Occurs when the ContextMenu opens.

Применяется к

Дополнительно