ContextMenuService Classe

Definizione

Fornisce un'implementazione di file system per la visualizzazione di una classe 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
Ereditarietà
ContextMenuService

Esempi

Nell'esempio seguente viene assegnato lo stesso ContextMenu a due pulsanti e vengono HasDropShadowimpostate le Placementproprietà PlacementRectangle, HorizontalOffset ContextMenu ,, VerticalOffset e per impostare su posizioni diverse per ogni pulsante.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>

Nell'esempio seguente viene illustrato come utilizzare il servizio per visualizzare un ContextMenu oggetto in un pulsante disabilitato.The following example shows how to use the service to display a ContextMenu on a disabled button. Si noti che è possibile ShowOnDisabled impostare la proprietà sul pulsante padre del menu di scelta rapida.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>

Commenti

La ContextMenuService classe fornisce proprietà associate che possono essere utilizzate per specificare l'aspetto e la posizione di un menu di scelta rapida.The ContextMenuService class provides attached properties that can be used to specify the appearance and position of a context menu. Molte delle proprietà ContextMenuService della classe sono definite anche ContextMenuda.Many of the properties in the ContextMenuService class are also defined by the ContextMenu. A volte è più pratico impostare le proprietà usando la ContextMenuService classe anziché impostando le proprietà in un oggetto. ContextMenuSometimes it is more convenient to set the properties by using the ContextMenuService class than by setting the properties on a ContextMenu. Ad esempio, è possibile creare un ContextMenu oggetto da condividere con più elementi, ma usare la ContextMenuService classe per specificare ContextMenu una posizione diversa per ogni elemento.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. Le seguenti proprietà sono definite dalle ContextMenu classi e. ContextMenuServiceThe following properties are defined by the ContextMenu and ContextMenuService classes. Se una di queste proprietà viene impostata sia ContextMenu in ContextMenuServiceche in, ContextMenuService viene utilizzato il valore della proprietà da.If any of these properties are set on both ContextMenu and the ContextMenuService, the property value from the ContextMenuService is used.

È inoltre possibile utilizzare per ContextMenuService visualizzare i menu sugli elementi disabilitati.You can also use the ContextMenuService to display menus on disabled items.

Campi

ContextMenuClosingEvent

Identifica l'evento indirizzato ContextMenuClosing.Identifies the ContextMenuClosing routed event.

ContextMenuOpeningEvent

Identifica l'evento associato ContextMenuOpening.Identifies the ContextMenuOpening attached event.

ContextMenuProperty

Identifica la proprietà associata ContextMenu.Identifies the ContextMenu attached property.

HasDropShadowProperty

Identifica la proprietà associata HasDropShadow.Identifies the HasDropShadow attached property.

HorizontalOffsetProperty

Identifica la proprietà associata HorizontalOffset.Identifies the HorizontalOffset attached property.

IsEnabledProperty

Identifica la proprietà associata IsEnabled.Identifies the IsEnabled attached property.

PlacementProperty

Identifica la proprietà associata Placement.Identifies the Placement attached property.

PlacementRectangleProperty

Identifica la proprietà associata PlacementRectangle.Identifies the PlacementRectangle attached property.

PlacementTargetProperty

Identifica la proprietà associata PlacementTarget.Identifies the PlacementTarget attached property.

ShowOnDisabledProperty

Identifica la proprietà associata ShowOnDisabled.Identifies the ShowOnDisabled attached property.

VerticalOffsetProperty

Identifica la proprietà associata VerticalOffset.Identifies the VerticalOffset attached property.

Proprietà associate

ContextMenu

Ottiene o imposta il contenuto di una classe ContextMenu.Gets or sets the content of a ContextMenu.

HasDropShadow

Ottiene o imposta un valore che indica se la proprietà ContextMenu ha l'effetto ombreggiatura abilitato.Gets or sets a value that indicates whether the ContextMenu has the drop shadow effect enabled.

HorizontalOffset

Ottiene o imposta un valore che indica dove posizionare la proprietà ContextMenu lungo la direzione x rispetto al controllo padre.Gets or sets a value that indicates where along the x-direction to place the ContextMenu with respect to the parent control.

IsEnabled

Ottiene o imposta un valore che indica se è possibile visualizzare la proprietà ContextMenu.Gets or sets a value that indicates whether the ContextMenu can be shown.

Placement

Ottiene o imposta un valore che specifica la posizione della proprietà ContextMenu relativa alla proprietà PlacementTarget o PlacementRectangle.Gets or sets a value that specifies the placement of the ContextMenu relative to the PlacementTarget or PlacementRectangle.

PlacementRectangle

Ottiene o imposta l'area rispetto alla quale viene posizionato il menu di scelta rapida quando si apre.Gets or sets the area relative to which the context menu is positioned when it opens.

PlacementTarget

Ottiene o imposta il controllo padre della proprietà ContextMenu.Gets or sets the parent control of the ContextMenu.

