ComponentDesigner 类

定义

命名空间:

System.ComponentModel.Design

程序集:

System.Windows.Forms.Design.dll

Source:

ComponentDesigner.cs

扩展组件的设计模式行为。

public ref class ComponentDesigner : IDisposable, System::ComponentModel::Design::IComponentInitializer, System::ComponentModel::Design::IDesignerFilter, System::ComponentModel::Design::ITreeDesigner

public class ComponentDesigner : IDisposable, System.ComponentModel.Design.IComponentInitializer, System.ComponentModel.Design.IDesignerFilter, System.ComponentModel.Design.ITreeDesigner

type ComponentDesigner = class
    interface ITreeDesigner
    interface IDesigner
    interface IDisposable
    interface IDesignerFilter
    interface IComponentInitializer

Public Class ComponentDesigner
Implements IComponentInitializer, IDesignerFilter, IDisposable, ITreeDesigner

继承

Object

ComponentDesigner

派生

System.Diagnostics.Design.ProcessDesigner

System.Diagnostics.Design.ProcessModuleDesigner

System.Diagnostics.Design.ProcessThreadDesigner

System.Messaging.Design.MessageDesigner

System.ServiceProcess.Design.ServiceControllerDesigner

System.Web.UI.Design.HtmlControlDesigner

System.Windows.Forms.Design.ComponentDocumentDesigner

System.Windows.Forms.Design.ControlDesigner

实现

IDesigner IDesignerFilter IDisposable IComponentInitializer ITreeDesigner

示例

下面的代码示例提供了一个示例 ComponentDesigner 实现以及与设计器关联的示例组件。 设计器实现调用基方法的方法的Initialize重写、双击组件时显示 MessageBox 的方法的DoDefaultAction重写，以及向组件的快捷菜单提供自定义DesignerVerb菜单命令的属性访问器的替代Verbs。Initialize

#using <System.dll>
#using <System.Design.dll>
#using <System.Drawing.dll>
#using <System.Windows.Forms.dll>

using namespace System;
using namespace System::Collections;
using namespace System::ComponentModel;
using namespace System::ComponentModel::Design;
using namespace System::Drawing;
using namespace System::Windows::Forms;

// Provides an example component designer.
ref class ExampleComponentDesigner: public ComponentDesigner
{
public:
   ExampleComponentDesigner()
   {
   }

   // This method provides an opportunity to perform processing when a designer is initialized.
   // The component parameter is the component that the designer is associated with.
   virtual void Initialize( IComponent^ component ) override
   {
      // Always call the base Initialize method in an of this method.
      ComponentDesigner::Initialize( component );
   }

   // This method is invoked when the associated component is double-clicked.
   virtual void DoDefaultAction() override
   {
      MessageBox::Show( "The event handler for the default action was invoked." );
   }

   // This method provides designer verbs.
   property DesignerVerbCollection^ Verbs 
   {
      virtual DesignerVerbCollection^ get() override
      {
         array<DesignerVerb^>^ newDesignerVerbs = {gcnew DesignerVerb( "Example Designer Verb Command", gcnew EventHandler( this, &ExampleComponentDesigner::onVerb ) )};
         return gcnew DesignerVerbCollection( newDesignerVerbs );
      }
   }

private:
   // Event handling method for the example designer verb
   void onVerb( Object^ sender, EventArgs^ e )
   {
      MessageBox::Show( "The event handler for the Example Designer Verb Command was invoked." );
   }
};

// Provides an example component associated with the example component designer.

[DesignerAttribute(ExampleComponentDesigner::typeid, IDesigner::typeid)]
ref class ExampleComponent: public Component
{
public:
   ExampleComponent(){}
};

using System;
using System.Collections;
using System.ComponentModel;
using System.ComponentModel.Design;
using System.Drawing;
using System.Windows.Forms;

namespace ExampleComponent
{	
    // Provides an example component designer.
    public class ExampleComponentDesigner : System.ComponentModel.Design.ComponentDesigner
    {
        public ExampleComponentDesigner()
        {
        }

