Bagikan melalui


DesignerCategoryAttribute Kelas

Definisi

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
public sealed class DesignerCategoryAttribute : Attribute
[<System.AttributeUsage(System.AttributeTargets.Class, AllowMultiple=false, Inherited=true)>]
type DesignerCategoryAttribute = class
    inherit Attribute
type DesignerCategoryAttribute = class
    inherit Attribute
Public NotInheritable Class DesignerCategoryAttribute
Inherits Attribute
Warisan
DesignerCategoryAttribute
Atribut

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.

TypeId

Ketika diimplementasikan di kelas turunan, mendapatkan pengidentifikasi unik untuk ini Attribute.

(Diperoleh dari Attribute)

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.

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