ShowOnDisabled

Ottiene o imposta un valore che indica se la proprietà ContextMenu deve essere visualizzata quando il padre è inattivo.Gets or sets a value that indicates whether the ContextMenu should be shown when its parent is grayed out.

VerticalOffset

Ottiene o imposta un valore che indica dove posizionare la proprietà ContextMenu lungo la direzione y rispetto al controllo padre.Gets or sets a value that indicates where along the y-direction to place the ContextMenu with respect to the parent control.

Metodi

AddContextMenuClosingHandler(DependencyObject, ContextMenuEventHandler)

Aggiunge un gestore per l'evento associato ContextMenuClosing.Adds a handler for the ContextMenuClosing attached event.

AddContextMenuOpeningHandler(DependencyObject, ContextMenuEventHandler)

Aggiunge un gestore per l'evento associato ContextMenuOpening.Adds a handler for the ContextMenuOpening attached event.

GetContextMenu(DependencyObject)

Ottiene il valore della proprietà ContextMenu dell'oggetto specificato.Gets the value of the ContextMenu property of the specified object.

GetHasDropShadow(DependencyObject)

Ottiene un valore che indica se la proprietà ContextMenu ha un'ombreggiatura.Gets a value that indicates whether the ContextMenu has a drop shadow.

GetHorizontalOffset(DependencyObject)

Ottiene il valore della proprietà HorizontalOffset dell'oggetto specificato.Gets the value of the HorizontalOffset property of the specified object.

GetIsEnabled(DependencyObject)

Ottiene il valore della proprietà IsEnabled dell'oggetto specificato.Gets the value of the IsEnabled property of the specified object.

GetPlacement(DependencyObject)

Ottiene il valore della proprietà Placement dell'oggetto specificato.Gets the value of the Placement property of the specified object.

GetPlacementRectangle(DependencyObject)

Ottiene il valore della proprietà PlacementRectangle dell'oggetto specificato.Gets the value of the PlacementRectangle property of the specified object.

GetPlacementTarget(DependencyObject)

Ottiene il valore della proprietà PlacementTarget dell'oggetto specificato.Gets the value of the PlacementTarget property of the specified object.

GetShowOnDisabled(DependencyObject)

Ottiene il valore della proprietà ShowOnDisabled dell'oggetto specificato.Gets the value of the ShowOnDisabled property of the specified object.

GetVerticalOffset(DependencyObject)

Ottiene il valore della proprietà VerticalOffset dell'oggetto specificato.Gets the value of the VerticalOffset property of the specified object.

RemoveContextMenuClosingHandler(DependencyObject, ContextMenuEventHandler)

Rimuove un gestore per l'evento associato ContextMenuClosing.Removes a handler for the ContextMenuClosing attached event.

RemoveContextMenuOpeningHandler(DependencyObject, ContextMenuEventHandler)

Rimuove un gestore per l'evento associato ContextMenuOpening.Removes a handler for the ContextMenuOpening attached event.

SetContextMenu(DependencyObject, ContextMenu)

Imposta il valore della proprietà ContextMenu dell'oggetto specificato.Sets the value of the ContextMenu property of the specified object.

SetHasDropShadow(DependencyObject, Boolean)

Imposta un valore che indica se la proprietà ContextMenu ha un'ombreggiatura.Sets a value that indicates whether the ContextMenu has a drop shadow.

SetHorizontalOffset(DependencyObject, Double)

Imposta il valore della proprietà HorizontalOffset dell'oggetto specificato.Sets the value of the HorizontalOffset property of the specified object.

SetIsEnabled(DependencyObject, Boolean)

Imposta il valore della proprietà IsEnabled dell'oggetto specificato.Sets the value of the IsEnabled property of the specified object.

SetPlacement(DependencyObject, PlacementMode)

Imposta il valore della proprietà Placement dell'oggetto specificato.Sets the value of the Placement property of the specified object.

SetPlacementRectangle(DependencyObject, Rect)

Imposta il valore della proprietà PlacementRectangle dell'oggetto specificato.Sets the value of the PlacementRectangle property of the specified object.

SetPlacementTarget(DependencyObject, UIElement)

Imposta il valore della proprietà PlacementTarget dell'oggetto specificato.Sets the value of the PlacementTarget property of the specified object.

SetShowOnDisabled(DependencyObject, Boolean)

Imposta il valore della proprietà ShowOnDisabled dell'oggetto specificato.Sets the value of the ShowOnDisabled property of the specified object.

SetVerticalOffset(DependencyObject, Double)

Imposta il valore della proprietà VerticalOffset dell'oggetto specificato.Sets the value of the VerticalOffset property of the specified object.

Eventi associati

ContextMenuClosing

Si verifica quando si chiude il controllo ContextMenu.Occurs when the ContextMenu closes.

ContextMenuOpening

Si verifica all'apertura di ContextMenu.Occurs when the ContextMenu opens.

Si applica a

Vedi anche