ContextMenu Sınıf

Başvuru

Tanım

Ad Alanı:: System.Windows.Forms

Bütünleştirilmiş Kod:: System.Windows.Forms.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

Kısayol menüsünü temsil eder.

Bu sınıf .NET Core 3.1 ve sonraki sürümlerde kullanılamaz. Bunun yerine, denetimin yerini alan ve genişleten öğesini ContextMenu kullanınContextMenuStrip.

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

Devralma: Object

MarshalByRefObject

Component

Menu
ContextMenu

Örnekler

Aşağıdaki kod örneği, olayı için Popup bir olay işleyicisi ContextMenuoluşturur. Olay işleyicisindeki kod, iki denetimden PictureBox hangisinin bir adlandırılmış pictureBox1 ve hangilerinin TextBoxtextBox1 kısayol menüsünü görüntüleyen denetim olduğunu belirler. öğesinin ContextMenu kısayol menüsünü görüntülemesine neden olan denetime bağlı olarak, denetim uygun MenuItem nesneleri öğesine ContextMenuekler. Bu örnek, sınıfının formda tanımlanan adlı contextMenu1bir örneğine ContextMenu sahip olmasını gerektirir. Bu örnek ayrıca forma bir TextBox ve PictureBox ekleyip bu denetimlerin ContextMenu özelliğinin olarak ayarlanmasını contextMenu1gerektirir.

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

Açıklamalar

Bu sınıf .NET Core 3.1 ve sonraki sürümlerde kullanılamaz. Bunun yerine ContextMenuStrip kullanın.

sınıfı, ContextMenu kullanıcı formun bir denetimi veya alanı üzerinde sağ fare düğmesine tıkladığında görüntülenebilen kısayol menülerini temsil eder. Kısayol menüleri genellikle uygulamanın bağlamı göz önüne alındığında kullanıcı için yararlı olan bir MainMenu formdaki farklı menü öğelerini birleştirmek için kullanılır. Örneğin, metnin yazı tipini değiştirmek, denetim içinde metin bulmak veya metni kopyalayıp yapıştırmak için Pano özellikleri sağlamak için denetime atanmış TextBox bir kısayol menüsünü kullanabilirsiniz. Ayrıca, öğesinin görüntülenmesi için uygun olmayan duruma özgü komutlar sağlamak için MainMenu içinde bulunmayan bir MainMenu kısayol menüsünde yeni MenuItem nesneler de görüntüleyebilirsiniz.

Genellikle, bir kullanıcı bir denetimin veya formun üzerinde sağ fare düğmesine tıkladığında bir kısayol menüsü görüntülenir. Görünür denetimler ve Form sınıfı kısayol menüsünü görüntüleyen denetime bağlayan ContextMenu bir ContextMenu özelliği vardır. Birden fazla denetim kullanabilir ContextMenu. denetimine SourceControl özgü görevleri gerçekleştirmek veya denetim için görüntülenen kısayol menüsünü değiştirmek amacıyla kısayol menüsünü en son hangi denetimin görüntülediğini belirlemek için özelliğini kullanabilirsiniz.

Kullanıcıya menü görüntülenmeden önce onay işaretlerini ayarlamak, öğeleri devre dışı bırakmak ve diğer menü görevlerini gerçekleştirmek için kısayol menüsünün ne zaman görüntülendiğini bilmek isteyebilirsiniz. Kısayol menüsünün Popup ne zaman görüntüleneceğini belirlemek için olayı işleyebilirsiniz.

Not

içinde görüntülenen MainMenu nesneleri içinde kullanmak üzere yeniden MenuItem kullanmak ContextMenuiçin sınıfının yöntemini MenuItem kullanarak CloneMenu menünün bir kopyasını oluşturmanız gerekir. Ayrıca, sınıfın yöntemini MenuItem kullanarak menü öğelerini ve bunların alt menü öğelerini tek MenuItem bir nesnede MergeMenu birleştirebilirsiniz.

Oluşturucular

ContextMenu()	Menü öğesi belirtilmediğinde sınıfın ContextMenu yeni bir örneğini başlatır.
ContextMenu(MenuItem[])	Belirtilen nesne kümesiyle sınıfının yeni bir örneğini ContextMenu MenuItem başlatır.

Alanlar

FindHandle	yönteminin FindMenuItem(Int32, IntPtr) bir tanıtıcı araması gerektiğini belirtir. (Devralındığı yer: Menu)
FindShortcut	yönteminin FindMenuItem(Int32, IntPtr) bir kısayol araması gerektiğini belirtir. (Devralındığı yer: Menu)

Özellikler

