Bagikan melalui


Cara: Menyediakan Bitmap Kotak Alat untuk Kontrol

Jika Anda ingin memiliki ikon khusus untuk kontrol Anda muncul di Kotak Alat Visual Studio, Anda dapat menentukan gambar tertentu dengan menggunakan ToolboxBitmapAttribute. Kelas ini adalah atribut, jenis kelas khusus yang dapat Anda lampirkan ke kelas lain. Untuk informasi selengkapnya tentang atribut, lihat Gambaran umum atribut (Visual Basic) untuk Visual Basic atau Atribut (C#) untuk C#.

ToolboxBitmapAttributeDengan menggunakan , Anda dapat menentukan string yang menunjukkan jalur dan nama file untuk bitmap 16 kali 16 piksel. Bitmap ini kemudian muncul di samping kontrol Anda saat ditambahkan ke Kotak Alat. Anda juga dapat menentukan Type, dalam hal ini bitmap yang terkait dengan jenis tersebut dimuat. Jika Anda menentukan Type string dan , kontrol mencari sumber daya gambar dengan nama yang ditentukan oleh parameter string dalam rakitan yang berisi jenis yang ditentukan oleh Type parameter .

Untuk menentukan bitmap Kotak Alat untuk kontrol Anda

  1. ToolboxBitmapAttribute Tambahkan ke deklarasi kelas kontrol Anda sebelum Class kata kunci untuk visual Basic, dan di atas deklarasi kelas untuk Visual C#.

    ' Specifies the bitmap associated with the Button type.
    <ToolboxBitmap(GetType(Button))> Class MyControl1
    ' Specifies a bitmap file.
    End Class
    <ToolboxBitmap("C:\Documents and Settings\Joe\MyPics\myImage.bmp")> _
       Class MyControl2
    End Class
    ' Specifies a type that indicates the assembly to search, and the name
    ' of an image resource to look for.
    <ToolboxBitmap(GetType(MyControl), "MyControlBitmap")> Class MyControl
    End Class
    
    // Specifies the bitmap associated with the Button type.
    [ToolboxBitmap(typeof(Button))]
    class MyControl1 : UserControl
    {
    }
    // Specifies a bitmap file.
    [ToolboxBitmap(@"C:\Documents and Settings\Joe\MyPics\myImage.bmp")]
    class MyControl2 : UserControl
    {
    }
    // Specifies a type that indicates the assembly to search, and the name
    // of an image resource to look for.
    [ToolboxBitmap(typeof(MyControl), "MyControlBitmap")]
    class MyControl : UserControl
    {
    }
    
  2. Membangun kembali proyek.

    Catatan

    Bitmap tidak muncul di Kotak Alat untuk kontrol dan komponen yang dibuat secara otomatis. Untuk melihat bitmap, muat ulang kontrol dengan menggunakan kotak dialog Pilih Item Kotak Alat. Untuk informasi selengkapnya, lihat Panduan: Mengisi Kotak Alat secara otomatis dengan Komponen Kustom.

Baca juga