DesignerVerb Class

 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

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

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: