Objeto TextBox (Script do Outlook Forms)
Exibe informações de um usuário ou de um conjunto organizado de dados.
Comentários
Uma TextBox é o controle mais comumente usado para exibir informações digitadas por um usuário. Além disso, pode exibir um conjunto de dados, como uma tabela, consulta, planilha ou resultado de cálculo. Se uma TextBox estiver ligada a uma fonte de dados, alterar o conteúdo da TextBox também alterará o valor da fonte de dados associada.
Uma formatação aplicada a qualquer parte do texto em um TextBox afetará todo o texto no controle. Por exemplo, se você alterar a fonte ou o tamanho de ponto de qualquer caractere no controle, a alteração afetará todos os caracteres no controle.
A propriedade padrão de um TextBox é a propriedade Value.
Dicas sobre como usar caixas de texto
O TextBox é um controle flexível governado pelas seguintes propriedades: Text, MultiLine, WordWrap e AutoSize.
Text contém o texto exibido na caixa de texto.
MultiLine controla se o TextBox pode exibir o texto como uma linha individual ou como várias linhas. Os caracteres novos identificam onde termina uma linha e começa outra. Se MultiLine for False (valor padrão), o texto será truncado em vez de quebrar.
WordWrap permite à TextBox quebrar linhas de texto mais longas do que a TextBox em linhas mais curtas que se encaixem nela. O valor padrão é True.
Se você não usar o WordWrap, o TextBox iniciará uma nova linha de texto quando ele encontrar um caractere newline no texto. Se o WordWrap estiver desativado, você poderá ter linhas de texto que não se encaixam completamente no TextBox. O TextBox exibe as partes do texto que se encaixam dentro de sua largura e trunca as partes do texto que não se encaixam. WordWrap só se aplicará quando MultiLine for True.
AutoSize controla se o TextBox se ajusta para exibir todo o texto. Quando AutoSize é usada com um TextBox, a largura do TextBox se reduz ou expande de acordo com a quantidade de texto no TextBox e com o tamanho da fonte usada para exibir o texto. O valor padrão é False.
AutoSize funciona bem nas seguintes situações:
Exibir uma legenda de uma ou mais linhas.
Exibir o conteúdo de uma TextBox com uma só linha.
Exibindo o conteúdo de um TextBox com várias linhas que seja somente leitura para o usuário.
Evite utilizar AutoSize com uma TextBox vazia que também utilize as propriedades MultiLine e WordWrap. Quando o usuário digitar texto em uma TextBox com essas propriedades, a TextBox automaticamente se dimensionará como uma caixa longa e estreita, com um caractere de largura e o comprimento da linha de texto.
Métodos
| Nome | Descrição |
|---|---|
| Copy | Copies the contents of an object to the Clipboard. |
| Cut | Removes selected information from an object and transfers it to the Clipboard. |
| Paste | Transfere o conteúdo da Área de transferência para um objeto. |
Propriedades
| Nome | Descrição |
|---|---|
| AutoSize | Returns or sets a Boolean that specifies whether an object automatically resizes to display its entire contents. Leitura/gravação. |
| AutoTab | Retorna ou define um booliano que especifica se uma guia automática ocorre quando um usuário insere o número máximo permitido de caracteres em uma Caixa de Texto. Leitura/gravação. |
| AutoWordSelect | Returns or sets a Boolean that specifies whether the basic unit used to extend a selection is a word or a single character. Leitura/gravação. |
| BackColor | Returns or sets a Long that specifies the background color of the object. Leitura/gravação. |
| BackStyle | Returns or sets an Integer that specifies the background style for an object. Leitura/gravação. |
| BorderColor | Returns or sets a Long that specifies the border color of an object. Leitura/gravação. |
| BorderStyle | Returns or sets an Integer that specifies the type of border of the control. Leitura/gravação. |
| CanPaste | Returns a Boolean that specifies whether the Clipboard contains data that the object supports. Somente leitura. |
| CurLine | Returns or sets a Long that represents the current line of a control. Leitura/gravação. |
| CurTargetX | Returns a Long that represents the preferred horizontal position of the insertion point in a multiline TextBox. Somente leitura. |
| CurX | Returns or sets a Long that represents the current horizontal position of the insertion point in a multiline TextBox. Leitura/gravação. |
| DragBehavior | Returns or sets an Integer that specifies whether the system enables the drag-and-drop feature for the control. Leitura/gravação. |
| Enabled | Returns or sets a Boolean that specifies whether a control can receive the focus and respond to user-generated events. Leitura/gravação. |
| EnterFieldBehavior | Returns or sets an Integer that specifies the selection behavior when entering a TextBox. Leitura/gravação. |
| EnterKeyBehavior | Retorna ou define um booliano que define o efeito de pressionar ENTER em uma Caixa de Texto. Leitura/gravação. |
| ForeColor | Returns or sets a Long that specifies the foreground color of an object. Leitura/gravação. |
| HideSelection | Returns or sets a Boolean that specifies whether selected text remains highlighted when a control does not have the focus. Leitura/gravação. |
| IMEMode | Returns or sets an Integer that specifies the default run-time mode of the Input Method Editor (IME) for a control. Leitura/gravação. |
| IntegralHeight | Returns or sets a Boolean that specifies whether a TextBox displays full lines of text or partial lines. Leitura/gravação. |
| LineCount | Returns a Long that specifies the number of text lines in a TextBox. Somente leitura. |
| Locked | Returns or sets a Boolean that specifies whether a control can be edited. Leitura/gravação. |
| MaxLength | Retorna ou define um Long que especifica o número máximo de caracteres que um usuário pode inserir em um TextBox. Leitura/gravação. |
| MouseIcon | Returns a String that represents the full path name of a custom icon that is to be assigned to the control. Somente leitura. |
| MousePointer | Returns or sets an Integer that specifies the type of pointer displayed when the user positions the mouse over a particular object. Leitura/gravação. |
| MultiLine | Returns or sets a Boolean that specifies whether a control can accept and display multiple lines of text. Leitura/gravação. |
| PasswordChar | Returns or sets a String that specifies a placeholder character to be displayed instead of the characters actually entered in a TextBox. Leitura/gravação. |
| ScrollBars | Returns or sets an Integer that specifies whether a control has vertical scroll bars, horizontal scroll bars, or both. Leitura/gravação. |
| SelectionMargin | Returns or sets a Boolean that specifies whether the user can select a line of text by clicking in the region to the left of the text. Leitura/gravação. |
| SelLength | Retorna ou define um Long que representa o número de caracteres selecionados em uma Caixa de Texto. Leitura/gravação. |
| SelStart | Returns or sets a Long that represents the starting point of selected text, or the insertion point if no text is selected. Leitura/gravação. |
| SelText | Returns or sets a String that represents the selected text of a control. Leitura/gravação. |
| SpecialEffect | Returns or sets an Integer that specifies the visual appearance of an object. Leitura/gravação. |
| TabKeyBehavior | Returns or sets a Boolean that specifies whether tabs are allowed in the edit region. Leitura/gravação. |
| Text | Returns or sets a String that specifies text in the control. Leitura/gravação. |
| TextAlign | Returns or sets an Integer that specifies how text is aligned in a control. Leitura/gravação. |
| TextLength | Retorna um Long que representa o comprimento, em número de caracteres, do texto na região de edição de um TextBox. Somente leitura. |
| Valor | Returns or sets a Variant that specifies text in the edit region. Leitura/gravação. |
| WordWrap | Returns or sets a Boolean that specifies whether the contents of a control automatically wrap at the end of a line and the control expands to fit the text. Leitura/gravação. |
Suporte e comentários
Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.