ContextMenu Kelas

Definisi

Ruang nama:

System.Windows.Forms

Rakitan:

System.Windows.Forms.dll

Mewakili menu pintasan.

Kelas ini tidak tersedia di .NET Core 3.1 dan versi yang lebih baru. Gunakan ContextMenuStrip sebagai gantinya, yang menggantikan dan memperluas ContextMenu kontrol.

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

Warisan

Object

MarshalByRefObject

Component

Menu

ContextMenu

Contoh

Contoh kode berikut membuat penanganan aktivitas untuk Popup peristiwa ContextMenu. Kode dalam penanganan aktivitas menentukan mana dari dua kontrol bernama PictureBoxpictureBox1 dan bernama TextBoxtextBox1 adalah kontrol yang menampilkan menu pintasan. Bergantung pada kontrol mana yang menyebabkan ContextMenu menampilkan menu pintasannya, kontrol menambahkan objek yang sesuai MenuItem ke ContextMenu. Contoh ini mengharuskan Anda memiliki instans ContextMenu kelas , bernama contextMenu1, yang ditentukan dalam formulir. Contoh ini juga mengharuskan Anda memiliki TextBox dan PictureBox ditambahkan ke formulir dan bahwa ContextMenu properti kontrol ini diatur ke 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

Keterangan

Kelas ini tidak tersedia di .NET Core 3.1 dan versi yang lebih baru. Gunakan ContextMenuStrip sebagai gantinya.

Kelas ContextMenu mewakili menu pintasan yang dapat ditampilkan saat pengguna mengklik tombol kanan mouse di atas kontrol atau area formulir. Menu pintasan biasanya digunakan untuk menggabungkan item menu yang berbeda dari MainMenu formulir yang berguna untuk pengguna yang diberikan konteks aplikasi. Misalnya, Anda dapat menggunakan menu pintasan yang TextBox ditetapkan ke kontrol untuk menyediakan item menu untuk mengubah font teks, menemukan teks dalam kontrol, atau fitur Clipboard untuk menyalin dan menempelkan teks. Anda juga dapat menampilkan objek baru MenuItem di menu pintasan yang tidak terletak di dalam MainMenu untuk memberikan perintah spesifik situasi yang tidak sesuai untuk MainMenu ditampilkan.

Biasanya, menu pintasan ditampilkan saat pengguna mengklik tombol kanan mouse di atas kontrol atau formulir itu sendiri. Kontrol yang terlihat dan Form memiliki ContextMenu properti yang mengikat ContextMenu kelas ke kontrol yang menampilkan menu pintasan. Lebih dari satu kontrol dapat menggunakan ContextMenu. Anda dapat menggunakan SourceControl properti untuk menentukan kontrol mana yang terakhir kali ditampilkan menu pintasan untuk melakukan tugas khusus untuk kontrol atau untuk mengubah menu pintasan yang ditampilkan untuk kontrol.

Anda mungkin ingin tahu kapan menu pintasan ditampilkan untuk mengatur tanda centang, menonaktifkan item, dan melakukan tugas menu lainnya sebelum menu ditampilkan kepada pengguna. Anda dapat menangani Popup peristiwa untuk menentukan kapan menu pintasan ditampilkan.

Catatan

Untuk menggunakan MenuItem kembali objek yang ditampilkan dalam MainMenu untuk digunakan dalam ContextMenu, Anda harus membuat salinan menu menggunakan CloneMenu metode MenuItem kelas . Anda juga dapat menggabungkan item menu dan item submenu mereka ke dalam satu MenuItem objek menggunakan MergeMenu metode MenuItem kelas .

Konstruktor

ContextMenu()	Menginisialisasi instans ContextMenu baru kelas tanpa item menu yang ditentukan.
ContextMenu(MenuItem[])	Menginisialisasi instans ContextMenu baru kelas dengan sekumpulan MenuItem objek tertentu.

Bidang

FindHandle	Menentukan bahwa FindMenuItem(Int32, IntPtr) metode harus mencari handel. (Diperoleh dari Menu)
FindShortcut	Menentukan bahwa FindMenuItem(Int32, IntPtr) metode harus mencari pintasan. (Diperoleh dari Menu)

Properti

