Hide

SftMask/OCX 7.0 - ActiveX Masked Edit Control

Display
Print

TabAdvance Property, SftMask Object

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

Syntax

Get

VB.NETBoolean = object.TabAdvance As Boolean
VBBoolean = object.TabAdvance As Boolean
C#.NETbool Boolean = object.TabAdvance;
VC++VARIANT_BOOL Boolean = object->TabAdvance;
VARIANT_BOOL Boolean = object->GetTabAdvance();
CHRESULT object->get_TabAdvance(VARIANT_BOOL* Boolean);

Put

VB.NETobject.TabAdvance = Boolean As Boolean
VBobject.TabAdvance = Boolean As Boolean
C#.NETbool object.TabAdvance = Boolean;
VC++VARIANT_BOOL object->TabAdvance = Boolean;
void object->PutTabAdvance(VARIANT_BOOL Boolean);
CHRESULT object->put_TabAdvance(VARIANT_BOOL Boolean);

object

A SftMask object.

Boolean

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

BooleanDescription
TrueEnables tabbing within the control.
FalseDisables tabbing within the 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

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

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#

{
    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++

    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


Last Updated 08/13/2020 - (email)
© 2024 Softel vdm, Inc.