DesignerCategoryAttribute Classe

Définition

Espace de noms:

System.ComponentModel

Assembly:

System.dll

Spécifie que le concepteur d’une classe appartient à une certaine catégorie.

public ref class DesignerCategoryAttribute sealed : Attribute

[System.AttributeUsage(System.AttributeTargets.Class, AllowMultiple=false, Inherited=true)]
public sealed class DesignerCategoryAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.Class, AllowMultiple=false, Inherited=true)>]
type DesignerCategoryAttribute = class
    inherit Attribute

Public NotInheritable Class DesignerCategoryAttribute
Inherits Attribute

Héritage

Object

Attribute

DesignerCategoryAttribute

Attributs

AttributeUsageAttribute

Exemples

L’exemple suivant crée une classe appelée MyForm. MyForm a deux attributs, un DesignerAttribute qui spécifie cette classe utilise le DocumentDesigner, et un DesignerCategoryAttribute qui spécifie la Form catégorie.

[Designer("System.Windows.Forms.Design.DocumentDesigner, System.Windows.Forms.Design",
IRootDesigner::typeid),
DesignerCategory("Form")]
ref class MyForm: public ContainerControl{
   // Insert code here.
};

[Designer("System.Windows.Forms.Design.DocumentDesigner, System.Windows.Forms.Design",
    typeof(IRootDesigner)),
    DesignerCategory("Form")]

public class MyForm : ContainerControl
{
    // Insert code here.
}

<Designer("System.Windows.Forms.Design.DocumentDesigner, System.Windows.Forms.Design", _
    GetType(IRootDesigner)), DesignerCategory("Form")> _
Public Class MyForm
    
    Inherits ContainerControl
    ' Insert code here.
End Class

L’exemple suivant crée une instance de MyForm. Ensuite, il obtient les attributs de la classe, extrait le DesignerCategoryAttribute, et imprime le nom du concepteur.

int main()
{
   // Creates a new form.
   MyForm^ myNewForm = gcnew MyForm;

   // Gets the attributes for the collection.
   AttributeCollection^ attributes = TypeDescriptor::GetAttributes( myNewForm );

   /* Prints the name of the designer by retrieving the 
       * DesignerCategoryAttribute from the AttributeCollection. */
   DesignerCategoryAttribute^ myAttribute = dynamic_cast<DesignerCategoryAttribute^>(attributes[ DesignerCategoryAttribute::typeid ]);
   Console::WriteLine( "The category of the designer for this class is: {0}", myAttribute->Category );
   return 0;
}

public static int Main()
{
    // Creates a new form.
    MyForm myNewForm = new();

    // Gets the attributes for the collection.
    AttributeCollection attributes = TypeDescriptor.GetAttributes(myNewForm);

    /* Prints the name of the designer by retrieving the 
     * DesignerCategoryAttribute from the AttributeCollection. */
    DesignerCategoryAttribute myAttribute =
       (DesignerCategoryAttribute)attributes[typeof(DesignerCategoryAttribute)];
    Console.WriteLine("The category of the designer for this class is: " + myAttribute.Category);

    return 0;
}

Public Shared Function Main() As Integer
    ' Creates a new form.
    Dim myNewForm As New MyForm()
    
    ' Gets the attributes for the collection.
    Dim attributes As AttributeCollection = TypeDescriptor.GetAttributes(myNewForm)
    
    ' Prints the name of the designer by retrieving the
    ' DesignerCategoryAttribute from the AttributeCollection. 
    Dim myAttribute As DesignerCategoryAttribute = _
        CType(attributes(GetType(DesignerCategoryAttribute)), DesignerCategoryAttribute)
    Console.WriteLine(("The category of the designer for this class is: " + myAttribute.Category))
    Return 0
End Function 'Main

Remarques

Un concepteur visuel peut utiliser une catégorie de concepteur pour informer un environnement de développement du type de concepteur qui sera implémenté. Si aucune catégorie de concepteur n’est fournie sur une classe, un environnement de développement peut ou non autoriser la classe à être conçue. Une catégorie peut être créée pour n’importe quel nom.

Lorsque vous marquez une classe avec cet attribut, elle est définie sur un membre constant. Lorsque vous souhaitez vérifier la valeur de cet attribut dans votre code, vous devez spécifier le membre constant. La colonne Description du tableau ci-dessous répertorie le membre constant sur lequel chaque valeur est définie.

La DesignerCategoryAttribute classe définit les catégories courantes suivantes :

Category	Description
Composant	Concepteurs utilisés avec des composants. L’attribut est défini sur le membre DesignerCategoryAttribute.Componentconstant .
Formulaire	Concepteurs utilisés avec des formulaires. L’attribut est défini sur le membre DesignerCategoryAttribute.Formconstant .
Designer	Concepteurs utilisés avec des concepteurs. L’attribut est défini sur le membre DesignerCategoryAttribute.Genericconstant .
Chaîne vide («  »)	Il s’agit de la catégorie par défaut.

Pour plus d’informations, consultez Attributs.

Constructeurs

Nom	Description
DesignerCategoryAttribute()	Initialise une nouvelle instance de la DesignerCategoryAttribute classe avec une chaîne vide («  »).
DesignerCategoryAttribute(String)	Initialise une nouvelle instance de la DesignerCategoryAttribute classe avec le nom de catégorie donné.

Champs

Nom	Description
Component	Spécifie qu’un composant marqué avec cette catégorie utilise un concepteur de composants. Ce champ est en lecture seule.
Default	Spécifie qu’un composant marqué avec cette catégorie ne peut pas utiliser un concepteur visuel. Ce static champ est en lecture seule.
Form	Spécifie qu’un composant marqué avec cette catégorie utilise un concepteur de formulaires. Ce static champ est en lecture seule.
Generic	Spécifie qu’un composant marqué avec cette catégorie utilise un concepteur générique. Ce static champ est en lecture seule.

Propriétés

Nom	Description
Category	Obtient le nom de la catégorie.
TypeId	Obtient un identificateur unique pour cet attribut.

Méthodes

Nom	Description
Equals(Object)	Retourne si la valeur de l’objet donné est égale à la valeur actuelle DesignOnlyAttribute.
GetHashCode()	Retourne le code de hachage pour cette instance.
GetType()	Obtient la Type de l’instance actuelle. (Hérité de Object)
IsDefaultAttribute()	Détermine si cet attribut est la valeur par défaut.
Match(Object)	En cas de substitution dans une classe dérivée, retourne une valeur qui indique si cette instance est égale à un objet spécifié. (Hérité de Attribute)
MemberwiseClone()	Crée une copie superficielle du Objectactuel. (Hérité de Object)
ToString()	Retourne une chaîne qui représente l’objet actuel. (Hérité de Object)

Implémentations d’interfaces explicites

Nom	Description
_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)	Mappe un jeu de noms avec un jeu correspondant d'identificateurs de dispatch. (Hérité de Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)	Récupère les informations de type d’un objet, qui peuvent être utilisées pour obtenir les informations de type d’une interface. (Hérité de Attribute)
_Attribute.GetTypeInfoCount(UInt32)	Récupère le nombre d'interfaces d'informations de type fourni par un objet (0 ou 1). (Hérité de Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)	Fournit l’accès aux propriétés et méthodes exposées par un objet. (Hérité de Attribute)

Voir aussi

• Attribute
• DesignerAttribute