IMenuCommandService Arabirim

Tanım

Tasarım modunda kullanılabilen genel tasarımcı fiillerini ve menü komutlarını yönetmek ve bazı kısayol menü türlerini göstermek için yöntemler sağlar.

public interface class IMenuCommandService
public interface IMenuCommandService
[System.Runtime.InteropServices.ComVisible(true)]
public interface IMenuCommandService
type IMenuCommandService = interface
[<System.Runtime.InteropServices.ComVisible(true)>]
type IMenuCommandService = interface
Public Interface IMenuCommandService
Türetilmiş
Öznitelikler

Örnekler

Bu örnekte, eklemek için öğesinin IMenuCommandService kullanılması gösterilmektedir MenuCommand.

   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." );
      }
   };
}
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.");
    }
}
<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

Açıklamalar

Bu arabirim aşağıdakilere yönelik yöntemler sağlar:

  • Genel tasarımcı fiil komutlarını bulma, çağırma, ekleme ve kaldırma.

  • Standart menü komutlarını bulma, çağırma, ekleme ve kaldırma.

  • Standart menü komutları ile ilişkili olay işleyicilerini değiştirin.

  • Bir menüyle ilişkili standart komutların kısayol menüsünü CommandIDgörüntüleyin.

Designer fiiller, kısayol menüsünde tasarım modunda listelenen özel tanımlı komutları temsil edin. Tasarımcı fiili belirtilen bir metin etiketi sağlayabilir. Her tasarımcı fiiline otomatik olarak benzersiz CommandIDbir atanır. Tasarımcı özelliği aracılığıyla tasarımcı fiilleri Verbs sağlayabilir, ancak bunlar yalnızca tasarımcının bileşeni seçili olduğunda kullanılabilir. Genel tasarımcı fiilleri, seçilen bileşenden bağımsız olarak tasarım modu kısayol menüsünden erişilebilen tasarımcı fiil komutlarıdır. Bu arabirim, tasarım modunda kullanılabilen genel tasarımcı fiilleri kümesini yönetmenizi sağlar.

yöntemini kullanarak AddVerb genel tasarımcı fiili ekleyebilir ve yöntemini kullanarak genel tasarımcı fiilini RemoveVerb kaldırabilirsiniz. Fiili biliyorsanız CommandID yöntemini kullanarak GlobalInvoke bir tasarımcı fiili çağırabilirsiniz. Verbs Bu arabirimin özelliği, bir kısayol menüsünde görüntülenecek geçerli tasarımcı fiil komutları kümesini içerir. Bu tasarımcı fiil komutları kümesi, tüm genel tasarımcı fiillerinden ve o anda seçili olan herhangi bir bileşenin tasarımcısı tarafından sunulan tüm tasarımcı fiillerinden oluşur. Tasarımcı fiil komutları sunan bir tasarımcı bileşeni her seçildiğinde veya seçimi kaldırıldığında bu fiil kümesi güncelleştirilir.

Menü komutları, önceden tanımlanmış standart komutlar kümesiyle sınırlıdır. Önceden tanımlanmış standart komutların çoğu ve MenuCommands sabit listelerinde StandardCommands tanımlanır. Menü komutları ekleyebilir, kaldırabilir ve çağırabilir ve bu arabirimin yöntemlerini kullanarak bir menüye eklenmiş menü komutlarını arayabilirsiniz.

yöntemini kullanarak AddCommand standart menü komutu ekleyebilir ve yöntemini kullanarak RemoveCommand standart menü komutunu kaldırabilirsiniz. Yöntemin belgelerinde ayrıntılarıyla açıklanan yordamı izleyerek önceden tanımlanmış bir standart menü komutuna olay işleyicisi AddCommand ekleyebilirsiniz. bir menü komutu CommandID yöntemi kullanılarak FindCommand bir menüye eklenip eklenmediğini kullanarak alabilirsiniz. yöntemini kullanarak GlobalInvoke bir menü komutu veya tasarımcı fiili komutu CommandID çağırabilirsiniz.

Not

Zaten var olan CommandID bir menü komutu ekleme girişimi bir InvalidOperationExceptionoluşturur. Menü komutu eklerken, yöntemini kullanarak zaten bir menüde olmadığından emin olun veya özel durum işlemeyi FindCommand akıllıca kullanın.

Not

Menü komutu bir menüye eklenebilir ve Visible veya Enabled özellikleri olarak falseayarlanabilir. Bir menüye eklenmiş menü komutunu görsel olarak bulamazsanız, bu özelliklerden biri olarak falseayarlanmış olabilir.

yöntemini kullanarak belirli bir konumda menü komutları içeren bazı standart kısayol menülerini ShowContextMenu gösterebilirsiniz. Bu yöntemin belgeleri, gösterilecek geçerli menüleri belirten komut kimliklerini listeleyen bir tablo içerir.

Özellikler

Verbs

Şu anda kullanılabilir olan tasarımcı fiillerinin koleksiyonunu alır.

Yöntemler

AddCommand(MenuCommand)

Belirtilen standart menü komutunu menüye ekler.

AddVerb(DesignerVerb)

Belirtilen tasarımcı fiilini genel tasarımcı fiilleri kümesine ekler.

FindCommand(CommandID)

Belirtilen komut kimliğini arar ve onunla ilişkilendirilmiş menü komutunu döndürür.

GlobalInvoke(CommandID)

Belirtilen komut kimliğiyle eşleşen bir menü veya tasarımcı fiili komutunu çağırır.

RemoveCommand(MenuCommand)

Belirtilen standart menü komutunu menüden kaldırır.

RemoveVerb(DesignerVerb)

Belirtilen tasarımcı fiilini genel tasarımcı fiilleri koleksiyonundan kaldırır.

ShowContextMenu(CommandID, Int32, Int32)

Belirtilen konumda belirtilen kısayol menüsünü gösterir.

Şunlara uygulanır

Ayrıca bkz.