System.Windows.Forms 名前空間


.NET Framework クラス ライブラリ
TextBox クラス

更新 : 2007 年 11 月

Windows テキスト ボックス コントロールを表します。

名前空間 :  System.Windows.Forms
アセンブリ :  System.Windows.Forms (System.Windows.Forms.dll 内)

構文

Visual Basic (宣言)
<ComVisibleAttribute(True)> _
<ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)> _
Public Class TextBox _
    Inherits TextBoxBase
Visual Basic (使用法)
Dim instance As TextBox
C#
[ComVisibleAttribute(true)]
[ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)]
public class TextBox : TextBoxBase
Visual C++
[ComVisibleAttribute(true)]
[ClassInterfaceAttribute(ClassInterfaceType::AutoDispatch)]
public ref class TextBox : public TextBoxBase
J#
/** @attribute ComVisibleAttribute(true) */
/** @attribute ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch) */
public class TextBox extends TextBoxBase
JScript
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 アプリケーションの場合、単一行テキスト ボックスではタブ文字は角かっこ ([]) として表示されます。ただし、Multilinetrue に設定されている場合は通常どおりに表示されます。


垂直スクロール バーのある複数行 TextBox コントロールを作成するコード例を次に示します。この例では、AcceptsTabAcceptsReturnDock の各プロパティを使用して、テキスト ドキュメントを作成しやすいように複数行テキスト ボックス コントロールを設定します。

Visual Basic
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
C#
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
参照

参照

タグ :


Page view tracker