CanRaiseEvents	Mendapatkan nilai yang menunjukkan apakah komponen dapat menaikkan peristiwa. (Diperoleh dari Component)
Container	IContainer Mendapatkan yang berisi Component. (Diperoleh dari Component)
DesignMode	Mendapatkan nilai yang menunjukkan apakah Component saat ini dalam mode desain. (Diperoleh dari Component)
Events	Mendapatkan daftar penanganan aktivitas yang dilampirkan ke ini Component. (Diperoleh dari Component)
Handle	Mendapatkan nilai yang mewakili handel jendela untuk menu. (Diperoleh dari Menu)
IsParent	Mendapatkan nilai yang menunjukkan apakah menu ini berisi item menu apa pun. Properti ini bersifat hanya baca. (Diperoleh dari Menu)
MdiListItem	Mendapatkan nilai yang menunjukkan MenuItem yang digunakan untuk menampilkan daftar beberapa formulir anak antarmuka dokumen (MDI). (Diperoleh dari Menu)
MenuItems	Mendapatkan nilai yang menunjukkan kumpulan MenuItem objek yang terkait dengan menu. (Diperoleh dari Menu)
Name	Mendapatkan atau mengatur nama Menu. (Diperoleh dari Menu)
RightToLeft	Mendapatkan atau mengatur nilai yang menunjukkan apakah teks yang ditampilkan oleh kontrol ditampilkan dari kanan ke kiri.
Site	Mendapatkan atau mengatur ISite dari Component. (Diperoleh dari Component)
SourceControl	Mendapatkan kontrol yang menampilkan menu pintasan.
Tag	Mendapatkan atau mengatur data yang ditentukan pengguna yang terkait dengan kontrol. (Diperoleh dari Menu)

Metode

CloneMenu(Menu)	Menu Menyalin yang diteruskan sebagai parameter ke saat ini Menu. (Diperoleh dari Menu)
CreateMenuHandle()	Membuat handel baru ke Menu. (Diperoleh dari Menu)
CreateObjRef(Type)	Membuat objek yang berisi semua informasi relevan yang diperlukan untuk menghasilkan proksi yang digunakan untuk berkomunikasi dengan objek jarak jauh. (Diperoleh dari MarshalByRefObject)
Dispose()	Merilis semua sumber daya yang Componentdigunakan oleh . (Diperoleh dari Component)
Dispose(Boolean)	Membuang sumber daya, selain memori, yang digunakan oleh Menu. (Diperoleh dari Menu)
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
FindMenuItem(Int32, IntPtr)	MenuItem Mendapatkan yang berisi nilai yang ditentukan. (Diperoleh dari Menu)
FindMergePosition(Int32)	Mengembalikan posisi di mana item menu harus disisipkan ke dalam menu. (Diperoleh dari Menu)
GetContextMenu()	Mendapatkan yang ContextMenu berisi menu ini. (Diperoleh dari Menu)
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetLifetimeService()	Mengambil objek layanan seumur hidup saat ini yang mengontrol kebijakan seumur hidup untuk instans ini. (Diperoleh dari MarshalByRefObject)
GetMainMenu()	Mendapatkan yang MainMenu berisi menu ini. (Diperoleh dari Menu)
GetService(Type)	Mengembalikan objek yang mewakili layanan yang disediakan oleh Component atau oleh Container. (Diperoleh dari Component)
GetType()	Mendapatkan instans Type saat ini. (Diperoleh dari Object)
InitializeLifetimeService()	Mendapatkan objek layanan seumur hidup untuk mengontrol kebijakan seumur hidup untuk instans ini. (Diperoleh dari MarshalByRefObject)
MemberwiseClone()	Membuat salinan dangkal dari yang saat ini Object. (Diperoleh dari Object)
MemberwiseClone(Boolean)	Membuat salinan dangkal objek saat ini MarshalByRefObject . (Diperoleh dari MarshalByRefObject)
MergeMenu(Menu)	MenuItem Menggabungkan objek dari satu menu dengan menu saat ini. (Diperoleh dari Menu)
OnCollapse(EventArgs)	Memunculkan kejadian Collapse.
OnPopup(EventArgs)	Memunculkan kejadian Popup.
ProcessCmdKey(Message, Keys)	Memproses kunci perintah. (Diperoleh dari Menu)
ProcessCmdKey(Message, Keys, Control)	Memproses kunci perintah.
Show(Control, Point)	Menampilkan menu pintasan pada posisi yang ditentukan.
Show(Control, Point, LeftRightAlignment)	Menampilkan menu pintasan pada posisi yang ditentukan dan dengan perataan yang ditentukan.
ToString()	Mengembalikan yang String mewakili Menu kontrol. (Diperoleh dari Menu)

Acara

Collapse	Terjadi saat menu pintasan diciutkan.
Disposed	Terjadi ketika komponen dibuang oleh panggilan ke Dispose() metode . (Diperoleh dari Component)
Popup	Terjadi sebelum menu pintasan ditampilkan.

Lihat juga

• Menu
• MenuItem
• MainMenu