IDesignerFilter.PreFilterAttributes-Methode

Artikel
08/20/2007

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

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

Syntax

'Declaration
Sub PreFilterAttributes ( _
    attributes As IDictionary _
)
'Usage
Dim instance As IDesignerFilter
Dim attributes As IDictionary

instance.PreFilterAttributes(attributes)

void PreFilterAttributes (
    IDictionary attributes
)

void PreFilterAttributes (
    IDictionary^ attributes
)

void PreFilterAttributes (
    IDictionary attributes
)

function PreFilterAttributes (
    attributes : IDictionary
)

Parameter

attributes
Die Attribute-Objekte für die Klasse der Komponente. Die Schlüssel im Attributwörterbuch sind die TypeID-Werte der Attribute.

Hinweise

Diese Methode stellt ein Verfahren zum Hinzufügen von Elementen zum Attributwörterbuch zur Verfügung, das die zugeordnete Komponente des Designers, der diese Schnittstelle implementiert, über einen TypeDescriptor verfügbar macht.

Die Schlüssel im Attributwörterbuch sind die Typ-IDs der Attribute. Die Objekte sind vom Typ Attribute. Diese Methode wird unmittelbar vor PostFilterAttributes aufgerufen.

Die Typ-ID eines Attributs kann ein beliebiges Objekt sein. In der Standardeinstellung gibt das Attribute seinen Type als Wert für die TypeID-Eigenschaft zurück. Sie können zum Bezeichnen eines Attributs überprüfen, ob die TypeID eines Attributs im Wörterbuch mit einer bekannten TypeID für ein Attribut übereinstimmt, oder Sie können System.Reflection verwenden, um das Attributobjekt selbst zu bezeichnen.

Wenn einer Komponente ein Attribut mit derselben TypeID wie ein vorhandenes oder geerbtes Attribut hinzugefügt wird, ersetzt das neue Attribut das alte Attribut. Bei vielen Attributen ersetzt ein neues Attribut alle früheren Attribute desselben Typs. Einige Attributtypen geben jedoch eine TypeID zurück, anhand derer sich das Attribut selektiv unterscheiden lässt. Um beispielsweise für einen Typ verschiedene Typen von gleichzeitig aktiven Designern bereitzustellen, z. B. einen IRootDesigner und einen IDesigner, gibt die DesignerAttribute-Klasse eine TypeID zurück, die sowohl das Attribut als auch den Basisdesignertyp eindeutig kennzeichnet. Der DesignerAttribute-Konstruktor ermöglicht es Ihnen, neben dem spezifischen Typ des Designers dessen Basisdesignertyp anzugeben, und DesignerAttribute gibt eine TypeID zurück, um dies wiederzuspiegeln. Wenn Sie daher ein neues DesignerAttribute hinzufügen, dessen Basisdesignertyp mit dem Basisdesignertyp eines vorhandenen DesignerAttribute übereinstimmt, wird das alte Attribut durch das neue Attribut ersetzt.

Hinweise für Implementierer Sie können das über den attributes-Parameter zugängliche Wörterbuch direkt filtern, oder Sie können es ungeändert lassen. Wenn Sie diese Methode überschreiben, müssen Sie die Basisimplementierung aufrufen, nachdem Sie einen eigenen Filtervorgang ausgeführt haben.

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-Schnittstelle
IDesignerFilter-Member
System.ComponentModel.Design-Namespace
FilterAttributes

Freigeben über