ContextMenuService ContextMenuService ContextMenuService ContextMenuService Class

Definition

Stellt die Systemimplementierung zum Anzeigen eines ContextMenu bereit.Provides the system implementation for displaying a ContextMenu.

public ref class ContextMenuService abstract sealed
public static class ContextMenuService
type ContextMenuService = class
Public Class ContextMenuService
Vererbung
ContextMenuServiceContextMenuServiceContextMenuServiceContextMenuService

Beispiele

Im folgenden Beispiel werden die gleichen ContextMenu zwei Schaltflächen zugewiesen, und HasDropShadowdie PlacementEigenschaften PlacementRectangle, HorizontalOffset,, VerticalOffset und werden so fest ContextMenu gelegt, dass für die einzelnen Schaltflächen auf unterschiedliche Positionen festgelegt wird.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>

Im folgenden Beispiel wird gezeigt, wie der-Dienst verwendet wird ContextMenu , um einen auf einer deaktivierten Schaltfläche anzuzeigen.The following example shows how to use the service to display a ContextMenu on a disabled button. Beachten Sie, dass Sie ShowOnDisabled die-Eigenschaft auf der Schaltfläche festlegen, die das übergeordnete Element des Kontextmenüs ist.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>

Hinweise

Die ContextMenuService -Klasse stellt angefügte Eigenschaften bereit, die verwendet werden können, um die Darstellung und Position eines Kontextmenüs anzugeben.The ContextMenuService class provides attached properties that can be used to specify the appearance and position of a context menu. Viele der Eigenschaften in der ContextMenuService -Klasse werden auch ContextMenuvom definiert.Many of the properties in the ContextMenuService class are also defined by the ContextMenu. In manchen Fällen ist es einfacher, die Eigenschaften mithilfe der ContextMenuService -Klasse festzulegen, als durch Festlegen der Eigenschaften für einen. ContextMenuSometimes it is more convenient to set the properties by using the ContextMenuService class than by setting the properties on a ContextMenu. Sie können z. b. ein ContextMenu -Element erstellen, das von mehreren-Elementen gemeinsam ContextMenuService genutzt werden soll, aber die-Klasse ContextMenu verwenden, um eine andere Position der für jedes Element anzugeben.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. Die folgenden Eigenschaften werden von der ContextMenu -Klasse und der- ContextMenuService Klasse definiert.The following properties are defined by the ContextMenu and ContextMenuService classes. Wenn eine dieser Eigenschaften sowohl ContextMenu für ContextMenuServiceals auch für festgelegt ist, wird der-Eigenschafts Wert aus der ContextMenuService verwendet.If any of these properties are set on both ContextMenu and the ContextMenuService, the property value from the ContextMenuService is used.

Sie können auch das ContextMenuService verwenden, um Menüs für deaktivierte Elemente anzuzeigen.You can also use the ContextMenuService to display menus on disabled items.

Felder

ContextMenuClosingEvent ContextMenuClosingEvent ContextMenuClosingEvent ContextMenuClosingEvent

Identifiziert das ContextMenuClosing-Routingereignis.Identifies the ContextMenuClosing routed event.

ContextMenuOpeningEvent ContextMenuOpeningEvent ContextMenuOpeningEvent ContextMenuOpeningEvent

Bezeichnet das angefügte ContextMenuOpening-Ereignis.Identifies the ContextMenuOpening attached event.

ContextMenuProperty ContextMenuProperty ContextMenuProperty ContextMenuProperty

Bezeichnet die angefügte ContextMenu-Eigenschaft.Identifies the ContextMenu attached property.

HasDropShadowProperty HasDropShadowProperty HasDropShadowProperty HasDropShadowProperty

Bezeichnet die angefügte HasDropShadow-Eigenschaft.Identifies the HasDropShadow attached property.

HorizontalOffsetProperty HorizontalOffsetProperty HorizontalOffsetProperty HorizontalOffsetProperty

Bezeichnet die angefügte HorizontalOffset-Eigenschaft.Identifies the HorizontalOffset attached property.

IsEnabledProperty IsEnabledProperty IsEnabledProperty IsEnabledProperty

