SftMask/OCX 7.0 - ActiveX Masked Edit Control

Empty Property, SftMaskContents Object

Determines whether data has been entered.

Syntax

Get

object

A SftMaskContents object.

Boolean

Determines whether data has been entered.

Comments

The Empty property determines whether data has been entered.

The AllowEmpty property can be used to enable optional data input.

If the DefaultText property is used, the control contents are automatically updated with string defined by the DefaultText property. In that case, the control is no longer considered empty and the Empty property will return False.

Examples

VB.NET

    AxSftMask1.ForeColorInvalid = Color.White
    AxSftMask1.FormattedText = "Please enter a telephone number"
End Sub

Private Sub AxSftMask1_Change(ByVal sender As Object, ByVal e As System.EventArgs) Handles AxSftMask1.Change
    If AxSftMask1.Contents.Valid Then
        MsgBox("This is a valid phone number.")
    Else
        If AxSftMask1.Contents.Empty Then
            AxSftMask1.FormattedText = "Please enter a telephone number"
        Else
            AxSftMask1.FormattedText = ""
        End If
    End If
End Sub

View Entire Sample Code

VB6

        SftMask1.FormattedText = "Please enter a telephone number"
    End With
End Sub

Private Sub SftMask1_Change()
    If SftMask1.Contents.Valid Then
        MsgBox ("This is a valid phone number.")
    Else
        If SftMask1.Contents.Empty Then
            SftMask1.FormattedText = "Please enter a telephone number"
        Else
            SftMask1.FormattedText = ""
        End If
    End If
End Sub

View Entire Sample Code

C#

    axSftMask1.FormattedText = "Please enter a telephone number";
}

private void axSftMask1_Change(object sender, System.EventArgs e)
{
    if (axSftMask1.Contents.Valid) {
        MessageBox.Show("This is a valid phone number.");
    } else {
        if (axSftMask1.Contents.Empty)
            axSftMask1.FormattedText = "Please enter a telephone number";
        else
            axSftMask1.FormattedText = "";
    }
}

View Entire Sample Code

C++

    return TRUE;
}

void CProject1Dlg::OnChangeSftMask1()
{
    if (m_pMask1->Contents->Valid != VARIANT_FALSE) {
        AfxMessageBox(_T("This is a valid phone number."));
    } else {
        if (m_pMask1->Contents->Empty != VARIANT_FALSE)
            m_pMask1->FormattedText = _T("Please enter a telephone number");
        else
            m_pMask1->FormattedText = _T("");
    }
}

BEGIN_EVENTSINK_MAP(CProject1Dlg, CDialog)

View Entire Sample Code

See Also SftMaskContents Object | Object Hierarchy