This example demonstrates how to create, configure and use masked text boxes. The text box on the right lets you configure the prompt character (i.e. the PromptChar property) of the sample masked text boxes.

| Language: C# |
using Nevron.Nov;
using Nevron.Nov.Dom;
using Nevron.Nov.Editors;
using Nevron.Nov.Graphics;
using Nevron.Nov.Layout;
using Nevron.Nov.UI;
using Nevron.Nov.Windows.Forms;
using System.Windows.Forms;
namespace NovWinFormsProject
{
public partial class Form1 : Form
{
#region Constructors
public Form1()
{
InitializeComponent();
// Set form title
Text = "NOV WinForms - NMaskedTextBoxExample";
// Create the NOV example and its controls
NWidget exampleContent = CreateExampleContent();
NWidget exampleControls = CreateExampleControls();
if (exampleControls != null)
{
exampleControls.PreferredWidth = 300;
}
// Place the example and its controls in a pair box
NPairBox pairBox = new NPairBox(exampleContent, exampleControls);
pairBox.FillMode = ENStackFillMode.First;
pairBox.FitMode = ENStackFitMode.First;
pairBox.Margins = new NMargins(NDesign.HorizontalSpacing, NDesign.VerticalSpacing);
// Host the example in the form
NNovWidgetHost host = new NNovWidgetHost(pairBox);
host.Dock = DockStyle.Fill;
Controls.Add(host);
}
#endregion
#region Example
public NWidget CreateExampleContent()
{
NStackPanel stack = new NStackPanel();
stack.HorizontalPlacement = ENHorizontalPlacement.Left;
m_PhoneNumberTextBox = new NMaskedTextBox();
m_PhoneNumberTextBox.Mask = "(999) 000-0000";
m_PhoneNumberTextBox.MaskInputRejected += OnMaskInputRejected;
stack.Add(NPairBox.Create("Phone Number:", m_PhoneNumberTextBox));
m_CreditCardNumberTextBox = new NMaskedTextBox();
m_CreditCardNumberTextBox.Mask = "0000 0000 0000 0000";
m_CreditCardNumberTextBox.MaskInputRejected += OnMaskInputRejected;
stack.Add(NPairBox.Create("Credit Card Number:", m_CreditCardNumberTextBox));
m_SocialSecurityNumberTextBox = new NMaskedTextBox();
m_SocialSecurityNumberTextBox.Mask = "000-00-0000";
m_SocialSecurityNumberTextBox.MaskInputRejected += OnMaskInputRejected;
stack.Add(NPairBox.Create("Social Security Number:", m_SocialSecurityNumberTextBox));
return new NUniSizeBoxGroup(stack);
}
public NWidget CreateExampleControls()
{
NStackPanel stack = new NStackPanel();
stack.FillMode = ENStackFillMode.Last;
stack.FitMode = ENStackFitMode.Last;
NTextBox promptCharTextBox = new NTextBox("_");
promptCharTextBox.MaxLength = 1;
promptCharTextBox.SelectAllOnFocus = true;
promptCharTextBox.HorizontalPlacement = ENHorizontalPlacement.Left;
promptCharTextBox.TextChanged += OnPromptCharTextBoxTextChanged;
stack.Add(NPairBox.Create("Prompt char: ", promptCharTextBox));
m_EventsLog = new NExampleEventsLog();
stack.Add(m_EventsLog);
return stack;
}
public string GetExampleDescription()
{
return @"
This example demonstrates how to create, configure and use masked text boxes. The text box on the right lets you configure
the prompt character (i.e. the PromptChar property) of the sample masked text boxes.
";
}
///
/// Gets the relevant documentation links for the example
///
///
public (string Name, string Url)[] GetDocumentationUrls()
{
return new[]
{
("Masked Text Box", "https://www.nevron.com/docs/openvision/ui-masked-text-box.html"),
("Text Box", "https://www.nevron.com/docs/openvision/ui-text-box.html"),
};
}
#endregion
#region Implementation
#endregion
#region Event Handlers
private void OnMaskInputRejected(NMaskInputRejectedEventArgs arg)
{
m_EventsLog.LogEvent("Rejected Character: '" + arg.Character + "', reason: '" +
NStringHelpers.InsertSpacesBeforeUppersAndDigits(arg.Reason.ToString()) + "'");
}
private void OnPromptCharTextBoxTextChanged(NValueChangeEventArgs arg)
{
string text = (string)arg.NewValue;
if (text != null && text.Length == 1)
{
char promptChar = text[0];
m_PhoneNumberTextBox.PromptChar = promptChar;
m_CreditCardNumberTextBox.PromptChar = promptChar;
m_SocialSecurityNumberTextBox.PromptChar = promptChar;
}
}
#endregion
#region Fields
private NMaskedTextBox m_PhoneNumberTextBox;
private NMaskedTextBox m_CreditCardNumberTextBox;
private NMaskedTextBox m_SocialSecurityNumberTextBox;
private NExampleEventsLog m_EventsLog;
#endregion
#region Static Methods
#endregion
#region Constants
#endregion
#region Nested Types
#endregion
}
}