DesignerCategoryAttribute Klas

Definitie

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

Overname

Object

Attribute

DesignerCategoryAttribute

Kenmerken

AttributeUsageAttribute

Voorbeelden

In het volgende voorbeeld wordt een klasse gemaakt met de naam MyForm. MyForm heeft twee kenmerken, een DesignerAttribute die aangeeft dat deze klasse gebruikmaakt van de DocumentDesigneren een die DesignerCategoryAttribute de Form categorie aangeeft.

[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

In het volgende voorbeeld wordt een exemplaar van MyForm. Vervolgens worden de kenmerken voor de klasse opgehaald, wordt de DesignerCategoryAttributenaam van de ontwerper geëxtraheerd en afgedrukt.

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

Opmerkingen

Een visuele ontwerper kan een ontwerpcategorie gebruiken om een ontwikkelomgeving te informeren over het type ontwerper dat wordt geïmplementeerd. Als er geen ontwerpfunctiecategorie is opgegeven in een klasse, kan een ontwikkelomgeving de klasse wel of niet toestaan om te worden ontworpen. Er kan een categorie worden gemaakt voor elke naam.

Wanneer u een klasse markeert met dit kenmerk, wordt deze ingesteld op een constant lid. Wanneer u de waarde van dit kenmerk in uw code wilt controleren, moet u het constante lid opgeven. De kolom Beschrijving in de onderstaande tabel bevat het constante lid waarop elke waarde is ingesteld.

De DesignerCategoryAttribute klasse definieert de volgende algemene categorieën:

Zie Kenmerken voor meer informatie.

Zie ook

• Attribute
• DesignerAttribute