TextBoxBase.Modified プロパティとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

TextBoxBase.Modified プロパティ

コントロールが作成されてから、またはコントロールが最後に設定されてから、ユーザーがテキストボックスコントロールを変更したかどうかを示す値を取得または設定します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Public Property Modified As
 Boolean

Visual Basic (使用法)

Dim instance As TextBoxBase
Dim value As Boolean

value = instance.Modified

instance.Modified = value

public bool Modified { get;
 set; }

C++

public:
property bool Modified {
    bool get ();
    void set (bool value);
}

/** @property */
public boolean get_Modified ()

/** @property */
public void set_Modified (boolean value)

JScript

public function get Modified
 () : boolean

public function set Modified
 (value : boolean)

プロパティ値
コントロールの内容が変更された場合は true。それ以外の場合は false。既定値は false です。

解説

このプロパティを使用すると、ユーザーがテキストボックスコントロールの内容を変更したかどうかを判断できます。また、このプロパティをコードで使用すると、アプリケーションでテキストボックスコントロールに変更が加えられたかどうかを判断することもできます。テキストボックスコントロールで変更が加えられたかどうかを判断するために、このプロパティを validation メソッドおよび data-saving メソッドで使用すると、変更された内容を検証または保存できます。

使用例

派生クラス TextBox の TextChanged イベントを使用して、コントロールにデータが入力されてから TextBox コントロールの内容が変更されたかどうかを判断するコード例を次に示します。この例では、コントロールの元の内容を格納している文字列を使用して、その文字列と TextBox の内容を比較し、内容が変更されたかどうかを判断します。内容が変更された場合は、Modified プロパティが true に設定されます。それ以外の場合は false にリセットされます。この例では、textBox1 という名前の TextBox コントロールが作成されており、TextBox コントロールの元のテキストを格納するために originalText という名前の String 変数が作成されている必要があります。

Visual Basic

Private Sub TextBox1_TextChanged(sender As
 Object, e As EventArgs)
    ' Check to see if the change made does not return the
    ' control to its original state. 
    If originalText <> textBox1.Text Then
        ' Set the Modified property to true to reflect the change.
        textBox1.Modified = True
        ' Contents of textBox1 have not changed, reset the Modified
 property.
    Else
        textBox1.Modified = False
    End If
End Sub

private void TextBox1_TextChanged(object sender,
 EventArgs e)
 {
    /* Check to see if the change made does not return
 the
       control to its original state. */
    if (originalText != textBox1.Text)
       // Set the Modified property to true to reflect the change.
       textBox1.Modified = true;
    else
       // Contents of textBox1 have not changed, reset the Modified
 property.
       textBox1.Modified = false;
 }

C++

private:
   void TextBox1_TextChanged( Object^ sender, EventArgs^ e )
   {
      /* Check to see if the change made does not return
 the
         control to its original state. */
      if ( originalText != textBox1->Text )
      {
         // Set the Modified property to true to reflect the change.
         textBox1->Modified = true;
      }
      else
      {
         // Contents of textBox1 have not changed, reset the Modified
 property.
         textBox1->Modified = false;
      }
   }

private void textBox1_TextChanged(Object sender,
 EventArgs e)
{
    /* Check to see if the change made does not return
 the
       control to its original state. 
     */
    if (!(originalText.Equals(textBox1.get_Text()))) {
        // Set the Modified property to true to reflect the change.
        textBox1.set_Modified(true);
    }
    else {
        // Contents of textBox1 have not changed,
        // reset the Modified property.
        textBox1.set_Modified(false);
    }
} //TextBox1_TextChanged