ContextMenu Klass

Definition

public ref class ContextMenu : System::Windows::Forms::Menu

public class ContextMenu : System.Windows.Forms.Menu

[System.ComponentModel.Browsable(false)]
[System.Obsolete("`ContextMenu` is provided for binary compatibility with .NET Framework and is not intended to be used directly from your code. Use `ContextMenuStrip` instead.", false, DiagnosticId="WFDEV006", UrlFormat="https://aka.ms/winforms-warnings/{0}")]
public class ContextMenu : System.Windows.Forms.Menu

type ContextMenu = class
    inherit Menu

[<System.ComponentModel.Browsable(false)>]
[<System.Obsolete("`ContextMenu` is provided for binary compatibility with .NET Framework and is not intended to be used directly from your code. Use `ContextMenuStrip` instead.", false, DiagnosticId="WFDEV006", UrlFormat="https://aka.ms/winforms-warnings/{0}")>]
type ContextMenu = class
    inherit Menu

Public Class ContextMenu
Inherits Menu

Arv

Object

MarshalByRefObject

Component

Menu

ContextMenu

Attribut

BrowsableAttribute ObsoleteAttribute

Exempel

I följande kodexempel skapas en händelsehanterare för Popup händelsen för ContextMenu. Koden i händelsehanteraren avgör vilken av två kontroller som en PictureBox namngiven pictureBox1 och en TextBox namngiven textBox1 är kontrollen som visar snabbmenyn. Beroende på vilken kontroll som gjorde ContextMenu att snabbmenyn visades lägger kontrollen till lämpliga MenuItem objekt i ContextMenu. Det här exemplet kräver att du har en instans av ContextMenu klassen med namnet contextMenu1, definierad i formuläret. Det här exemplet kräver också att du har ett TextBox och PictureBox lagt till i ett formulär och att ContextMenu egenskapen för dessa kontroller är inställd på contextMenu1.

private:
   void MyPopupEventHandler( System::Object^ /*sender*/, System::EventArgs^ /*e*/ )
   {
      // Define the MenuItem objects to display for the TextBox.
      MenuItem^ menuItem1 = gcnew MenuItem( "&Copy" );
      MenuItem^ menuItem2 = gcnew MenuItem( "&Find and Replace" );
      // Define the MenuItem object to display for the PictureBox.
      MenuItem^ menuItem3 = gcnew MenuItem( "C&hange Picture" );
      
      // Clear all previously added MenuItems.
      contextMenu1->MenuItems->Clear();

      if ( contextMenu1->SourceControl == textBox1 )
      {
         
         // Add MenuItems to display for the TextBox.
         contextMenu1->MenuItems->Add( menuItem1 );
         contextMenu1->MenuItems->Add( menuItem2 );
      }
      else if ( contextMenu1->SourceControl == pictureBox1 )
      {
         // Add the MenuItem to display for the PictureBox.
         contextMenu1->MenuItems->Add( menuItem3 );
      }
   }

private void MyPopupEventHandler(System.Object sender, System.EventArgs e)
 {
    // Define the MenuItem objects to display for the TextBox.
    MenuItem menuItem1 = new MenuItem("&Copy");
    MenuItem menuItem2 = new MenuItem("&Find and Replace");
    // Define the MenuItem object to display for the PictureBox.
    MenuItem menuItem3 = new MenuItem("C&hange Picture");

    // Clear all previously added MenuItems.
    contextMenu1.MenuItems.Clear();
 
    if(contextMenu1.SourceControl == textBox1)
    {
       // Add MenuItems to display for the TextBox.
       contextMenu1.MenuItems.Add(menuItem1);
       contextMenu1.MenuItems.Add(menuItem2);
    }
    else if(contextMenu1.SourceControl == pictureBox1)
    {
       // Add the MenuItem to display for the PictureBox.
       contextMenu1.MenuItems.Add(menuItem3);
    }
 }

Private Sub MyPopupEventHandler(sender As System.Object, e As System.EventArgs)
    ' Define the MenuItem objects to display for the TextBox.
    Dim menuItem1 As New MenuItem("&Copy")
    Dim menuItem2 As New MenuItem("&Find and Replace")
    ' Define the MenuItem object to display for the PictureBox.
    Dim menuItem3 As New MenuItem("C&hange Picture")
    
    ' Clear all previously added MenuItems.
    contextMenu1.MenuItems.Clear()
    
    If contextMenu1.SourceControl Is textBox1 Then
        ' Add MenuItems to display for the TextBox.
        contextMenu1.MenuItems.Add(menuItem1)
        contextMenu1.MenuItems.Add(menuItem2)
    ElseIf contextMenu1.SourceControl Is pictureBox1 Then
        ' Add the MenuItem to display for the PictureBox.
        contextMenu1.MenuItems.Add(menuItem3)
    End If
End Sub

Kommentarer

Den här klassen är inte tillgänglig i .NET Core 3.1 och senare versioner. Använd ContextMenuStrip i stället.

Klassen ContextMenu representerar snabbmenyer som kan visas när användaren klickar på höger musknapp över en kontroll eller ett område i formuläret. Snabbmenyer används vanligtvis för att kombinera olika menyalternativ från ett MainMenu formulär som är användbara för användaren med tanke på programmets kontext. Du kan till exempel använda en snabbmeny som tilldelats en TextBox kontroll för att ange menyalternativ för att ändra textens teckensnitt, söka efter text i kontrollen eller Urklippsfunktioner för att kopiera och klistra in text. Du kan också visa nya MenuItem objekt i en snabbmeny som inte finns i en MainMenu för att tillhandahålla situationsspecifika kommandon som inte är lämpliga för MainMenu visning.

Vanligtvis visas en snabbmeny när en användare klickar på höger musknapp över en kontroll eller själva formuläret. Synliga kontroller och Form har en ContextMenu egenskap som binder ContextMenu klassen till kontrollen som visar snabbmenyn. Mer än en kontroll kan använda en ContextMenu. Du kan använda SourceControl egenskapen för att avgöra vilken kontroll som senast visade snabbmenyn för att utföra uppgifter som är specifika för kontrollen eller för att ändra snabbmenyn som visas för kontrollen.

Du kanske vill veta när snabbmenyn visas för att ange bockmarkeringar, inaktivera objekt och utföra andra menyaktiviteter innan menyn visas för användaren. Du kan hantera Popup händelsen för att avgöra när snabbmenyn visas.

Se även

• Menu
• MenuItem
• MainMenu