Adicionar um comando Shell na barra de ferramentas do aplicativo

Esta lição mostra como adicionar um comando à barra de ferramentas do aplicativo e escrever código que é executado quando o comando é clicado em tempo de execução.O comando executa uma consulta parametrizada e exibe os resultados em uma tela de pesquisa.

Adicionar um Comando Shell

Na lição anterior, adicione um comando que aparece na barra de comando de uma tela.Você também pode programar um botão da barra de ferramentas para realizar outras tarefas, por exemplo, abrir outra tela, aplicar um filtro de dados ou até mesmo enviar um e-mail.

Para adicionar uma consulta parametrizada

  1. No Gerenciador de Soluções, selecione o nó Clientes.

  2. No menu Projeto, clique em Adicionar Consulta.

  3. Na janela Propriedades, no campo Nome, digite EncontrarCliente.

  4. No Designer de Consulta, clique em Adicionar Filtro.

  5. Na segunda lista suspensa, selecione NomedoContato.

  6. Na quarta lista suspensa, selecione Parâmetro.

  7. Na última lista suspensa, clique em Adicionar Novo.

    Um novo parâmetro, chamado NomedoContato, do tipo String é adicionado à seção Parâmetros do Editor de Consulta.

Para adicionar uma tela de pesquisa

  1. Na barra de ferramentas, clique no botão Adicionar Tela.

  2. Na caixa de diálogo Adicionar Nova Tela, na lista Selecionar um modelo de tela, selecione Tela de Dados de Pesquisa.

  3. No campo Nome da Tela, digite ProcurarCliente.

  4. Na lista Dados da Tela, selecione – EncontrarCliente e clique em OK.

  5. No Designer de Tela, selecione o nó NomedoContatodoCliente.

  6. Na janela Propriedades, selecione a propriedade É Parâmetro.

Para adicionar um comando à barra de ferramentas do aplicativo

  1. No Gerenciador de Soluções, clique duas vezes em ListadeContato.

  2. No Designer de Tela, expanda o nó Barra de Comando de Tela.

  3. Na lista Adicionar, selecione Novo Botão.

    A caixa de diálogo Adicionar Botão aparece.

  4. Na caixa de diálogo Adicionar Botão, selecione Novo Método e digite Localizar na caixa Nome e clique em OK.

  5. Na janela Propriedades, selecione Descrição e digite Localizar o contato selecionado na lista de clientes..

  6. Clique no link Escolher Imagem.

  7. Na caixa de diálogo Selecionar Imagem, clique em Importar.

  8. Na caixa de diálogo Abrir, navegue até um diretório que contenha imagens, selecione uma imagem e clique em Abrir.

  9. Clique em OK para fechar a caixa de diálogo Selecionar Imagem.

  10. No painel esquerdo, selecione Localizar.

  11. Na janela Propriedades, clique em Editar/Executar Código.

    O Editor de Código aparece e exibe o método Find_Execute().

  12. No método Find_Execute(), adicione o seguinte código.

    Application.ShowSearchCustomer(Contacts.SelectedItem.ContactName)

    Application.ShowSearchCustomer(Contacts.SelectedItem.ContactName);

    Esse código exibe a tela MostrarProcuraporCliente quando um usuário clica no botão que você acabou de criar.

  13. Pressione F5 para executar o aplicativo.

    Verifique o novo comando selecionando Howard Snyder na lista Contatos e clicando no botão Localizar.

    Os resultados da pesquisa

    A tela ProcurarCliente deverá aparecer e deve exibir os dados de Great Lakes Food Market.Quando você clica em Great Lakes Food Market na coluna Empresa, uma tela Detalhes do Cliente deve aparecer.

Visão aprofundada

Esta lição mostrou como criar uma consulta parametrizada para retornar Clientes correspondentes a um parâmetro NomedoContato e como criar uma tela de pesquisa com base na consulta.Você deve ter notado que a tela ProcurarCliente não aparece no Menu de Navegação no aplicativo em execução.Telas com base em consultas parametrizadas só podem ser abertas pela execução de um comando e não podem ser adicionadas ao menu.

A lição mostrou como adicionar um comando à tela ListadeContatos, dar a ela um Nome para Exibição, Descrição, e Imagem e adicionar o código que é executado sempre que o botão de comando é clicado.O código executa o método ShowSearchCustomer, que exibe a tela ProcurarCliente.O código entre parênteses é o parâmetro do método, neste caso o NomedoContato do item selecionado na coleção Contatos.

Você pode ter notado que o comando só aparece na barra de ferramentas do aplicativo quando a tela Lista de Contatos é selecionada.Como os comandos que são adicionados à barra de ferramentas são específicas da tela, você deve criar um comando separado para cada tela.

Próximas Etapas

Na próxima lição, você aprenderá como adicionar um item ao menu de navegação.

Próxima lição: Personalizando os itens de Menu

Consulte também

Tarefas

Como adicionar um comando personalizado a uma tela do Silverlight

Conceitos

Escrever o código em LightSwitch

Outros recursos

Criação de Menus e comandos

  • Last updated on