Como: Fornecer um bitmap de Toolbox para um controle

Se você desejar ter um ícone especial de controle de aparecer no Caixa de ferramentas, você pode especificar uma imagem específica usando o ToolboxBitmapAttribute. Essa classe é um atributo, um tipo especial de classe, você pode anexar a outras classes.Para obter mais informações sobre atributos, consulte Visão Geral de Atributos em Visual Basic para Visual Basic e Atributos (guia de programação C#) para Visual C#.

Usando o ToolboxBitmapAttribute, você pode especificar uma seqüência de caracteres que indica nome de arquivo e caminho de um bitmap de 16 por 16 pixels. Esse bitmap, em seguida, aparece próximo ao seu controle quando adicionados ao Caixa de ferramentas.Você também pode especificar um Type, caso em que o bitmap associado a esse tipo é carregado. Se você especificar um Type e uma seqüência de caracteres, o controle procura por um recurso de imagem com o nome especificado pelo parâmetro de seqüência de caracteres no conjunto de módulos (assembly) que contém o tipo especificado pela Type parâmetro.

Para especificar um bitmap de Toolbox para seu controle

1. Adicionar o ToolboxBitmapAttribute a declaração de classe do seu controle antes da Class palavra-chave para Visual Basice 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
   {
   }
   

   // 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. Crie o projeto.

   Observação:
   O bitmap não aparece na caixa de ferramentas para gerado automaticamente controles e componentes.Para ver o bitmap Re carregar o controle usando o Escolher itens da caixa de ferramentas caixa de diálogo.Para obter mais informações, consulte Demonstra Passo a passo: Preenchendo automaticamente a caixa de ferramentas com componentes personalizados.

Consulte também

Tarefas

Demonstra Passo a passo: Preenchendo automaticamente a caixa de ferramentas com componentes personalizados

Referência

Atributos (guia de programação C#)

ToolboxBitmapAttribute

Outros recursos

Desenvolvimento de Windows Forms Controls at tempo de design

Atributos do Visual Basic