Compartilhar via

Como fornecer um bitmap da caixa de ferramentas para um controle

  • Artigo

Se você deseja que um ícone especial para seu controle apareça na caixa de ferramentas do Visual Studio, você pode especificar uma imagem específica usando o ToolboxBitmapAttribute. Esta 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 , você pode especificar uma cadeia de caracteres que indica o caminho e o ToolboxBitmapAttributenome 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, caso em que o bitmap associado a esse tipo é carregado. Se você especificar uma e uma Type cadeia de caracteres, o controle procurará um recurso de imagem com o nome especificado pelo parâmetro string no assembly que contém o tipo especificado pelo Type parâmetro.

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 para visual Basic e acima da Class 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.

    Observação

    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 mais informações, consulte Instruções passo a passo: preenchendo de forma automática a caixa de ferramentas com componentes personalizados.

Confira também