HeaderPane
Main
Hide
Share Link
Print

PromptUnderline Property, SftMask Object

Defines whether input fields are underlined when the control has the input focus.

Syntax

Get

C#bool Boolean = object.PromptUnderline;
VB.NETBoolean = object.PromptUnderline As Boolean
C++VARIANT_BOOL Boolean = object->PromptUnderline;
VARIANT_BOOL Boolean = object->GetPromptUnderline();
CHRESULT object->get_PromptUnderline(VARIANT_BOOL* Boolean);

Put

C#bool object.PromptUnderline = Boolean;
VB.NETobject.PromptUnderline = Boolean As Boolean
C++VARIANT_BOOL object->PromptUnderline = Boolean;
void object->PutPromptUnderline(VARIANT_BOOL Boolean);
CHRESULT object->put_PromptUnderline(VARIANT_BOOL Boolean);

object

A SftMask object.

Boolean

Defines whether input fields are underlined when the control has the input focus.

BooleanDescription
TrueAll modifiable positions in a Masked Edit control are underlined.
FalseModifiable positions in a Masked Edit control are displayed as defined using the Font property.

Comments

The PromptUnderline property defines whether input fields are underlined when the control has the input focus.

Using PromptUnderline, input fields are easily recognized by users as all modifiable positions are underlined. Even positions where data has already been entered are underlined.

Input fields are underlined only while the control has the input focus. The PromptUnderlineNoFocus property can be used to define underlining when the control does not have the input focus.

When used with a simple edit control (without Mask), all text is underlined.

Examples

C# View entire sample code

private void Form1_Load(object sender, System.EventArgs e)
{
    axSftMask1.Caption.SizePercent = 33;
    axSftMask1.Caption.Text = "&Password";
    axSftMask1.PromptUnderline = false;
    axSftMask1.Mask = "";
    axSftMask1.PswdChar = "*";
    axSftMask1.MaxLength = 16;
}

VB.NET View entire sample code

Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles MyBase.Load
    AxSftMask1.Caption.SizePercent = 33
    AxSftMask1.Caption.Text = "&Password"
    AxSftMask1.PromptUnderline = False
    AxSftMask1.Mask = ""
    AxSftMask1.PswdChar = "*"
    AxSftMask1.MaxLength = 16
End Sub

C++ View entire sample code

{
    CDialog::OnInitDialog();

    m_pMask1 = m_Mask1.GetControlUnknown();
    _ASSERT(m_pMask1 != NULL);

    m_pMask1->Caption->SizePercent = 33;
    m_pMask1->Caption->Text = _T("&Password");
    m_pMask1->PromptUnderline = VARIANT_FALSE;
    m_pMask1->Mask = _T("");
    m_pMask1->PswdChar = _T("*");
    m_pMask1->MaxLength = 16;

    return TRUE;  // return TRUE  unless you set the focus to a control
}

See Also SftMask Object | Object Hierarchy


Last Updated 11/15/2026 - (email)
© 2026 Softel vdm, Inc.