Events in WinUI Masked TextBox

8 Jul 20262 minutes to read

This section provides information about the events available in the WinUI Masked TextBox control.

ValueChanging Event

The ValueChanging event occurs when the Value property is about to change in the Masked TextBox control. The MaskedTextBoxValueChangingEventArgs provides the following properties:

  • NewValue: Gets the new value of the Masked TextBox control.
  • OldValue: Gets the previous value of the Masked TextBox control.
  • IsValid: Gets a boolean value indicating whether the input is considered valid based on the mask completion.
  • Cancel: Gets or sets a value indicating whether the event should be canceled.
private void MaskedTextBox_ValueChanging(object sender, MaskedTextBoxValueChangingEventArgs e)
{
    // Access the new and old values
    string newValue = e.NewValue;
    string oldValue = e.OldValue;

    // Check the validity of the input
    bool isValid = e.IsValid;

    // Cancel the event if needed
    if (newValue == "1234")
    {
        e.Cancel = true;
    }

    // Perform additional actions based on the value changing
    // ...
}

ValueChanged Event

The ValueChanged event occurs when the Value property is changed in the Masked TextBox control. The MaskedTextBoxValueChangedEventArgs provides the following properties:

  • IsMaskCompleted: Gets a boolean value indicating whether all the required inputs for the mask are completed.
  • NewValue: Gets the new value of the Masked TextBox control.
  • OldValue: Gets the previous value of the Masked TextBox control.
private void MaskedTextBox_ValueChanged(object sender, MaskedTextBoxValueChangedEventArgs e)
{
    // Access the new and old values
    string newValue = e.NewValue;
    string oldValue = e.OldValue;

    // Check if the mask input is completed
    bool isMaskCompleted = e.IsMaskCompleted;

    // Perform actions based on the value change
    // ...
}