MenuCommand Classe

Definição

Representa um item de comando no menu ou barra de ferramentas do Windows.

public ref class MenuCommand
[System.Runtime.InteropServices.ComVisible(true)]
public class MenuCommand
public class MenuCommand
[<System.Runtime.InteropServices.ComVisible(true)>]
type MenuCommand = class
type MenuCommand = class
Public Class MenuCommand
Herança
MenuCommand
Derivado
Atributos

Exemplos

O seguinte exemplo de código cria um MenuCommand objeto, configura as suas propriedades e adiciona-o ao IMenuCommandServicearquivo .

Cria uma instância da classe Component1 no teu formulário e abre-o num ambiente de design como o Visual Studio. Pressione a tecla F1 para invocar o 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();
        }
    }

    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

Observações

A classe MenuCommand representa informação sobre um comando de menu Windows ou barra de ferramentas. A interface IMenuCommandService permite adicionar objetos MenuCommand ao menu Visual Studio.

Esta classe fornece os seguintes membros:

  • Uma propriedade de gestor de eventos à qual podes anexar um gestor de eventos para o comando.

  • Uma CommandID propriedade que identifica de forma única o comando.

  • Um Invoke método que executa o comando.

  • Um OnCommandChanged método que pode ser sobreposto para lidar com o evento que ocorre quando um novo comando é selecionado.

  • A flag booleana indica se o comando é Checked, Enabled, Supported, ou Visible.

  • Uma OleStatus propriedade que indica o código de estado do comando OLE para o comando.

  • Uma anulação para o ToString método.

Construtores

Name Description
MenuCommand(EventHandler, CommandID)

Inicializa uma nova instância da MenuCommand classe.

Propriedades

Name Description
Checked

Recebe ou define um valor que indica se este item do menu está assinalado.

CommandID

Recebe o CommandID comando associado a este menu.

Enabled

Recebe um valor que indica se este item do menu está disponível.

OleStatus

Recebe o código de estado do comando OLE para este item do menu.

Properties

Obtém as propriedades públicas associadas ao MenuCommand.

Supported

Recebe ou define um valor que indica se este item do menu é suportado.

Visible

Recebe ou define um valor que indica se este item do menu é visível.

Métodos

Name Description
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetHashCode()

Serve como função de hash predefinida.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
Invoke()

Invoca o comando.

Invoke(Object)

Invoca o comando com o parâmetro indicado.

MemberwiseClone()

Cria uma cópia superficial do atual Object.

(Herdado de Object)
OnCommandChanged(EventArgs)

Eleva o CommandChanged evento.

ToString()

Devolve uma representação em cadeia deste comando de menu.

evento

Name Description
CommandChanged

Ocorre quando o comando do menu muda.

Aplica-se a

Ver também