Partilhar via


Como tratar eventos de telas do Silverlight

Você pode personalizar seu aplicativo escrevendo um código executado quando determinados eventos ocorrem. Por exemplo, você pode escrever um código executado antes dos dados serem salvos em uma fonte de dados.

Os eventos que você pode identificar podem ser agrupados em duas categorias:

  • Métodos de botão chamados quando um botão é clicado.

  • Métodos gerais chamados quando os dados são carregados ou salvos, ou quando uma tela é fechada.

  • Métodos de controle de acesso são chamados para verificar se um usuário tem permissão para executar uma tarefa.

  • Métodos de coleção são chamados quando uma coleção é modificada.

Uma descrição desses métodos aparece nas tabelas ao final deste tópico.

Para identificar um evento de tela

  1. Abra a tela que você deseja modificar com um duplo clique no Gerenciador de Soluções.

    O Designer de Tela é aberto.

  2. Na parte superior do Designer de tela, clique na seta ao lado do botão Gravar Código e selecione um método. Os métodos aos quais você pode adicionar código personalizado aparecem nas tabelas abaixo.

    O Editor de Códigos é aberto.

    Dica

    Os Métodos de Coleção só serão exibidos na lista suspensa Gravar Código se a coleção estiver selecionada no painel de dados à esquerda no Designer de Tela.

  3. Coloque o cursor no método recém-criado e digite o código que você deseja executar quando o evento ocorrer.

Lista de métodos de evento da tela

A tabela a seguir lista os métodos de evento relacionados à tela. Todos esses métodos são executados na camada do cliente.

Métodos de botão

Descrição

<MyMethodName>_Execute

Chamado quando o botão associado ao método é clicado.

Métodos gerais

Descrição

<ScreenName>_Activated

Chamado logo depois de uma tela ser ativada.

<ScreenName>_Closing

Chamado pouco antes da tela fechar.

<ScreenName>_Created

Chamado logo depois da tela aparecer.

<ScreenName>_InitializeDataWorkspace

Chamado pouco antes dos dados da tela serem recuperados.

<ScreenName>_Run

Chamado quando uma solicitação é feita para exibir a tela.

<ScreenName>_SaveError

Chamado quando a tentativa de salvar a tela resulta em um erro.

<ScreenName>_Saved

Chamado logo depois da tela ser salva.

<ScreenName>_Saving

Chamado pouco antes da tela ser salva.

Métodos de controle de acesso

Descrição

CanRun<ScreenNam

Chamado antes de uma tela aparecer. LightSwitch chama esse método para verificar as permissões do usuário atual.

<MyMethodName>_CanExecute

Chamado antes de um método ser executado. LightSwitch chama esse método para verificar as permissões do usuário atual.

Métodos de coleção

Descrição

<CollectionName>_Changed

Chamado logo depois da coleção ser alterada.

<CollectionName>_SelectionChanged

Chamado logo depois do item selecionado na coleção no momento ser selecionado.

Consulte também

Tarefas

Como tratar eventos de dados

Como tratar eventos de consulta

Conceitos

Como modificar uma tela do Silverlight usando código

Outros recursos

Telas: a interface de usuário do aplicativo LightSwitch