ContextMenu Klasa

Definicja

Reprezentuje menu skrótów.

Ta klasa nie jest dostępna na platformie .NET Core 3.1 i nowszych wersjach. Zamiast tego należy użyć ContextMenuStrip elementu , który zastępuje i rozszerza kontrolkę 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
Dziedziczenie

Przykłady

Poniższy przykład kodu tworzy procedurę obsługi zdarzeń dla Popup zdarzenia ContextMenu. Kod w procedurze obsługi zdarzeń określa, które z dwóch kontrolek ma PictureBox nazwę pictureBox1 , a TextBox nazwa textBox1 jest kontrolką wyświetlającą menu skrótów. W zależności od tego, która kontrolka ContextMenu spowodowała wyświetlenie menu skrótów, kontrolka dodaje odpowiednie MenuItem obiekty do obiektu ContextMenu. Ten przykład wymaga wystąpienia ContextMenu klasy o nazwie contextMenu1, zdefiniowanej w formularzu. W tym przykładzie jest również wymagane TextBox dodanie obiektu i PictureBox do formularza oraz że ContextMenu właściwość tych kontrolek jest ustawiona na contextMenu1wartość .

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

Uwagi

Ta klasa nie jest dostępna na platformie .NET Core 3.1 i nowszych wersjach. Zamiast tego użyj polecenia cmdlet ContextMenuStrip.

Klasa ContextMenu reprezentuje menu skrótów, które można wyświetlić, gdy użytkownik kliknie prawy przycisk myszy nad kontrolką lub obszarem formularza. Menu skrótów są zwykle używane do łączenia różnych elementów menu z MainMenu formularza, który jest przydatny dla użytkownika w kontekście aplikacji. Na przykład można użyć menu skrótów przypisanego TextBox do kontrolki, aby udostępnić elementy menu umożliwiające zmianę czcionki tekstu, znalezienie tekstu w kontrolce lub funkcje Schowka na potrzeby kopiowania i wklejania tekstu. Nowe obiekty można również wyświetlić MenuItem w menu skrótów, które nie znajdują się w obiekcie MainMenu , aby zapewnić konkretne polecenia, które nie są odpowiednie do MainMenu wyświetlenia.

Zazwyczaj menu skrótów jest wyświetlane, gdy użytkownik kliknie prawy przycisk myszy nad kontrolką lub samym formularzem. Widoczne kontrolki i Form mają właściwość, która wiąże ContextMenu klasę ContextMenu z kontrolką, która wyświetla menu skrótów. Więcej niż jedna kontrolka może używać kontrolki ContextMenu. Za pomocą SourceControl właściwości można określić, która kontrolka ostatnio wyświetla menu skrótów, aby wykonywać zadania specyficzne dla kontrolki lub zmodyfikować menu skrótów wyświetlane dla kontrolki.

Warto wiedzieć, kiedy menu skrótów jest wyświetlane, aby ustawić znaczniki wyboru, wyłączyć elementy i wykonać inne zadania menu przed wyświetleniem menu użytkownikowi. Zdarzenie można obsłużyć, Popup aby określić, kiedy jest wyświetlane menu skrótów.

Uwaga

Aby ponownie używać MenuItem obiektów wyświetlanych w obiekcie do użycia w MainMenu obiekcie ContextMenu, należy utworzyć kopię menu przy użyciu CloneMenu metody MenuItem klasy . Można również scalić elementy menu i ich elementy podrzędne w jeden MenuItem obiekt przy użyciu MergeMenu metody MenuItem klasy.

Konstruktory

ContextMenu()

Inicjuje ContextMenu nowe wystąpienie klasy bez określonych elementów menu.

ContextMenu(MenuItem[])

Inicjuje ContextMenu nowe wystąpienie klasy z określonym zestawem MenuItem obiektów.

Pola

FindHandle

Określa, że FindMenuItem(Int32, IntPtr) metoda powinna wyszukać uchwyt.

(Odziedziczone po Menu)
FindShortcut

Określa, że FindMenuItem(Int32, IntPtr) metoda powinna wyszukać skrót.

(Odziedziczone po Menu)

Właściwości

CanRaiseEvents

Pobiera wartość wskazującą, czy składnik może zgłosić zdarzenie.

(Odziedziczone po Component)
Container

Pobiera element IContainer zawierający element Component.

(Odziedziczone po Component)
DesignMode

Pobiera wartość wskazującą, czy Component element jest obecnie w trybie projektowania.

(Odziedziczone po Component)
Events

Pobiera listę programów obsługi zdarzeń dołączonych do tego Componentelementu .

(Odziedziczone po Component)
Handle

Pobiera wartość reprezentującą uchwyt okna dla menu.

(Odziedziczone po Menu)
IsParent

