IDesignerFilter Schnittstelle

Definition

Stellt eine Schnittstelle bereit, die einem Designer den Zugriff auf und das Filtern von Wörterbüchern eines TypeDescriptor ermöglicht, der Eigenschafts-, Attribut- und Ereignisdeskriptoren enthält, die ein Komponenten-Designer für die Entwurfszeitumgebung verfügbar machen kann.

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

Beispiele

Im folgenden Beispiel wird eine Außerkraftsetzung von PreFilterProperties veranschaulicht, die dem Eigenschaftenfenster eine Eigenschaft des Designers hinzufügt, wenn das Steuerelement des Designers zur Entwurfszeit ausgewählt ist. Im Beispiel für die ControlDesigner -Klasse finden Sie ein vollständiges Designerbeispiel, das die IDesignerFilter -Schnittstelle verwendet.

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

Hinweise

IDesignerFilter ermöglicht es einem Designer, den Satz von Eigenschafts-, Attribut- und Ereignisdeskriptoren zu filtern, die seine zugeordnete Komponente über eine TypeDescriptorverfügbar macht. Die Methoden dieser Schnittstelle, deren Namen mit Pre beginnen, werden unmittelbar vor den Methoden aufgerufen, deren Namen mit Postbeginnen.

Wenn Sie Attribut-, Ereignis- oder Eigenschaftsdeskriptoren hinzufügen möchten, verwenden Sie eine PreFilterAttributes- , PreFilterEvents- oder PreFilterProperties -Methode.

Wenn Sie Attribut-, Ereignis- oder Eigenschaftsdeskriptoren ändern oder entfernen möchten, verwenden Sie eine PostFilterAttributes- , PostFilterEvents- oder PostFilterProperties -Methode.

Methoden

PostFilterAttributes(IDictionary)

Ermöglicht es einem Designer, beim Überschreiben in einer abgeleiteten Klasse Elemente in der über einen TypeDescriptor verfügbar gemachten Attributgruppe zu ändern oder zu entfernen.

PostFilterEvents(IDictionary)

Ermöglicht einem Designer, beim Überschreiben in einer abgeleiteten Klasse Elemente in der über einen TypeDescriptor verfügbar gemachten Menge von Ereignissen zu ändern oder daraus entfernen.

PostFilterProperties(IDictionary)

Ermöglicht einem Designer, beim Überschreiben in einer abgeleiteten Klasse Elemente in der über einen TypeDescriptor verfügbar gemachten Menge von Eigenschaften zu ändern oder daraus entfernen.

PreFilterAttributes(IDictionary)

Ermöglicht es einem Designer, beim Überschreiben in einer abgeleiteten Klasse den über einen TypeDescriptor verfügbar gemachten Attributen Elemente hinzuzufügen.

PreFilterEvents(IDictionary)

Ermöglicht es einem Designer, beim Überschreiben in einer abgeleiteten Klasse der über einen TypeDescriptor verfügbar gemachten Gruppe von Ereignissen Elemente hinzuzufügen.

PreFilterProperties(IDictionary)

Ermöglicht es einem Designer, beim Überschreiben in einer abgeleiteten Klasse der über einen TypeDescriptor verfügbar gemachten Gruppe von Eigenschaften Elemente hinzuzufügen.

Gilt für:

Weitere Informationen