        // This method provides an opportunity to perform processing when a designer is initialized.
        // The component parameter is the component that the designer is associated with.
        public override void Initialize(System.ComponentModel.IComponent component)
        {
            // Always call the base Initialize method in an override of this method.
            base.Initialize(component);
        }

        // This method is invoked when the associated component is double-clicked.
        public override void DoDefaultAction()
        {
            MessageBox.Show("The event handler for the default action was invoked.");
        }

        // This method provides designer verbs.
        public override System.ComponentModel.Design.DesignerVerbCollection Verbs
        {
            get
            {
                return new DesignerVerbCollection( new DesignerVerb[] { new DesignerVerb("Example Designer Verb Command", new EventHandler(this.onVerb)) } );
            }
        }

        // Event handling method for the example designer verb
        private void onVerb(object sender, EventArgs e)
        {
            MessageBox.Show("The event handler for the Example Designer Verb Command was invoked.");
        }
    }

    // Provides an example component associated with the example component designer.
    [DesignerAttribute(typeof(ExampleComponentDesigner), typeof(IDesigner))]
    public class ExampleComponent : System.ComponentModel.Component
    {		
        public ExampleComponent()
        {
        }
    }
}

Imports System.Collections
Imports System.ComponentModel
Imports System.ComponentModel.Design
Imports System.Drawing
Imports System.Windows.Forms

Namespace ExampleComponent

    ' Provides an example component designer.
    Public Class ExampleComponentDesigner
        Inherits System.ComponentModel.Design.ComponentDesigner

        Public Sub New()
        End Sub

        ' This method provides an opportunity to perform processing when a designer is initialized.
        ' The component parameter is the component that the designer is associated with.
        Public Overrides Sub Initialize(ByVal component As System.ComponentModel.IComponent)
            ' Always call the base Initialize method in an override of this method.
            MyBase.Initialize(component)
        End Sub

        ' This method is invoked when the associated component is double-clicked.
        Public Overrides Sub DoDefaultAction()
            MessageBox.Show("The event handler for the default action was invoked.")
        End Sub

        ' This method provides designer verbs.
        Public Overrides ReadOnly Property Verbs() As System.ComponentModel.Design.DesignerVerbCollection
            Get
                Return New DesignerVerbCollection(New DesignerVerb() {New DesignerVerb("Example Designer Verb Command", New EventHandler(AddressOf Me.onVerb))})
            End Get
        End Property

        ' Event handling method for the example designer verb
        Private Sub onVerb(ByVal sender As Object, ByVal e As EventArgs)
            MessageBox.Show("The event handler for the Example Designer Verb Command was invoked.")
        End Sub
    End Class

    ' Provides an example component associated with the example component designer.
    <DesignerAttribute(GetType(ExampleComponentDesigner), GetType(IDesigner))> _
     Public Class ExampleComponent
        Inherits System.ComponentModel.Component

        Public Sub New()
        End Sub
    End Class

End Namespace 'ExampleComponent

注解

基 ComponentDesigner 设计器类提供了一个简单的设计器，该设计器可以在设计模式下扩展关联组件的行为。

ComponentDesigner 提供了一个空 IDesignerFilter 接口实现，其方法可以重写，以在设计时调整关联组件的属性、属性和事件。

可以使用 将设计器与类型 DesignerAttribute相关联。 有关自定义设计时行为的概述，请参阅 扩展 Design-Time 支持。

类 ComponentDesigner 为继承组件的属性描述符实现特殊行为。 默认ComponentDesigner实现使用名为 InheritedPropertyDescriptor 的内部类型来代表从基类继承的属性。 在两种情况下，添加这些属性描述符。

1. 到根对象本身（由 IDesignerHost.RootComponent 属性返回），因为你是从其基类继承的。

2. 在根对象的基类中找到的字段。 基类中的公共字段和受保护字段将添加到设计器中，以便用户可对其进行操作。

类 InheritedPropertyDescriptor 修改属性的默认值，以便默认值是对象实例化的当前值。 这是因为属性继承自另一个实例。 设计器将重置属性值定义为将其设置为由继承类设置的值。 此值可能与存储在元数据中的默认值不同。

构造函数

ComponentDesigner()

