Compartilhar via

Como fornecer um bitmap da caixa de ferramentas para um controle

  • Artigo

Se você quiser que um ícone especial para seu controle apareça no da caixa de ferramentas do Visual Studio, você poderá especificar uma imagem específica usando o . Essa classe é um atributo , um tipo especial de classe que você pode anexar a outras classes. Para obter mais informações sobre atributos, consulte Visão geral de atributos (Visual Basic) para Visual Basic ou Atributos (C#) para C#.

Usando o ToolboxBitmapAttribute, você pode especificar uma cadeia de caracteres que indica o caminho e o nome do arquivo para um bitmap de 16 por 16 pixels. O bitmap aparece ao lado de seu controle quando adicionado à Caixa de ferramentas. Você também pode especificar um Type; nesse caso, o bitmap associado a esse tipo é carregado. Se você especificar tanto um Type quanto uma cadeia de caracteres, o controle buscará um recurso de imagem com o nome especificado pelo parâmetro de cadeia de caracteres no assembly que contém o tipo especificado pelo parâmetro Type.

Especificar um bitmap da caixa de ferramentas para seu controle

  1. Adicione o ToolboxBitmapAttribute à declaração de classe do seu controle antes da palavra-chave Class para visual Basic e acima da declaração de classe para 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. Recompile o projeto.

    Nota

    O bitmap não aparece na Caixa de Ferramentas para controles e componentes gerados automaticamente. Para ver o bitmap, recarregue o controle usando a caixa de diálogo Escolher Itens da Caixa de Ferramentas. Para obter mais informações, consulte Passo a passo: preencher automaticamente a caixa de ferramentas com componentes personalizados.

Consulte também