DesignerVerb Class

Definition

Rappresenta un verbo che può essere richiamato da una finestra di progettazione.Represents a verb that can be invoked from a designer.

public ref class DesignerVerb : System::ComponentModel::Design::MenuCommand
public class DesignerVerb : System.ComponentModel.Design.MenuCommand
[System.Runtime.InteropServices.ComVisible(true)]
public class DesignerVerb : System.ComponentModel.Design.MenuCommand
type DesignerVerb = class
    inherit MenuCommand
Public Class DesignerVerb
Inherits MenuCommand
Inheritance
DesignerVerb
Derived
Attributes

Examples

Nell'esempio di codice seguente viene illustrato come creare oggetti DesignerVerb e aggiungerli al menu di scelta rapida della fase di progettazione per un componente.The following code example demonstrates how to create DesignerVerb objects and add them to the design-time shortcut menu for a component.

#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::Windows::Forms;

/* This sample demonstrates a designer that adds menu commands
to the design-time shortcut menu for a component.

To test this sample, build the code for the component as a class library,
add the resulting component to the toolbox, open a form in design mode,
and drag the component from the toolbox onto the form.

The component should appear in the component tray beneath the form.
Right-click the component.  The verbs should appear in the shortcut menu.
*/
// This is a designer class which provides designer verb menu commands for
// the associated component. This code is called by the design environment at design-time.
private ref class MyDesigner: public ComponentDesigner
{
public:

   property DesignerVerbCollection^ Verbs 
   {
      // DesignerVerbCollection is overridden from ComponentDesigner
      virtual DesignerVerbCollection^ get() override
      {
         if ( m_Verbs == nullptr )
         {
            // Create and initialize the collection of verbs
            m_Verbs = gcnew DesignerVerbCollection;
            m_Verbs->Add( gcnew DesignerVerb( "First Designer Verb",gcnew EventHandler( this, &MyDesigner::OnFirstItemSelected ) ) );
            m_Verbs->Add( gcnew DesignerVerb( "Second Designer Verb",gcnew EventHandler( this, &MyDesigner::OnSecondItemSelected ) ) );
         }

         return m_Verbs;
      }
   }
   MyDesigner(){}

private:
   DesignerVerbCollection^ m_Verbs;
   void OnFirstItemSelected( Object^ /*sender*/, EventArgs^ /*args*/ )
   {
      // Display a message
      MessageBox::Show( "The first designer verb was invoked." );
   }

   void OnSecondItemSelected( Object^ /*sender*/, EventArgs^ /*args*/ )
   {
      // Display a message
      MessageBox::Show( "The second designer verb was invoked." );
   }
};

// Associate MyDesigner with this component type using a DesignerAttribute
[Designer(MyDesigner::typeid)]
public ref class Component1: public System::ComponentModel::Component{};
using System;
using System.ComponentModel;
using System.ComponentModel.Design;
using System.Collections;

/* This sample demonstrates a designer that adds menu commands
    to the design-time shortcut menu for a component.

    To test this sample, build the code for the component as a class library, 
    add the resulting component to the toolbox, open a form in design mode, 
    and drag the component from the toolbox onto the form. 

    The component should appear in the component tray beneath the form. 
    Right-click the component.  The verbs should appear in the shortcut menu.
*/

namespace CSDesignerVerb
{
    // Associate MyDesigner with this component type using a DesignerAttribute
    [Designer(typeof(MyDesigner))]
    public class Component1 : System.ComponentModel.Component
    {
    }

    // This is a designer class which provides designer verb menu commands for 
    // the associated component. This code is called by the design environment at design-time.
    internal class MyDesigner : ComponentDesigner
    {
        DesignerVerbCollection m_Verbs;

        // DesignerVerbCollection is overridden from ComponentDesigner
        public override DesignerVerbCollection Verbs
        {
            get 
            {
                if (m_Verbs == null) 
                {
                    // Create and initialize the collection of verbs
                    m_Verbs = new DesignerVerbCollection();
            
                    m_Verbs.Add( new DesignerVerb("First Designer Verb", new EventHandler(OnFirstItemSelected)) );
                    m_Verbs.Add( new DesignerVerb("Second Designer Verb", new EventHandler(OnSecondItemSelected)) );
                }
                return m_Verbs;
            }
        }

        MyDesigner() 
        {
        }

        private void OnFirstItemSelected(object sender, EventArgs args) 
        {
            // Display a message
            System.Windows.Forms.MessageBox.Show("The first designer verb was invoked.");
        }

        private void OnSecondItemSelected(object sender, EventArgs args) 
        {
            // Display a message
            System.Windows.Forms.MessageBox.Show("The second designer verb was invoked.");
        }
    }
}
Imports System.ComponentModel
Imports System.Collections
Imports System.ComponentModel.Design

