Aracılığıyla paylaş


DesignerCategoryAttribute Sınıf

Tanım

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
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
Devralma
DesignerCategoryAttribute
Öznitelikler

Ö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.

TypeId

Türetilmiş bir sınıfta uygulandığında, bu Attributeiçin benzersiz bir tanımlayıcı alır.

(Devralındığı yer: Attribute)

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.

IsDefaultAttribute()

Türetilmiş bir sınıfta geçersiz kılındığında, bu örneğin değerinin türetilmiş sınıf için varsayılan değer olup olmadığını gösterir.

(Devralındığı yer: Attribute)
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)

Belirtik Arabirim Kullanımları

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)

Bir ad kümesini karşılık gelen bir dağıtma tanımlayıcısı kümesine eşler.

(Devralındığı yer: Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Bir arabirimin tür bilgilerini almak için kullanılabilecek bir nesnenin tür bilgilerini alır.

(Devralındığı yer: Attribute)
_Attribute.GetTypeInfoCount(UInt32)

Bir nesnenin sağladığı tür bilgisi arabirimlerinin sayısını alır (0 ya da 1).

(Devralındığı yer: Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Bir nesne tarafından sunulan özelliklere ve yöntemlere erişim sağlar.

(Devralındığı yer: Attribute)

Şunlara uygulanır

Ayrıca bkz.