CategoryAttribute Sınıf

Tanım

Ad Alanı:

System.ComponentModel

Bütünleştirilmiş Kodlar:

netstandard.dll, System.ComponentModel.Primitives.dll

Kaynak:

CategoryAttribute.cs

Kategorilere Ayrılmış mod olarak ayarlanmış bir PropertyGrid denetiminde 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 örnekte özelliği oluşturulur 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.
        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 nesnesinin 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 alanından 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 ayarlanmış bir denetimde PropertyGrid özellikleri veya olayları listelerken ilişkili özelliğin veya olayın ilişkilendirilecek kategoriyi Categorized gösterir. Bir CategoryAttribute özellik veya olaya uygulanmamışsa, PropertyGrid bunu Misc kategorisiyle ilişkilendirir. oluşturucusunda kategorinin adını belirterek 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 davranacakları ile ilgili ö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

Name	Description
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

Name	Description
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 için kategorinin 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

Name	Description
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()	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)

Ayrıca bkz.

• Attribute
• PropertyDescriptor
• EventDescriptor