TabAdvance Property, SftMask Object

Defines whether the Tab key advances to the next input field in the edit control.

Syntax

Get

Put

object

A SftMask object.

Boolean

Defines whether the Tab key advances to the next input field in the edit control.

Comments

The TabAdvance property defines whether the Tab key advances to the next input field in the edit control.

Depending on the input mask, it may be desirable to allow the user to tab between different input fields within one Masked Edit control. For example, when entering dates, the user may wish to tab between Month, Day and Year fields. The TabAdvance property can be used to enable this feature.

If TabAdvance is set to True, the Tab key will advance or back up (Shift+Tab) the caret location to the next input field (see Keyboard & Mouse Interface). If the caret location is already at the end (or beginning) of the input data, the input focus will move to the next (or previous) control on the form instead.

The TabAdvance property has no effect if the control is used as a simple edit control (without Mask).

The TabAdvanceLast property can be used to control whether the Tab key advances to the last position in the control or to the next control instead.

Examples

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 = "&IP:"
    AxSftMask1.Mask = "$I^03(0,255)\.$I^03(0,255)\.$I^03(0,255)\.$I^03(0,255)"
    AxSftMask1.Text = "127.0.0.1"
    AxSftMask1.EditStyle = SftMaskEditStyleConstants.editSftMaskUpDown
    AxSftMask1.AutoAdvance = True
    AxSftMask1.AutoSize = True
    AxSftMask1.TabAdvance = True
    AxSftMask1.TabAdvanceLast = True
    AxSftMask1.EntrySelect = SftMaskEntrySelectConstants.entrySftMaskSelectHome
    AxSftMask1.EntrySelectMouse = True
End Sub

VB6 View entire sample code

Private Sub Form_Load()
    SftMask1.Caption.SizePercent = 33
    SftMask1.Caption.Text = "&IP:"
    SftMask1.Mask = "$I^03(0,255)\.$I^03(0,255)\.$I^03(0,255)\.$I^03(0,255)"
    SftMask1.Text = "127.0.0.1"
    SftMask1.EditStyle = editSftMaskUpDown
    SftMask1.AutoAdvance = True
    SftMask1.AutoSize = True
    SftMask1.TabAdvance = True
    SftMask1.TabAdvanceLast = True
    SftMask1.EntrySelect = entrySftMaskSelectHome
    SftMask1.EntrySelectMouse = True
End Sub

C# View entire sample code

{
    axSftMask1.Caption.SizePercent = 33;
    axSftMask1.Caption.Text = "&IP:";
    axSftMask1.Mask = @"$I^03(0,255)\.$I^03(0,255)\.$I^03(0,255)\.$I^03(0,255)";
    axSftMask1.Text = "127.0.0.1";
    axSftMask1.EditStyle = SftMaskEditStyleConstants.editSftMaskUpDown;
    axSftMask1.AutoAdvance = true;
    axSftMask1.AutoSize = true;
    axSftMask1.TabAdvance = true;
    axSftMask1.TabAdvanceLast = true;
    axSftMask1.EntrySelect = SftMaskEntrySelectConstants.entrySftMaskSelectHome;
    axSftMask1.EntrySelectMouse = true;
}

C++ View entire sample code

    m_pMask1->Caption->SizePercent = 33;
    m_pMask1->Caption->Text = _T("&IP:");
    m_pMask1->Mask = _T("$I^03(0,255)\\.$I^03(0,255)\\.$I^03(0,255)\\.$I^03(0,255)");
    m_pMask1->Text = _T("127.0.0.1");
    m_pMask1->EditStyle = editSftMaskUpDown;
    m_pMask1->AutoAdvance = VARIANT_TRUE;
    m_pMask1->AutoSize = VARIANT_TRUE;
    m_pMask1->TabAdvance = VARIANT_TRUE;
    m_pMask1->TabAdvanceLast = VARIANT_TRUE;
    m_pMask1->EntrySelect = entrySftMaskSelectHome;
    m_pMask1->EntrySelectMouse = VARIANT_TRUE;

    return TRUE;
}

See Also SftMask Object | Object Hierarchy