CategoryAttribute Sınıf

Tanım

Ad Alanı:

System.ComponentModel

Bütünleştirilmiş Kod:

System.ComponentModel.Primitives.dll

Kaynak:

CategoryAttribute.cs

Kategorilere Ayrılmış mod olarak ayarlanmış bir PropertyGrid denetimde görüntülendiğinde özelliğin veya olayın gruplandırıldığı kategorinin adını belirtir.

public ref class CategoryAttribute : Attribute

[System.AttributeUsage(System.AttributeTargets.All)]
public class CategoryAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.All)>]
type CategoryAttribute = class
    inherit Attribute

Public Class CategoryAttribute
Inherits Attribute

Devralma

Object

Attribute

CategoryAttribute

Öznitelikler

AttributeUsageAttribute

Örnekler

Aşağıdaki örnek özelliğini oluşturur MyImage . özelliğinin iki özniteliği vardır: a DescriptionAttribute ve CategoryAttribute.

   [Description("The image associated with the control"),Category("Appearance")]
   System::Drawing::Image^ get()
   {
      // Insert code here.
      return m_Image1;
   }

   void set( System::Drawing::Image^ )
   {
      // Insert code here.
   }
}

[Description("The image associated with the control"),Category("Appearance")] 
 public Image MyImage {
    get {
       // Insert code here.
       return image1;
    }
    set {
       // Insert code here.
    }
 }

<Description("The image associated with the control"), _
    Category("Appearance")> _
Public Property MyImage() As Image
    
    Get
        ' Insert code here.
        Return image1
    End Get
    Set
        ' Insert code here.
    End Set 
End Property

Sonraki örnek için MyImagekategorisini alır. İlk olarak kod, nesnenin tüm özellikleriyle bir PropertyDescriptorCollection alır. Ardından kod, almak için dizinini PropertyDescriptorCollection oluşturur MyImage. Ardından bu özelliğin özniteliklerini döndürür ve değişkenine attributeskaydeder.

Örnek daha sonra kategoriyi içinden alıp CategoryAttributeAttributeCollectionkonsol ekranına yazarak yazdırır.

// Gets the attributes for the property.
AttributeCollection^ attributes = TypeDescriptor::GetProperties( this )[ "MyImage" ]->Attributes;

// Prints the description by retrieving the CategoryAttribute.
// from the AttributeCollection.
CategoryAttribute^ myAttribute = static_cast<CategoryAttribute^>(attributes[ CategoryAttribute::typeid ]);
Console::WriteLine( myAttribute->Category );

// Gets the attributes for the property.
 AttributeCollection attributes = 
    TypeDescriptor.GetProperties(this)["MyImage"].Attributes;
 
 // Prints the description by retrieving the CategoryAttribute.
 // from the AttributeCollection.
 CategoryAttribute myAttribute = 
    (CategoryAttribute)attributes[typeof(CategoryAttribute)];
 Console.WriteLine(myAttribute.Category);

' Gets the attributes for the property.
Dim attributes As AttributeCollection = _
    TypeDescriptor.GetProperties(Me)("MyImage").Attributes

' Prints the description by retrieving the CategoryAttribute. 
' from the AttributeCollection.
Dim myAttribute As CategoryAttribute = _
    CType(attributes(GetType(CategoryAttribute)), CategoryAttribute)
    Console.WriteLine(myAttribute.Category)

Açıklamalar

A CategoryAttribute , bir denetim modunda PropertyGrid ayarlanan özellikleri veya olayları listelerken ilişkili özelliğin veya olayın ilişkilendirilecek kategoriyi Categorized gösterir. bir CategoryAttribute özelliğine veya olayına uygulanmadıysa, PropertyGrid bunu Misc kategorisiyle ilişkilendirir. oluşturucusunda kategorinin adı belirtilerek herhangi bir ad için CategoryAttributeyeni bir kategori oluşturulabilir.

özelliği, Category özniteliğin temsil ettiği kategorinin adını gösterir. Category özelliği, kategori adlarının saydam yerelleştirilmesini de sağlar.

Devralanlara Notlar

Önceden tanımlanmış adlar dışında kategori adları kullanıyorsanız ve kategori adlarınızı yerelleştirmek istiyorsanız, yöntemini geçersiz kılmanız GetLocalizedString(String) gerekir.

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

Kategori	Açıklama
Action	Kullanılabilir eylemlerle ilgili özellikler.
Appearance	Bir varlığın görüntülenme şekliyle ilgili özellikler.
Behavior	Bir varlığın nasıl hareket ettiğini gösteren özellikler.
Data	Veri ve veri kaynağı yönetimiyle ilgili özellikler.
Default	Varsayılan kategoride gruplandırılmış özellikler.
Design	Yalnızca tasarım zamanında kullanılabilen özellikler.
DragDrop	Sürükle ve bırak işlemleriyle ilgili özellikler.
Focus	Odakla ilgili özellikler.
Format	Biçimlendirmeyle ilgili özellikler.
Key	Klavyeyle ilgili özellikler.
Layout	Düzen ile ilgili özellikler.
Mouse	Fareyle ilgili özellikler.
WindowStyle	En üst düzey formların pencere stiliyle ilgili özellikler.

Daha fazla bilgi için bkz . Öznitelikler.

Oluşturucular

CategoryAttribute()	Varsayılan kategori adını kullanarak sınıfın CategoryAttribute yeni bir örneğini başlatır.
CategoryAttribute(String)	Belirtilen kategori adını kullanarak sınıfın CategoryAttribute yeni bir örneğini başlatır.

Özellikler

Action	Eylem kategorisini temsil eden bir CategoryAttribute alır.
Appearance	Görünüm kategorisini temsil eden bir CategoryAttribute alır.
Asynchronous	Zaman Uyumsuz kategorisini temsil eden bir CategoryAttribute alır.
Behavior	Davranış kategorisini temsil eden bir CategoryAttribute alır.
Category	Bu özniteliğin uygulandığı özellik veya olayın kategorisinin adını alır.
Data	Veri kategorisini temsil eden bir CategoryAttribute alır.
Default	Varsayılan kategoriyi temsil eden bir CategoryAttribute alır.
Design	Tasarım kategorisini temsil eden bir CategoryAttribute alır.
DragDrop	DragDrop kategorisini temsil eden bir CategoryAttribute alır.
Focus	Odak kategorisini temsil eden bir CategoryAttribute alır.
Format	Biçim kategorisini temsil eden bir CategoryAttribute alır.
Key	Anahtar kategorisini temsil eden bir CategoryAttribute alır.
Layout	Düzen kategorisini temsil eden bir CategoryAttribute alır.
Mouse	Fare kategorisini temsil eden bir CategoryAttribute 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)
WindowStyle	WindowStyle kategorisini temsil eden bir CategoryAttribute alır.

Yöntemler

Equals(Object)	Verilen nesnenin değerinin geçerli CategoryAttributedeğerine eşit olup olmadığını döndürür.
GetHashCode()	Bu özniteliğin karma kodunu döndürür.
GetLocalizedString(String)	Belirtilen kategorinin yerelleştirilmiş adını arar.
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
• PropertyDescriptor
• EventDescriptor