MenuCommand Klasse

Definition

Namespace:

System.ComponentModel.Design

Assemblys:

netstandard.dll, System.ComponentModel.TypeConverter.dll

Quelle:

MenuCommand.cs

Stellt ein Windows-Menü- oder Symbolleistenbefehlselement dar.

public ref class MenuCommand

public class MenuCommand

type MenuCommand = class

Public Class MenuCommand

Vererbung

Object

MenuCommand

Abgeleitet

System.ComponentModel.Design.DesignerVerb

Beispiele

Im folgenden Codebeispiel wird ein MenuCommand Objekt erstellt, seine Eigenschaften konfiguriert und dem IMenuCommandServiceObjekt hinzugefügt.

Erstellen Sie eine Instanz der Component1 Klasse in Ihrem Formular, und öffnen Sie das Formular in einer Entwurfsumgebung wie Visual Studio. Drücken Sie F1, um die MenuCommandTaste aufzurufen.

#using <system.dll>
#using <system.design.dll>
#using <system.windows.forms.dll>

using namespace System;
using namespace System::ComponentModel;
using namespace System::ComponentModel::Design;
using namespace System::Security::Permissions;

namespace CppMenuCommand
{
   public ref class CDesigner: public ComponentDesigner
   {
   public:
    [PermissionSetAttribute(SecurityAction::Demand, Name="FullTrust")]
      virtual void Initialize( IComponent^ comp ) override
      {
         ComponentDesigner::Initialize( comp );
         IMenuCommandService^ mcs = static_cast<IMenuCommandService^>(comp->Site->GetService( IMenuCommandService::typeid ));
         MenuCommand^ mc = gcnew MenuCommand( gcnew EventHandler( this, &CDesigner::OnF1Help ),StandardCommands::F1Help );
         mc->Enabled = true;
         mc->Visible = true;
         mc->Supported = true;
         mcs->AddCommand( mc );
         System::Windows::Forms::MessageBox::Show( "Initialize() has been invoked." );
      }

   private:
      void OnF1Help( Object^ /*sender*/, EventArgs^ /*e*/ )
      {
         System::Windows::Forms::MessageBox::Show( "F1Help has been invoked." );
      }
   };
}

using System;
using System.ComponentModel;
using System.ComponentModel.Design;

namespace CSMenuCommand
{
    [Designer(typeof(CDesigner))]
    public class Component1 : System.ComponentModel.Component
    {
        private System.ComponentModel.Container components = null;

        public Component1(System.ComponentModel.IContainer container)
        {
            container.Add(this);
            InitializeComponent();
        }

        public Component1()
        {
            InitializeComponent();
        }

        private void InitializeComponent()
        {
            components = new System.ComponentModel.Container();
        }
    }

    public class CDesigner : System.ComponentModel.Design.ComponentDesigner 
    {
        public override void Initialize(IComponent comp) 
        {
            base.Initialize(comp);

            IMenuCommandService mcs = (IMenuCommandService)comp.Site.
                        GetService(typeof(IMenuCommandService));
            MenuCommand mc = new MenuCommand(new EventHandler(OnF1Help), StandardCommands.F1Help);
            mc.Enabled = true;
            mc.Visible = true;
            mc.Supported = true;
            mcs.AddCommand(mc);
            System.Windows.Forms.MessageBox.Show("Initialize() has been invoked.");
        }

        private void OnF1Help(object sender, EventArgs e) 
        {
            System.Windows.Forms.MessageBox.Show("F1Help has been invoked.");
        }
    }
}

Imports System.ComponentModel
Imports System.ComponentModel.Design

Namespace VbMenuCommand
    <Designer(GetType(CDesigner))> _
    Public Class Component1
        Inherits System.ComponentModel.Component
        Private components As System.ComponentModel.Container = Nothing

        Public Sub New(ByVal container As System.ComponentModel.IContainer)
            container.Add(Me)
            InitializeComponent()
        End Sub

        Public Sub New()
            InitializeComponent()
        End Sub

        Private Sub InitializeComponent()
        End Sub
    End Class

    <System.Security.Permissions.PermissionSetAttribute(System.Security.Permissions.SecurityAction.Demand, Name:="FullTrust")> _
    Public Class CDesigner
        Inherits System.ComponentModel.Design.ComponentDesigner

        Public Overrides Sub Initialize(ByVal comp As IComponent)
            MyBase.Initialize(comp)

            Dim mcs As IMenuCommandService = CType(comp.Site.GetService(GetType(IMenuCommandService)), IMenuCommandService)
            Dim mc As New MenuCommand(New EventHandler(AddressOf OnF1Help), StandardCommands.F1Help)
            mc.Enabled = True
            mc.Visible = True
            mc.Supported = True
            mcs.AddCommand(mc)
            System.Windows.Forms.MessageBox.Show("Initialize() has been invoked.")
        End Sub

        Private Sub OnF1Help(ByVal sender As Object, ByVal e As EventArgs)
            System.Windows.Forms.MessageBox.Show("F1Help has been invoked.")
        End Sub
    End Class
End Namespace

Hinweise

Die MenuCommand Klasse stellt Informationen zu einem Windows-Menü oder einem Symbolleistenbefehl dar. Über die IMenuCommandService Schnittstelle können Sie dem Visual Studio-Menü Objekte hinzufügen MenuCommand .

Diese Klasse stellt die folgenden Member bereit:

• Eine Ereignishandlereigenschaft, der Sie einen Ereignishandler für den Befehl anfügen können.

• Eine CommandID Eigenschaft, die den Befehl eindeutig identifiziert.

• Eine Invoke Methode, die den Befehl ausführt.

• Eine OnCommandChanged Methode, die überschrieben werden kann, um das Ereignis zu behandeln, das auftritt, wenn ein neuer Befehl ausgewählt wird.

• Boolesche Kennzeichnungszustände, die angeben, ob der Befehl Checked, , Enabled, Supportedoder Visible.

• Eine OleStatus Eigenschaft, die den OLE-Befehlsstatuscode für den Befehl angibt.

• Eine Außerkraftsetzung für die ToString Methode.

Konstruktoren

Name	Beschreibung
MenuCommand(EventHandler, CommandID)	Initialisiert eine neue Instanz der MenuCommand-Klasse.

Eigenschaften

Name	Beschreibung
Checked	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob dieses Menüelement aktiviert ist.
CommandID	Ruft den CommandID diesem Menübefehl zugeordneten Ab.
Enabled	Ruft einen Wert ab, der angibt, ob dieses Menüelement verfügbar ist.
OleStatus	Ruft den OLE-Befehlsstatuscode für dieses Menüelement ab.
Properties	Ruft die öffentlichen Eigenschaften ab, die der MenuCommand.
Supported	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob dieses Menüelement unterstützt wird.
Visible	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob dieses Menüelement sichtbar ist.

Methoden

Name	Beschreibung
Equals(Object)	Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht. (Geerbt von Object)
GetHashCode()	Dient als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft die Type der aktuellen Instanz ab. (Geerbt von Object)
Invoke()	Ruft den Befehl auf.
Invoke(Object)	Ruft den Befehl mit dem angegebenen Parameter auf.
MemberwiseClone()	Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object)
OnCommandChanged(EventArgs)	Löst das CommandChanged-Ereignis aus.
ToString()	Gibt eine Zeichenfolgendarstellung dieses Menübefehls zurück.

Ereignisse

Name	Beschreibung
CommandChanged	Tritt auf, wenn sich der Menübefehl ändert.

Weitere Informationen

• StandardCommands
• IMenuCommandService
• CommandID
• Designerbefehle und das DesignerAction-Objektmodell für Windows Forms