Este artigo foi traduzido por máquina. Para visualizar o arquivo em inglês, marque a caixa de seleção Inglês. Você também pode exibir o texto Em inglês em uma janela pop-up, movendo o ponteiro do mouse sobre o texto.
Tradução
Inglês
Esta documentação foi arquivada e não está sendo atualizada.

Classe ToolStripTextBox

Representa uma caixa de texto em um ToolStrip que permite que o usuário inserir texto.

Namespace:  System.Windows.Forms
Assembly:  System.Windows.Forms (em System.Windows.Forms.dll)

[ToolStripItemDesignerAvailabilityAttribute(ToolStripItemDesignerAvailability.None|ToolStripItemDesignerAvailability.ToolStrip|ToolStripItemDesignerAvailability.MenuStrip|ToolStripItemDesignerAvailability.ContextMenuStrip)]
public class ToolStripTextBox : ToolStripControlHost

ToolStripTextBox é o TextBox otimizado para hospedagem em um ToolStrip. Um subconjunto de propriedades e eventos do controle hospedado são expostos no ToolStripTextBox nível, mas a base TextBox controle é totalmente acessível por meio do TextBox propriedade.

The ToolStripTextBox controle permite que o usuário digitar texto em um aplicativo. Esse controle tem funcionalidade adicional que o padrão Windows controle de caixa de texto, incluindo edição de várias linhas não foi encontrada.

Normalmente, um ToolStripTextBox controle é usado para exibir uma única linha de texto ou a aceita sistema autônomo entrada. Você pode usar o Multiline para permitir várias linhas de texto a ser exibido ou inseridos. conjunto o AcceptsTab e AcceptsReturn propriedades para true para permitir maior manipulação de texto em uma de várias linhas ToolStripTextBox controle.

Você pode limitar a quantidade de texto inserido em um ToolStripTextBox controle Definindo o MaxLength propriedade para um número específico de caracteres. Use o CharacterCasing propriedade para permitir que o usuário digitar somente letras maiúsculas, em minúsculas somente ou uma combinação de caracteres maiúsculos e minúsculos na ToolStripTextBox controle.

Para impedir que o texto seja inserido em um ToolStripTextBox controle, você pode criar um manipulador de eventos para o KeyDown evento para validar cada caractere inserido no controle. Você também pode restringir a todas as entrada de dados em um ToolStripTextBox controle Definindo o ReadOnly propriedade para true.

O exemplo de código a seguir demonstra um ToolStripTextBox com várias configurações de propriedade comuns, incluindo as opções de preenchimento automático.

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

namespace WindowsApplication2
{
    publicclass Form1 : Form
    {
        private ToolStrip toolStrip1;
        private ToolStripTextBox toolStripTextBox1;

        public Form1()
        {
            InitializeComponent();
        }
        [STAThread]
        staticvoid Main()
        {
            Application.EnableVisualStyles();
            Application.Run(new Form1());
        }

        privatevoid 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();

        }
    }
}


Quaisquer membros static (Shared no Visual Basic) públicos deste tipo são thread-safe. Não há garantia de que qualquer membro de instância seja thread-safe.

Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

o.NET Framework e.NET Compact Framework não oferecem suporte a todas as versões de cada plataforma. Para obter uma lista de versões suportadas, consulte Requisitos de sistema do .NET framework.

.NET Framework

Compatível com: 3.5, 3.0, 2.0
Mostrar: