CategoryAttribute Sınıf

Başvuru

Tanım

Ad Alanı:: System.ComponentModel

Bütünleştirilmiş Kod:: System.ComponentModel.Primitives.dll

Bütünleştirilmiş Kod:: System.dll

Bütünleştirilmiş Kod:: netstandard.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

Kategorilere Ayrılmış modda 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

public class CategoryAttribute : Attribute

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

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şkeninde attributeskaydeder.

Örnek daha sonra kategoriyi içinden alıp CategoryAttribute AttributeCollectionkonsol 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.
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