DesignerCategoryAttribute Třída

Definice

Obor názvů:

System.ComponentModel

Sestavení:

System.ComponentModel.Primitives.dll

Zdroj:

DesignerCategoryAttribute.cs

Určuje, že návrhář třídy patří do určité kategorie.

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

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:

Kategorie	Popis
Součást	Návrháři, kteří se používají s komponentami. Atribut je nastaven na konstantní člen DesignerCategoryAttribute.Component.
Formulář	Návrháři, kteří se používají s formuláři. Atribut je nastaven na konstantní člen DesignerCategoryAttribute.Form.
Návrhář	Návrháři, kteří se používají s návrháři. Atribut je nastaven na konstantní člen DesignerCategoryAttribute.Generic.
Prázdný řetězec ("")	Toto je výchozí kategorie.

Další informace najdete v tématu Atributy.

Konstruktory

DesignerCategoryAttribute()	Inicializuje novou instanci třídy pomocí prázdného DesignerCategoryAttribute řetězce ("").
DesignerCategoryAttribute(String)	Inicializuje novou instanci DesignerCategoryAttribute třídy s daným názvem kategorie.

Pole

Component	Určuje, že součást označená touto kategorií používá návrháře komponent. Toto pole je jen ke čtení.
Default	Určuje, že komponenta označená touto kategorií nemůže používat vizuální návrháře. Toto static pole je jen pro čtení.
Form	Určuje, že součást označená touto kategorií používá návrháře formulářů. Toto static pole je jen pro čtení.
Generic	Určuje, že součást označená touto kategorií používá obecného návrháře. Toto static pole je jen pro čtení.

Vlastnosti

Category	Získá název kategorie.
TypeId	Získá jedinečný identifikátor pro tento atribut.

Metody

Equals(Object)	Vrátí, zda je hodnota daného objektu rovna aktuálnímu DesignOnlyAttributeobjektu .
GetHashCode()	Vrátí hodnotu hash pro tuto instanci.
GetType()	Získá aktuální Type instanci. (Zděděno od Object)
IsDefaultAttribute()	Určuje, jestli je tento atribut výchozí.
Match(Object)	Při přepsání v odvozené třídě vrátí hodnotu, která označuje, zda se tato instance rovná zadanému objektu. (Zděděno od Attribute)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)

Viz také

• Attribute
• DesignerAttribute