IDesignerFilter IDesignerFilter IDesignerFilter IDesignerFilter Interface

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.Provides an interface that enables a designer to access and filter the dictionaries of a TypeDescriptor that stores the property, attribute, and event descriptors that a component designer can expose to the design-time environment.

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

Beispiele

Das folgende Beispiel veranschaulicht das Überschreiben der PreFilterProperties , eine Eigenschaft des Designers auf das Fenster "Eigenschaften" addiert, wenn das Steuerelement des Designers zur Entwurfszeit ausgewählt ist.The following example demonstrates an override of PreFilterProperties that adds a property of the designer to the Properties window when the designer's control is selected at design time. Siehe das Beispiel für die ControlDesigner -Klasse für ein vollständiges Designer-Beispiel, verwendet der IDesignerFilter Schnittstelle.See the example for the ControlDesigner class for a complete designer example that uses the IDesignerFilter interface.

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 einem Designer, den Satz der Eigenschaft, Attribut- und Deskriptoren zu filtern, die über die zugeordnete Komponente verfügbar gemachten eine TypeDescriptor.IDesignerFilter enables a designer to filter the set of property, attribute, and event descriptors that its associated component exposes through a TypeDescriptor. Die Methoden dieser Schnittstelle, deren Namen beginnen mit Pre werden aufgerufen, unmittelbar bevor die Methoden, deren Namen beginnen mit Post.The methods of this interface whose names begin with Pre are called immediately before the methods whose names begin with Post.

Wenn Sie Attribut, Ereignisse oder Eigenschaftendeskriptoren hinzufügen möchten, verwenden Sie eine PreFilterAttributes, PreFilterEvents, oder PreFilterProperties Methode.If you want to add attribute, event, or property descriptors, use a PreFilterAttributes, PreFilterEvents, or PreFilterProperties method.

Wenn Sie verwenden möchten, ändern oder Entfernen von Attribut-, Ereignisses oder Eigenschaftenbezeichner, verwenden eine PostFilterAttributes, PostFilterEvents, oder PostFilterProperties Methode.If you want to change or remove attribute, event, or property descriptors, use a PostFilterAttributes, PostFilterEvents, or PostFilterProperties method.

Methoden

PostFilterAttributes(IDictionary) PostFilterAttributes(IDictionary) PostFilterAttributes(IDictionary) 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.When overridden in a derived class, allows a designer to change or remove items from the set of attributes that it exposes through a TypeDescriptor.

PostFilterEvents(IDictionary) PostFilterEvents(IDictionary) PostFilterEvents(IDictionary) 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.When overridden in a derived class, allows a designer to change or remove items from the set of events that it exposes through a TypeDescriptor.

PostFilterProperties(IDictionary) PostFilterProperties(IDictionary) PostFilterProperties(IDictionary) 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.When overridden in a derived class, allows a designer to change or remove items from the set of properties that it exposes through a TypeDescriptor.

PreFilterAttributes(IDictionary) PreFilterAttributes(IDictionary) PreFilterAttributes(IDictionary) PreFilterAttributes(IDictionary)

Ermöglicht es einem Designer, beim Überschreiben in einer abgeleiteten Klasse den über einen TypeDescriptor verfügbar gemachten Attributen Elemente hinzuzufügen.When overridden in a derived class, allows a designer to add items to the set of attributes that it exposes through a TypeDescriptor.

PreFilterEvents(IDictionary) PreFilterEvents(IDictionary) PreFilterEvents(IDictionary) 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.When overridden in a derived class, allows a designer to add items to the set of events that it exposes through a TypeDescriptor.

PreFilterProperties(IDictionary) PreFilterProperties(IDictionary) PreFilterProperties(IDictionary) 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.When overridden in a derived class, allows a designer to add items to the set of properties that it exposes through a TypeDescriptor.

Gilt für:

Siehe auch