MenuCommand Classe

Definição

Namespace:

System.ComponentModel.Design

Assembly:

System.ComponentModel.TypeConverter.dll

Origem:

MenuCommand.cs

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

public ref class MenuCommand

public class MenuCommand

type MenuCommand = class

Public Class MenuCommand

Herança

Object

MenuCommand

Derivado

System.ComponentModel.Design.DesignerVerb

Exemplos

O exemplo de código a seguir cria um MenuCommand objeto , configura suas propriedades e o adiciona ao IMenuCommandService.

Crie uma instância da Component1 classe em seu formulário e abra o formulário em um 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

Comentários

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

Essa classe fornece os seguintes membros:

• Uma propriedade do manipulador de eventos à qual você pode anexar um manipulador de eventos para o comando.

• Uma CommandID propriedade que identifica exclusivamente o comando.

• Um Invoke método que executa o comando .

• Um OnCommandChanged método que pode ser substituído para manipular o evento que ocorre quando um novo comando é selecionado.

• Estados de sinalizador booliano que indicam se o comando é Checked, Enabled, Supportedou Visible.

• Uma OleStatus propriedade que indica o comando OLE status código para o comando .

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

Construtores

MenuCommand(EventHandler, CommandID)

Inicializa uma nova instância da classe MenuCommand.

Propriedades

Checked	Obtém ou define um valor que indica se esse item de menu está marcado.
CommandID	Obtém o CommandID associado a esse comando de menu.
Enabled	Obtém um valor que indica se este item de menu está disponível.
OleStatus	Obtém o código de status do comando OLE para este item de menu.
Properties	Obtém as propriedades públicas associadas ao MenuCommand.
Supported	Obtém ou define um valor que indica se esse item de menu é compatível.
Visible	Obtém ou define um valor que indica se esse item de menu está visível.

Métodos

Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetHashCode()	Serve como a função de hash padrão. (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 especificado.
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
OnCommandChanged(EventArgs)	Aciona o evento CommandChanged.
ToString()	Retorna uma representação de cadeia de caracteres desse comando de menu.

Eventos

CommandChanged

Ocorre quando o comando de menu muda.

Confira também

• StandardCommands
• IMenuCommandService
• CommandID
• Comandos de designer e o modelo de objeto DesignerAction para Windows Forms