IDesignerFilter-Schnittstelle

Artikel
08/20/2007

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.

Namespace: System.ComponentModel.Design
Assembly: System (in system.dll)

Syntax

'Declaration
Public Interface IDesignerFilter
'Usage
Dim instance As IDesignerFilter

public interface IDesignerFilter

public interface class IDesignerFilter

public interface IDesignerFilter

public interface IDesignerFilter

Hinweise

IDesignerFilter ermöglicht es dem Designer, die Gruppe der Attribut-, Ereignis- und Eigenschaftsdeskriptoren zu filtern, die die zugeordnete Komponente über einen TypeDescriptor verfügbar macht. Die Methoden dieser Schnittstelle, deren Namen mit Pre beginnen, werden unmittelbar vor den Methoden aufgerufen, deren Namen mit Post beginnen.

Verwenden Sie zum Hinzufügen eines Attribut-, Ereignis- oder Eigenschaftsdeskriptors eine PreFilterAttributes-Methode, eine PreFilterEvents-Methode oder eine PreFilterProperties-Methode.

Verwenden Sie zum Ändern oder Entfernen von Attribut-, Ereignis- oder Eigenschaftsdeskriptoren eine PostFilterAttributes-Methode, eine PostFilterEvents-Methode oder eine PostFilterProperties-Methode.

Beispiel

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

' Adds a property to this designer's control at design time 
' that indicates the outline color to use.
Protected Overrides Sub PreFilterProperties(ByVal properties As System.Collections.IDictionary)
    properties.Add("OutlineColor", TypeDescriptor.CreateProperty(GetType(TestControlDesigner), "OutlineColor", GetType(System.Drawing.Color), Nothing))
End Sub

// Adds a property to this designer's control at design time 
// that indicates the outline color to use.
protected override void PreFilterProperties(System.Collections.IDictionary properties)
{
    properties.Add("OutlineColor", TypeDescriptor.CreateProperty(typeof(ExampleControlDesigner), "OutlineColor", typeof(System.Drawing.Color), null));
}

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 ) );
   }

Plattformen

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

IDesignerFilter-Member
System.ComponentModel.Design-Namespace
ITypeDescriptorFilterService
TypeDescriptor-Klasse

Freigeben über