IDesignerFilter.PreFilterAttributes(IDictionary) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Lorsqu'elle est substituée dans une classe dérivée, permet à un concepteur d'ajouter des éléments à l'ensemble d'attributs qu'il expose à l'aide d'un TypeDescriptor.
public:
void PreFilterAttributes(System::Collections::IDictionary ^ attributes);
public void PreFilterAttributes (System.Collections.IDictionary attributes);
abstract member PreFilterAttributes : System.Collections.IDictionary -> unit
Public Sub PreFilterAttributes (attributes As IDictionary)
Paramètres
- attributes
- IDictionary
Objets Attribute de la classe du composant. Les clés du dictionnaire d'attributs sont les valeurs TypeId des attributs.
Remarques
Cette méthode permet d’ajouter des éléments au dictionnaire d’attributs que le composant associé du concepteur implémentant cette interface expose via un TypeDescriptor.
Les clés du dictionnaire des attributs sont les ID de type des attributs. Les objets sont de type Attribute. Cette méthode est appelée immédiatement avant PostFilterAttributes.
L’ID de type d’un attribut peut être n’importe quel objet. Par défaut, Attribute retourne son Type en tant que valeur de sa TypeId propriété. Vous pouvez case activée le TypeId d’un attribut dans le dictionnaire pour l’équivalence avec un attribut connu TypeId pour l’identifier, ou utiliser System.Reflection pour identifier l’objet d’attribut lui-même.
Lorsqu’un attribut ayant le même TypeId attribut qu’un attribut existant ou hérité est ajouté à un composant, le nouvel attribut remplace l’ancien attribut. Pour de nombreux attributs, un nouvel attribut du même type remplace tout attribut précédent du type. Toutefois, certains types d’attributs retournent un TypeId qui distingue l’attribut de manière sélective. Par exemple, pour fournir différents types de concepteurs actifs simultanément pour un type, tel qu’un IRootDesigner et un IDesigner, la DesignerAttribute classe retourne un qui identifie de TypeId manière unique à la fois l’attribut et le type de concepteur de base. Le DesignerAttribute constructeur vous permet de spécifier le type de concepteur de base du concepteur en plus de son type spécifique, et DesignerAttribute retourne un TypeId qui le reflète. Par conséquent, lorsque vous ajoutez un nouveau DesignerAttribute avec un type de concepteur de base du même type que le type de concepteur de base d’un attribut existant DesignerAttribute, l’ancien attribut est remplacé par le nouvel attribut.
Notes pour les responsables de l’implémentation
Vous pouvez filtrer directement le dictionnaire accessible via le attributes
paramètre ou le laisser inchangé. Si vous substituez cette méthode, appelez l’implémentation de base après avoir effectué votre propre filtrage.