Objeto TextBox (script de formularios de Outlook)
Muestra información del usuario o de un conjunto de datos organizado.
Comentarios
El control TextBox es el más utilizado para mostrar la información que especifica el usuario. También puede mostrar un conjunto de datos, como una tabla, una consulta, una hoja de cálculo o el resultado de una operación. Si un control TextBox es dependiente de un origen de datos, al modificar el contenido de TextBox también se modifica el valor del origen de datos correspondiente.
El formato aplicado a una parte del texto de un TextBox afectará al texto del control. Por ejemplo, si cambia la fuente o el tamaño de puntos de cualquier carácter del control, el cambio afectará a todos los caracteres del control.
La propiedad predeterminada del control TextBox es Value.
Sugerencias sobre el uso de cuadros de texto
El control TextBox es flexible y está regido por las siguientes propiedades: Text, MultiLine, WordWrap y AutoSize.
Text contiene el texto que aparece en el control.
MultiLine controla si el TextBox puede aparecer en una sola línea o en varias. Los caracteres de nueva línea indican dónde termina una línea y comienza la siguiente. Si MultiLine es False (el valor predeterminado), el texto se trunca en lugar de ajustarse.
WordWrap permite al control TextBox ajustar las líneas de texto de longitud superior al ancho del control TextBox dividiéndolas en líneas más cortas. El valor predeterminado es True.
Si no usa WordWrap, textbox inicia una nueva línea de texto cuando encuentra un carácter de nueva línea en el texto. Si WordWrap está desactivado, puede tener líneas de texto que no encajan completamente en el Cuadro de texto. TextBox muestra las partes del texto que caben dentro de su ancho y trunca las partes del texto que no caben. WordWrap sólo es aplicable cuando MultiLine es True.
AutoSize determina si el control TextBox cambia de tamaño para mostrar todo el texto que contiene. Al utilizar AutoSize con un TextBox, el ancho de TextBox se reducirá o aumentará según la longitud del texto que contenga TextBox y el tamaño de texto usado para mostrarlo. El valor predeterminado es False.
Utilizar AutoSize es adecuado cuando se desea:
Mostrar un título de una o más líneas.
Mostrar el contenido de un control TextBox de una sola línea.
Mostrar el contenido de un control TextBox de varias líneas que sea de sólo lectura para el usuario.
Evite el uso de AutoSize en los controles TextBox vacíos que utilicen también las propiedades MultiLine y WordWrap. Cuando el usuario introduzca texto en un control TextBox con estas propiedades, el TextBox cambiará de tamaño automáticamente para convertirse en un cuadro largo y estrecho de un carácter de ancho y tan largo como la línea de texto.
Métodos
| Nombre | Descripción |
|---|---|
| Copy | Copia el contenido de un objeto en el Portapapeles. |
| Cut | Elimina la información seleccionada en un objeto y la transfiere al Portapapeles. |
| Paste | Transfiere el contenido del Portapapeles a un objeto. |
Propiedades
| Nombre | Descripción |
|---|---|
| AutoSize | Devuelve o establece Boolean que especifica si uno objeto cambia de tamaño automáticamente para mostrar todo su contenido. Lectura/escritura. |
| AutoTab | Devuelve o establece un valor booleano que especifica si se produce una pestaña automática cuando un usuario escribe el número máximo permitido de caracteres en un cuadro de texto. Lectura y escritura. |
| AutoWordSelect | Devuelve o establece un valor de tipo Boolean que especifica si la unidad básica utilizada para expandir una selección es una palabra o un carácter. Lectura/escritura. |
| BackColor | Devuelve o establece un valor de tipo Long que especifica el color de fondo del control. Lectura y escritura. |
| BackStyle | Devuelve o establece un valor de tipo Integer que especifica el estilo del fondo del control. Lectura y escritura. |
| BorderColor | Devuelve o establece un valor de tipo Long que especifica el color del borde del control. Lectura y escritura. |
| BorderStyle | Devuelve o establece un valor de tipo Integer que especifica el tipo de borde del control. Lectura y escritura. |
| CanPaste | Devuelve un valor Boolean que especifica si el Portapapeles contiene datos compatibles con el objeto. Solo lectura. |
| CurLine | Devuelve o establece un valor de tipo Long que representa la línea actual de un control. Lectura/escritura. |
| CurTargetX | Devuelve un valor Long que representa la posición horizontal preferida del punto de inserción en un TextBox. Solo lectura. |
| CurX | Devuelve o establece un valor Long que representa la posición horizontal del punto de inserción en un TextBox. Lectura/escritura. |
| DragBehavior | Devuelve o establece un valor Integer que especifica si el sistema permite la característica de arrastrar y colocar para este control. Lectura/escritura. |
| Enabled | Devuelve o establece un valor de tipo Boolean que especifica si un control puede tomar el foco y responder a eventos generados por el usuario. Lectura/escritura. |
| EnterFieldBehavior | Devuelve o establece una constante Integer que especifica el comportamiento de selección al entrar en el TextBox. Lectura/escritura. |
| EnterKeyBehavior | Devuelve o establece un valor booleano que define el efecto de presionar ENTRAR en un textbox. Lectura/escritura. |
| ForeColor | Devuelve o establece un valor de tipo Long que especifica el color del primer plano del control. Lectura y escritura. |
| HideSelection | Devuelve o establece un valor de tipo Boolean que especifica si el texto seleccionado permanece resaltado cuando un control no toma el foco. Lectura/escritura. |
| IMEMode | Devuelve o establece un valor Integer que especifica el modo en tiempo de ejecución predeterminado del editor de métodos de entrada (IME) de un control. Lectura y escritura. |
| IntegralHeight | Devuelve o establece un valor de tipo Boolean que especifica si un TextBox muestran líneas completas o parciales de texto. Lectura y escritura. |
| LineCount | Devuelve un Long que especifica el número de líneas de texto de un TextBox. Solo lectura. |
| Locked | Devuelve o establece un valor de tipo Boolean que puede modificarse. Lectura y escritura. |
| MaxLength | Devuelve o establece un valor de tipo Long que especifica el número máximo de caracteres que un usuario puede escribir en un TextBox. Lectura y escritura. |
| MouseIcon | Devuelve una String que representa el nombre de ruta completo de un icono personalizado que está asignado al control. Solo lectura. |
| MousePointer | Returns or sets an Integer that specifies the type of pointer displayed when the user positions the mouse over a particular object. Lectura y escritura. |
| MultiLine | Devuelve o establece un valor de tipo Boolean que indica si un control puede aceptar y mostrar varias líneas de texto. Lectura/escritura. |
| PasswordChar | Devuelve o establece un valor de tipo String que representa el marcador de posición que se mostrará en lugar del número de caracteres introducidos en un TextBox. Lectura/escritura. |
| ScrollBars | Devuelve o establece un Integer que indica si el control tiene una barra de desplazamiento vertical, una barra de desplazamiento horizontal o ambas barras. Lectura y escritura. |
| SelectionMargin | Devuelve o establece un valor de tipo Boolean que especifica si el usuario puede seleccionar una línea de texto haciendo clic en el área situada a la izquierda del texto. Lectura/escritura. |
| SelLength | Devuelve o establece un valor de tipo Long que representa el número de caracteres seleccionados en un TextBox. Lectura y escritura. |
| SelStart | Devuelve o establece un valor de tipo Long que representa el punto de inicio del texto seleccionado o el punto de inserción si no hay ningún texto seleccionado. Lectura y escritura. |
| SelText | Devuelve o establece un valor de tipo String que representa el texto seleccionado de un control. Lectura y escritura. |
| SpecialEffect | Devuelve o establece un valor de tipo Integer que especifica el aspecto visual del control. Lectura y escritura. |
| TabKeyBehavior | Devuelve o establece un valor de tipo Boolean que indica si se permiten las tabulaciones en el área de edición. Lectura y escritura. |
| Texto | Devuelve o establece un valor de tipo String que especifica el texto en el control. Lectura y escritura. |
| TextAlign | Devuelve o establece una constante Integer que especifica el modo en que el texto se alinea en el control. Lectura/escritura. |
| TextLength | Devuelve un long que representa la longitud, en número de caracteres, del texto de la región de edición de un TextBox. Solo lectura. |
| Valor | Devuelve o establece un valor de tipo Variant que especifica el área de edición. Lectura/escritura. |
| WordWrap | Devuelve o establece un valor de tipo Boolean que especifica si el contenido de un control se ajusta automáticamente al final de una línea y el control se expande para ajustar el texto. Lectura y escritura. |
Soporte técnico y comentarios
¿Tiene preguntas o comentarios sobre VBA para Office o esta documentación? Vea Soporte técnico y comentarios sobre VBA para Office para obtener ayuda sobre las formas en las que puede recibir soporte técnico y enviar comentarios.