SftMask/OCX 7.0 - ActiveX Masked Edit Control

MessageEmpty Property, SftMask Object

Defines the error message text when no input is provided by the end-user.

Syntax

Get

Put

object

A SftMask object.

String

Defines the error message text when no input is provided by the end-user.

Comments

The MessageEmpty property defines the error message text when no input is provided by the end-user.

This error message is displayed when an application uses the Contents.ValidMsg property to test the control contents and the control is empty (see Contents.Empty).

The MessageEmpty property is also used to display the tooltip shown when the mouse cursor hovers over the error image (the control contents are empty and the ImageEmpty property is defined).

The MessageInvalid property defines the error message text when the input is invalid.

The MessageRequired property defines the warning message text when input is required.

Examples

VB.NET

Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles MyBase.Load
    AxSftMask1.Mask = "$D"
    AxSftMask1.Alignment = SftMaskAlignConstants.alignSftMaskLeft
    AxSftMask1.EditStyle = SftMaskEditStyleConstants.editSftMaskCalendarDropDown
    AxSftMask1.AutoAdvance = True
    AxSftMask1.TabAdvance = True
    AxSftMask1.AllowEmpty = False
    AxSftMask1.MessageTitle = "Sample"
    AxSftMask1.MessageEmpty = "Please enter a date"
    AxSftMask1.MessageInvalid = "Please enter a valid date"
    AxSftMask1.AutoSize = True
    AxSftMask1.Calendar.CircleToday = True
    AxSftMask1.Calendar.WeekNumbers = True
    AxSftMask1.Calendar.FirstDate = #1/1/2000#
    AxSftMask1.Calendar.LastDate = #12/31/2020#
    AxSftMask1.Calendar.ShowToday = True

View Entire Sample Code

VB6

Private Sub Form_Load()
    SftMask1.Mask = "$D"
    SftMask1.Alignment = alignSftMaskLeft ' edit control
    SftMask1.EditStyle = editSftMaskCalendarDropDown
    SftMask1.AutoAdvance = True
    SftMask1.TabAdvance = True
    SftMask1.AllowEmpty = False
    SftMask1.MessageTitle = "Sample"
    SftMask1.MessageEmpty = "Please enter a date"
    SftMask1.MessageInvalid = "Please enter a valid date"
    SftMask1.AutoSize = True
    SftMask1.Calendar.CircleToday = True
    SftMask1.Calendar.WeekNumbers = True
    SftMask1.Calendar.FirstDate = #1/1/2000#
    SftMask1.Calendar.LastDate = #12/31/2020#
    SftMask1.Calendar.ShowToday = True

View Entire Sample Code

C#

{
    axSftMask1.Mask = "$D";
    axSftMask1.Alignment = SftMaskAlignConstants.alignSftMaskLeft;
    axSftMask1.EditStyle = SftMaskEditStyleConstants.editSftMaskCalendarDropDown;
    axSftMask1.AutoAdvance = true;
    axSftMask1.TabAdvance = true;
    axSftMask1.AllowEmpty = false;
    axSftMask1.MessageTitle = "Sample";
    axSftMask1.MessageEmpty = "Please enter a date";
    axSftMask1.MessageInvalid = "Please enter a valid date";
    axSftMask1.AutoSize = true;
    axSftMask1.Calendar.CircleToday = true;
    axSftMask1.Calendar.WeekNumbers = true;
    axSftMask1.Calendar.FirstDate = new DateTime(2000, 1, 1);
    axSftMask1.Calendar.LastDate = new DateTime(2020, 12, 31);
    axSftMask1.Calendar.ShowToday = true;

View Entire Sample Code

C++

    m_pMask1->Mask = _T("$D");
    m_pMask1->Alignment = alignSftMaskLeft;
    m_pMask1->EditStyle = editSftMaskCalendarDropDown;
    m_pMask1->AutoAdvance = VARIANT_TRUE;
    m_pMask1->TabAdvance = VARIANT_TRUE;
    m_pMask1->AllowEmpty = VARIANT_FALSE;
    m_pMask1->MessageTitle = _T("Sample");
    m_pMask1->MessageEmpty = _T("Please enter a date");
    m_pMask1->MessageInvalid = _T("Please enter a valid date");
    m_pMask1->AutoSize = VARIANT_TRUE;
    m_pMask1->Calendar->CircleToday = VARIANT_TRUE;
    m_pMask1->Calendar->WeekNumbers = VARIANT_TRUE;

    COleDateTime first(2000, 1, 1, 0,0,0);
    m_pMask1->Calendar->FirstDate = first;
    COleDateTime last(2020, 12, 31, 0,0,0);

View Entire Sample Code

See Also SftMask Object | Object Hierarchy