Passo a passo: Criando um ícone de caixa de ferramentas personalizada para um controle

Esta explicação passo a passo mostra como criar um ícone da caixa de ferramentas para um controle personalizadode Windows Presentation Foundation (WPF). Quando você adiciona o controle personalizado à caixa de ferramentas, o ícone aparece próximo ao nome do controle.

In this walkthrough, you perform the following tasks:

  • Create a WPF custom control library project.

  • Crie um arquivo de bitmap de personalizado para o ícone da caixa de ferramentas do controle.

  • Teste o ícone do controle em tempo de design.

Quando tiver terminado, você saberá como criar um ícone na caixa de ferramentas para um controle personalizado.

ObservaçãoObservação

Caixas de diálogo e comandos de menu que você vê podem diferir das descritas na Help dependendo das suas configurações ativas ou edição. Para alterar as configurações, escolha Import and Export Settings sobre o Ferramentas menu. For more information, see Trabalhando com configurações.

Pré-requisitos

You need the following components to complete this walkthrough:

  • Visual Studio 2010.

Criar um ícone da caixa de ferramentas Personalizar

Para criar um ícone personalizado para um controle de caixa de ferramentas, adicione uma imagem como um recurso inserido do controle projeto.

Para criar um ícone personalizado de ferramentas

  1. Criar uma biblioteca de controlePersonalizar WPFnovo projeto em Visual Basic ou o Visual C# chamado CustomControlWithToolboxIcon.

    The code for CustomControl1 opens in the Code Editor.

  2. From the Project menu, select Add New Item.

    The Add New Item dialog box opens.

  3. No Adicionar Novo Item caixa de diálogo, selecione o Geral categoria.

  4. Na lista de modelos, selecione Arquivode Bitmap, nomeie o novo arquivo CustomControl1.Icon.bmpe em seguida, clique em Adicionar.

    O Editor de imagem é aberta.

  5. No janela Propriedades, definir o bitmapdo cores depropriedade para de 24 bits.

  6. Use as ferramentas do Editor de imagem para pintar uma imagem em bitmap. For more information, see Editor de imagens.

  7. Em Solution Explorer, selecione CustomControl1.Icon.bmp.

  8. No janela Propriedades, defina a Build Action depropriedade para Embedded Resource.

  9. Build the solution.

    For more information, see Ícones de caixa de ferramentas.

O ícone da caixa de ferramentas de teste.

Teste seu ícone da caixa de ferramentas personalizada, adicionando CustomControl1 a caixa de ferramentas.

Para teste o ícone da caixa de ferramentas

  1. Adicionar um novo aplicativo do WPF projeto em Visual Basic ou o Visual C# chamado TestApplication à solução.

    MainWindow. XAML é aberto no WPF Designer. Na caixa de ferramentas, CustomControl1 consta o Controles de CustomControlWithToolboxIcon guia.

    Caixa de Ferramentas com controle personalizado

  2. Na caixa de ferramentas, clique em direita- CustomControl1 e selecione Excluir.

  3. Na caixa de mensagem que aparece, clique em OK.

    CustomControl1 é removida da caixa de ferramentas.

  4. Na caixa de ferramentas, clique-, o controle de grupo onde deseja adicionar o controle e, em seguida, selecione a direita Escolher itens nomenude contexto.

    The Choose Toolbox Items dialog box opens.

  5. No Choose Toolbox Items caixa de diálogo, clique no componentes doWPF guia. For more information, see Componentes do WPF de tabulação, escolha a caixa de diálogo de itens da caixa de ferramentas.

  6. Clique em Procurar e navegue até a pasta bin\Debug de CustomControlWithToolboxIcon projeto.

  7. No Abrir caixa de diálogo, selecione CustomControlWithToolboxIcon.dll e clique em Abrir.

    Detalhes do assembly de CustomControlWithToolboxIcon são exibidos no Choose Toolbox Items caixa de diálogo. Consta de seu ícone personalizado a CustomControl1 caixa de grupo.

  8. Click OK.

    CustomControl1 aparece na caixa de ferramentas com seu ícone correspondente.

    Ícone de Caixa de Ferramentas personalizado

Consulte também

Tarefas

Como: Incorporar um ícone em um conjunto de módulos (assembly)

Referência

Componentes do WPF de tabulação, escolha a caixa de diálogo de itens da caixa de ferramentas

Outros recursos

Ícones de caixa de ferramentas

Usando recursos

Passo a passo: Fornecendo metadados para ícones de caixa de ferramentas