Bezeichnet die angefügte IsEnabled-Eigenschaft.Identifies the IsEnabled attached property.

PlacementProperty PlacementProperty PlacementProperty PlacementProperty

Bezeichnet die angefügte Placement-Eigenschaft.Identifies the Placement attached property.

PlacementRectangleProperty PlacementRectangleProperty PlacementRectangleProperty PlacementRectangleProperty

Bezeichnet die angefügte PlacementRectangle-Eigenschaft.Identifies the PlacementRectangle attached property.

PlacementTargetProperty PlacementTargetProperty PlacementTargetProperty PlacementTargetProperty

Bezeichnet die angefügte PlacementTarget-Eigenschaft.Identifies the PlacementTarget attached property.

ShowOnDisabledProperty ShowOnDisabledProperty ShowOnDisabledProperty ShowOnDisabledProperty

Bezeichnet die angefügte ShowOnDisabled-Eigenschaft.Identifies the ShowOnDisabled attached property.

VerticalOffsetProperty VerticalOffsetProperty VerticalOffsetProperty VerticalOffsetProperty

Bezeichnet die angefügte VerticalOffset-Eigenschaft.Identifies the VerticalOffset attached property.

Angefügte Eigenschaften

ContextMenu ContextMenu ContextMenu ContextMenu

Ruft den Inhalt einer ContextMenu ab oder legt diesen fest.Gets or sets the content of a ContextMenu.

HasDropShadow HasDropShadow HasDropShadow HasDropShadow

Ruft einen Wert ab, der angibt, ob für das ContextMenu ein Schlagschatteneffekt aktiviert ist, oder legt diesen fest.Gets or sets a value that indicates whether the ContextMenu has the drop shadow effect enabled.

HorizontalOffset HorizontalOffset HorizontalOffset HorizontalOffset

Ruft einen Wert ab, der angibt, an welcher Stelle in der x-Richtung das ContextMenu in Bezug auf das übergeordnete Steuerelement platziert werden soll, oder legt diesen fest.Gets or sets a value that indicates where along the x-direction to place the ContextMenu with respect to the parent control.

IsEnabled IsEnabled IsEnabled IsEnabled

Ruft einen Wert ab, der angibt, ob das ContextMenu angezeigt werden kann, oder legt diesen fest.Gets or sets a value that indicates whether the ContextMenu can be shown.

Placement Placement Placement Placement

Ruft einen Wert ab, der die Platzierung des ContextMenu in Bezug auf das PlacementTarget bzw. das PlacementRectangle angibt, oder legt diesen fest.Gets or sets a value that specifies the placement of the ContextMenu relative to the PlacementTarget or PlacementRectangle.

PlacementRectangle PlacementRectangle PlacementRectangle PlacementRectangle

Ruft den Bereich ab, in Bezug auf den das Kontextmenü beim Öffnen positioniert wird, oder legt diesen fest.Gets or sets the area relative to which the context menu is positioned when it opens.

PlacementTarget PlacementTarget PlacementTarget PlacementTarget

Ruft das übergeordnete Steuerelement des ContextMenu ab oder legt dieses fest.Gets or sets the parent control of the ContextMenu.

ShowOnDisabled ShowOnDisabled ShowOnDisabled ShowOnDisabled

Ruft einen Wert ab, der angibt, ob das ContextMenu angezeigt werden soll, wenn sein übergeordnetes Element abgeblendet dargestellt wird, oder legt diesen fest.Gets or sets a value that indicates whether the ContextMenu should be shown when its parent is grayed out.

VerticalOffset VerticalOffset VerticalOffset VerticalOffset

Ruft einen Wert ab, der angibt, an welcher Stelle in der y-Richtung das ContextMenu in Bezug auf das übergeordnete Steuerelement platziert werden soll, oder legt diesen fest.Gets or sets a value that indicates where along the y-direction to place the ContextMenu with respect to the parent control.

Methoden

AddContextMenuClosingHandler(DependencyObject, ContextMenuEventHandler) AddContextMenuClosingHandler(DependencyObject, ContextMenuEventHandler) AddContextMenuClosingHandler(DependencyObject, ContextMenuEventHandler) AddContextMenuClosingHandler(DependencyObject, ContextMenuEventHandler)

