IMenuCommandService Schnittstelle

Definition

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

Abgeleitet

System.ComponentModel.Design.MenuCommandService

Attribute

ComVisibleAttribute

Beispiele

In diesem Beispiel wird die Verwendung von IMenuCommandService zum Hinzufügen eines MenuCommandveranschaulicht.

   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

Hinweise

Diese Schnittstelle bietet Methoden für Folgendes:

• Suchen, Aufrufen, Hinzufügen und Entfernen von Befehlen für globale Designerverben.

• Suchen, Aufrufen, Hinzufügen und Entfernen von Standardmenübefehlen.

• Ändern Sie die Ereignishandler, die Standardmenübefehlen zugeordnet sind.

• Zeigt ein Kontextmenü mit Standardbefehlen an, das einem Menü CommandIDzugeordnet ist.

Designer Verben stellen benutzerdefinierte Befehle dar, die im Entwurfsmodus im Kontextmenü aufgeführt werden. Ein Designerverb kann eine angegebene Textbezeichnung bereitstellen. Jedem Designerverb wird automatisch ein eindeutiges CommandIDzugewiesen. Ein Designer kann Designerverben über seine Verbs -Eigenschaft bereitstellen, diese sind jedoch nur verfügbar, wenn die Komponente des Designers derzeit ausgewählt ist. Globale Designerverben sind Designerverbbefehle, auf die unabhängig von der ausgewählten Komponente über ein Kontextmenü im Entwurfsmodus zugegriffen werden kann. Mit dieser Schnittstelle können Sie den Satz von globalen Designerverben verwalten, die im Entwurfsmodus verfügbar sind.

Sie können mithilfe der AddVerb -Methode ein globales Designerverb hinzufügen und ein globales Designerverb mithilfe der RemoveVerb -Methode entfernen. Sie können ein Designerverb mit der GlobalInvoke -Methode aufrufen, wenn Sie den CommandID des Verbs kennen. Die Verbs -Eigenschaft dieser Schnittstelle enthält den aktuellen Satz von Designer-Verbbefehlen, die in einem Kontextmenü angezeigt werden sollen. Dieser Satz von Designer-Verbbefehlen besteht aus allen globalen Designerverben und allen Designerverben, die vom Designer einer derzeit ausgewählten Komponente angeboten werden. Dieser Satz von Verben wird jedes Mal aktualisiert, wenn eine Komponente mit einem Designer, der Designer-Verbbefehle anbietet, ausgewählt oder deaktiviert wird.

Menübefehle sind auf den Satz vordefinierter Standardbefehle beschränkt. Die meisten vordefinierten Standardbefehle sind in den StandardCommands Enumerationen und MenuCommands definiert. Sie können Menübefehle hinzufügen, entfernen und aufrufen sowie nach Menübefehlen suchen, die einem Menü hinzugefügt wurden, indem Sie Methoden dieser Schnittstelle verwenden.

Sie können einen Standardmenübefehl mithilfe der AddCommand -Methode hinzufügen und einen Standardmenübefehl mithilfe der RemoveCommand -Methode entfernen. Sie können einen Ereignishandler an einen vordefinierten Standardmenübefehl anfügen, indem Sie das in der Dokumentation für die AddCommand -Methode beschriebene Verfahren befolgen. Sie können einen Menübefehl mithilfe der FindCommand -Methode abrufen, wenn CommandID er einem Menü hinzugefügt wurde. Sie können einen Menübefehl oder einen Designerverbbefehl CommandID mit der GlobalInvoke -Methode aufrufen.

Mithilfe der ShowContextMenu -Methode können Sie bestimmte Standardverknüpfungsmenüs mit Menübefehlen an einer bestimmten Position anzeigen. Die Dokumentation für diese Methode enthält eine Tabelle mit den Befehls-IDs, die die gültigen anzuzeigenden Menüs angeben.

Eigenschaften

Methoden

Gilt für:

Weitere Informationen

• MenuCommand
• DesignerVerb
• CommandID
• MenuCommands
• StandardCommands