'  This sample demonstrates a designer that adds menu commands
'   to the design-time shortcut menu for a component.
'
'   To test this sample, build the code for the component as a class library, 
'   add the resulting component to the toolbox, open a form in design mode, 
'   and drag the component from the toolbox onto the form. 
'
'   The component should appear in the component tray beneath the form. 
'   Right-click the component.  The verbs should appear in the shortcut menu.

Namespace VBDesignerVerb
    ' Associate MyDesigner with this component type using a DesignerAttribute
    <Designer(GetType(MyDesigner))> _
    Public Class Component1
        Inherits System.ComponentModel.Component
    End Class 


    '  This is a designer class which provides designer verb menu commands for 
    '  the associated component. This code is called by the design environment at design-time.    
    Friend Class MyDesigner
        Inherits ComponentDesigner

        Private m_Verbs As DesignerVerbCollection

        ' DesignerVerbCollection is overridden from ComponentDesigner
        Public Overrides ReadOnly Property Verbs() As DesignerVerbCollection
            Get
                If m_Verbs Is Nothing Then
                    ' Create and initialize the collection of verbs
                    m_Verbs = New DesignerVerbCollection()
                    m_Verbs.Add( New DesignerVerb("First Designer Verb", New EventHandler(AddressOf OnFirstItemSelected)) )
                    m_Verbs.Add( New DesignerVerb("Second Designer Verb", New EventHandler(AddressOf OnSecondItemSelected)) )
                End If
                Return m_Verbs
            End Get
        End Property

        Sub New()
        End Sub 

        Private Sub OnFirstItemSelected(ByVal sender As Object, ByVal args As EventArgs)
            ' Display a message
            System.Windows.Forms.MessageBox.Show("The first designer verb was invoked.")
        End Sub 

        Private Sub OnSecondItemSelected(ByVal sender As Object, ByVal args As EventArgs)
            ' Display a message
            System.Windows.Forms.MessageBox.Show("The second designer verb was invoked.")
        End Sub 
    End Class 
End Namespace

Remarks

Un verbo di progettazione è un comando di menu collegato a un gestore evento.A designer verb is a menu command linked to an event handler. I verbi della finestra di progettazione vengono aggiunti al menu di scelta rapida di un componente in fase di progettazione.Designer verbs are added to a component's shortcut menu at design time. In Visual Studio, anche ogni verbo della finestra di progettazione è elencato, usando una LinkLabel, nel riquadro Descrizione della finestra Proprietà.In Visual Studio, each designer verb is also listed, using a LinkLabel, in the Description pane of the Properties window.

Constructors

DesignerVerb(String, EventHandler)

Inizializza una nuova istanza della classe DesignerVerb.Initializes a new instance of the DesignerVerb class.

DesignerVerb(String, EventHandler, CommandID)

Inizializza una nuova istanza della classe DesignerVerb.Initializes a new instance of the DesignerVerb class.

Properties

Checked

Ottiene o imposta un valore che indica se la voce di menu è selezionata.Gets or sets a value indicating whether this menu item is checked.

(Inherited from MenuCommand)
CommandID

Ottiene l'oggetto CommandID associato a questo comando di menu.Gets the CommandID associated with this menu command.

(Inherited from MenuCommand)
Description

Ottiene o imposta la descrizione della voce di menu per il verbo.Gets or sets the description of the menu item for the verb.

Enabled

Ottiene un valore che indica se questa voce di menu è disponibile.Gets a value indicating whether this menu item is available.

(Inherited from MenuCommand)
OleStatus

Ottiene il codice di stato del comando OLE per questa voce di menu.Gets the OLE command status code for this menu item.

(Inherited from MenuCommand)
Properties

Ottiene le proprietà pubbliche associate all'oggetto MenuCommand.Gets the public properties associated with the MenuCommand.

(Inherited from MenuCommand)
Supported

Ottiene o imposta un valore che indica se la voce di menu è supportata.Gets or sets a value indicating whether this menu item is supported.

(Inherited from MenuCommand)
Text

Ottiene il testo descrittivo del comando verbo nel menu.Gets the text description for the verb command on the menu.

Visible

Ottiene o imposta un valore che indica se la voce di menu è visibile.Gets or sets a value indicating whether this menu item is visible.

(Inherited from MenuCommand)

Methods

Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Inherited from Object)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Inherited from Object)
Invoke()

Richiama il comando.Invokes the command.

(Inherited from MenuCommand)
Invoke(Object)

Richiama il comando con il parametro dato.Invokes the command with the given parameter.

(Inherited from MenuCommand)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Inherited from Object)
OnCommandChanged(EventArgs)

Genera l'evento CommandChanged.Raises the CommandChanged event.

(Inherited from MenuCommand)
ToString()

Esegue l'override dell'oggetto ToString().Overrides ToString().

Events

CommandChanged

Viene generato quando viene modificato il comando di menu.Occurs when the menu command changes.

(Inherited from MenuCommand)

Applies to

See also