Como adicionar um controle personalizado a uma tela do Silverlight

Artigo
06/10/2015

É possível adicionar controles do Silverlight a uma tela do LightSwitch. Usando os controles do Silverlight, é possível exibir ou coletar informações de maneiras além dos recursos dos controles internos do LightSwitch.

É possível usar os controles incluídos no tempo de execução do Silverlight e no SDK do Silverlight. Também é possível usar controles que você cria usando modelos de projeto do Silverlight, por exemplo, aqueles que estão disponíveis no Visual Studio 2010. Os dois tipos de controles são chamados de controles personalizados no LightSwitch.

Para obter informações sobre como criar controles personalizados usando modelos de projeto do Silverlight no Visual Studio, consulte Noções básicas de controle (Silverlight QuickStart).

Adicionando novos controles e substituindo controles existentes

É possível adicionar um controle personalizado a uma tela, como um novo controle ou como uma substituição de um controle LightSwitch existente.

Para adicionar um controle personalizado a uma tela

Na Árvore de Conteúdo da Tela, selecione qualquer grupo.
Na parte superior do Designer de Tela, clique em Adicionar Item de Layout e em Controle Personalizado.
Na caixa de diálogo Adicionar Controle Personalizado, expanda o nó do assembly e o nó do namespace e selecione o nó do controle.

Se o assembly desejado não aparecer na caixa de diálogo Adicionar Controle Personalizado, clique em Adicionar Referência. Na caixa de diálogo Adicionar Referência, selecione um assembly ou um projeto local que contenha o controle que você deseja usar e clique em OK.

Dica

Se tiver criado esse controle usando modelos de projeto do Silverlight no Visual Studio e associado o controle a dados modificando o XAML do controle, você não precisará executar a próxima etapa.Para obter mais informações sobre como associar um controle personalizado a dados modificando o XAML do controle, consulte Usando Controles Personalizados para Aprimorar a Interface do Usuário do Aplicativo LightSwitch.Se o controle personalizado for um controle interno do Silverlight ou se você tiver criado esse controle usando modelos de projeto do Silverlight no Visual Studio, mas quiser associar o controle aos dados usando o LightSwitch, vá para a próxima etapa.
No campo Especifique os dados do novo controle personalizado, digite o nome dos dados da tela que você deseja associar ao controle e clique em OK.

Por exemplo, se você quiser que uma caixa de listagem personalizada mostre nomes de uma coleção chamada CustomerSet, digite CustomerSet. Se você quiser que o controle mostre o nome do cliente selecionado no momento, digite CustomerSet.SelectedItem.ContactName.
Adicione o código que associa os dados a uma propriedade específica do controle. Para obter mais informações, consulte Associando dados a uma propriedade do controle personalizado mais à frente neste documento.

Para usar um controle personalizado a fim de substituir um controle existente

Na Árvore de Conteúdo da Tela, na lista suspensa perto do controle que você deseja substituir, selecione Controle Personalizado.
Na janela Propriedades, perto do campo Controle Personalizado, clique em Alterar
Na caixa de diálogo Adicionar Controle Personalizado, expanda o nó do assembly e o nó do namespace, selecione o nó do controle e clique em OK.

Se o assembly que contém o controle não aparecer na caixa de diálogo Adicionar Controle Personalizado, clique em Adicionar Referência. Na caixa de diálogo Adicionar Referência, selecione um assembly ou um projeto local que contenha o controle que você deseja usar e clique em OK.
Adicione o código que associa os dados a uma propriedade específica do controle. Para obter mais informações, consulte Associando dados a uma propriedade do controle personalizado mais à frente neste documento.

Associando dados a uma propriedade do controle personalizado

Você deve associar os dados que especificou na caixa de diálogo Adicionar Controle Personalizado a uma propriedade específica do controle personalizado.

Para associar dados a uma propriedade do controle personalizado

No Designer de Tela, clique na seta perto do botão Gravar Código e clique em qualquer método.

Dica

Escolha um método que será executado antes que os dados apareçam no controle no tempo de execução, por exemplo, o CustomerListDetail_Activated.

Um bloco de métodos aparece no Editor de Códigos.
No bloco de métodos, adicione o código que associa os dados da tela a uma propriedade de controle personalizado.

O exemplo a seguir referencia um controle de caixa de listagem personalizado chamado Customers. Esse código associa uma coleção de dados especificada na caixa de diálogo Adicionar Controle Personalizado a uma propriedade específica da caixa de listagem. Esse código também especifica que os dados podem ser modificados com esse controle.
```
Private Sub CustomersListDetail_Activated()
    Me.FindControl("Customers").SetBinding( _
        System.Windows.Controls.ListBox.ItemsSourceProperty, _
                "Value", System.Windows.Data.BindingMode.TwoWay)
End Sub
```
```
partial void CustomersListDetail_Activated()
{
    this.FindControl("Customers").SetBinding(
        System.Windows.Controls.ListBox.ItemsSourceProperty,
        "Value", System.Windows.Data.BindingMode.TwoWay);
}
```