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 Class DesignerVerb
	Inherits 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.

Imports System
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

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: