Bagikan melalui


CategoryAttribute Kelas

Definisi

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
public class CategoryAttribute : Attribute
[<System.AttributeUsage(System.AttributeTargets.All)>]
type CategoryAttribute = class
    inherit Attribute
type CategoryAttribute = class
    inherit Attribute
Public Class CategoryAttribute
Inherits Attribute
Warisan
CategoryAttribute
Atribut

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.

IsDefaultAttribute()

Ketika ditimpa di kelas turunan, menunjukkan apakah nilai instans ini adalah nilai default untuk kelas turunan.

(Diperoleh dari Attribute)
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)

Implementasi Antarmuka Eksplisit

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)

Memetakan sekumpulan nama ke sekumpulan pengidentifikasi pengiriman yang sesuai.

(Diperoleh dari Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Mengambil informasi jenis untuk objek, yang dapat digunakan untuk mendapatkan informasi jenis untuk antarmuka.

(Diperoleh dari Attribute)
_Attribute.GetTypeInfoCount(UInt32)

Mengambil jumlah antarmuka informasi jenis yang disediakan objek (baik 0 atau 1).

(Diperoleh dari Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Menyediakan akses ke properti dan metode yang diekspos oleh objek.

(Diperoleh dari Attribute)

Berlaku untuk

Lihat juga