SftMask/OCX 7.0 - ActiveX Masked Edit Control

ForeColorInvalid Property, SftMask Object

Defines the control's default text color when its contents are invalid.

Syntax

Get

VB.NET	Clr = object.ForeColorInvalid As System.Drawing.Color
VB	Clr = object.ForeColorInvalid As OLE_COLOR
C#.NET	System.Drawing.Color Clr = object.ForeColorInvalid;
VC++	OLE_COLOR Clr = object->ForeColorInvalid; OLE_COLOR Clr = object->GetForeColorInvalid();
C	HRESULT object->get_ForeColorInvalid(OLE_COLOR* Clr);

Put

VB.NET	object.ForeColorInvalid = Clr As System.Drawing.Color
VB	object.ForeColorInvalid = Clr As OLE_COLOR
C#.NET	System.Drawing.Color object.ForeColorInvalid = Clr;
VC++	OLE_COLOR object->ForeColorInvalid = Clr; void object->PutForeColorInvalid(OLE_COLOR Clr);
C	HRESULT object->put_ForeColorInvalid(OLE_COLOR Clr);

object

A SftMask object.

Clr

Defines the control's default text color when its contents are invalid.

Comments

The ForeColorInvalid property defines the control's default text color when its contents are invalid (see Contents.Valid).

If the contents are valid, the ForeColor property defines the control's default text color.

If the control is disabled (see Enabled property), the ForeColorGrayed property defines the foreground color.

Text that is selected uses the SelectForeColor property instead. The caption's foreground color is defined using the Caption.ForeColor property.

Examples

VB.NET

Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles MyBase.Load
    AxSftMask1.Caption.SizePercent = 33
    AxSftMask1.Caption.Text = "&Text:"
    AxSftMask1.Mask = "\(###\) ###\-####"
    AxSftMask1.Alignment = SftMaskAlignConstants.alignSftMaskLeft
    AxSftMask1.BackColorInvalid = Color.Red
    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"

View Entire Sample Code

VB6

Private Sub Form_Load()
    With SftMask1.Direct
        .Caption.SizePercent = 33
        .Caption.Text = "&Text:"
        .Mask = "\(###\) ###\-####"
        .Alignment = alignSftMaskLeft
        .BackColorInvalid = vbRed
        .ForeColorInvalid = vbWhite
        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

View Entire Sample Code

C#

private void Form1_Load(object sender, System.EventArgs e)
{
    axSftMask1.Caption.SizePercent = 33;
    axSftMask1.Caption.Text = "&Text:";
    axSftMask1.Mask = @"\(###\) ###\-####";
    axSftMask1.Alignment = SftMaskAlignConstants.alignSftMaskLeft;
    axSftMask1.BackColorInvalid = Color.Red;
    axSftMask1.ForeColorInvalid = Color.White;
    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 {

View Entire Sample Code

C++

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

    m_pMask1->Caption->SizePercent = 33;
    m_pMask1->Caption->Text = _T("&Text:");
    m_pMask1->Mask = _T("\\(###\\) ###\\-####");
    m_pMask1->Alignment = alignSftMaskLeft;
    m_pMask1->BackColorInvalid = RGB(255,0,0);
    m_pMask1->ForeColorInvalid = RGB(255,255,255);
    m_pMask1->FormattedText = _T("Please enter a telephone number");

    return TRUE;
}

void CProject1Dlg::OnChangeSftMask1()
{

View Entire Sample Code

See Also SftMask Object | Object Hierarchy