CategoryAttribute Kelas

Definisi

Ruang nama:

System.ComponentModel

Rakitan:

System.ComponentModel.Primitives.dll

Sumber:

CategoryAttribute.cs

Menentukan nama kategori untuk mengelompokkan properti atau peristiwa saat ditampilkan dalam kontrol yang PropertyGrid diatur ke mode Terkategorikan.

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

Warisan

Object

Attribute

CategoryAttribute

Atribut

AttributeUsageAttribute

Contoh

Contoh berikut membuat MyImage properti . Properti memiliki dua atribut: a DescriptionAttribute dan 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

Contoh berikutnya mendapatkan kategori untuk MyImage. Pertama, kode mendapatkan PropertyDescriptorCollection dengan semua properti untuk objek . Selanjutnya, kode mengindeks ke PropertyDescriptorCollection dalam untuk mendapatkan MyImage. Kemudian mengembalikan atribut untuk properti ini dan menyimpannya dalam variabel attributes.

Contohnya kemudian mencetak kategori dengan mengambil CategoryAttribute dari AttributeCollection, dan menulisnya ke layar konsol.

// 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)

Keterangan

A CategoryAttribute menunjukkan kategori untuk mengaitkan properti atau peristiwa terkait dengan, saat mencantumkan properti atau peristiwa dalam kontrol yang PropertyGrid diatur ke Categorized mode. CategoryAttribute Jika belum diterapkan ke properti atau peristiwa, mengaitkannya PropertyGrid dengan kategori Misc. Kategori baru dapat dibuat untuk nama apa pun dengan menentukan nama kategori di konstruktor untuk CategoryAttribute.

Properti Category menunjukkan nama kategori yang diwakili atribut. Properti ini Category juga menyediakan pelokalan transparan nama kategori.

Catatan Bagi Inheritor

Jika Anda menggunakan nama kategori selain nama yang telah ditentukan sebelumnya, dan Anda ingin melokalisasi nama kategori, Anda harus mengambil alih metode tersebut GetLocalizedString(String) .

Kelas CategoryAttribute mendefinisikan kategori umum berikut:

Kategori	Deskripsi
Action	Properti yang terkait dengan tindakan yang tersedia.
Appearance	Properti yang terkait dengan bagaimana entitas muncul.
Behavior	Properti yang terkait dengan cara entitas bertindak.
Data	Properti yang terkait dengan manajemen data dan sumber data.
Default	Properti yang dikelompokkan dalam kategori default.
Design	Properti yang hanya tersedia pada waktu desain.
DragDrop	Properti yang terkait dengan operasi seret dan letakkan.
Focus	Properti yang terkait dengan fokus.
Format	Properti yang terkait dengan pemformatan.
Key	Properti yang terkait dengan keyboard.
Layout	Properti yang terkait dengan tata letak.
Mouse	Properti yang terkait dengan mouse.
WindowStyle	Properti yang terkait dengan gaya jendela formulir tingkat atas.

Untuk informasi selengkapnya, lihat Atribut.

Konstruktor

CategoryAttribute()	Menginisialisasi instans CategoryAttribute baru kelas menggunakan nama kategori Default.
CategoryAttribute(String)	Menginisialisasi instans CategoryAttribute baru kelas menggunakan nama kategori yang ditentukan.

Properti

Action	Mendapatkan yang CategoryAttribute mewakili kategori Tindakan.
Appearance	Mendapatkan yang CategoryAttribute mewakili kategori Penampilan.
Asynchronous	Mendapatkan yang CategoryAttribute mewakili kategori Asinkron.
Behavior	Mendapatkan yang CategoryAttribute mewakili kategori Perilaku.
Category	Mendapatkan nama kategori untuk properti atau peristiwa tempat atribut ini diterapkan.
Data	Mendapatkan yang CategoryAttribute mewakili kategori Data.
Default	Mendapatkan yang CategoryAttribute mewakili kategori Default.
Design	Mendapatkan yang CategoryAttribute mewakili kategori Desain.
DragDrop	Mendapatkan yang CategoryAttribute mewakili kategori DragDrop.
Focus	Mendapatkan yang CategoryAttribute mewakili kategori Fokus.
Format	Mendapatkan yang CategoryAttribute mewakili kategori Format.
Key	Mendapatkan yang CategoryAttribute mewakili kategori Kunci.
Layout	Mendapatkan yang CategoryAttribute mewakili kategori Tata Letak.
Mouse	Mendapatkan yang CategoryAttribute mewakili kategori Mouse.
TypeId	Ketika diimplementasikan di kelas turunan, mendapatkan pengidentifikasi unik untuk ini Attribute. (Diperoleh dari Attribute)
WindowStyle	Mendapatkan yang CategoryAttribute mewakili kategori WindowStyle.

Metode

Equals(Object)	Mengembalikan apakah nilai objek yang diberikan sama dengan saat ini CategoryAttribute.
GetHashCode()	Mengembalikan kode hash untuk atribut ini.
GetLocalizedString(String)	Mencari nama yang dilokalkan dari kategori yang ditentukan.
GetType()	Mendapatkan instans Type saat ini. (Diperoleh dari Object)
IsDefaultAttribute()	Menentukan apakah atribut ini adalah default.
Match(Object)	Saat ditimpa di kelas turunan, mengembalikan nilai yang menunjukkan apakah instans ini sama dengan objek tertentu. (Diperoleh dari Attribute)
MemberwiseClone()	Membuat salinan dangkal dari yang saat ini Object. (Diperoleh dari Object)
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)

Lihat juga

• Attribute
• PropertyDescriptor
• EventDescriptor