DesignerCategoryAttribute Třída

Definice

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

Dědičnost

Object

Attribute

DesignerCategoryAttribute

Atributy

AttributeUsageAttribute

Příklady

Následující příklad vytvoří třídu s názvem MyForm. MyForm má dva atributy, které určují, DesignerAttribute že tato třída používá DocumentDesigner, a DesignerCategoryAttribute , která určuje Form kategorii.

[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

Další příklad vytvoří instanci objektu MyForm. Pak získá atributy pro třídu, extrahuje DesignerCategoryAttributea vytiskne název návrháře.

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

Poznámky

Vizuální návrhář může použít kategorii návrháře k informování vývojového prostředí o typu návrháře, který bude implementován. Pokud není u třídy k dispozici žádná kategorie návrháře, vývojové prostředí může nebo nemusí umožnit, aby byla třída navržena. Kategorie může být vytvořena pro libovolný název.

Když označíte třídu tímto atributem, nastaví se na konstantní člen. Pokud chcete zkontrolovat hodnotu tohoto atributu v kódu, musíte zadat konstantní člen. Sloupec Popis v tabulce níže uvádí konstantní člen, na který je každá hodnota nastavená.

Třída DesignerCategoryAttribute definuje následující běžné kategorie:

Další informace najdete v tématu Atributy.

Konstruktory

Pole

Vlastnosti

Metody

Explicitní implementace rozhraní

Platí pro

Viz také

• Attribute
• DesignerAttribute