TextBoxBase.Modified Propriedade

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 de Propriedade

true se o conteúdo do controlo tiver sido modificado; caso contrário, false. A predefinição é false.

Atributos

BrowsableAttribute

Exemplos

O exemplo de código seguinte utiliza o TextChanged evento para uma TextBox, uma classe derivada, para determinar se o conteúdo do TextBox controlo mudou desde que o controlo foi preenchido com dados. O exemplo utiliza uma cadeia para armazenar o conteúdo original do controlo e compará-lo com o conteúdo do TextBox para determinar se o conteúdo mudou. Se o conteúdo tiver mudado, a Modified propriedade é definida para true. Caso contrário, é reiniciado para false. Este exemplo exige que um TextBox controlo nomeado textBox1 tenha sido criado e que uma String variável nomeada originalText tenha sido criada para armazenar o texto original do TextBox controlo.

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

Observações

Pode usar esta propriedade para determinar se o utilizador modificou o conteúdo do controlo da caixa de texto. Também pode definir esta propriedade no código para indicar que foram feitas alterações ao controlo da caixa de texto pela aplicação. Esta propriedade pode ser usada por métodos de validação e gravação de dados para determinar se foram feitas alterações num controlo de caixa de texto, de modo a que o conteúdo alterado possa ser validado ou guardado.

Se alterar a Text propriedade programaticamente, a Modified propriedade reverte para false. Isto não eleva o ModifiedChanged evento.