Como: Fornecer um Bitmap de Toolbox para um controle

Se você deseja ter um ícone especial para o seu controle aparecem na 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 Attributes Overview in Visual Basic para Visual Basic e Atributos (C# e Visual Basic) para Visual C#.

Usando o ToolboxBitmapAttribute, você pode especificar uma seqüência de caracteres que indica o caminho e nome de arquivo para um bitmap de 16 por 16 pixels. Esse bitmap é exibido próximo ao seu controle quando adicionado para o caixa de ferramentas. Você também pode especificar um Type, caso em que o bitmap associado àquele tipo é carregado. Se você especificar ambos 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 assembly que contém o tipo especificado pelo Type parâmetro.

Para especificar um bitmap de Toolbox para seu controle.

1. Adicionar o ToolboxBitmapAttribute para a declaração de classe do seu controle antes de 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 componentes e controles de gerado automaticamente. Para ver o bitmap, recarregar o controle usando o Choose Toolbox Items 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 (C# e Visual Basic)

ToolboxBitmapAttribute

Conceitos

Atributos (Visual Basic)

Outros recursos

Desenvolvendo controles Windows Forms em tempo de Design