更新 : 2007 年 11 月
Windows テキスト ボックス コントロールを表します。
名前空間 :
System.Windows.Forms アセンブリ :
System.Windows.Forms (System.Windows.Forms.dll 内)
<ComVisibleAttribute(True)> _
<ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)> _
Public Class TextBox _
Inherits TextBoxBase
[ComVisibleAttribute(true)]
[ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)]
public class TextBox : TextBoxBase
[ComVisibleAttribute(true)]
[ClassInterfaceAttribute(ClassInterfaceType::AutoDispatch)]
public ref class TextBox : public TextBoxBase
/** @attribute ComVisibleAttribute(true) */
/** @attribute ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch) */
public class TextBox extends TextBoxBase
public class TextBox extends TextBoxBase
TextBox コントロールを使用すると、ユーザーはアプリケーションにテキストを入力できます。このコントロールには、複数行の編集やパスワード文字のマスクなど、標準の Windows テキスト ボックス コントロールにはない追加機能があります。
通常、TextBox コントロールは、単一行のテキストを表示したり、入力として受け入れたりするために使用されます。Multiline プロパティと ScrollBars プロパティを使用すると、複数行のテキストを表示または入力できます。AcceptsTab プロパティと AcceptsReturn プロパティを true に設定すると、複数行の TextBox コントロールでより多くのテキストを処理できるようになります。
メモ : |
|---|
TextBox コントロールの高さを調整するには、Multiline プロパティを true に設定する必要があります。Size プロパティを設定することで高さを調整できます。 |
MaxLength プロパティを特定の文字数に設定すると、TextBox コントロールへ入力するテキストの文字数を制限できます。TextBox コントロールは、パスワードやその他の機密情報を受け入れるためにも使用できます。PasswordChar プロパティを使用すると、単一行形式のコントロールで入力した文字をマスクできます。また、CharacterCasing プロパティを使用すると、TextBox コントロールへのユーザー入力を大文字のみまたは小文字のみに制限するか、大文字と小文字の両方を受け付けるかを指定できます。
カーソル (キャレット) がコントロールの表示領域内に入るまで TextBox の内容をスクロールするには、ScrollToCaret メソッドを使用します。テキスト ボックス内のテキストの範囲を選択するには、Select メソッドを使用します。
TextBox コントロールに入力するテキストを制限するには、コントロールに入力した各文字の妥当性を検査するために KeyDown イベントのイベント ハンドラを作成します。ReadOnly プロパティを true に設定すると、TextBox コントロールでデータが入力されないようにすることもできます。
メモ : |
|---|
TextBox コントロールのほとんどの機能は、TextBoxBase クラスから継承します。 visual スタイルが有効な状態で TextBox コントロールを使用すると、サロゲート フォントが正しく処理されなくなります。 |
Windows Mobile for Pocket PC、Windows Mobile for Smartphone、Windows CE プラットフォーム メモ :
Pocket PC アプリケーションの場合、単一行テキスト ボックスではタブ文字は角かっこ ([]) として表示されます。ただし、Multiline が true に設定されている場合は通常どおりに表示されます。
垂直スクロール バーのある複数行 TextBox コントロールを作成するコード例を次に示します。この例では、AcceptsTab、AcceptsReturn、Dock の各プロパティを使用して、テキスト ドキュメントを作成しやすいように複数行テキスト ボックス コントロールを設定します。
Imports System
Imports System.Collections.Generic
Imports System.ComponentModel
Imports System.Data
Imports System.Drawing
Imports System.Linq
Imports System.Text
Imports System.Windows.Forms
Public Class Form1
Inherits Form
Dim textBox1 As TextBox
Public Sub New()
InitializeComponent()
End Sub
Private Sub InitializeComponent()
Me.textBox1 = New System.Windows.Forms.TextBox()
Me.SuspendLayout()
'
' textBox1
'
Me.textBox1.AcceptsReturn = True
Me.textBox1.AcceptsTab = True
Me.textBox1.Dock = System.Windows.Forms.DockStyle.Fill
Me.textBox1.Multiline = True
Me.textBox1.ScrollBars = System.Windows.Forms.ScrollBars.Vertical
'
' Form1
'
Me.ClientSize = New System.Drawing.Size(284, 264)
Me.Controls.Add(Me.textBox1)
Me.Text = "TextBox Example"
Me.ResumeLayout(False)
Me.PerformLayout()
End Sub
End Class
using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Data;
using System.Drawing;
using System.Linq;
using System.Text;
using System.Windows.Forms;
public class Form1 : Form
{
private TextBox textBox1;
public Form1()
{
InitializeComponent();
}
private void InitializeComponent()
{
this.textBox1 = new System.Windows.Forms.TextBox();
this.SuspendLayout();
//
// textBox1
//
this.textBox1.AcceptsReturn = true;
this.textBox1.AcceptsTab = true;
this.textBox1.Dock = System.Windows.Forms.DockStyle.Fill;
this.textBox1.Multiline = true;
this.textBox1.ScrollBars = System.Windows.Forms.ScrollBars.Vertical;
//
// Form1
//
this.ClientSize = new System.Drawing.Size(284, 264);
this.Controls.Add(this.textBox1);
this.Text = "TextBox Example";
this.ResumeLayout(false);
this.PerformLayout();
}
[STAThread]
static void Main()
{
Application.EnableVisualStyles();
Application.SetCompatibleTextRenderingDefault(false);
Application.Run(new Form1());
}
}
System..::.Object
System..::.MarshalByRefObject
System.ComponentModel..::.Component
System.Windows.Forms..::.Control
System.Windows.Forms..::.TextBoxBase
System.Windows.Forms..::.TextBox
System.Windows.Forms..::.DataGridTextBox
System.Windows.Forms..::.DataGridViewTextBoxEditingControl
この型のすべてのパブリック static (Visual Basic では Shared) メンバは、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。
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, Windows CE, Windows Mobile for Smartphone, Windows Mobile for Pocket PC
.NET Framework および .NET Compact Framework では、各プラットフォームのすべてのバージョンはサポートしていません。サポートされているバージョンについては、「.NET Framework システム要件」を参照してください。
.NET Framework
サポート対象 : 3.5、3.0、2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 3.5、2.0、1.0
参照