TextBoxBase.Modified Propriedade

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Obtém ou define um valor que indica que o controle da caixa de texto foi modificado pelo usuário desde que o controle foi criado ou que seu conteúdo foi definido pela última vez.

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

[System.ComponentModel.Browsable(false)]
public bool Modified { get; set; }

[<System.ComponentModel.Browsable(false)>]
member this.Modified : bool with get, set

Public Property Modified As Boolean

Valor da propriedade

Boolean

true se o conteúdo do controle foi modificado; caso contrário, false. O padrão é false.

Atributos

BrowsableAttribute

Exemplos

O exemplo de código a TextBox seguir usa o TextChanged evento para um TextBox, uma classe derivada, para determinar se o conteúdo do controle foi alterado desde que o controle foi preenchido com dados. O exemplo usa uma cadeia de caracteres para armazenar o conteúdo original do controle e compara-o com o conteúdo do TextBox para determinar se o conteúdo foi alterado. Se o conteúdo tiver sido alterado, a Modified propriedade será definida truecomo . Caso contrário, ele será redefinido para false. Este exemplo requer que um TextBox controle chamado textBox1 tenha sido criado e que uma String variável chamada originalText tenha sido criada para armazenar o texto original para o TextBox controle.

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 != 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 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

Comentários

Você pode usar essa propriedade para determinar se o usuário modificou o conteúdo do controle de caixa de texto. Você também pode definir essa propriedade no código para indicar que foram feitas alterações no controle de caixa de texto pelo aplicativo. Essa propriedade pode ser usada por métodos de validação e de salvamento de dados para determinar se foram feitas alterações em um controle de caixa de texto para que o conteúdo alterado possa ser validado ou salvo.

Se você alterar a Text propriedade programaticamente, a Modified propriedade será revertida para false. Isso não gera o ModifiedChanged evento.