Aracılığıyla paylaş


CategoryAttribute Sınıf

Tanım

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
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
CategoryAttribute
Öznitelikler

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

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.