Examinar mais detalhadamente: Adicionando propriedades com valores nomeados

Artigo
08/25/2010

Nesta lição, você aprenderá como adicionar uma propriedade que contém uma lista de valores para o controle de usuário.

Valores nomeados

As propriedades que você adicionou ao seu controle de usuário até agora levaram valores de sequência de caracteres, mas as propriedades podem ser de vários tipos diferentes.Às vezes você desejará fornecer uma lista de valores pré-definidos para selecionar a partir dela, como a propriedade SizeMode do controle PictureBox que você definiu em uma lição anterior.

Digamos, por exemplo, que você queira criar uma propriedade para NamesControl que permite que você escolha como o rótulo FullName exibirá o nome.Você precisará de uma lista de valores para escolher: nome em primeiro lugar, Sobrenome pela primeira vez, primeiro e último nome somente e assim por diante.

No Visual Basic, você pode criar uma enumeração que contém os valores que você deseja. "Enumeração"é apenas uma palavra sofisticada para"lista numerada";Visual Basic armazena os números para você, para que você pode consultar os valores por nome. Você declara uma enumeração usando a palavra-chave Enum, como no exemplo a seguir.

Public Enum Display
    FirstMiddleLast
    FirstLast
    LastFirstMiddle
    LastFirst
End Enum

Depois de criar uma enumeração, você poderá usá-la exatamente como qualquer outro tipo de dados.Para adicionar uma propriedade que exibe uma lista de valores, você primeiro declara uma variável do mesmo tipo de dados como Enum e em seguida, declara uma propriedade do mesmo tipo de dados.Em tempo de design, uma lista de valores que estão contidos na enumeração aparecerá na janela Properties.

Tente-o!

Para adicionar uma propriedade que exibe uma lista de valores

Abra o projeto NamesUserControl que você criou na lição anterior.Se você não o salvou, você primeiramente precisará voltar para a lição anterior, Adicionar código ao seu controle de usuário, e completar os procedimentos da lição.
No Solution Explorer, selecione NamesControl.vb e no menu View, escolha Code.

No Editor de Códigos, adicione o código a seguir para criar uma enumeração.

Public Enum Display
    FirstMiddleLast
    FirstLast
    LastFirstMiddle
    LastFirst
End Enum

Adicione o código a seguir para adicionar uma nova propriedade.

Private DisplayStyleList As Display 
Property DisplayStyle() As Display
    Get
        Return DisplayStyleList
    End Get
    Set(ByVal value As Display)
        DisplayStyleList = value
    End Set
End Property

Exclua o código existente no manipulador de eventos FirstName_TextChanged e o substitua pelo código a seguir.

Select Case DisplayStyleList
    Case Display.FirstLast
        FullName.Text = FirstName.Text & " " & LastName.Text
    Case Display.FirstMiddleLast
        FullName.Text = FirstName.Text & " " & MiddleName.Text & " " & LastName.Text
    Case Display.LastFirst
        FullName.Text = LastName.Text & ", " & FirstName.Text
    Case Display.LastFirstMiddle
        FullName.Text = LastName.Text & ", " & FirstName.Text & " " & MiddleName.Text
End Select

Pressione F5 para executar a página.Insira seu primeiro, último e o nome do meio nas três caixas de texto.
Em UserControl TestContainer, vá para a parte inferior da grade de Properties e selecione a propriedade DisplayStyle.Selecione um valor diferente e, em seguida, altere o texto em uma das caixas de texto para ver como ele afeta o rótulo.
No menu File, clique em Save All para salvar seu trabalho.

Próximas etapas

Nesta lição, você aprendeu a usar uma enumeração para criar uma propriedade que possui uma lista de valores.Na próxima lição, você aprenderá a testar o controle de usuário, colocando-o em um formulário.

Próxima Lesson: Testando seu controle de usuário