ContextMenuService Classe

Definizione

Spazio dei nomi:

System.Windows.Controls

Assembly:

PresentationFramework.dll

Fornisce l'implementazione del sistema per la visualizzazione di un oggetto ContextMenu.

public ref class ContextMenuService abstract sealed

public static class ContextMenuService

type ContextMenuService = class

Public Class ContextMenuService

Ereditarietà

Object

ContextMenuService

Esempio

Nell'esempio seguente vengono assegnati gli stessi ContextMenu pulsanti e vengono impostate le HasDropShadowproprietà , Placement, PlacementRectangleHorizontalOffset, e VerticalOffset per impostare su ContextMenu posizioni diverse per ogni pulsante.

<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 usare il servizio per visualizzare un oggetto ContextMenu su un pulsante disabilitato. Si noti che si imposta la ShowOnDisabled proprietà sul pulsante padre del menu di scelta rapida.

<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. Molte delle proprietà nella ContextMenuService classe sono definite anche da ContextMenu. In alcuni casi è più pratico impostare le proprietà usando la classe rispetto all'impostazione ContextMenuService delle proprietà in un oggetto ContextMenu. Ad esempio, è possibile creare un ContextMenu oggetto da condividere da più elementi, ma usare la ContextMenuService classe per specificare una posizione diversa dell'oggetto ContextMenu per ogni elemento. Le proprietà seguenti sono definite dalle ContextMenu classi e ContextMenuService . Se una di queste proprietà è impostata su e ContextMenuContextMenuServicesu , viene utilizzato il valore della ContextMenuService proprietà da .

• Placement

• PlacementRectangle

• PlacementTargetProperty

• HorizontalOffset

• VerticalOffsetProperty

• HasDropShadow

È anche possibile utilizzare per ContextMenuService visualizzare i menu per gli elementi disabilitati.

Campi

Nome	Descrizione
ContextMenuClosingEvent	Identifica l'evento ContextMenuClosing indirizzato.
ContextMenuOpeningEvent	Identifica l'evento ContextMenuOpening associato.
ContextMenuProperty	Identifica la ContextMenu proprietà associata.
HasDropShadowProperty	Identifica la HasDropShadow proprietà associata.
HorizontalOffsetProperty	Identifica la HorizontalOffset proprietà associata.
IsEnabledProperty	Identifica la IsEnabled proprietà associata.
PlacementProperty	Identifica la Placement proprietà associata.
PlacementRectangleProperty	Identifica la PlacementRectangle proprietà associata.
PlacementTargetProperty	Identifica la PlacementTarget proprietà associata.
ShowOnDisabledProperty	Identifica la ShowOnDisabled proprietà associata.
VerticalOffsetProperty	Identifica la VerticalOffset proprietà associata.

Proprietà associate

Nome	Descrizione
ContextMenu	Ottiene o imposta il contenuto di un oggetto ContextMenu.
HasDropShadow	Ottiene o imposta un valore che indica se l'oggetto ContextMenu ha l'effetto ombreggiatura abilitato.
HorizontalOffset	Ottiene o imposta un valore che indica dove lungo la direzione x posizionare l'oggetto ContextMenu rispetto al controllo padre.
IsEnabled	Ottiene o imposta un valore che indica se l'oggetto ContextMenu può essere visualizzato.
Placement	Ottiene o imposta un valore che specifica la posizione dell'oggetto rispetto all'oggetto ContextMenuPlacementTarget o PlacementRectangle.
PlacementRectangle	Ottiene o imposta l'area relativa alla quale viene posizionato il menu di scelta rapida all'apertura.
PlacementTarget	Ottiene o imposta il controllo padre dell'oggetto ContextMenu.
ShowOnDisabled	Ottiene o imposta un valore che indica se deve essere visualizzato quando l'elemento ContextMenu padre è disattivato.
VerticalOffset	Ottiene o imposta un valore che indica dove si trova lungo la direzione y per posizionare l'oggetto ContextMenu rispetto al controllo padre.

Metodi

Nome	Descrizione
AddContextMenuClosingHandler(DependencyObject, ContextMenuEventHandler)	Aggiunge un gestore per l'evento ContextMenuClosing associato.
AddContextMenuOpeningHandler(DependencyObject, ContextMenuEventHandler)	Aggiunge un gestore per l'evento ContextMenuOpening associato.
GetContextMenu(DependencyObject)	Ottiene il valore della ContextMenu proprietà dell'oggetto specificato.
GetHasDropShadow(DependencyObject)	Ottiene un valore che indica se ha ContextMenu un'ombreggiatura.
GetHorizontalOffset(DependencyObject)	Ottiene il valore della HorizontalOffset proprietà dell'oggetto specificato.
GetIsEnabled(DependencyObject)	Ottiene il valore della IsEnabled proprietà dell'oggetto specificato.
GetPlacement(DependencyObject)	Ottiene il valore della Placement proprietà dell'oggetto specificato.
GetPlacementRectangle(DependencyObject)	Ottiene il valore della PlacementRectangle proprietà dell'oggetto specificato.
GetPlacementTarget(DependencyObject)	Ottiene il valore della PlacementTarget proprietà dell'oggetto specificato.
GetShowOnDisabled(DependencyObject)	Ottiene il valore della ShowOnDisabled proprietà dell'oggetto specificato.
GetVerticalOffset(DependencyObject)	Ottiene il valore della VerticalOffset proprietà dell'oggetto specificato.
RemoveContextMenuClosingHandler(DependencyObject, ContextMenuEventHandler)	Rimuove un gestore per l'evento ContextMenuClosing associato.
RemoveContextMenuOpeningHandler(DependencyObject, ContextMenuEventHandler)	Rimuove un gestore per l'evento ContextMenuOpening associato.
SetContextMenu(DependencyObject, ContextMenu)	Imposta il valore della ContextMenu proprietà dell'oggetto specificato.
SetHasDropShadow(DependencyObject, Boolean)	Imposta un valore che indica se ha ContextMenu un'ombreggiatura.
SetHorizontalOffset(DependencyObject, Double)	Imposta il valore della HorizontalOffset proprietà dell'oggetto specificato.
SetIsEnabled(DependencyObject, Boolean)	Imposta il valore della IsEnabled proprietà dell'oggetto specificato.
SetPlacement(DependencyObject, PlacementMode)	Imposta il valore della Placement proprietà dell'oggetto specificato.
SetPlacementRectangle(DependencyObject, Rect)	Imposta il valore della PlacementRectangle proprietà dell'oggetto specificato.
SetPlacementTarget(DependencyObject, UIElement)	Imposta il valore della PlacementTarget proprietà dell'oggetto specificato.
SetShowOnDisabled(DependencyObject, Boolean)	Imposta il valore della ShowOnDisabled proprietà dell'oggetto specificato.
SetVerticalOffset(DependencyObject, Double)	Imposta il valore della VerticalOffset proprietà dell'oggetto specificato.

Eventi associati

Nome	Descrizione
ContextMenuClosing	Si verifica quando l'oggetto ContextMenu viene chiuso.
ContextMenuOpening	Si verifica all'apertura dell'oggetto ContextMenu .

Vedi anche

• ContextMenu