DesignerCategoryAttribute Sınıf

Tanım

Ad Alanı:

System.ComponentModel

Bütünleştirilmiş Kod:

System.ComponentModel.Primitives.dll

Kaynak:

DesignerCategoryAttribute.cs

Bir sınıf için tasarımcının belirli bir kategoriye ait olduğunu belirtir.

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

Devralma

Object

Attribute

DesignerCategoryAttribute

Öznitelikler

AttributeUsageAttribute

Örnekler

Aşağıdaki örnek adlı MyFormbir sınıf oluşturur. MyForm , bu sınıfı belirten ve DesignerAttribute kategorisini DocumentDesignerbelirten bir DesignerCategoryAttribute olmak üzere iki özniteliği vardır Form .

[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

Sonraki örnek bir örneği MyFormoluşturur. Ardından sınıfın özniteliklerini alır, ayıklar DesignerCategoryAttributeve tasarımcının adını yazdırır.

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

Açıklamalar

Görsel tasarımcı, geliştirme ortamını uygulanacak tasarımcı türü hakkında bilgilendirmek için tasarımcı kategorisini kullanabilir. Bir sınıfta tasarımcı kategorisi sağlanmazsa, geliştirme ortamı sınıfın tasarlanmasına izin verebilir veya vermeyebilir. Herhangi bir ad için bir kategori oluşturulabilir.

Bir sınıfı bu öznitelikle işaretlediğinizde, sabit üye olarak ayarlanır. Kodunuzda bu özniteliğin değerini denetlemek istediğinizde sabit üyeyi belirtmeniz gerekir. Aşağıdaki tablodaki Açıklama sütunu, her değerin ayarlandığı sabit üyeyi listeler.

DesignerCategoryAttribute sınıfı aşağıdaki yaygın kategorileri tanımlar:

Kategori	Açıklama
Bileşen	Bileşenlerle kullanılan tasarımcılar. özniteliği sabit üyesi DesignerCategoryAttribute.Componentolarak ayarlanır.
Form	Formlarla kullanılan tasarımcılar. özniteliği sabit üyesi DesignerCategoryAttribute.Formolarak ayarlanır.
Tasarımcı	Tasarımcılarla birlikte kullanılan tasarımcılar. özniteliği sabit üyesi DesignerCategoryAttribute.Genericolarak ayarlanır.
Boş Dize ("")	Bu varsayılan kategoridir.

Daha fazla bilgi için bkz . Öznitelikler.

Oluşturucular

DesignerCategoryAttribute()	Boş dize ("") ile sınıfının yeni bir örneğini DesignerCategoryAttribute başlatır.
DesignerCategoryAttribute(String)	Verilen kategori adıyla sınıfının yeni bir örneğini DesignerCategoryAttribute başlatır.

Alanlar

Component	Bu kategoriyle işaretlenmiş bir bileşenin bileşen tasarımcısı kullandığını belirtir. Bu alan salt okunur durumdadır.
Default	Bu kategoriyle işaretlenmiş bir bileşenin görsel tasarımcı kullanamayacağını belirtir. Bu static alan salt okunur.
Form	Bu kategoriyle işaretlenmiş bir bileşenin form tasarımcısı kullandığını belirtir. Bu static alan salt okunur.
Generic	Bu kategoriyle işaretlenmiş bir bileşenin genel tasarımcı kullandığını belirtir. Bu static alan salt okunur.

Özellikler

Category	Kategorinin adını alır.
TypeId	Bu öznitelik için benzersiz bir tanımlayıcı alır.

Yöntemler

Equals(Object)	Verilen nesnenin değerinin geçerli DesignOnlyAttributedeğerine eşit olup olmadığını döndürür.
GetHashCode()	Bu örneğe ilişkin karma kodu döndürür.
GetType()	Type Geçerli örneğini alır. (Devralındığı yer: Object)
IsDefaultAttribute()	Bu özniteliğin varsayılan olup olmadığını belirler.
Match(Object)	Türetilmiş bir sınıfta geçersiz kılındığında, bu örneğin belirtilen bir nesneye eşit olup olmadığını gösteren bir değer döndürür. (Devralındığı yer: Attribute)
MemberwiseClone()	Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object)
ToString()	Geçerli nesneyi temsil eden dizeyi döndürür. (Devralındığı yer: Object)

Ayrıca bkz.

• Attribute
• DesignerAttribute