Partager via


IDesignerFilter Interface

Définition

Fournit une interface permettant à un concepteur d'accéder et de filtrer les dictionnaires d'un TypeDescriptor qui stocke les descripteurs de propriétés, d'attributs et d'événements qu'un concepteur de composant peut exposer dans l'environnement au moment du design.

public interface class IDesignerFilter
public interface IDesignerFilter
type IDesignerFilter = interface
Public Interface IDesignerFilter
Dérivé

Exemples

L’exemple suivant illustre une substitution 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 de la conception. 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 de descripteurs de propriété, d’attribut et d’événement que son composant associé expose via un TypeDescriptor. Les méthodes de cette interface dont les noms commencent par Pre 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 une PreFilterAttributesméthode , PreFilterEventsou PreFilterProperties .

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

Méthodes

PostFilterAttributes(IDictionary)

Lorsqu'elle est substituée 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)

Lorsqu'elle est substituée 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 à l'aide d'un TypeDescriptor.

PostFilterProperties(IDictionary)

Lorsqu'elle est substituée 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 à l'aide d'un TypeDescriptor.

PreFilterAttributes(IDictionary)

Lorsqu'elle est substituée dans une classe dérivée, permet à un concepteur d'ajouter des éléments à l'ensemble d'attributs qu'il expose à l'aide d'un TypeDescriptor.

PreFilterEvents(IDictionary)

Lorsqu'elle est substituée dans une classe dérivée, permet à un concepteur d'ajouter des éléments à l'ensemble d'événements qu'il expose à l'aide d'un TypeDescriptor.

PreFilterProperties(IDictionary)

Lorsqu'elle est substituée dans une classe dérivée, permet à un concepteur d'ajouter des éléments à l'ensemble de propriétés qu'il expose à l'aide d'un TypeDescriptor.

S’applique à

Voir aussi