ContextMenu Osztály

Definíció

Névtér:: System.Windows.Forms

Szerelvény:: System.Windows.Forms.dll

Fontos

Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.

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

public class ContextMenu : System.Windows.Forms.Menu

type ContextMenu = class
    inherit Menu

Public Class ContextMenu
Inherits Menu

Öröklődés: Object

MarshalByRefObject

Component

Menu
ContextMenu

Példák

Az alábbi példakód egy eseménykezelőt hoz létre az Popup ContextMenueseményhez. Az eseménykezelőben található kód határozza meg, hogy a névvel ellátott pictureBox1 és a TextBox névvel ellátott textBox1 két vezérlő PictureBox 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 TextBox PictureBox ű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 MainMenu újbóli felhasználásához ContextMenu MenuItem létre kell hoznia a menü egy példányát az CloneMenu MenuItem osztály metódusával. A menüelemeket és azok almenüelemeit egyetlen MenuItem objektumba is egyesítheti az MergeMenu MenuItem osztály metódusával.

Konstruktorok

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

Mezők

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

Tulajdonságok

Name	Description
CanRaiseEvents	Beolvas egy értéket, amely jelzi, hogy az összetevő képes-e eseményt létrehozni. (Öröklődés forrása Component)
Container	Lekéri a IContainer .Component (Öröklődés forrása Component)
DesignMode	Olyan értéket kap, amely jelzi, hogy az Component aktuálisan tervezési módban van-e. (Öröklődés forrása Component)
Events	Lekéri az ehhez Componentcsatolt eseménykezelők listáját. (Öröklődés forrása Component)
Handle	Lekéri a menü ablakfogópontját jelképező értéket. (Öröklődés forrása Menu)
IsParent	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	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	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	Lekéri vagy beállítja a Menunevét. (Öröklődés forrása Menu)
RightToLeft	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.
Site	Lekéri vagy megadja a ISite értékét a Component-hez. (Öröklődés forrása Component)
SourceControl	Lekéri a helyi menüt megjelenítő vezérlőt.
Tag	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)	Az aktuálisnak Menuparaméterként átadott példányt másolja Menu át. (Öröklődés forrása Menu)
CreateMenuHandle()	Új fogópontot hoz létre a Menu. (Öröklődés forrása Menu)
CreateObjRef(Type)	Létrehoz egy objektumot, amely tartalmazza a távoli objektumokkal való kommunikációhoz használt proxy létrehozásához szükséges összes releváns információt. (Öröklődés forrása MarshalByRefObject)
Dispose()	Felszabadítja a .-hez használt összes erőforrást Component. (Öröklődés forrása Component)
Dispose(Boolean)	A rendszer a memórián kívül más erőforrásokat is használ Menu. (Öröklődés forrása Menu)
Equals(Object)	Meghatározza, hogy a megadott objektum egyenlő-e az aktuális objektummal. (Öröklődés forrása Object)
FindMenuItem(Int32, IntPtr)	Lekéri a MenuItem megadott értéket tartalmazó értéket. (Öröklődés forrása Menu)
FindMergePosition(Int32)	Azt a helyet adja vissza, ahová be kell szúrni egy menüelemet. (Öröklődés forrása Menu)
GetContextMenu()	Lekéri a ContextMenu menüt tartalmazó menüt. (Öröklődés forrása Menu)
GetHashCode()	Ez az alapértelmezett kivonatoló függvény. (Öröklődés forrása Object)
GetLifetimeService()	Lekéri a példány élettartamszabályzatát vezérlő aktuális élettartam-szolgáltatásobjektumot. (Öröklődés forrása MarshalByRefObject)
GetMainMenu()	Lekéri a MainMenu menüt tartalmazó menüt. (Öröklődés forrása Menu)
GetService(Type)	Olyan objektumot ad vissza, amely az általa vagy annak által Component Containernyújtott szolgáltatást jelöli. (Öröklődés forrása Component)
GetType()	Lekéri az Type aktuális példányt. (Öröklődés forrása Object)
InitializeLifetimeService()	Beolvas egy élettartam-szolgáltatásobjektumot a példány élettartam-szabályzatának szabályozásához. (Öröklődés forrása MarshalByRefObject)
MemberwiseClone()	Az aktuális Objectpéldány sekély másolatát hozza létre. (Öröklődés forrása Object)
MemberwiseClone(Boolean)	Az aktuális MarshalByRefObject objektum sekély másolatát hozza létre. (Öröklődés forrása MarshalByRefObject)
MergeMenu(Menu)	Egyesít egy MenuItem menü objektumait az aktuális menüvel. (Öröklődés forrása Menu)
OnCollapse(EventArgs)	Az eseményt emeli Collapse ki.
OnPopup(EventArgs)	Az eseményt emeli Popup ki.
ProcessCmdKey(Message, Keys, Control)	Parancskulcsot dolgoz fel.
ProcessCmdKey(Message, Keys)	Parancskulcsot dolgoz fel. (Öröklődés forrása Menu)
Show(Control, Point, LeftRightAlignment)	Megjeleníti a helyi menüt a megadott helyen és a megadott igazítással.
Show(Control, Point)	Megjeleníti a helyi menüt a megadott helyen.
ToString()	A vezérlőt jelképező Menu értéket String ad vissza. (Öröklődés forrása Menu)

esemény

Name	Description
Collapse	A helyi menü összecsukásakor fordul elő.
Disposed	Akkor fordul elő, ha az összetevőt a metódus hívása megsemmisíti Dispose() . (Öröklődés forrása Component)
Popup	A helyi menü megjelenítése előtt következik be.

A következőre érvényes:

Lásd még

Visszajelzés

Hasznosnak találta ezt az oldalt?