O que é controle TextBox?
O controle TextBox permite inserir texto no formulário durante o tempo de execução. A configuração padrão é aceitar apenas uma linha de texto, mas você pode modificá-la para aceitar várias linhas. Você pode até incluir barras de rolagem em seu controle TextBox.
Neste tutorial, você aprenderá
- O que é controle TextBox?
- Propriedades de TextBox
- Eventos de caixa de texto
- Como criar um TextBox
- Personagem de senha
- Nova linha em TextBox
- Recuperando valores inteiros
- ReadOnly TextBox
- comprimento máximo
Propriedades de TextBox
A seguir estão as propriedades mais comuns do controle TextBox do Visual Basic:
- TextAlign - para definir o alinhamento do texto
- ScrollBars - para adicionar barras de rolagem, tanto verticais quanto horizontais
- Multiline - para definir o controle TextBox para permitir várias linhas
- MaxLength - para especificar o número máximo de caracteres que o controle TextBox aceitará
- Índice - para especificar o índice da matriz de controle
- Habilitado - para habilitar o controle de caixa de texto
- Readonly - se definido como true, você poderá usar o controle TextBox, se definido como false, você não poderá usar o controle TextBox.
- SelectionStart - para definir ou obter o ponto de partida para o controle TextBox.
- SelectionLength - para definir ou obter o número de caracteres que foram selecionados no controle TextBox.
- SelectedText - retorna o controle TextBox atualmente selecionado.
Eventos de caixa de texto
O objetivo dos eventos é fazer com que o controle TextBox responda às ações do usuário, como um clique, um clique duplo ou alteração no alinhamento do texto. Aqui estão os eventos comuns para o controle TextBox:
- AutoSizeChanged - Disparado por uma alteração na propriedade AutoSize.
- ReadOnlyChanged - Disparado por uma alteração do valor da propriedade ReadOnly.
- Clique - Disparado por um clique no controle TextBox.
Como criar um TextBox
Etapa 1) Para criar um TextBox, arraste o controle TextBox da caixa de ferramentas para o WindowForm:
Passo 2)
- Clique no controle TextBox que você adicionou ao formulário.
- Vá para a seção Propriedades localizada na parte inferior esquerda da tela. Altere o nome da caixa de texto de TextBox1 para HelloTextBox:
Etapa 3) Adicione o seguinte código para adicionar texto ao controle:
Private Sub Form1_Load(sender As Object, e As EventArgs) Handles MyBase.Load'Add text to the controlHelloTextBox.Text = "Hello. Welcome to Guru99!"End Sub
Etapa 4) Agora você pode executar o código clicando no botão Iniciar localizado na barra superior:
Etapa 5) Você deve obter o seguinte formulário:
Aqui está uma captura de tela do código completo para o acima:
Explicação do código:
- Criação de uma classe pública chamada Form1
- Criando um subprocedimento denominado Form1_Load. Ele será chamado quando o formulário for carregado.
- Um comentário. O compilador VB.net irá pular isso.
- Fim do subprocedimento
- Termine a aula.
Personagem de senha
Às vezes, você deseja que uma caixa de texto seja usada para digitar uma senha. Isso significa que tudo o que for digitado nessa caixa de texto permanecerá confidencial. Isso é possível com VB.net. Isso pode ser feito usando a propriedade PasswordChar que nos permite usar qualquer caractere que você quiser. Vamos demonstrar isso usando um exemplo:
Comece criando um novo projeto. Arraste dois controles TextBox, dois rótulos e um botão para o formulário. Altere os textos nas duas etiquetas e no botão para o seguinte:
Clique na caixa de texto ao lado do rótulo Nome de usuário, vá para a seção Propriedades localizada na parte inferior esquerda da janela. Dê a ele o nome UsernameField.
Faça o mesmo para o controle TextBox ao lado do rótulo Senha, dando a ele o nome PasswordField.
Agora você deve fazer o controle PasswordField TextBox mostrar * para cada caractere digitado nele. Adicione o seguinte código:
Private Sub PasswordField_TextChanged(sender As Object, e As EventArgs) Handles PasswordField.TextChangedPasswordField.PasswordChar = "*"End Sub
Agora, execute o código clicando no botão Iniciar. Um formulário aparecerá.
Digite o nome de usuário e a senha e observe o que acontece. Você deve ver o seguinte:
O nome de usuário é mostrado, mas a senha foi ocultada. Aqui está o código para o acima:
Explicação do código:
- Criando uma classe chamada Form1.
- Criando um subprocedimento denominado PasswordField_textchanged (). Ele será chamado quando o formulário for carregado.
- Usando a propriedade PasswordChar para mostrar * à medida que um usuário digita a senha.
- Terminando o subprocedimento.
- Terminando a aula.
Nova linha em TextBox
Por padrão, você só pode criar uma linha de texto em uma caixa de texto. Existem duas maneiras pelas quais podemos conseguir isso. Deixe-nos discuti-los.
Arraste e solte um controle TextBox em seu formulário. Dê ao controle o nome de GuruWelcome.
Clique no controle da caixa de texto novamente e mova o cursor do mouse para a seção Propriedades. Altere o valor da propriedade Multiline para True.
Alternativamente, você pode definir a propriedade Multiline como true em seu código da seguinte maneira:
GuruWelcome.Multiline = True
Adicione o seguinte código:
Private Sub Form1_Load(sender As Object, e As EventArgs) Handles MyBase.LoadGuruWelcome.Multiline = TrueGuruWelcome.Text = "Line 1"GuruWelcome.Text = GuruWelcome.Text & ControlChars.NewLine & "Line 2"End Sub
Na execução, as duas linhas de texto serão separadas.
Explicação do código:
- Criação de uma classe chamada Form1
- Criando uma sub-rotina chamada Form1_Load ()
- Configurando a propriedade Multiline como True. A caixa de texto poderá ocupar mais de uma linha.
- Adicionando a primeira linha de texto à caixa de texto.
- Adicionando a segunda linha de texto à caixa de texto. A propriedade Controlchars.NewLine nos ajuda a dividir as duas linhas.
- Terminando a sub-rotina.
- Terminando a aula.
Recuperando valores inteiros
O VB.net trata tudo como uma string. Isso significa que você lê um inteiro da caixa de texto como uma string e, em seguida, o converte em um inteiro. Isso normalmente é feito usando o método Integer.Parse () .
Para demonstrar isso, crie um novo controle de caixa de texto e um botão. Dê à caixa de texto o nome idade. Dê ao botão o nome de Button1. Você deve ter a seguinte interface:
Adicione o seguinte código:
Private Sub Button1_Click(sender As Object, e As EventArgs) Handles Button1.ClickDim x As Integerx = Integer.Parse(age.Text)MessageBox.Show(x)
Execute o código e insira sua idade na caixa de texto. Clique no botão Mostrar Idade. Você deve ver o seguinte:
O valor inserido é retornado em uma MessageBox.
Explicação do código:
- Criando uma classe chamada Form1.
- Criação de um subprocedimento denominado Button1_Click. Ele será chamado quando o botão for clicado.
- Definindo uma variável inteira chamada x.
- Converter o valor lido da caixa de texto chamada idade em um inteiro.
- Exibindo o valor convertido na etapa acima em uma MessageBox.
- Terminando o subprocedimento.
- Terminando a aula.
ReadOnly TextBox
Você pode tornar uma caixa de texto somente leitura. Isso significa que o usuário não poderá modificar o valor exibido na caixa de texto. Para fazer isso, você define a propriedade ReadOnly como True. Para demonstrar isso, crie uma nova caixa de texto e dê a ela o nome de guru99. Adicione o seguinte código:
Private Sub guru99_TextChanged(sender As Object, e As EventArgs) Handles guru99.TextChangedguru99.Text = "welcome to Guru99"guru99.ReadOnly = TrueEnd Sub
O código deve retornar o seguinte:
Aqui está o código:
Explicação do código:
- Criando uma classe chamada Form1.
- Criando uma sub-rotina chamada guru99_TextChanged.
- Adicionando texto à caixa de texto chamada guru99.
- Definindo a propriedade ReadOnly da caixa de texto como True. Isso torna o texto na caixa de texto inalterável.
- Terminando o subprocedimento.
- Terminando a aula.
comprimento máximo
A propriedade MaxLength pode ajudá-lo a definir o número máximo de palavras ou caracteres que a caixa de texto permitirá. Para demonstrar isso, crie um controle TextBox e dê a ele o nome fullName. Adicione o seguinte código:
Private Sub fullName_TextChanged(sender As Object, e As EventArgs) Handles fullName.TextChangedfullName.MaxLength = 8End Sub
Execute o código e tente digitar seu nome completo. Você não poderá digitar mais de 8 caracteres, com espaços em branco incluídos:
O código:
Explicação do código:
- Criando uma classe chamada Form1.
- Criando um subprocedimento denominado fullName_TextChanged.
- Fazendo com que a caixa de texto fullName aceite no máximo 8 caracteres.
- Terminando o subprocedimento.
- Terminando a aula.
Resumo:
- O controle TextBox permite que você insira texto em seu formulário durante o tempo de execução. É bom para obter informações dos usuários.
- A configuração padrão é que o controle TextBox aceitará apenas uma linha de texto. No entanto, é possível alterar isso.
- Você pode ocultar o que o usuário digita no TextBox, especialmente quando você precisa capturar senhas.
- Você também pode definir o número máximo de caracteres que você precisa inserir no TextBox.
- Você pode tornar seu TextBox não editável, o que significa que os usuários não poderão alterar o texto exibido nele.