ContextMenu Osztály

Definíció

Névtér:

System.Windows.Forms

Szerelvény:

System.Windows.Forms.dll

Forrás:

ContextMenu.cs

Figyelemfelhívás

ContextMenu is provided for binary compatibility with .NET Framework and is not intended to be used directly from your code. Use ContextMenuStrip instead.

Gyorsmenüt jelöl.

Ez az osztály nem érhető el .NET Core 3.1 és újabb verziókban. Helyette használja ContextMenuStrip , amely lecseréli és kibővíti a vezérlőt ContextMenu .

public ref 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

[<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

Öröklődés

Object

MarshalByRefObject

Component

Menu

ContextMenu

Attribútumok

BrowsableAttribute ObsoleteAttribute

Példák

Az alábbi példakód egy eseménykezelőt hoz létre az PopupContextMenueseményhez. Az eseménykezelőben található kód határozza meg, hogy a névvel ellátott PictureBox és a pictureBox1 névvel ellátott TextBox két vezérlő textBox1 közül melyik a helyi menüt megjelenítő vezérlő. Attól függően, hogy melyik vezérlőelem okozta a ContextMenu helyi menü megjelenítését, a vezérlő hozzáadja a megfelelő MenuItem objektumokat a ContextMenu. Ebben a példában az osztály egy, az ContextMenu űrlapon belül definiált példánya van definiálva contextMenu1. Ez a példa azt is megköveteli, hogy egy űrlaphoz hozzáadjon egy TextBoxPictureBox űrlapot, és hogy ezeknek a vezérlőknek a ContextMenu tulajdonsága a következőre contextMenu1legyen állítva.

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

Megjegyzések

Ez az osztály nem érhető el .NET Core 3.1 és újabb verziókban. A ContextMenuStrip használható helyette.

Az ContextMenu osztály helyi menüket jelöl, amelyek akkor jelennek meg, ha a felhasználó a jobb egérgombra kattint az űrlap egy vezérlője vagy területe felett. A helyi menük általában egy űrlap különböző menüelemeinek MainMenu kombinálására szolgálnak, amelyek az alkalmazás kontextusa alapján hasznosak a felhasználó számára. Egy vezérlőelemhez TextBox rendelt helyi menüvel például menüelemeket adhat meg a szöveg betűtípusának módosításához, a vezérlőelemen belüli szöveg megkereséséhez, illetve a szöveg másolásához és beillesztéséhez használható vágólapfunkciókhoz. A helyi menüben olyan új MenuItem objektumokat is megjeleníthet, amelyek nem egy adott helyen találhatók MainMenu , így olyan helyzetspecifikus parancsokat adhat meg, amelyek nem megfelelőek a MainMenu megjelenítéshez.

A helyi menü általában akkor jelenik meg, ha egy felhasználó a jobb egérgombra kattint egy vezérlő vagy maga az űrlap felett. Látható vezérlők, és Form van egy ContextMenu tulajdonsága, amely az ContextMenu osztályt a helyi menüt megjelenítő vezérlőhöz köti. Egynél több vezérlő is használhatja a ContextMenu. A tulajdonság használatával meghatározhatja, SourceControl hogy melyik vezérlő jelenjen meg utoljára a helyi menüben a vezérlőre jellemző feladatok végrehajtásához vagy a vezérlőhöz megjelenített helyi menü módosításához.

Érdemes lehet tudni, hogy mikor jelenik meg a helyi menü, hogy pipák legyenek beállítva, letiltsa az elemeket, és egyéb menüfeladatokat hajtson végre, mielőtt a menü megjelenik a felhasználó számára. Az eseményt kezelheti annak Popup meghatározásához, hogy mikor jelenik meg a helyi menü.

Note

A használathoz használt objektumok MenuItem újbóli felhasználásához MainMenuContextMenu létre kell hoznia a menü egy példányát az CloneMenuMenuItem osztály metódusával. A menüelemeket és azok almenüelemeit egyetlen MenuItem objektumba is egyesítheti az MergeMenuMenuItem osztály metódusával.

Konstruktorok

Name	Description
ContextMenu()	Elavult. Inicializálja az osztály új példányát, ContextMenu amelyben nincsenek megadva menüelemek.
ContextMenu(MenuItem[])	Elavult. Inicializálja az ContextMenu osztály új példányát egy meghatározott objektumkészlettel MenuItem .

Mezők

Name	Description
FindHandle	Elavult. Megadja, hogy a FindMenuItem(Int32, IntPtr) metódusnak egy leírót kell keresnie. (Öröklődés forrása Menu)
FindShortcut	Elavult. Megadja, hogy a FindMenuItem(Int32, IntPtr) metódusnak egy parancsikont kell keresnie. (Öröklődés forrása Menu)

Tulajdonságok

Name	Description
Handle	Elavult. Lekéri a menü ablakfogópontját jelképező értéket. (Öröklődés forrása Menu)
IsParent	Elavult. Beolvas egy értéket, amely jelzi, hogy ez a menü tartalmaz-e menüelemeket. Ez a tulajdonság írásvédett. (Öröklődés forrása Menu)
MdiListItem	Elavult. Lekéri a MenuItem több dokumentumfelületi (MDI-) gyermekűrlap listájának megjelenítéséhez használt értéket. (Öröklődés forrása Menu)
MenuItems	Elavult. Lekéri a menühöz társított objektumok gyűjteményét MenuItem jelző értéket. (Öröklődés forrása Menu)
Name	Elavult. Lekéri vagy beállítja a Menunevét. (Öröklődés forrása Menu)
RightToLeft	Elavult. Beolvas vagy beállít egy értéket, amely jelzi, hogy a vezérlőelem által megjelenített szöveg jobbról balra jelenik-e meg.
SourceControl	Elavult. Lekéri a helyi menüt megjelenítő vezérlőt.
Tag	Elavult. Lekéri vagy beállítja a vezérlőhöz társított felhasználó által definiált adatokat. (Öröklődés forrása Menu)

Metódusok

Name	Description
CloneMenu(Menu)	Elavult. Az aktuálisnak Menuparaméterként átadott példányt másolja Menu át. (Öröklődés forrása Menu)
CreateMenuHandle()	Elavult. Új fogópontot hoz létre a Menu. (Öröklődés forrása Menu)
FindMenuItem(Int32, IntPtr)	Elavult. Lekéri a MenuItem megadott értéket tartalmazó értéket. (Öröklődés forrása Menu)
FindMergePosition(Int32)	Elavult. Azt a helyet adja vissza, ahová be kell szúrni egy menüelemet. (Öröklődés forrása Menu)
GetContextMenu()	Elavult. Lekéri a ContextMenu menüt tartalmazó menüt. (Öröklődés forrása Menu)
GetMainMenu()	Elavult. Lekéri a MainMenu menüt tartalmazó menüt. (Öröklődés forrása Menu)
MergeMenu(Menu)	Elavult. Egyesít egy MenuItem menü objektumait az aktuális menüvel. (Öröklődés forrása Menu)
OnCollapse(EventArgs)	Elavult. Az eseményt emeli Collapse ki.
OnPopup(EventArgs)	Elavult. Az eseményt emeli Popup ki.
ProcessCmdKey(Message, Keys, Control)	Elavult. Parancskulcsot dolgoz fel.
ProcessCmdKey(Message, Keys)	Elavult. Parancskulcsot dolgoz fel. (Öröklődés forrása Menu)
Show(Control, Point, LeftRightAlignment)	Elavult. Megjeleníti a helyi menüt a megadott helyen és a megadott igazítással.
Show(Control, Point)	Elavult. Megjeleníti a helyi menüt a megadott helyen.

esemény

Name	Description
Collapse	Elavult. A helyi menü összecsukásakor fordul elő.
Popup	Elavult. A helyi menü megjelenítése előtt következik be.

Lásd még

• Menu
• MenuItem
• MainMenu