IDesignerFilter Interface

Definição

Espaço de Nomes:
System.ComponentModel.Design
Assemblagem:
System.dll
Assemblagem:
netstandard.dll

Fornece uma interface que permite ao designer aceder e filtrar os dicionários de um TypeDescriptor que armazena os descritores de propriedades, atributos e eventos que um designer de componentes pode expor ao ambiente em tempo de design.

public interface class IDesignerFilter
public interface IDesignerFilter
type IDesignerFilter = interface
Public Interface IDesignerFilter
Derivado

Exemplos

O exemplo seguinte demonstra uma sobreposição de PreFilterProperties que adiciona uma propriedade do designer à janela Propriedades quando o controlo do designer é selecionado no momento do projeto. Veja o exemplo da ControlDesigner classe para um exemplo completo de design que utiliza a IDesignerFilter interface.

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

Observações

IDesignerFilter permite que um designer filtre o conjunto de descritores de propriedades, atributos e eventos que o seu componente associado expõe através de um TypeDescriptor. Os métodos desta interface cujos nomes começam com Pre são chamados imediatamente antes dos métodos cujos nomes começam por Post.

Se quiser adicionar descritores de atributo, evento ou propriedade, use um PreFilterAttributes, PreFilterEvents, ou PreFilterProperties método.

Se quiser alterar ou remover descritores de atributo, evento ou propriedade, use um PostFilterAttributes, PostFilterEvents, ou PostFilterProperties método.

Métodos

Name Description
PostFilterAttributes(IDictionary)

Quando sobrescrito numa classe derivada, permite a um designer alterar ou remover itens do conjunto de atributos que expõe através de um TypeDescriptor.
PostFilterEvents(IDictionary)

Quando sobrescrito numa classe derivada, permite a um designer alterar ou remover itens do conjunto de eventos que expõe através de um TypeDescriptor.
PostFilterProperties(IDictionary)

Quando sobrescrito numa classe derivada, permite a um designer alterar ou remover itens do conjunto de propriedades que expõe através de um TypeDescriptor.
PreFilterAttributes(IDictionary)

Quando sobrescrito numa classe derivada, permite a um designer adicionar itens ao conjunto de atributos que expõe através de um TypeDescriptor.
PreFilterEvents(IDictionary)

Quando sobrescrito numa classe derivada, permite a um designer adicionar itens ao conjunto de eventos que expõe através de um TypeDescriptor.
PreFilterProperties(IDictionary)

Quando sobrescrito numa classe derivada, permite a um designer adicionar itens ao conjunto de propriedades que expõe através de um TypeDescriptor.

Aplica-se a

Ver também