Fügt einen Handler für das angefügte ContextMenuClosing -Ereignis hinzu.Adds a handler for the ContextMenuClosing attached event.

AddContextMenuOpeningHandler(DependencyObject, ContextMenuEventHandler) AddContextMenuOpeningHandler(DependencyObject, ContextMenuEventHandler) AddContextMenuOpeningHandler(DependencyObject, ContextMenuEventHandler) AddContextMenuOpeningHandler(DependencyObject, ContextMenuEventHandler)

Fügt einen Handler für das angefügte ContextMenuOpening-Ereignis hinzu.Adds a handler for the ContextMenuOpening attached event.

GetContextMenu(DependencyObject) GetContextMenu(DependencyObject) GetContextMenu(DependencyObject) GetContextMenu(DependencyObject)

Ruft den Wert der ContextMenu-Eigenschaft des angegebenen Objekts ab.Gets the value of the ContextMenu property of the specified object.

GetHasDropShadow(DependencyObject) GetHasDropShadow(DependencyObject) GetHasDropShadow(DependencyObject) GetHasDropShadow(DependencyObject)

Ruft einen Wert ab, der angibt, ob das ContextMenu einen Schlagschatten aufweist.Gets a value that indicates whether the ContextMenu has a drop shadow.

GetHorizontalOffset(DependencyObject) GetHorizontalOffset(DependencyObject) GetHorizontalOffset(DependencyObject) GetHorizontalOffset(DependencyObject)

Ruft den Wert der HorizontalOffset-Eigenschaft des angegebenen Objekts ab.Gets the value of the HorizontalOffset property of the specified object.

GetIsEnabled(DependencyObject) GetIsEnabled(DependencyObject) GetIsEnabled(DependencyObject) GetIsEnabled(DependencyObject)

Ruft den Wert der IsEnabled-Eigenschaft des angegebenen Objekts ab.Gets the value of the IsEnabled property of the specified object.

GetPlacement(DependencyObject) GetPlacement(DependencyObject) GetPlacement(DependencyObject) GetPlacement(DependencyObject)

Ruft den Wert der Placement-Eigenschaft des angegebenen Objekts ab.Gets the value of the Placement property of the specified object.

GetPlacementRectangle(DependencyObject) GetPlacementRectangle(DependencyObject) GetPlacementRectangle(DependencyObject) GetPlacementRectangle(DependencyObject)

Ruft den Wert der PlacementRectangle-Eigenschaft des angegebenen Objekts ab.Gets the value of the PlacementRectangle property of the specified object.

GetPlacementTarget(DependencyObject) GetPlacementTarget(DependencyObject) GetPlacementTarget(DependencyObject) GetPlacementTarget(DependencyObject)

Ruft den Wert der PlacementTarget-Eigenschaft des angegebenen Objekts ab.Gets the value of the PlacementTarget property of the specified object.

GetShowOnDisabled(DependencyObject) GetShowOnDisabled(DependencyObject) GetShowOnDisabled(DependencyObject) GetShowOnDisabled(DependencyObject)

Ruft den Wert der ShowOnDisabled-Eigenschaft des angegebenen Objekts ab.Gets the value of the ShowOnDisabled property of the specified object.

GetVerticalOffset(DependencyObject) GetVerticalOffset(DependencyObject) GetVerticalOffset(DependencyObject) GetVerticalOffset(DependencyObject)

Ruft den Wert der VerticalOffset-Eigenschaft des angegebenen Objekts ab.Gets the value of the VerticalOffset property of the specified object.

RemoveContextMenuClosingHandler(DependencyObject, ContextMenuEventHandler) RemoveContextMenuClosingHandler(DependencyObject, ContextMenuEventHandler) RemoveContextMenuClosingHandler(DependencyObject, ContextMenuEventHandler) RemoveContextMenuClosingHandler(DependencyObject, ContextMenuEventHandler)

Entfernt einen Handler für das angefügte ContextMenuClosing-Ereignis.Removes a handler for the ContextMenuClosing attached event.

