DesignerCategoryAttribute Osztály

Definíció

Névtér:

System.ComponentModel

Szerelvények:

netstandard.dll, System.ComponentModel.Primitives.dll

Forrás:

DesignerCategoryAttribute.cs

Megadja, hogy egy osztály tervezője egy adott kategóriához tartozik-e.

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

Öröklődés

Object

Attribute

DesignerCategoryAttribute

Attribútumok

AttributeUsageAttribute

Példák

Az alábbi példa létrehoz egy osztályt MyForm. MyForm két attribútummal rendelkezik, az DesignerAttribute osztályt meghatározó osztály a DocumentDesigner, és egy DesignerCategoryAttribute , a kategóriát Form meghatározó attribútummal rendelkezik.

[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

A következő példa létrehoz egy példányt.MyForm Ezután lekéri az osztály attribútumait, kinyeri és DesignerCategoryAttributekinyomtatja a tervező nevét.

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

Megjegyzések

A vizualizációtervezők egy tervezőkategóriával tájékoztathatják a fejlesztői környezetet a megvalósítandó tervező típusáról. Ha egy osztályban nincs tervezőkategória, a fejlesztői környezetek esetleg nem teszik lehetővé az osztály tervezését. Bármely névhez létrehozhat kategóriát.

Ha ezzel az attribútummal jelöl meg egy osztályt, az állandó tagra van állítva. Ha ellenőrizni szeretné ennek az attribútumnak az értékét a kódban, meg kell adnia az állandó tagot. Az alábbi táblázat Leírás oszlopa felsorolja azokat az állandó tagokat, amelyekre az egyes értékek be van állítva.

Az DesignerCategoryAttribute osztály a következő gyakori kategóriákat határozza meg:

Kategória	Leírás
Component	Az összetevőkkel használt tervezők. Az attribútum az állandó tagra DesignerCategoryAttribute.Componentvan állítva.
Form	Űrlapokkal használt tervezők. Az attribútum az állandó tagra DesignerCategoryAttribute.Formvan állítva.
Tervező	Tervezőkkel használt tervezők. Az attribútum az állandó tagra DesignerCategoryAttribute.Genericvan állítva.
Üres sztring ("")	Ez az alapértelmezett kategória.

További információ: Attribútumok.

Konstruktorok

Name	Description
DesignerCategoryAttribute()	Inicializálja az DesignerCategoryAttribute osztály új példányát egy üres sztringgel ("").
DesignerCategoryAttribute(String)	Inicializálja az DesignerCategoryAttribute osztály új példányát a megadott kategórianévvel.

Mezők

Name	Description
Component	Megadja, hogy az ezzel a kategóriával megjelölt összetevők összetevőtervezőt használnak. Ez a mező csak olvasható.
Default	Megadja, hogy az ezzel a kategóriával megjelölt összetevők nem használhatnak vizualizációtervezőt. Ez static a mező írásvédett.
Form	Megadja, hogy az ezzel a kategóriával megjelölt összetevők űrlaptervezőt használnak. Ez static a mező írásvédett.
Generic	Megadja, hogy az ezzel a kategóriával megjelölt összetevők általános tervezőt használnak. Ez static a mező írásvédett.

Tulajdonságok

Name	Description
Category	Lekéri a kategória nevét.
TypeId	Egyedi azonosítót kap ehhez az attribútumhoz.

Metódusok

Name	Description
Equals(Object)	Azt adja vissza, hogy az adott objektum értéke megegyezik-e az aktuális DesignOnlyAttributeértékkel.
GetHashCode()	A példány kivonatkódját adja vissza.
GetType()	Lekéri az Type aktuális példányt. (Öröklődés forrása Object)
IsDefaultAttribute()	Meghatározza, hogy ez az attribútum-e az alapértelmezett érték.
Match(Object)	Származtatott osztály felülírásakor egy olyan értéket ad vissza, amely jelzi, hogy ez a példány egy adott objektummal egyenlő-e. (Öröklődés forrása Attribute)
MemberwiseClone()	Az aktuális Objectpéldány sekély másolatát hozza létre. (Öröklődés forrása Object)
ToString()	Az aktuális objektumot jelképező sztringet ad vissza. (Öröklődés forrása Object)

Lásd még

• Attribute
• DesignerAttribute