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

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

С помощью ToolboxBitmapAttribute, можно указать строку, которая указывает путь и имя файла для точечного рисунка 16 x 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  
{  
}

  2. Перестройте проект.

    Note

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

См. также