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.
En cas de substitution dans une classe dérivée, permet à un concepteur d’ajouter des éléments à l’ensemble d’attributs qu’il expose par le biais d’un TypeDescriptor.
public:
void PreFilterAttributes(System::Collections::IDictionary ^ attributes);public void PreFilterAttributes(System.Collections.IDictionary attributes);abstract member PreFilterAttributes : System.Collections.IDictionary -> unitPublic 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 TypeId valeurs 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 d’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 sa Type valeur comme valeur de sa TypeId propriété. Vous pouvez vérifier l’équivalence TypeId d’un attribut dans le dictionnaire avec un attribut connu TypeId pour l’identifier ou l’utiliser System.Reflection pour identifier l’objet d’attribut lui-même.
Lorsqu’un attribut qui a 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 tous les attributs précédents du type. Toutefois, certains types d’attributs retournent un TypeId attribut 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 une TypeId valeur qui identifie de manière unique l’attribut et le type du 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 une TypeId valeur qui reflète cela. Par conséquent, lorsque vous ajoutez un nouveau DesignerAttribute 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 vous pouvez le laisser inchangé. Si vous substituez cette méthode, appelez l’implémentation de base après avoir effectué votre propre filtrage.
