Практическое руководство. Предоставление точечного рисунка панели элементов для элемента управления

Обновлен: Ноябрь 2007

Если нужно, чтобы в панели элементов рядом с вашим элементом управления отображался особый значок, можно указать рисунок для этого с помощью класса ToolboxBitmapAttribute. Этот класс представляет собой атрибут — особый тип класса, который можно присоединять к другим классам. Дополнительные сведения о работе с атрибутами см. в разделах Общие сведения об атрибутах в Visual Basic для Visual Basic и Атрибуты (Руководство по программированию на C#) для Visual C#.

С помощью класса ToolboxBitmapAttribute можно задать строковое значение, которое указывает путь и имя файла, содержащего точечный рисунок размером 16 х 16 точек. Этот рисунок появится рядом с элементом управления при добавлении элемента в панель элементов. Можно также задать значение Type. В этом случае загрузится рисунок, связанный с этим типом. Если заданы оба значения, Type и строковое значение, элемент управления будет искать файл рисунка с именем, заданным в строковом параметре, в сборке, которая содержит тип, заданный параметром Type.

Чтобы задать для элемента управления точечный рисунок панели элементов

1. Добавьте в объявление класса элемента управления атрибут ToolboxBitmapAttribute перед ключевым словом Class для Visual Basic и над объявлением класса для 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
   {
   }
   

   // Specifies the bitmap associated with the Button type.
   /** @attribute ToolboxBitmap(Button.class)  */
   class MyControl1 extends UserControl
   {
   }
   // Specifies a bitmap file.
   /** @attribute ToolboxBitmap("C:\\Documents and Settings\\Joe\\MyPics\\myImage.bmp")*/
   class MyControl2 extends UserControl
   {
   }
   // Specifies a type that indicates the assembly to search, and the name 
   // of an image resource to look for.
   /* @attribute ToolboxBitmap(MyControl.class, "MyControlBitmap") */
   class MyControl extends UserControl
   {
   }
   

2. Заново соберите проект.

   Примечание.
   Растровый рисунок не будет отображаться в панели элементов для автоматически созданных элементов управления и компонентов. Чтобы увидеть растровый рисунок, перезагрузите элемент управления с помощью окна Выберите элементы панели элементов. Дополнительные сведения см. в разделе Пример. Автоматическое заполнение панели элементов пользовательскими компонентами.

См. также

Задачи

Пример. Автоматическое заполнение панели элементов пользовательскими компонентами

Ссылки

Атрибуты (Руководство по программированию на C#)

ToolboxBitmapAttribute

Другие ресурсы

Создание элементов управления Windows Forms во время разработки

Атрибуты в Visual Basic