DesignerCategoryAttribute Sınıf

Tanım

Ad Alanı:

System.ComponentModel

Bütünleştirilmiş Kod:

System.dll

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. MyFormiki özniteliği vardır. Bu sınıfı belirten bir DesignerAttribute özniteliği, DocumentDesigner kategorisini DesignerCategoryAttributeForm belirten ise öğesini kullanır.

[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, örneğini 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();

    // 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, bir 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, bu sabit üyeye 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	Description
Bileşen	Bileşenlerle kullanılan tasarımcılar. özniteliği sabit üyesine DesignerCategoryAttribute.Componentayarlanır.
Form	Formlarla kullanılan tasarımcılar. özniteliği sabit üyesine DesignerCategoryAttribute.Formayarlanır.
Tasarımcı	Tasarımcılarla birlikte kullanılan tasarımcılar. özniteliği sabit üyesine DesignerCategoryAttribute.Genericayarlanır.
Boş Dize ("")	Bu varsayılan kategoridir.

Daha fazla bilgi için bkz . Öznitelikler.

Oluşturucular

Name	Description
DesignerCategoryAttribute()	Boş bir 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 DesignerCategoryAttribute yeni bir örneğini başlatır.

Alanlar

Name	Description
Component	Bu kategoriyle işaretlenmiş bir bileşenin bir bileşen tasarımcısı kullandığını belirtir. Bu alan salt okunurdur.
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

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

Yöntemler

Name	Description
Equals(Object)	Verilen nesnenin değerinin geçerli DesignOnlyAttributedeğerine eşit olup olmadığını döndürür.
GetHashCode()	Bu örneğin karma kodunu döndürür.
GetType()	Geçerli örneğin Type 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 Objectbasit bir kopyasını oluşturur. (Devralındığı yer: Object)
ToString()	Geçerli nesneyi temsil eden bir dize döndürür. (Devralındığı yer: Object)

Belirtik Arabirim Kullanımları

Name	Description
_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 kullanıma sunulan özelliklere ve yöntemlere erişim sağlar. (Devralındığı yer: Attribute)

Ayrıca bkz.

• Attribute
• DesignerAttribute