Esta documentación está archivada y no tiene mantenimiento.

ToolStripTextBox (Clase)

Representa un cuadro de texto en un control ToolStrip que permite al usuario escribir texto.

Espacio de nombres: System.Windows.Forms
Ensamblado: System.Windows.Forms (en system.windows.forms.dll)

public class ToolStripTextBox : ToolStripControlHost
public class ToolStripTextBox extends ToolStripControlHost
public class ToolStripTextBox extends ToolStripControlHost
No aplicable.

ToolStripTextBox es el TextBox optimizado para el alojamiento en ToolStrip. En el nivel ToolStripTextBox se expone un subconjunto de las propiedades y los eventos del control alojado, pero se puede obtener acceso total al control TextBox subyacente mediante la propiedad TextBox.

El control ToolStripTextBox permite al usuario escribir texto en una aplicación. Este control tiene funcionalidad adicional que no se encuentra en el control de cuadro de texto estándar de Windows, como la edición de múltiples líneas.

Normalmente, los controles ToolStripTextBox se utilizan para mostrar una sola línea de texto o aceptarla como entrada. Puede utilizar la propiedad Multiline para permitir que se muestren o escriban varias líneas de texto. Establezca las propiedades AcceptsTab y AcceptsReturn en true con el fin de permitir una mayor manipulación de texto en un control ToolStripTextBox multilínea.

Puede limitar la cantidad de texto escrito en un control ToolStripTextBox estableciendo la propiedad MaxLength en un número de caracteres concreto. Utilice la propiedad CharacterCasing para permitir al usuario escribir sólo mayúsculas, sólo minúsculas o una combinación de caracteres en mayúsculas y minúsculas en el control ToolStripTextBox.

Para restringir que se escriba texto en un control ToolStripTextBox, se puede crear un controlador de eventos para el evento KeyDown con el fin de validar cada carácter escrito en el control. También se puede restringir toda entrada de datos en un control ToolStripTextBox; para ello, establezca la propiedad ReadOnly en true.

En el ejemplo de código siguiente se muestra un ToolStripTextBox con varios valores de propiedades comunes, incluyendo opciones de finalización automática.

using System;
using System.Text;
using System.Windows.Forms;

namespace WindowsApplication2
{
    public class Form1 : Form
    {
        private ToolStrip toolStrip1;
        private ToolStripTextBox toolStripTextBox1;
    
        public Form1()
        {
            InitializeComponent();
        }
        [STAThread]
        static void Main()
        {
            Application.EnableVisualStyles();
            Application.Run(new Form1());
        }

        private void InitializeComponent()
        {
            toolStrip1 = new System.Windows.Forms.ToolStrip();
            toolStripTextBox1 = new System.Windows.Forms.ToolStripTextBox();
            toolStrip1.SuspendLayout();
            SuspendLayout();
            // 
            // toolStrip1
            // 
            toolStrip1.Items.AddRange(new System.Windows.Forms.ToolStripItem[] {
            toolStripTextBox1});
            toolStrip1.Location = new System.Drawing.Point(0, 0);
            toolStrip1.Name = "toolStrip1";
            toolStrip1.Size = new System.Drawing.Size(292, 25);
            toolStrip1.TabIndex = 0;
            toolStrip1.Text = "toolStrip1";
            // This code example demonstrates the syntax for setting
            // various ToolStripTextBox properties.
            // 
            toolStripTextBox1.AcceptsReturn = true;
            toolStripTextBox1.AcceptsTab = true;
            toolStripTextBox1.AutoCompleteCustomSource.AddRange(new string[] {
            "This is line one.",
            "Second line.",
            "Another line."});
            toolStripTextBox1.AutoCompleteMode = System.Windows.Forms.AutoCompleteMode.SuggestAppend;
            toolStripTextBox1.AutoCompleteSource = System.Windows.Forms.AutoCompleteSource.CustomSource;
            toolStripTextBox1.BorderStyle = System.Windows.Forms.BorderStyle.FixedSingle;
            toolStripTextBox1.CharacterCasing = System.Windows.Forms.CharacterCasing.Upper;
            toolStripTextBox1.HideSelection = false;
            toolStripTextBox1.MaxLength = 32000;
            toolStripTextBox1.Name = "toolStripTextBox1";
            toolStripTextBox1.ShortcutsEnabled = false;
            toolStripTextBox1.Size = new System.Drawing.Size(100, 25);
            toolStripTextBox1.Text = "STRING1\r\nSTRING2\r\nSTRING3\r\nSTRING4";
            toolStripTextBox1.TextBoxTextAlign = System.Windows.Forms.HorizontalAlignment.Center;
            // 
            // Form1
            // 
            ClientSize = new System.Drawing.Size(292, 273);
            Controls.Add(toolStrip1);
            Name = "Form1";
            toolStrip1.ResumeLayout(false);
            toolStrip1.PerformLayout();
            ResumeLayout(false);
            PerformLayout();

        }
    }
}

Los miembros estáticos públicos (Shared en Visual Basic) de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.

Windows 98, Windows 2000 Service Pack 4, Windows CE, Windows Millennium, Windows Mobile para Pocket PC, Windows Mobile para Smartphone, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter

Microsoft .NET Framework 3.0 es compatible con Windows Vista, Microsoft Windows XP SP2 y Windows Server 2003 SP1.

.NET Framework

Compatible con: 3.0, 2.0
Mostrar: