ContextMenuService Classe

Definição

Fornece a implementação do sistema para exibir um 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
Herança
ContextMenuService

Exemplos

O exemplo a seguir atribui o mesmo ContextMenu a dois botões e define as HasDropShadowPropriedades, Placement, PlacementRectangle, HorizontalOffsete VerticalOffset para definir as ContextMenu diferentes posições para cada botão.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>

O exemplo a seguir mostra como usar o serviço para exibir um ContextMenu em um botão desabilitado.The following example shows how to use the service to display a ContextMenu on a disabled button. Observe que você definiu ShowOnDisabled a propriedade no botão que é o pai do menu de contexto.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>

Comentários

A ContextMenuService classe fornece propriedades anexadas que podem ser usadas para especificar a aparência e a posição de um menu de contexto.The ContextMenuService class provides attached properties that can be used to specify the appearance and position of a context menu. Muitas das propriedades na ContextMenuService classe também são definidas ContextMenupelo.Many of the properties in the ContextMenuService class are also defined by the ContextMenu. Às vezes, é mais conveniente definir as propriedades usando a ContextMenuService classe do que definindo as propriedades em um. ContextMenuSometimes it is more convenient to set the properties by using the ContextMenuService class than by setting the properties on a ContextMenu. Por exemplo, você pode criar um ContextMenu para ser compartilhado por vários elementos, mas usar a ContextMenuService classe para especificar ContextMenu uma posição diferente do elemento for each.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. As propriedades a seguir são definidas pelas ContextMenu classes ContextMenuService e.The following properties are defined by the ContextMenu and ContextMenuService classes. Se qualquer uma dessas propriedades for definida no ContextMenu e no ContextMenuService, ContextMenuService o valor da Propriedade do será usado.If any of these properties are set on both ContextMenu and the ContextMenuService, the property value from the ContextMenuService is used.

Você também pode usar o ContextMenuService para exibir menus em itens desabilitados.You can also use the ContextMenuService to display menus on disabled items.

Campos

ContextMenuClosingEvent

Identifica o evento roteado ContextMenuClosing.Identifies the ContextMenuClosing routed event.

ContextMenuOpeningEvent

Identifica o evento ContextMenuOpening anexado.Identifies the ContextMenuOpening attached event.

ContextMenuProperty

Identifica a propriedade ContextMenu anexada.Identifies the ContextMenu attached property.

HasDropShadowProperty

Identifica a propriedade HasDropShadow anexada.Identifies the HasDropShadow attached property.

HorizontalOffsetProperty

Identifica a propriedade HorizontalOffset anexada.Identifies the HorizontalOffset attached property.

IsEnabledProperty

Identifica a propriedade IsEnabled anexada.Identifies the IsEnabled attached property.

PlacementProperty

Identifica a propriedade Placement anexada.Identifies the Placement attached property.

PlacementRectangleProperty

Identifica a propriedade PlacementRectangle anexada.Identifies the PlacementRectangle attached property.

PlacementTargetProperty

Identifica a propriedade PlacementTarget anexada.Identifies the PlacementTarget attached property.

ShowOnDisabledProperty

Identifica a propriedade ShowOnDisabled anexada.Identifies the ShowOnDisabled attached property.

VerticalOffsetProperty

Identifica a propriedade VerticalOffset anexada.Identifies the VerticalOffset attached property.

Propriedades Anexadas

ContextMenu

Obtém ou define o conteúdo de um ContextMenu.Gets or sets the content of a ContextMenu.

HasDropShadow

Obtém ou define um valor que indica se o ContextMenu tem o efeito de sombra habilitado.Gets or sets a value that indicates whether the ContextMenu has the drop shadow effect enabled.

HorizontalOffset

Obtém ou define um valor que indica onde na direção x colocar o ContextMenu em relação ao controle pai.Gets or sets a value that indicates where along the x-direction to place the ContextMenu with respect to the parent control.

IsEnabled

Obtém ou define um valor que indica se o ContextMenu pode ser mostrado.Gets or sets a value that indicates whether the ContextMenu can be shown.

Placement

Obtém ou define um valor que especifica o posicionamento do ContextMenu relativo a PlacementTarget ou PlacementRectangle.Gets or sets a value that specifies the placement of the ContextMenu relative to the PlacementTarget or PlacementRectangle.

PlacementRectangle

Obtém ou define a área em relação à qual o menu de contexto está posicionado ao abrir.Gets or sets the area relative to which the context menu is positioned when it opens.

PlacementTarget

Obtém ou define o controle pai do ContextMenu.Gets or sets the parent control of the ContextMenu.

ShowOnDisabled

