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 du Design. ControlDesignerPour obtenir un exemple de concepteur complet qui utilise l’interface, consultez l’exemple de la classe 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 le jeu de descripteurs de propriété, d’attribut et d’événement que le composant associé expose à l’aide d’un TypeDescriptor . Les méthodes de cette interface dont les noms commencent par Pre sont appelées immédiatement avant les méthodes dont le nom commence par Post .

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

Si vous souhaitez modifier ou supprimer des descripteurs d’attribut, d’événement ou de propriété, utilisez une PostFilterAttributes PostFilterEvents méthode, ou 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