Pobiera wartość wskazującą, czy to menu zawiera jakiekolwiek elementy menu. Ta właściwość jest tylko do odczytu.

(Odziedziczone po Menu)
MdiListItem

Pobiera wartość wskazującą MenuItem , która jest używana do wyświetlania listy formularzy podrzędnych interfejsu wielu dokumentów (MDI).

(Odziedziczone po Menu)
MenuItems

Pobiera wartość wskazującą kolekcję obiektów skojarzonych MenuItem z menu.

(Odziedziczone po Menu)
Name

Pobiera lub ustawia nazwę .Menu

(Odziedziczone po Menu)
RightToLeft

Pobiera lub ustawia wartość wskazującą, czy tekst wyświetlany przez kontrolkę jest wyświetlany od prawej do lewej.

Site

Pobiera lub ustawia wartość ISite .Component

(Odziedziczone po Component)
SourceControl

Pobiera kontrolkę wyświetlającą menu skrótów.

Tag

Pobiera lub ustawia dane zdefiniowane przez użytkownika skojarzone z kontrolką.

(Odziedziczone po Menu)

Metody

CloneMenu(Menu)

Kopiuje Menu element przekazywany jako parametr do bieżącego Menuelementu .

(Odziedziczone po Menu)
CreateMenuHandle()

Tworzy nowy dojście do elementu Menu.

(Odziedziczone po Menu)
CreateObjRef(Type)

Tworzy obiekt zawierający wszystkie istotne informacje wymagane do wygenerowania serwera proxy używanego do komunikowania się z obiektem zdalnym.

(Odziedziczone po MarshalByRefObject)
Dispose()

Zwalnia wszelkie zasoby używane przez element Component.

(Odziedziczone po Component)
Dispose(Boolean)

Usuwa zasoby, inne niż pamięć, używane przez element Menu.

(Odziedziczone po Menu)
Equals(Object)

Określa, czy dany obiekt jest taki sam, jak bieżący obiekt.

(Odziedziczone po Object)
FindMenuItem(Int32, IntPtr)

Pobiera element MenuItem zawierający określoną wartość.

(Odziedziczone po Menu)
FindMergePosition(Int32)

Zwraca pozycję, w której element menu powinien zostać wstawiony do menu.

(Odziedziczone po Menu)
GetContextMenu()

Pobiera element ContextMenu zawierający to menu.

(Odziedziczone po Menu)
GetHashCode()

Służy jako domyślna funkcja skrótu.

(Odziedziczone po Object)
GetLifetimeService()
Przestarzałe.

Pobiera bieżący obiekt usługi okresu istnienia, który kontroluje zasady okresu istnienia dla tego wystąpienia.

(Odziedziczone po MarshalByRefObject)
GetMainMenu()

Pobiera element MainMenu zawierający to menu.

(Odziedziczone po Menu)
GetService(Type)

Zwraca obiekt, który reprezentuje usługę dostarczaną przez Component obiekt lub przez element Container.

(Odziedziczone po Component)
GetType()

Type Pobiera wartość bieżącego wystąpienia.

(Odziedziczone po Object)
InitializeLifetimeService()
Przestarzałe.

Uzyskuje obiekt usługi okresu istnienia w celu kontrolowania zasad okresu istnienia dla tego wystąpienia.

(Odziedziczone po MarshalByRefObject)
MemberwiseClone()

Tworzy płytkią kopię bieżącego Objectelementu .

(Odziedziczone po Object)
MemberwiseClone(Boolean)

Tworzy płytkią kopię bieżącego MarshalByRefObject obiektu.

(Odziedziczone po MarshalByRefObject)
MergeMenu(Menu)

Scala MenuItem obiekty jednego menu z bieżącym menu.

(Odziedziczone po Menu)
OnCollapse(EventArgs)

Collapse Zgłasza zdarzenie.

OnPopup(EventArgs)

Popup Zgłasza zdarzenie.

ProcessCmdKey(Message, Keys)

Przetwarza klucz polecenia.

(Odziedziczone po Menu)
ProcessCmdKey(Message, Keys, Control)

Przetwarza klucz polecenia.

Show(Control, Point)

Wyświetla menu skrótów w określonej pozycji.

Show(Control, Point, LeftRightAlignment)

Wyświetla menu skrótów w określonej pozycji i z określonym wyrównaniem.

ToString()

Zwraca kontrolkę reprezentującą String kontrolkę Menu .

(Odziedziczone po Menu)

Zdarzenia

Collapse

Występuje, gdy menu skrótów zwinie się.

Disposed

Występuje, gdy składnik jest usuwany przez wywołanie Dispose() metody .

(Odziedziczone po Component)
Popup

Występuje przed wyświetleniem menu skrótów.

Dotyczy

Zobacz też