RemoveContextMenuOpeningHandler(DependencyObject, ContextMenuEventHandler) RemoveContextMenuOpeningHandler(DependencyObject, ContextMenuEventHandler) RemoveContextMenuOpeningHandler(DependencyObject, ContextMenuEventHandler) RemoveContextMenuOpeningHandler(DependencyObject, ContextMenuEventHandler)

Entfernt einen Handler für das angefügte ContextMenuOpening-Ereignis.Removes a handler for the ContextMenuOpening attached event.

SetContextMenu(DependencyObject, ContextMenu) SetContextMenu(DependencyObject, ContextMenu) SetContextMenu(DependencyObject, ContextMenu) SetContextMenu(DependencyObject, ContextMenu)

Legt den Wert der ContextMenu-Eigenschaft des angegebenen Objekts fest.Sets the value of the ContextMenu property of the specified object.

SetHasDropShadow(DependencyObject, Boolean) SetHasDropShadow(DependencyObject, Boolean) SetHasDropShadow(DependencyObject, Boolean) SetHasDropShadow(DependencyObject, Boolean)

Legt einen Wert fest, der angibt, ob das ContextMenu einen Schlagschatten aufweist.Sets a value that indicates whether the ContextMenu has a drop shadow.

SetHorizontalOffset(DependencyObject, Double) SetHorizontalOffset(DependencyObject, Double) SetHorizontalOffset(DependencyObject, Double) SetHorizontalOffset(DependencyObject, Double)

Legt den Wert der HorizontalOffset-Eigenschaft des angegebenen Objekts fest.Sets the value of the HorizontalOffset property of the specified object.

SetIsEnabled(DependencyObject, Boolean) SetIsEnabled(DependencyObject, Boolean) SetIsEnabled(DependencyObject, Boolean) SetIsEnabled(DependencyObject, Boolean)

Legt den Wert der IsEnabled-Eigenschaft des angegebenen Objekts fest.Sets the value of the IsEnabled property of the specified object.

SetPlacement(DependencyObject, PlacementMode) SetPlacement(DependencyObject, PlacementMode) SetPlacement(DependencyObject, PlacementMode) SetPlacement(DependencyObject, PlacementMode)

Legt den Wert der Placement-Eigenschaft des angegebenen Objekts fest.Sets the value of the Placement property of the specified object.

SetPlacementRectangle(DependencyObject, Rect) SetPlacementRectangle(DependencyObject, Rect) SetPlacementRectangle(DependencyObject, Rect) SetPlacementRectangle(DependencyObject, Rect)

Legt den Wert der PlacementRectangle-Eigenschaft des angegebenen Objekts fest.Sets the value of the PlacementRectangle property of the specified object.

SetPlacementTarget(DependencyObject, UIElement) SetPlacementTarget(DependencyObject, UIElement) SetPlacementTarget(DependencyObject, UIElement) SetPlacementTarget(DependencyObject, UIElement)

Legt den Wert der PlacementTarget-Eigenschaft des angegebenen Objekts fest.Sets the value of the PlacementTarget property of the specified object.

SetShowOnDisabled(DependencyObject, Boolean) SetShowOnDisabled(DependencyObject, Boolean) SetShowOnDisabled(DependencyObject, Boolean) SetShowOnDisabled(DependencyObject, Boolean)

Legt den Wert der ShowOnDisabled-Eigenschaft des angegebenen Objekts fest.Sets the value of the ShowOnDisabled property of the specified object.

SetVerticalOffset(DependencyObject, Double) SetVerticalOffset(DependencyObject, Double) SetVerticalOffset(DependencyObject, Double) SetVerticalOffset(DependencyObject, Double)

Legt den Wert der VerticalOffset-Eigenschaft des angegebenen Objekts fest.Sets the value of the VerticalOffset property of the specified object.

Angefügte Ereignisse

ContextMenuClosing ContextMenuClosing ContextMenuClosing ContextMenuClosing

Tritt ein, wenn ContextMenu geschlossen wird.Occurs when the ContextMenu closes.

ContextMenuOpening ContextMenuOpening ContextMenuOpening ContextMenuOpening

Tritt ein, wenn ContextMenu geöffnet wird.Occurs when the ContextMenu opens.

Gilt für:

Siehe auch