DesignerVerb Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Stellt ein Verb dar, das von einem Designer aufgerufen werden kann.
public ref class DesignerVerb : System::ComponentModel::Design::MenuCommand
[System.Runtime.InteropServices.ComVisible(true)]
public class DesignerVerb : System.ComponentModel.Design.MenuCommand
public class DesignerVerb : System.ComponentModel.Design.MenuCommand
[<System.Runtime.InteropServices.ComVisible(true)>]
type DesignerVerb = class
inherit MenuCommand
type DesignerVerb = class
inherit MenuCommand
Public Class DesignerVerb
Inherits MenuCommand
- Vererbung
- Abgeleitet
- Attribute
Beispiele
Im folgenden Codebeispiel wird veranschaulicht, wie Objekte erstellt DesignerVerb und dem Entwurfszeit-Kontextmenü für eine Komponente hinzugefügt werden.
#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 Menübefehl, der mit einem Ereignishandler verknüpft ist. Designerverben werden dem Kontextmenü einer Komponente während der Gestaltung hinzugefügt. In Visual Studio wird jedes Designerverb auch mithilfe eines LinkLabel im Bereich Description des Eigenschaftenfenster aufgeführt.
Konstruktoren
| Name | Beschreibung |
|---|---|
| DesignerVerb(String, EventHandler, CommandID) |
Initialisiert eine neue Instanz der DesignerVerb-Klasse. |
| DesignerVerb(String, EventHandler) |
Initialisiert eine neue Instanz der DesignerVerb-Klasse. |
Eigenschaften
| Name | Beschreibung |
|---|---|
| Checked |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob dieses Menüelement aktiviert ist. (Geerbt von MenuCommand) |
| CommandID |
Ruft den CommandID diesem Menübefehl zugeordneten Ab. (Geerbt von MenuCommand) |
| Description |
Dient zum Abrufen oder Festlegen der Beschreibung des Menüelements für das Verb. |
| Enabled |
Ruft einen Wert ab, der angibt, ob dieses Menüelement verfügbar ist. (Geerbt von MenuCommand) |
| OleStatus |
Ruft den OLE-Befehlsstatuscode für dieses Menüelement ab. (Geerbt von MenuCommand) |
| Properties |
Ruft die öffentlichen Eigenschaften ab, die der MenuCommand. (Geerbt von MenuCommand) |
| Supported |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob dieses Menüelement unterstützt wird. (Geerbt von MenuCommand) |
| Text |
Ruft die Textbeschreibung für den Verbbefehl im Menü ab. |
| Visible |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob dieses Menüelement sichtbar ist. (Geerbt von MenuCommand) |
Methoden
| Name | Beschreibung |
|---|---|
| Equals(Object) |
Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht. (Geerbt von Object) |
| GetHashCode() |
Dient als Standardhashfunktion. (Geerbt von Object) |
| GetType() |
Ruft die Type der aktuellen Instanz ab. (Geerbt von Object) |
| Invoke() |
Ruft den Befehl auf. (Geerbt von MenuCommand) |
| Invoke(Object) |
Ruft den Befehl mit dem angegebenen Parameter auf. (Geerbt von MenuCommand) |
| MemberwiseClone() |
Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object) |
| OnCommandChanged(EventArgs) |
Löst das CommandChanged-Ereignis aus. (Geerbt von MenuCommand) |
| ToString() |
Überschreibt ToString(). |
Ereignisse
| Name | Beschreibung |
|---|---|
| CommandChanged |
Tritt auf, wenn sich der Menübefehl ändert. (Geerbt von MenuCommand) |