初始化 ComponentDesigner 类的新实例。

属性

ActionLists	获取与设计器相关联的组件所支持的设计时操作列表。
AssociatedComponents	获取与设计器所管理的组件关联的组件集合。
Component	获取此设计器正在设计的组件。
InheritanceAttribute	获取一个特性，该特性指示关联组件的继承类型。
Inherited	获取一个值，该值指示是否继承此组件。
ParentComponent	获取此设计器的父组件。
SetTextualDefaultProperty	扩展组件的设计模式行为。
ShadowProperties	获取重写用户设置的属性值的集合。
Verbs	获取与设计器相关联的组件所支持的设计时谓词。

方法

Dispose()	释放由 ComponentDesigner 使用的所有资源。
Dispose(Boolean)	释放由 ComponentDesigner 占用的非托管资源，还可以另外再释放托管资源。
DoDefaultAction()	在源代码文件中为组件的默认事件创建方法签名，并将用户的光标定位到该位置。
Equals(Object)	确定指定对象是否等于当前对象。 (继承自 Object)
GetHashCode()	作为默认哈希函数。 (继承自 Object)
GetService(Type)	尝试从设计器组件的设计模式站点检索指定类型的服务。
GetType()	获取当前实例的 Type。 (继承自 Object)
Initialize(IComponent)	使设计器准备查看、编辑和设计指定的组件。
InitializeExistingComponent(IDictionary)	重新初始化现有组件。
InitializeNewComponent(IDictionary)	初始化新创建的组件。
InitializeNonDefault()	已过时. 对已初始化为非默认设置的导入组件的设置进行初始化。
InvokeGetInheritanceAttribute(ComponentDesigner)	获取指定 InheritanceAttribute 的 ComponentDesigner。
MemberwiseClone()	创建当前 Object 的浅表副本。 (继承自 Object)
OnSetComponentDefaults()	已过时. 设置组件的默认属性。
PostFilterAttributes(IDictionary)	允许设计器从通过 TypeDescriptor 公开的特性集中更改或移除项。
PostFilterEvents(IDictionary)	允许设计器从通过 TypeDescriptor 公开的事件集中更改或移除项。
PostFilterProperties(IDictionary)	允许设计器从通过 TypeDescriptor 公开的属性集中更改或移除项。
PreFilterAttributes(IDictionary)	允许设计器在通过 TypeDescriptor 公开的特性集中添加项。
PreFilterEvents(IDictionary)	允许设计器在通过 TypeDescriptor 公开的事件集中添加项。
PreFilterProperties(IDictionary)	允许设计器在通过 TypeDescriptor 公开的属性集中添加项。
RaiseComponentChanged(MemberDescriptor, Object, Object)	通知 IComponentChangeService 此组件已被更改。
RaiseComponentChanging(MemberDescriptor)	通知 IComponentChangeService 此组件即将被更改。
ToString()	返回表示当前对象的字符串。 (继承自 Object)

显式接口实现

IDesignerFilter.PostFilterAttributes(IDictionary)	有关此成员的说明，请参见 PostFilterAttributes(IDictionary) 方法。
IDesignerFilter.PostFilterEvents(IDictionary)	有关此成员的说明，请参见 PostFilterEvents(IDictionary) 方法。
IDesignerFilter.PostFilterProperties(IDictionary)	有关此成员的说明，请参见 PostFilterProperties(IDictionary) 方法。
IDesignerFilter.PreFilterAttributes(IDictionary)	有关此成员的说明，请参见 PreFilterAttributes(IDictionary) 方法。
IDesignerFilter.PreFilterEvents(IDictionary)	有关此成员的说明，请参见 PreFilterEvents(IDictionary) 方法。
IDesignerFilter.PreFilterProperties(IDictionary)	有关此成员的说明，请参见 PreFilterProperties(IDictionary) 方法。
ITreeDesigner.Children	有关此成员的说明，请参见 Children 属性。
ITreeDesigner.Parent	有关此成员的说明，请参见 Parent 属性。

另请参阅

• IDesigner
• IDesignerFilter
• DesignerAttribute
• 扩展设计时支持
• 如何：访问设计时服务