DesignerVerb Class

 

Represents a verb that can be invoked from a designer.

Namespace:   System.ComponentModel.Design
Assembly:  System (in System.dll)


[ComVisibleAttribute(true)]
[HostProtectionAttribute(SecurityAction::LinkDemand, SharedState = true)]
[PermissionSetAttribute(SecurityAction::LinkDemand, Name = "FullTrust")]
[PermissionSetAttribute(SecurityAction::InheritanceDemand, Name = "FullTrust")]
public ref class DesignerVerb : MenuCommand

NameDescription
System_CAPS_pubmethodDesignerVerb(String^, EventHandler^)

Initializes a new instance of the DesignerVerb class.

System_CAPS_pubmethodDesignerVerb(String^, EventHandler^, CommandID^)

Initializes a new instance of the DesignerVerb class.

NameDescription
System_CAPS_pubpropertyChecked

Gets or sets a value indicating whether this menu item is checked.(Inherited from MenuCommand.)

System_CAPS_pubpropertyCommandID

Gets the CommandID associated with this menu command.(Inherited from MenuCommand.)

System_CAPS_pubpropertyDescription

Gets or sets the description of the menu item for the verb.

System_CAPS_pubpropertyEnabled

Gets a value indicating whether this menu item is available.(Inherited from MenuCommand.)

System_CAPS_pubpropertyOleStatus

Gets the OLE command status code for this menu item.(Inherited from MenuCommand.)

System_CAPS_pubpropertyProperties

Gets the public properties associated with the MenuCommand.(Inherited from MenuCommand.)

System_CAPS_pubpropertySupported

Gets or sets a value indicating whether this menu item is supported.(Inherited from MenuCommand.)

System_CAPS_pubpropertyText

Gets the text description for the verb command on the menu.

System_CAPS_pubpropertyVisible

Gets or sets a value indicating whether this menu item is visible.(Inherited from MenuCommand.)

NameDescription
System_CAPS_pubmethodEquals(Object^)

Determines whether the specified object is equal to the current object.(Inherited from Object.)

System_CAPS_protmethodFinalize()

Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.(Inherited from Object.)

System_CAPS_pubmethodGetHashCode()

Serves as the default hash function. (Inherited from Object.)

System_CAPS_pubmethodGetType()

Gets the Type of the current instance.(Inherited from Object.)

System_CAPS_pubmethodInvoke()

Invokes the command.(Inherited from MenuCommand.)

System_CAPS_pubmethodInvoke(Object^)

Invokes the command with the given parameter.(Inherited from MenuCommand.)

System_CAPS_protmethodMemberwiseClone()

Creates a shallow copy of the current Object.(Inherited from Object.)

System_CAPS_protmethodOnCommandChanged(EventArgs^)

Raises the CommandChanged event.(Inherited from MenuCommand.)

System_CAPS_pubmethodToString()

Overrides ToString.(Overrides MenuCommand::ToString().)

NameDescription
System_CAPS_pubeventCommandChanged

Occurs when the menu command changes.(Inherited from MenuCommand.)

A designer verb is a menu command linked to an event handler. Designer verbs are added to a component's shortcut menu at design time. In Visual Studio, each designer verb is also listed, using a LinkLabel, in the Description pane of the Properties window.

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{};

NamedPermissionSet

for full access to system resources. Demand values: LinkDemand, InheritanceDemand. Associated state:

.NET Framework
Available since 1.1

Any public static ( Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Return to top
Show: