DesignerCategoryAttribute Classe

Définition

Spécifie que le concepteur pour 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
public sealed class DesignerCategoryAttribute : Attribute
[<System.AttributeUsage(System.AttributeTargets.Class, AllowMultiple=false, Inherited=true)>]
type DesignerCategoryAttribute = class
    inherit Attribute
type DesignerCategoryAttribute = class
    inherit Attribute
Public NotInheritable Class DesignerCategoryAttribute
Inherits Attribute
Héritage
DesignerCategoryAttribute
Attributs

Exemples

L’exemple suivant crée une classe appelée MyForm . MyForm a deux attributs, DesignerAttribute qui spécifie que 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 , puis 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 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 = 
       (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 conception de la classe. 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 dans le tableau ci-dessous répertorie le membre constant sur lequel chaque valeur est définie.

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

Category Description
Composant Concepteurs utilisés avec les composants. L’attribut est défini sur le membre constant DesignerCategoryAttribute.Component .
Formulaire Concepteurs utilisés avec les formulaires. L’attribut est défini sur le membre constant DesignerCategoryAttribute.Form .
Designer Concepteurs utilisés avec les concepteurs. L’attribut est défini sur le membre constant DesignerCategoryAttribute.Generic .
Chaîne vide ("") Il s’agit de la catégorie par défaut.

Pour plus d’informations, consultez Attributs.

Constructeurs

DesignerCategoryAttribute()

Initialise une nouvelle instance de la classe DesignerCategoryAttribute avec une chaîne vide ("").

DesignerCategoryAttribute(String)

Initialise une nouvelle instance de la classe DesignerCategoryAttribute avec le nom de catégorie donné.

Champs

Component

Spécifie qu'un composant de cette catégorie utilise un Concepteur de composants. Ce champ est en lecture seule.

Default

Spécifie qu'un composant de cette catégorie ne peut pas utiliser de Concepteur de composants. Ce champ static est en lecture seule.

Form

Spécifie qu'un composant de cette catégorie utilise un Concepteur de formulaires. Ce champ static est en lecture seule.

Generic

Spécifie qu'un composant de cette catégorie utilise un concepteur générique. Ce champ static est en lecture seule.

Propriétés

Category

Obtient le nom de la catégorie.

TypeId

Obtient un identificateur unique pour cet attribut.

TypeId

Lors de l'implémentation dans une classe dérivée, obtient un identificateur unique pour l'objet Attribute.

(Hérité de Attribute)

Méthodes

Equals(Object)

Retourne une valeur indiquant si la valeur de l'objet donné est égale au DesignOnlyAttribute en cours.

GetHashCode()

Retourne le code de hachage de cette instance.

GetType()

Obtient le Type de l'instance actuelle.

(Hérité de Object)
IsDefaultAttribute()

Détermine si cet attribut est l'attribut par défaut.

IsDefaultAttribute()

En cas de substitution dans une classe dérivée, indique si la valeur de cette instance est la valeur par défaut pour la classe dérivée.

(Hérité de Attribute)
Match(Object)

En cas de substitution dans une classe dérivée, retourne une valeur indiquant si cette instance équivaut à un objet spécifié.

(Hérité de Attribute)
MemberwiseClone()

Crée une copie superficielle du Object actuel.

(Hérité de Object)
ToString()

Retourne une chaîne qui représente l'objet actuel.

(Hérité de Object)

Implémentations d’interfaces explicites

_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 pour 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 aux méthodes exposées par un objet.

(Hérité de Attribute)

S’applique à

Voir aussi