IDesignerFilter 介面

定義

命名空間:

System.ComponentModel.Design

組件:

System.ComponentModel.TypeConverter.dll

提供可以讓設計工具存取和篩選 TypeDescriptor 物件字典的介面，在該物件中儲存了屬性 (Property)、屬性 (Attribute) 甚至是元件設計工具可公開至設計階段環境的事件描述項。

public interface class IDesignerFilter

public interface IDesignerFilter

type IDesignerFilter = interface

Public Interface IDesignerFilter

衍生

System.Web.UI.Design.WebFormsRootDesigner

System.Workflow.ComponentModel.Design.ActivityDesigner

範例

下列範例示範 的覆寫PreFilterProperties，它會在設計時間選取設計工具的控件時，將設計工具的 屬性新增至 屬性視窗。 如需使用 IDesignerFilter 介面的完整設計工具範例，請參閱 類別的範例ControlDesigner。

protected:
   [ReflectionPermission(SecurityAction::Demand, Flags=ReflectionPermissionFlag::MemberAccess)]
   virtual void PreFilterProperties( System::Collections::IDictionary^ properties ) override
   {
      properties->Add( "OutlineColor", TypeDescriptor::CreateProperty( TestControlDesigner::typeid, "OutlineColor", System::Drawing::Color::typeid, nullptr ) );
   }

// Adds a property to this designer's control at design time 
// that indicates the outline color to use. 
// The DesignOnlyAttribute ensures that the OutlineColor
// property is not serialized by the designer.
protected override void PreFilterProperties(System.Collections.IDictionary properties)
{
    PropertyDescriptor pd = TypeDescriptor.CreateProperty(
        typeof(ExampleControlDesigner), 
        "OutlineColor",
        typeof(System.Drawing.Color),
        new Attribute[] { new DesignOnlyAttribute(true) });

    properties.Add("OutlineColor", pd);
}

' Adds a property to this designer's control at design time 
' that indicates the outline color to use.
' The DesignOnlyAttribute ensures that the OutlineColor
' property is not serialized by the designer.
Protected Overrides Sub PreFilterProperties(ByVal properties As System.Collections.IDictionary)
    Dim pd As PropertyDescriptor = TypeDescriptor.CreateProperty( _
    GetType(ExampleControlDesigner), _
    "OutlineColor", _
    GetType(System.Drawing.Color), _
    New Attribute() {New DesignOnlyAttribute(True)})

    properties.Add("OutlineColor", pd)
End Sub

備註

IDesignerFilter 可讓設計工具篩選其相關聯元件透過 TypeDescriptor公開的屬性、屬性和事件描述元集。 這個介面的方法，其名稱開頭 Pre 為的方法，緊接在名稱開頭 Post為 的方法之前。

如果您要新增屬性、事件或屬性描述元，請使用 PreFilterAttributes、 PreFilterEvents或 PreFilterProperties 方法。

如果您想要變更或移除屬性、事件或屬性描述元，請使用 PostFilterAttributes、 PostFilterEvents或 PostFilterProperties 方法。

方法

PostFilterAttributes(IDictionary)	在衍生類別中覆寫時，允許設計工具可以變更或移除透過 TypeDescriptor 所公開之屬性集中的項目。
PostFilterEvents(IDictionary)	在衍生類別中覆寫時，允許設計工具可以變更或移除透過 TypeDescriptor 所公開之屬性集中的項目。
PostFilterProperties(IDictionary)	在衍生類別中覆寫時，允許設計工具可以變更或移除透過 TypeDescriptor 所公開之屬性集中的項目。
PreFilterAttributes(IDictionary)	在衍生類別中覆寫時，允許設計工具可以將項目加入到透過 TypeDescriptor 公開的屬性集。
PreFilterEvents(IDictionary)	在衍生類別中覆寫時，允許設計工具可以將項目加入到透過 TypeDescriptor 公開的事件集。
PreFilterProperties(IDictionary)	在衍生類別中覆寫時，允許設計工具可以將項目加入到透過 TypeDescriptor 公開的屬性集。

另請參閱

• ITypeDescriptorFilterService
• TypeDescriptor