IDesignerFilter Interface

Définition

Espace de noms:

System.ComponentModel.Design

Assembly:

System.dll

Fournit une interface qui permet à un concepteur d’accéder et de filtrer les dictionnaires d’un TypeDescriptor qui stocke les descripteurs de propriété, d’attribut et d’événement qu’un concepteur de composants peut exposer à l’environnement au moment du design.

public interface class IDesignerFilter

public interface IDesignerFilter

type IDesignerFilter = interface

Public Interface IDesignerFilter

Dérivé

System.ComponentModel.Design.ComponentDesigner

System.Web.UI.Design.WebFormsRootDesigner

System.Workflow.ComponentModel.Design.ActivityDesigner

Exemples

L'exemple suivant illustre un remplacement de PreFilterProperties qui ajoute une propriété du concepteur au Fenêtre Propriétés lorsque le contrôle du concepteur est sélectionné au moment du design. Consultez l’exemple de la ControlDesigner classe pour obtenir un exemple de concepteur complet qui utilise l’interface IDesignerFilter .

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

Remarques

IDesignerFilter permet à un concepteur de filtrer l’ensemble des descripteurs de propriété, d’attribut et d’événement que son composant associé expose par le biais d’un TypeDescriptor. Méthodes de cette interface dont les noms commencent Pre par sont appelées immédiatement avant les méthodes dont les noms commencent par Post.

Si vous souhaitez ajouter des descripteurs d’attribut, d’événement ou de propriété, utilisez un PreFilterAttributes, PreFilterEventsou PreFilterProperties une méthode.

Si vous souhaitez modifier ou supprimer des descripteurs d’attribut, d’événement ou de propriété, utilisez un PostFilterAttributes, PostFilterEventsou PostFilterProperties une méthode.

Méthodes

Nom	Description
PostFilterAttributes(IDictionary)	En cas de substitution dans une classe dérivée, permet à un concepteur de modifier ou de supprimer des éléments de l’ensemble d’attributs qu’il expose par le biais d’un TypeDescriptor.
PostFilterEvents(IDictionary)	En cas de substitution dans une classe dérivée, permet à un concepteur de modifier ou de supprimer des éléments de l’ensemble d’événements qu’il expose par le biais d’un TypeDescriptor.
PostFilterProperties(IDictionary)	En cas de substitution dans une classe dérivée, permet à un concepteur de modifier ou de supprimer des éléments de l’ensemble de propriétés qu’il expose par le biais d’un TypeDescriptor.
PreFilterAttributes(IDictionary)	En cas de substitution dans une classe dérivée, permet à un concepteur d’ajouter des éléments à l’ensemble d’attributs qu’il expose par le biais d’un TypeDescriptor.
PreFilterEvents(IDictionary)	En cas de substitution dans une classe dérivée, permet à un concepteur d’ajouter des éléments à l’ensemble d’événements qu’il expose par le biais d’un TypeDescriptor.
PreFilterProperties(IDictionary)	En cas de substitution dans une classe dérivée, permet à un concepteur d’ajouter des éléments à l’ensemble de propriétés qu’il expose par le biais d’un TypeDescriptor.

Voir aussi

• ITypeDescriptorFilterService
• TypeDescriptor