Control.ContextMenu-Eigenschaft

Ruft das dem Steuerelement zugeordnete Kontextmenü ab oder legt dieses fest.

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

Syntax

'Declaration
Public Overridable Property ContextMenu As ContextMenu
'Usage
Dim instance As Control
Dim value As ContextMenu

value = instance.ContextMenu

instance.ContextMenu = value

public virtual ContextMenu ContextMenu { get; set; }

public:
virtual property ContextMenu^ ContextMenu {
    ContextMenu^ get ();
    void set (ContextMenu^ value);
}

/** @property */
public ContextMenu get_ContextMenu ()

/** @property */
public void set_ContextMenu (ContextMenu value)

public function get ContextMenu () : ContextMenu

public function set ContextMenu (value : ContextMenu)

Eigenschaftenwert

Ein ContextMenu, das das diesem Steuerelement zugeordnete Kontextmenü darstellt.

Hinweise

Stellen Sie den Benutzern mithilfe von Kontextmenüs kontextspezifische Optionen beim Klicken mit der rechten Maustaste auf das Steuerelement bereit.

Hinweise für Erben Verwenden Sie beim Überschreiben der ContextMenu-Eigenschaft in einer abgeleiteten Klasse die ContextMenu-Eigenschaft der Basisklasse, um die Basisimplementierung zu erweitern. Andernfalls müssen Sie die gesamte Implementierung bereitstellen. Sie müssen nicht sowohl den get-Accessor als auch den set-Accessor der ContextMenu-Eigenschaft überschreiben. Sie können ggf. auch nur einen Accessor überschreiben.

Beispiel

Im folgenden Codebeispiel wird das ContextMenu angezeigt, das einer TreeView zugeordnet ist, wenn die rechte Maustaste gedrückt und losgelassen wird. Bei diesem Codebeispiel muss in einem Form eine TreeView vorhanden sein. Außerdem muss der ContextMenu-Eigenschaft der TreeView ein ContextMenu zugeordnet sein.

Private Sub treeView1_MouseUp(sender As Object, _
  e As MouseEventArgs) Handles treeView1.MouseUp
   ' If the right mouse button was clicked and released,
   ' display the shortcut menu assigned to the TreeView. 
   If e.Button = MouseButtons.Right Then
      treeView1.ContextMenu.Show(treeView1, New Point(e.X, e.Y))
   End If
End Sub

private void treeView1_MouseUp(object sender, MouseEventArgs e)
{
   // If the right mouse button was clicked and released,
   // display the shortcut menu assigned to the TreeView. 
   if(e.Button == MouseButtons.Right)
   {
      treeView1.ContextMenu.Show(treeView1, new Point(e.X, e.Y) );      
   }
}

private:
   void treeView1_MouseUp( Object^ /*sender*/, MouseEventArgs^ e )
   {
      // If the right mouse button was clicked and released,
      // display the shortcut menu assigned to the TreeView.
      if ( e->Button == ::MouseButtons::Right )
      {
         treeView1->ContextMenu->Show( treeView1, Point(e->X,e->Y) );
      }
   }

private void treeView1_MouseUp(Object sender, MouseEventArgs e)
{
    // If the right mouse button was clicked and released,
    // display the shortcut menu assigned to the TreeView. 
    if (e.get_Button().Equals(get_MouseButtons().Right)) {
        treeView1.get_ContextMenu().Show(treeView1, new Point(e.get_X(),
        e.get_Y()));
    }
} //treeView1_MouseUp

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

Control-Klasse
Control-Member
System.Windows.Forms-Namespace
ContextMenu-Klasse