Obtém ou define um valor que indica se o ContextMenu deve ser mostrado quando seu pai está esmaecido.Gets or sets a value that indicates whether the ContextMenu should be shown when its parent is grayed out.

VerticalOffset

Obtém ou define um valor que indica onde na direção y colocar o ContextMenu em relação ao controle pai.Gets or sets a value that indicates where along the y-direction to place the ContextMenu with respect to the parent control.

Métodos

AddContextMenuClosingHandler(DependencyObject, ContextMenuEventHandler)

Adiciona um manipulador para o evento anexado ContextMenuClosing .Adds a handler for the ContextMenuClosing attached event.

AddContextMenuOpeningHandler(DependencyObject, ContextMenuEventHandler)

Adiciona um manipulador ao evento anexado ContextMenuOpening.Adds a handler for the ContextMenuOpening attached event.

GetContextMenu(DependencyObject)

Obtém o valor da propriedade ContextMenu do objeto especificado.Gets the value of the ContextMenu property of the specified object.

GetHasDropShadow(DependencyObject)

Obtém um valor que indica se o ContextMenu tem uma sombra.Gets a value that indicates whether the ContextMenu has a drop shadow.

GetHorizontalOffset(DependencyObject)

Obtém o valor da propriedade HorizontalOffset do objeto especificado.Gets the value of the HorizontalOffset property of the specified object.

GetIsEnabled(DependencyObject)

Obtém o valor da propriedade IsEnabled do objeto especificado.Gets the value of the IsEnabled property of the specified object.

GetPlacement(DependencyObject)

Obtém o valor da propriedade Placement do objeto especificado.Gets the value of the Placement property of the specified object.

GetPlacementRectangle(DependencyObject)

Obtém o valor da propriedade PlacementRectangle do objeto especificado.Gets the value of the PlacementRectangle property of the specified object.

GetPlacementTarget(DependencyObject)

Obtém o valor da propriedade PlacementTarget do objeto especificado.Gets the value of the PlacementTarget property of the specified object.

GetShowOnDisabled(DependencyObject)

Obtém o valor da propriedade ShowOnDisabled do objeto especificado.Gets the value of the ShowOnDisabled property of the specified object.

GetVerticalOffset(DependencyObject)

Obtém o valor da propriedade VerticalOffset do objeto especificado.Gets the value of the VerticalOffset property of the specified object.

RemoveContextMenuClosingHandler(DependencyObject, ContextMenuEventHandler)

Remove um manipulador para o evento anexado ContextMenuClosing.Removes a handler for the ContextMenuClosing attached event.

RemoveContextMenuOpeningHandler(DependencyObject, ContextMenuEventHandler)

Remove um manipulador para o evento anexado ContextMenuOpening.Removes a handler for the ContextMenuOpening attached event.

SetContextMenu(DependencyObject, ContextMenu)

Define o valor da propriedade ContextMenu do objeto especificado.Sets the value of the ContextMenu property of the specified object.

SetHasDropShadow(DependencyObject, Boolean)

Define um valor que indica se o ContextMenu tem uma sombra.Sets a value that indicates whether the ContextMenu has a drop shadow.

SetHorizontalOffset(DependencyObject, Double)

Define o valor da propriedade HorizontalOffset do objeto especificado.Sets the value of the HorizontalOffset property of the specified object.

SetIsEnabled(DependencyObject, Boolean)

Define o valor da propriedade IsEnabled do objeto especificado.Sets the value of the IsEnabled property of the specified object.

SetPlacement(DependencyObject, PlacementMode)

Define o valor da propriedade Placement do objeto especificado.Sets the value of the Placement property of the specified object.

SetPlacementRectangle(DependencyObject, Rect)

Define o valor da propriedade PlacementRectangle do objeto especificado.Sets the value of the PlacementRectangle property of the specified object.

SetPlacementTarget(DependencyObject, UIElement)

Define o valor da propriedade PlacementTarget do objeto especificado.Sets the value of the PlacementTarget property of the specified object.

SetShowOnDisabled(DependencyObject, Boolean)

Define o valor da propriedade ShowOnDisabled do objeto especificado.Sets the value of the ShowOnDisabled property of the specified object.

SetVerticalOffset(DependencyObject, Double)

Define o valor da propriedade VerticalOffset do objeto especificado.Sets the value of the VerticalOffset property of the specified object.

Eventos Anexados

ContextMenuClosing

Ocorre quando o ContextMenu é fechado.Occurs when the ContextMenu closes.

ContextMenuOpening

Ocorre quando o ContextMenu é aberto.Occurs when the ContextMenu opens.

Aplica-se a

Veja também