Поделиться через

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

  • Статья

Если вы хотите, чтобы для элемента управления на панели элементов в Visual Studio отображался специальный значок, укажите соответствующее изображение с помощью класса 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. Выполните повторную сборку проекта.

    Примечание.

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

См. также