DesignerVerb Klasse
Definition
Stellt ein Verb dar, das aus einem Designer aufgerufen werden kann.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
[<System.Runtime.InteropServices.ComVisible(true)>]
type DesignerVerb = class
inherit MenuCommand
Public Class DesignerVerb
Inherits MenuCommand
- Vererbung
- Abgeleitet
- Attribute
Beispiele
Im folgenden Codebeispiel wird veranschaulicht, wie DesignerVerb -Objekte erstellt und dem Kontextmenü für eine-Komponente zur Entwurfszeit hinzugefügt werden.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
Hinweise
Ein Designerverb ist ein mit einem Ereignishandler verknüpfter Menübefehl.A designer verb is a menu command linked to an event handler. Designer Verben werden dem Kontextmenü einer Komponente zur Entwurfszeit hinzugefügt.Designer verbs are added to a component's shortcut menu at design time. In Visual Studio wird jedes Designer Verb auch mit einem LinkLabel im Beschreibungs Bereich der Eigenschaftenfenster aufgelistet.In Visual Studio, each designer verb is also listed, using a LinkLabel, in the Description pane of the Properties window.
Konstruktoren
DesignerVerb(String, EventHandler) |
Initialisiert eine neue Instanz der DesignerVerb-Klasse.Initializes a new instance of the DesignerVerb class. |
DesignerVerb(String, EventHandler, CommandID) |
Initialisiert eine neue Instanz der DesignerVerb-Klasse.Initializes a new instance of the DesignerVerb class. |
Eigenschaften
Checked |
Ruft einen Wert ab, der angibt, ob dieses Menüelement aktiviert ist, oder legt diesen fest.Gets or sets a value indicating whether this menu item is checked. (Geerbt von MenuCommand) |
CommandID |
Ruft die CommandID-Klasse ab, die diesem Menübefehl zugeordnet ist.Gets the CommandID associated with this menu command. (Geerbt von MenuCommand) |
Description |
Ruft die Beschreibung des Menüelements für das Verb ab oder legt diese fest.Gets or sets the description of the menu item for the verb. |
Enabled |
Ruft einen Wert ab, der angibt, ob dieses Menüelement verfügbar ist.Gets a value indicating whether this menu item is available. (Geerbt von MenuCommand) |
OleStatus |
Ruft den OLE-Befehlsstatus für dieses Menüelement ab.Gets the OLE command status code for this menu item. (Geerbt von MenuCommand) |
Properties |
Ruft die öffentlichen Eigenschaften ab, die der MenuCommand-Klasse zugeordnet sind.Gets the public properties associated with the MenuCommand. (Geerbt von MenuCommand) |
Supported |
Ruft einen Wert ab, der angibt, ob dieses Menüelement unterstützt wird, oder legt diesen fest.Gets or sets a value indicating whether this menu item is supported. (Geerbt von MenuCommand) |
Text |
Ruft die Textbeschreibung für den Verbbefehl im Menü ab.Gets the text description for the verb command on the menu. |
Visible |
Ruft einen Wert ab, der angibt, ob dieses Menüelement sichtbar ist, oder legt diesen fest.Gets or sets a value indicating whether this menu item is visible. (Geerbt von MenuCommand) |
Methoden
Equals(Object) |
Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object. (Geerbt von Object) |
GetHashCode() |
Fungiert als Standardhashfunktion.Serves as the default hash function. (Geerbt von Object) |
GetType() |
Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance. (Geerbt von Object) |
Invoke() |
Ruft den Befehl auf.Invokes the command. (Geerbt von MenuCommand) |
Invoke(Object) |
Ruft den Befehl mit dem angegebenen Parameter auf.Invokes the command with the given parameter. (Geerbt von MenuCommand) |
MemberwiseClone() |
Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object. (Geerbt von Object) |
OnCommandChanged(EventArgs) |
Löst das CommandChanged-Ereignis aus.Raises the CommandChanged event. (Geerbt von MenuCommand) |
ToString() |
Überschreibt ToString().Overrides ToString(). |
Ereignisse
CommandChanged |
Tritt bei einer Änderung des Menübefehls ein.Occurs when the menu command changes. (Geerbt von MenuCommand) |