IDesignerFilter Schnittstelle

Definition

Namespace:
System.ComponentModel.Design
Assembly:
System.dll
Assembly:
netstandard.dll

Stellt eine Schnittstelle bereit, mit der ein Designer auf die Wörterbücher eines TypeDescriptor Steuerelements zugreifen und filtern kann, das die Eigenschaften-, Attribut- und Ereignisdeskriptoren speichert, die ein Komponentendesigner 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 wird. Sehen Sie sich das Beispiel für die ControlDesigner Klasse für ein vollständiges Designerbeispiel an, 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 TypeDescriptor. Die Methoden dieser Schnittstelle, deren Namen beginnen Pre , werden unmittelbar vor den Methoden aufgerufen, mit denen die Namen beginnen Post.

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

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

Methoden

Name Beschreibung
PostFilterAttributes(IDictionary)

Wenn sie in einer abgeleiteten Klasse überschrieben werden, kann ein Designer Elemente aus dem Satz von Attributen ändern oder entfernen, die er über eine TypeDescriptor.
PostFilterEvents(IDictionary)

Wenn sie in einer abgeleiteten Klasse überschrieben werden, kann ein Designer Elemente aus der Gruppe von Ereignissen ändern oder entfernen, die er über eine TypeDescriptor.
PostFilterProperties(IDictionary)

Wenn sie in einer abgeleiteten Klasse überschrieben werden, kann ein Designer Elemente aus dem Satz von Eigenschaften ändern oder entfernen, die er über eine TypeDescriptor.
PreFilterAttributes(IDictionary)

Wenn sie in einer abgeleiteten Klasse überschrieben werden, kann ein Designer Elemente zu dem Satz von Attributen hinzufügen, die er über eine TypeDescriptor.
PreFilterEvents(IDictionary)

Wenn sie in einer abgeleiteten Klasse überschrieben werden, kann ein Designer Elemente zu der Gruppe von Ereignissen hinzufügen, die er über eine TypeDescriptor.
PreFilterProperties(IDictionary)

Wenn sie in einer abgeleiteten Klasse überschrieben werden, kann ein Designer elemente zu dem Satz von Eigenschaften hinzufügen, die er über eine TypeDescriptor.

Gilt für:

Weitere Informationen