MenuCommand MenuCommand MenuCommand MenuCommand Class

Definition

Stellt einen Befehl in einem Windows-Menü oder auf einer Windows-Symbolleiste dar.Represents a Windows menu or toolbar command item.

public ref class MenuCommand
[System.Runtime.InteropServices.ComVisible(true)]
public class MenuCommand
type MenuCommand = class
Public Class MenuCommand
Vererbung
MenuCommandMenuCommandMenuCommandMenuCommand
Abgeleitet
Attribute

Beispiele

Das folgende Codebeispiel erstellt eine MenuCommand -Objekt, dessen Eigenschaften konfiguriert und fügt es der IMenuCommandService.The following code example creates a MenuCommand object, configures its properties, and adds it to the IMenuCommandService.

Erstellen Sie eine Instanz von der Component1 Klasse in Ihrem Formular ein, und öffnen Sie das Formular in einer entwurfsumgebung wie Visual Studio.Create an instance of the Component1 class on your form and open the form in a design environment like Visual Studio. Drücken Sie die F1-Taste zum Aufrufen der MenuCommand.Press the F1 key to invoke the MenuCommand.

#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();
        }
    }

    [System.Security.Permissions.PermissionSet(System.Security.Permissions.SecurityAction.Demand, Name = "FullTrust")] 
    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
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 über einen Windows-Menü oder Symbolleiste-Befehl.The MenuCommand class represents information about a Windows menu or toolbar command. Die IMenuCommandService Schnittstelle ermöglicht es Ihnen hinzuzufügende MenuCommand Objekte, die Visual Studio-Menü.The IMenuCommandService interface allows you to add MenuCommand objects to the Visual Studio menu.

Diese Klasse bietet die folgenden Elemente:This class provides the following members:

  • Eine Ereignishandler-Eigenschaft, zu der Sie einen Ereignishandler für den Befehl anfügen können.An event-handler property to which you can attach an event handler for the command.

  • Ein CommandID -Eigenschaft, die den Befehl eindeutig identifiziert.A CommandID property that uniquely identifies the command.

  • Ein Invoke -Methode, die der Befehl ausgeführt wird.An Invoke method that executes the command.

  • Ein OnCommandChanged -Methode, die überschrieben werden kann, um das Ereignis zu behandeln, das auftritt, wenn ein neuer Befehl ausgewählt wird.An OnCommandChanged method that can be overridden to handle the event that occurs when a new command is selected.

  • Boolesches Flag, das Zustände, die angeben, ob der Befehl ist Checked, Enabled, Supported, oder Visible.Boolean flag states that indicate whether the command is Checked, Enabled, Supported, or Visible.

  • Ein OleStatus -Eigenschaft, die zeigt, an die OLE-Befehlsstatus für den Befehl.An OleStatus property that indicates the OLE command status code for the command.

  • Eine Außerkraftsetzung für die ToString Methode.An override for the ToString method.

Konstruktoren

MenuCommand(EventHandler, CommandID) MenuCommand(EventHandler, CommandID) MenuCommand(EventHandler, CommandID) MenuCommand(EventHandler, CommandID)

Initialisiert eine neue Instanz der MenuCommand-Klasse.Initializes a new instance of the MenuCommand class.

Eigenschaften

Checked Checked Checked Checked

Ruft einen Wert ab, der angibt, ob dieses Menüelement aktiviert ist, oder legt diesen fest.Gets or sets a value indicating whether this menu item is checked.

CommandID CommandID CommandID CommandID

Ruft die CommandID-Klasse ab, die diesem Menübefehl zugeordnet ist.Gets the CommandID associated with this menu command.

Enabled Enabled Enabled Enabled

Ruft einen Wert ab, der angibt, ob dieses Menüelement verfügbar ist.Gets a value indicating whether this menu item is available.

OleStatus OleStatus OleStatus OleStatus

Ruft den OLE-Befehlsstatus für dieses Menüelement ab.Gets the OLE command status code for this menu item.

Properties Properties Properties Properties

Ruft die öffentlichen Eigenschaften ab, die der MenuCommand-Klasse zugeordnet sind.Gets the public properties associated with the MenuCommand.

Supported Supported Supported Supported

Ruft einen Wert ab, der angibt, ob dieses Menüelement unterstützt wird, oder legt diesen fest.Gets or sets a value indicating whether this menu item is supported.

Visible Visible Visible Visible

Ruft einen Wert ab, der angibt, ob dieses Menüelement sichtbar ist, oder legt diesen fest.Gets or sets a value indicating whether this menu item is visible.

Methoden

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Inherited from Object)
Invoke() Invoke() Invoke() Invoke()

Ruft den Befehl auf.Invokes the command.

Invoke(Object) Invoke(Object) Invoke(Object) Invoke(Object)

Ruft den Befehl mit dem angegebenen Parameter auf.Invokes the command with the given parameter.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Inherited from Object)
OnCommandChanged(EventArgs) OnCommandChanged(EventArgs) OnCommandChanged(EventArgs) OnCommandChanged(EventArgs)

Löst das CommandChanged-Ereignis aus.Raises the CommandChanged event.

ToString() ToString() ToString() ToString()

Gibt eine Zeichenfolgendarstellung dieses Menübefehls zurück.Returns a string representation of this menu command.

Ereignisse

CommandChanged CommandChanged CommandChanged CommandChanged

Tritt bei einer Änderung des Menübefehls ein.Occurs when the menu command changes.

Sicherheit

NamedPermissionSet
für vollständigen Zugriff auf Systemressourcen.for full access to system resources. Erfordern von Werten: LinkDemand, InheritanceDemand.Demand values: LinkDemand, InheritanceDemand. Zugeordnete Zustand:Associated state:

Gilt für:

Siehe auch