DesignerCategoryAttribute Kelas

Definisi

Ruang nama:

System.ComponentModel

Rakitan:

System.ComponentModel.Primitives.dll

Sumber:

DesignerCategoryAttribute.cs

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

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 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 = 
       (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

Desainer visual dapat menggunakan kategori perancang untuk menginformasikan lingkungan pengembangan jenis perancang yang akan diimplementasikan. Jika tidak ada kategori perancang yang disediakan di 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 mendefinisikan kategori umum berikut:

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

Untuk informasi selengkapnya, lihat Atribut.

Konstruktor

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

Bidang

Component	Menentukan bahwa komponen yang ditandai dengan kategori ini menggunakan perancang komponen. Bidang ini hanya-baca.
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

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

Metode

Equals(Object)	Mengembalikan apakah nilai objek yang diberikan sama dengan saat ini DesignOnlyAttribute.
GetHashCode()	Mengembalikan kode hash untuk instans ini.
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
• DesignerAttribute