ContextMenu Třída

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Zdroj:

ContextMenu.cs

Upozornění

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

Představuje místní nabídku.

Tato třída není dostupná v .NET Core 3.1 a novějších verzích. Místo toho použijte ContextMenuStrip , který nahrazuje a rozšiřuje ContextMenu ovládací prvek.

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

Dědičnost

Object

MarshalByRefObject

Component

Menu

ContextMenu

Atributy

BrowsableAttribute ObsoleteAttribute

Příklady

Následující příklad kódu vytvoří obslužnou rutinu události pro Popup událost události ContextMenu. Kód v obslužné rutině události určuje, který ze dvou ovládacích prvků pojmenovaný PictureBoxpictureBox1 a pojmenovaný TextBoxtextBox1 je ovládací prvek zobrazující místní nabídku. V závislosti na tom, který ovládací prvek způsobil ContextMenu zobrazení jeho místní nabídky, ovládací prvek přidá příslušné MenuItem objekty do objektu ContextMenu. Tento příklad vyžaduje, abyste měli instanci ContextMenu třídy s názvem contextMenu1, definovanou ve formuláři. Tento příklad také vyžaduje, abyste měli TextBox formulář a PictureBox přidali ho do formuláře a aby ContextMenu vlastnost těchto ovládacích prvků byla nastavena na contextMenu1hodnotu .

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

Poznámky

Tato třída není dostupná v .NET Core 3.1 a novějších verzích. Místo toho použijte ContextMenuStrip.

Třída ContextMenu představuje místní nabídky, které lze zobrazit, když uživatel klikne pravým tlačítkem myši na ovládací prvek nebo oblast formuláře. Místní nabídky se obvykle používají ke kombinování různých položek nabídky z MainMenu formuláře, které jsou užitečné pro uživatele vzhledem k kontextu aplikace. Pomocí místní nabídky přiřazené ovládacímu TextBox prvku můžete například zadat položky nabídky pro změnu písma textu, vyhledání textu v ovládacím prvku nebo funkce schránky pro kopírování a vkládání textu. Můžete také zobrazit nové MenuItem objekty v místní nabídce, které nejsou umístěny v rámci MainMenu prostředí, aby poskytovaly konkrétní příkazy, které nejsou vhodné pro MainMenu zobrazení.

Místní nabídka se obvykle zobrazí, když uživatel klikne na pravé tlačítko myši nad ovládacím prvku nebo samotným formulářem. Viditelné ovládací prvky a Form mají ContextMenu vlastnost, která váže ContextMenu třídu na ovládací prvek, který zobrazuje místní nabídku. Více než jeden ovládací prvek může použít ContextMenu. Pomocí vlastnosti můžete SourceControl určit, který ovládací prvek naposledy zobrazil místní nabídku, aby bylo možné provádět úlohy specifické pro ovládací prvek nebo upravit místní nabídku zobrazenou pro ovládací prvek.

Možná budete chtít vědět, kdy se místní nabídka zobrazuje, aby bylo možné nastavit značky zaškrtnutí, zakázat položky a provádět další úkoly nabídky před zobrazením nabídky uživateli. Událost můžete zpracovat Popup a určit, kdy se místní nabídka zobrazuje.

Poznámka:

Chcete-li znovu použít MenuItem objekty, které jsou zobrazeny pro použití v MainMenu aplikaci ContextMenu, je nutné vytvořit kopii nabídky pomocí CloneMenu metody MenuItem třídy. Položky nabídky a jejich podnabídky můžete také sloučit do jednoho MenuItem objektu MergeMenu pomocí metody MenuItem třídy.

Konstruktory

Name	Description
ContextMenu()	Zastaralé. Inicializuje novou instanci ContextMenu třídy bez zadaných položek nabídky.
ContextMenu(MenuItem[])	Zastaralé. Inicializuje novou instanci ContextMenu třídy se zadanou sadou MenuItem objektů.

Pole

Name	Description
FindHandle	Zastaralé. Určuje, že FindMenuItem(Int32, IntPtr) metoda by měla hledat popisovač. (Zděděno od Menu)
FindShortcut	Zastaralé. Určuje, že FindMenuItem(Int32, IntPtr) metoda by měla vyhledat zástupce. (Zděděno od Menu)

Vlastnosti

Name	Description
Handle	Zastaralé. Získá hodnotu představující popisovač okna pro nabídku. (Zděděno od Menu)
IsParent	Zastaralé. Získá hodnotu určující, zda tato nabídka obsahuje jakékoli položky nabídky. Tato vlastnost je jen ke čtení. (Zděděno od Menu)
MdiListItem	Zastaralé. Získá hodnotu označující MenuItem , který se používá k zobrazení seznamu více podřízených formulářů rozhraní dokumentů (MDI). (Zděděno od Menu)
MenuItems	Zastaralé. Získá hodnotu označující kolekci objektů přidružených MenuItem k nabídce. (Zděděno od Menu)
Name	Zastaralé. Získá nebo nastaví název Menu. (Zděděno od Menu)
RightToLeft	Zastaralé. Získá nebo nastaví hodnotu určující, zda text zobrazený ovládacím prvku je zobrazen zprava doleva.
SourceControl	Zastaralé. Získá ovládací prvek, který zobrazuje místní nabídku.
Tag	Zastaralé. Získá nebo nastaví uživatelem definovaná data přidružená k ovládacímu prvku. (Zděděno od Menu)

Metody

Name	Description
CloneMenu(Menu)	Zastaralé. Menu Zkopíruje předaný jako parametr do aktuálního Menusouboru . (Zděděno od Menu)
CreateMenuHandle()	Zastaralé. Vytvoří nový popisovač .Menu (Zděděno od Menu)
FindMenuItem(Int32, IntPtr)	Zastaralé. MenuItem Získá hodnotu, která obsahuje zadanou hodnotu. (Zděděno od Menu)
FindMergePosition(Int32)	Zastaralé. Vrátí pozici, do které se má položka nabídky vložit. (Zděděno od Menu)
GetContextMenu()	Zastaralé. ContextMenu Získá hodnotu, která obsahuje tuto nabídku. (Zděděno od Menu)
GetMainMenu()	Zastaralé. MainMenu Získá hodnotu, která obsahuje tuto nabídku. (Zděděno od Menu)
MergeMenu(Menu)	Zastaralé. Sloučí MenuItem objekty jedné nabídky s aktuální nabídkou. (Zděděno od Menu)
OnCollapse(EventArgs)	Zastaralé. Collapse Vyvolá událost.
OnPopup(EventArgs)	Zastaralé. Popup Vyvolá událost.
ProcessCmdKey(Message, Keys, Control)	Zastaralé. Zpracovává příkazový klíč.
ProcessCmdKey(Message, Keys)	Zastaralé. Zpracovává příkazový klíč. (Zděděno od Menu)
Show(Control, Point, LeftRightAlignment)	Zastaralé. Zobrazí místní nabídku na zadané pozici a se zadaným zarovnáním.
Show(Control, Point)	Zastaralé. Zobrazí místní nabídku na zadané pozici.

Událost

Name	Description
Collapse	Zastaralé. Nastane, když se místní nabídka sbalí.
Popup	Zastaralé. Nastane před zobrazením místní nabídky.

Viz také

• Menu
• MenuItem
• MainMenu