DesignerCategoryAttribute Kelas

Definisi

Ruang nama:

System.ComponentModel

Rakitan:

System.dll

Menentukan bahwa perancang untuk kelas termasuk dalam kategori tertentu.

public ref class DesignerCategoryAttribute sealed : Attribute

[System.AttributeUsage(System.AttributeTargets.Class, AllowMultiple=false, Inherited=true)]
public sealed class DesignerCategoryAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.Class, AllowMultiple=false, Inherited=true)>]
type DesignerCategoryAttribute = class
    inherit Attribute

Public NotInheritable Class DesignerCategoryAttribute
Inherits Attribute

Warisan

Object

Attribute

DesignerCategoryAttribute

Atribut

AttributeUsageAttribute

Contoh

Contoh berikut membuat kelas yang disebut MyForm. MyForm memiliki dua atribut, yang DesignerAttribute menentukan kelas ini menggunakan DocumentDesigner, dan DesignerCategoryAttribute yang menentukan Form kategori.

[Designer("System.Windows.Forms.Design.DocumentDesigner, System.Windows.Forms.Design",
IRootDesigner::typeid),
DesignerCategory("Form")]
ref class MyForm: public ContainerControl{
   // Insert code here.
};

[Designer("System.Windows.Forms.Design.DocumentDesigner, System.Windows.Forms.Design",
    typeof(IRootDesigner)),
    DesignerCategory("Form")]

public class MyForm : ContainerControl
{
    // Insert code here.
}

<Designer("System.Windows.Forms.Design.DocumentDesigner, System.Windows.Forms.Design", _
    GetType(IRootDesigner)), DesignerCategory("Form")> _
Public Class MyForm
    
    Inherits ContainerControl
    ' Insert code here.
End Class

Contoh berikutnya membuat instans .MyForm Kemudian mendapatkan atribut untuk kelas , mengekstrak DesignerCategoryAttribute, dan mencetak nama perancang.

int main()
{
   // Creates a new form.
   MyForm^ myNewForm = gcnew MyForm;

   // Gets the attributes for the collection.
   AttributeCollection^ attributes = TypeDescriptor::GetAttributes( myNewForm );

   /* Prints the name of the designer by retrieving the 
       * DesignerCategoryAttribute from the AttributeCollection. */
   DesignerCategoryAttribute^ myAttribute = dynamic_cast<DesignerCategoryAttribute^>(attributes[ DesignerCategoryAttribute::typeid ]);
   Console::WriteLine( "The category of the designer for this class is: {0}", myAttribute->Category );
   return 0;
}

public static int Main()
{
    // Creates a new form.
    MyForm myNewForm = new();

    // Gets the attributes for the collection.
    AttributeCollection attributes = TypeDescriptor.GetAttributes(myNewForm);

    /* Prints the name of the designer by retrieving the 
     * DesignerCategoryAttribute from the AttributeCollection. */
    DesignerCategoryAttribute myAttribute =
       (DesignerCategoryAttribute)attributes[typeof(DesignerCategoryAttribute)];
    Console.WriteLine("The category of the designer for this class is: " + myAttribute.Category);

    return 0;
}

Public Shared Function Main() As Integer
    ' Creates a new form.
    Dim myNewForm As New MyForm()
    
    ' Gets the attributes for the collection.
    Dim attributes As AttributeCollection = TypeDescriptor.GetAttributes(myNewForm)
    
    ' Prints the name of the designer by retrieving the
    ' DesignerCategoryAttribute from the AttributeCollection. 
    Dim myAttribute As DesignerCategoryAttribute = _
        CType(attributes(GetType(DesignerCategoryAttribute)), DesignerCategoryAttribute)
    Console.WriteLine(("The category of the designer for this class is: " + myAttribute.Category))
    Return 0
End Function 'Main

Keterangan

Perancang visual dapat menggunakan kategori perancang untuk menginformasikan lingkungan pengembangan jenis desainer yang akan diimplementasikan. Jika tidak ada kategori perancang yang disediakan pada kelas, lingkungan pengembangan mungkin atau mungkin tidak mengizinkan kelas dirancang. Kategori dapat dibuat untuk nama apa pun.

Saat Anda menandai kelas dengan atribut ini, kelas diatur ke anggota konstanta. Ketika Anda ingin memeriksa nilai atribut ini dalam kode Anda, Anda harus menentukan anggota konstanta. Kolom Deskripsi dalam tabel di bawah ini mencantumkan anggota konstanta tempat setiap nilai diatur.

Kelas DesignerCategoryAttribute menentukan kategori umum berikut:

Kategori	Deskripsi
Komponen	Desainer yang digunakan dengan komponen. Atribut diatur ke anggota DesignerCategoryAttribute.Componentkonstanta .
Form	Desainer yang digunakan dengan formulir. Atribut diatur ke anggota DesignerCategoryAttribute.Formkonstanta .
Perancang	Desainer yang digunakan dengan desainer. Atribut diatur ke anggota DesignerCategoryAttribute.Generickonstanta .
String Kosong ("")	Ini adalah kategori default.

Untuk informasi selengkapnya, lihat Atribut.

Konstruktor

Nama	Deskripsi
DesignerCategoryAttribute()	Menginisialisasi instans DesignerCategoryAttribute baru kelas dengan string kosong ("").
DesignerCategoryAttribute(String)	Menginisialisasi instans DesignerCategoryAttribute baru kelas dengan nama kategori yang diberikan.

Bidang

Nama	Deskripsi
Component	Menentukan bahwa komponen yang ditandai dengan kategori ini menggunakan perancang komponen. Bidang ini hanya dapat dibaca.
Default	Menentukan bahwa komponen yang ditandai dengan kategori ini tidak dapat menggunakan desainer visual. Bidang ini static bersifat baca-saja.
Form	Menentukan bahwa komponen yang ditandai dengan kategori ini menggunakan perancang formulir. Bidang ini static bersifat baca-saja.
Generic	Menentukan bahwa komponen yang ditandai dengan kategori ini menggunakan perancang generik. Bidang ini static bersifat baca-saja.

Properti

Nama	Deskripsi
Category	Mendapatkan nama kategori.
TypeId	Mendapatkan pengidentifikasi unik untuk atribut ini.

Metode

Nama	Deskripsi
Equals(Object)	Mengembalikan apakah nilai objek yang diberikan sama dengan saat ini DesignOnlyAttribute.
GetHashCode()	Mengembalikan kode hash untuk instans ini.
GetType()	Mendapatkan Type instans saat ini. (Diperoleh dari Object)
IsDefaultAttribute()	Menentukan apakah atribut ini adalah default.
Match(Object)	Saat ditimpa dalam kelas turunan, mengembalikan nilai yang menunjukkan apakah instans ini sama dengan objek tertentu. (Diperoleh dari Attribute)
MemberwiseClone()	Membuat salinan dangkal dari Objectsaat ini. (Diperoleh dari Object)
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)

Implementasi Antarmuka Eksplisit

Nama	Deskripsi
_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)

Lihat juga

• Attribute
• DesignerAttribute