Como: Fornecer um Bitmap de Toolbox para um controle

  • Artigo

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çãoObservaçã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