CanRaiseEvents	Bileşenin bir olay oluşturup oluşturamayacağını belirten bir değer alır. (Devralındığı yer: Component)
Container	öğesini IContainer içeren öğesini Componentalır. (Devralındığı yer: Component)
DesignMode	öğesinin şu anda tasarım modunda olup olmadığını Component gösteren bir değer alır. (Devralındığı yer: Component)
Events	Bu Componentöğesine eklenen olay işleyicilerinin listesini alır. (Devralındığı yer: Component)
Handle	Menünün pencere tutamacını temsil eden bir değer alır. (Devralındığı yer: Menu)
IsParent	Bu menünün herhangi bir menü öğesi içerip içermediğini belirten bir değer alır. Bu özellik salt okunur durumdadır. (Devralındığı yer: Menu)
MdiListItem	Birden çok belge arabirimi (MDI) alt formu listesini görüntülemek için kullanılan değerini belirtir MenuItem . (Devralındığı yer: Menu)
MenuItems	Menüyle ilişkili nesne koleksiyonunu MenuItem gösteren bir değer alır. (Devralındığı yer: Menu)
Name	adını Menualır veya ayarlar. (Devralındığı yer: Menu)
RightToLeft	Denetim tarafından görüntülenen metnin sağdan sola görüntülenip görüntülenmeyeceğini belirten bir değer alır veya ayarlar.
Site	öğesini alır veya ayarlar ISite Component. (Devralındığı yer: Component)
SourceControl	Kısayol menüsünü görüntüleyen denetimi alır.
Tag	Denetimle ilişkili kullanıcı tanımlı verileri alır veya ayarlar. (Devralındığı yer: Menu)

Yöntemler

CloneMenu(Menu)	Menu Parametresi olarak geçirilen öğesini geçerli Menuöğesine kopyalar. (Devralındığı yer: Menu)
CreateMenuHandle()	için Menuyeni bir tanıtıcı oluşturur. (Devralındığı yer: Menu)
CreateObjRef(Type)	Uzak bir nesneyle iletişim kurmak için kullanılan bir ara sunucu oluşturmak için gereken tüm ilgili bilgileri içeren bir nesne oluşturur. (Devralındığı yer: MarshalByRefObject)
Dispose()	Component tarafından kullanılan tüm kaynakları serbest bırakır. (Devralındığı yer: Component)
Dispose(Boolean)	tarafından kullanılan bellek dışında kaynakları atılır Menu. (Devralındığı yer: Menu)
Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
FindMenuItem(Int32, IntPtr)	MenuItem Belirtilen değeri içeren değerini alır. (Devralındığı yer: Menu)
FindMergePosition(Int32)	Menü öğesinin menüye eklenmesi gereken konumu döndürür. (Devralındığı yer: Menu)
GetContextMenu()	Bu menüyü ContextMenu içeren öğesini alır. (Devralındığı yer: Menu)
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetLifetimeService()	Geçersiz. Bu örnek için yaşam süresi ilkesini denetleen geçerli yaşam süresi hizmet nesnesini alır. (Devralındığı yer: MarshalByRefObject)
GetMainMenu()	Bu menüyü MainMenu içeren öğesini alır. (Devralındığı yer: Menu)
GetService(Type)	veya tarafından Component Containersağlanan bir hizmeti temsil eden bir nesnesi döndürür. (Devralındığı yer: Component)
GetType()	Type Geçerli örneğini alır. (Devralındığı yer: Object)
InitializeLifetimeService()	Geçersiz. Bu örneğin yaşam süresi ilkesini denetlemek için bir yaşam süresi hizmet nesnesi alır. (Devralındığı yer: MarshalByRefObject)
MemberwiseClone()	Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object)
MemberwiseClone(Boolean)	Geçerli MarshalByRefObject nesnenin sığ bir kopyasını oluşturur. (Devralındığı yer: MarshalByRefObject)
MergeMenu(Menu)	Bir menünün MenuItem nesnelerini geçerli menüyle birleştirir. (Devralındığı yer: Menu)
OnCollapse(EventArgs)	Olayı tetikler Collapse .
OnPopup(EventArgs)	Olayı tetikler Popup .
ProcessCmdKey(Message, Keys)	Bir komut anahtarını işler. (Devralındığı yer: Menu)
ProcessCmdKey(Message, Keys, Control)	Bir komut anahtarını işler.
Show(Control, Point)	Kısayol menüsünü belirtilen konumda görüntüler.
Show(Control, Point, LeftRightAlignment)	Kısayol menüsünü belirtilen konumda ve belirtilen hizalamayla görüntüler.
ToString()	Denetimi temsil Menu eden bir String döndürür. (Devralındığı yer: Menu)

Ekinlikler

Collapse	Kısayol menüsü daraltıldığında gerçekleşir.
Disposed	Bileşen yöntemine Dispose() yapılan bir çağrı tarafından atıldığında gerçekleşir. (Devralındığı yer: Component)
Popup	Kısayol menüsü görüntülenmeden önce gerçekleşir.

Şunlara uygulanır