ContextMenu Sınıf

Tanım

Ad Alanı:

System.Windows.Forms

Bütünleştirilmiş Kod:

System.Windows.Forms.dll

Kaynak:

ContextMenu.cs

Dikkat

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

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

Bu sınıf .NET Core 3.1 ve sonraki sürümlerde kullanılamaz. Bunun ContextMenuStrip yerine, denetimin yerini alan ve genişleten kullanın 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

Devralma

Object

MarshalByRefObject

Component

Menu

ContextMenu

Öznitelikler

BrowsableAttribute ObsoleteAttribute

Örnekler

Aşağıdaki kod örneği, olayı için Popup bir olay işleyicisi ContextMenuoluşturur. Olay işleyicisindeki kod, bir adlı ve TextBoxtextBox1 bir adlı pictureBox1 iki denetimden PictureBox hangisinin 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, formda tanımlanan adlı contextMenu1sınıfının bir örneğine ContextMenu sahip olmanız gerekir. Bu örnek, forma bir TextBox ve PictureBox ekleyip bu denetimlerin ContextMenu özelliğinin olarak ayarlanmasını contextMenu1da gerektirir.

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 için menü öğeleri veya metin kopyalayıp yapıştırmak için Pano özellikleri sağlamak için denetime atanmış bir TextBox kısayol menüsünü kullanabilirsiniz. Ayrıca, öğesinin görüntülemesi 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, 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ını 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 üzere 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.

Uyarı

içinde kullanmak üzere içinde görüntülenen MainMenu nesneleri 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 alt menü öğelerini tek MenuItem bir nesnede MergeMenu birleştirebilirsiniz.

Oluşturucular

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

Alanlar

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

Özellikler

Name	Description
Handle	Geçersiz. Menünün pencere tutamacını temsil eden bir değer alır. (Devralındığı yer: Menu)
IsParent	Geçersiz. Bu menünün herhangi bir menü öğesi içerip içermediğini belirten bir değer alır. Bu özellik salt okunurdur. (Devralındığı yer: Menu)
MdiListItem	Geçersiz. Birden çok belge arabirimi (MDI) alt formu listesini görüntülemek için kullanılan değerini belirten MenuItem bir değer alır. (Devralındığı yer: Menu)
MenuItems	Geçersiz. Menüyle ilişkili nesne koleksiyonunu MenuItem gösteren bir değer alır. (Devralındığı yer: Menu)
Name	Geçersiz. öğesinin adını Menualır veya ayarlar. (Devralındığı yer: Menu)
RightToLeft	Geçersiz. 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.
SourceControl	Geçersiz. Kısayol menüsünü görüntüleyen denetimi alır.
Tag	Geçersiz. Denetimle ilişkili kullanıcı tanımlı verileri alır veya ayarlar. (Devralındığı yer: Menu)

Yöntemler

Name	Description
CloneMenu(Menu)	Geçersiz. Menu Parametresi olarak geçirilen öğesini geçerli Menuöğesine kopyalar. (Devralındığı yer: Menu)
CreateMenuHandle()	Geçersiz. için Menuyeni bir tanıtıcı oluşturur. (Devralındığı yer: Menu)
FindMenuItem(Int32, IntPtr)	Geçersiz. MenuItem Belirtilen değeri içeren değerini alır. (Devralındığı yer: Menu)
FindMergePosition(Int32)	Geçersiz. Menü öğesinin menüye eklenmesi gereken konumu döndürür. (Devralındığı yer: Menu)
GetContextMenu()	Geçersiz. Bu menüyü ContextMenu içeren öğesini alır. (Devralındığı yer: Menu)
GetMainMenu()	Geçersiz. Bu menüyü MainMenu içeren öğesini alır. (Devralındığı yer: Menu)
MergeMenu(Menu)	Geçersiz. Bir menünün MenuItem nesnelerini geçerli menüyle birleştirir. (Devralındığı yer: Menu)
OnCollapse(EventArgs)	Geçersiz. Olayı tetikler Collapse .
OnPopup(EventArgs)	Geçersiz. Olayı tetikler Popup .
ProcessCmdKey(Message, Keys, Control)	Geçersiz. Bir komut anahtarını işler.
ProcessCmdKey(Message, Keys)	Geçersiz. Bir komut anahtarını işler. (Devralındığı yer: Menu)
Show(Control, Point, LeftRightAlignment)	Geçersiz. Kısayol menüsünü belirtilen konumda ve belirtilen hizalamayla görüntüler.
Show(Control, Point)	Geçersiz. Kısayol menüsünü belirtilen konumda görüntüler.

Ekinlikler

Name	Description
Collapse	Geçersiz. Kısayol menüsü daraltıldığında gerçekleşir.
Popup	Geçersiz. Kısayol menüsü görüntülenmeden önce gerçekleşir.

Ayrıca bkz.

• Menu
• MenuItem
• MainMenu