SftMask/OCX 7.0 Documentation

Display
Print

Position Property, SftMaskCaption Object

Defines the caption's position.

Syntax

Get

VB.NETPos = object.Position As SftMaskPositionConstants
VBPos = object.Position As SftMaskPositionConstants
C#.NETSftMaskPositionConstants Pos = object.Position;
VC++enum SftMaskPositionConstants Pos = object->Position;
enum SftMaskPositionConstants Pos = object->GetPosition();
CHRESULT object->get_Position(enum SftMaskPositionConstants* Pos);

Put

VB.NETobject.Position = Pos As SftMaskPositionConstants
VBobject.Position = Pos As SftMaskPositionConstants
C#.NETSftMaskPositionConstants object.Position = Pos;
VC++enum SftMaskPositionConstants object->Position = Pos;
void object->PutPosition(enum SftMaskPositionConstants Pos);
CHRESULT object->put_Position(enum SftMaskPositionConstants Pos);

object

A SftMaskCaption object.

Pos

Defines the position of the built-in caption.

PosValueDescription
positionSftMaskLeft0The caption is located to the left of the edit control.
positionSftMaskTop1The caption is located above the edit control.
positionSftMaskRight2The caption is located to the right of the edit control.
positionSftMaskBottom3The caption is located below the edit control.

Comments

The Position property defines the caption's position.

The size of the caption area is determined by the SizePercent and the AutoSize properties.

The caption area can be hidden by setting the Position property to positionSftMaskLeft or positionSftMaskRight and the Caption.SizePercent property to 0.

The caption area position and size are defined using a combination of the Caption.SizePercent or Caption.Width, Caption.Position and AutoSize properties. For a detailed description of the various combinations, please see the chapter Built-In Caption.

Examples

VB.NET

Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles MyBase.Load
    AxSftMask1.Mask = "(!0###!!) !1###!!\-!2####!!"
    AxSftMask1.Caption.Text = "&Phone Number: "
    AxSftMask1.Caption.SizePercent = 40
    AxSftMask1.Caption.Alignment = SftMaskAlignConstants.alignSftMaskRight
    AxSftMask1.Caption.Position = SftMaskPositionConstants.positionSftMaskLeft
    AxSftMask1.Caption.VerticalAlignment = SftMaskVerticalAlignConstants.valignSftMaskBaseline
    AxSftMask1.AutoSize = True
    AxSftMask1.Text = "9415058600"
    MsgBox("The area code is " & AxSftMask1.Contents.Value(0))
    MsgBox("The exchange is " & AxSftMask1.Contents.Value(1))
    MsgBox("The last 4 digits are " & AxSftMask1.Contents.Value(2))
    AxSftMask1.Contents.Value(2) = "8555"
End Sub

VB6

Private Sub Form_Load()
    SftMask1.Mask = "(!0###!!) !1###!!\-!2####!!"
    SftMask1.Caption.Text = "&Phone Number: "
    SftMask1.Caption.SizePercent = 40
    SftMask1.Caption.Alignment = alignSftMaskRight
    SftMask1.Caption.Position = positionSftMaskLeft
    SftMask1.Caption.VerticalAlignment = valignSftMaskBaseline
    SftMask1.AutoSize = True
    SftMask1.Text = "9415058600"
    MsgBox ("The area code is " & SftMask1.Contents.Value(0))
    MsgBox ("The exchange is " & SftMask1.Contents.Value(1))
    MsgBox ("The last 4 digits are " & SftMask1.Contents.Value(2))
    SftMask1.Contents.Value(2) = "8555"
End Sub

C#

private void Form1_Load(object sender, System.EventArgs e)
{
    axSftMask1.Mask = @"(!0###!!) !1###!!\-!2####!!";
    axSftMask1.Caption.Text = "&Phone Number: ";
    axSftMask1.Caption.SizePercent = 40;
    axSftMask1.Caption.Alignment = SftMaskAlignConstants.alignSftMaskRight;
    axSftMask1.Caption.Position = SftMaskPositionConstants.positionSftMaskLeft;
    axSftMask1.Caption.VerticalAlignment = SftMaskVerticalAlignConstants.valignSftMaskBaseline;
    axSftMask1.AutoSize = true;
    axSftMask1.Text = "9415058600";
    MessageBox.Show("The area code is " + axSftMask1.Contents.get_Value(0).ToString());
    MessageBox.Show("The exchange is " + axSftMask1.Contents.get_Value(1).ToString());
    MessageBox.Show("The last 4 digits are " + axSftMask1.Contents.get_Value(2).ToString());
    axSftMask1.Contents.set_Value(2, "8555");
}

C++

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

    m_pMask1->Mask = _T("(!0###!!) !1###!!\\-!2####!!");
    m_pMask1->Caption->Text = _T("&Phone Number: ");
    m_pMask1->Caption->SizePercent = 40;
    m_pMask1->Caption->Alignment = alignSftMaskRight;
    m_pMask1->Caption->Position = positionSftMaskLeft;
    m_pMask1->Caption->VerticalAlignment = valignSftMaskBaseline;
    m_pMask1->AutoSize = VARIANT_TRUE;
    m_pMask1->Text = _T("9415058600");
    CString str;
    variant_t v = m_pMask1->Contents->Value[0];
    v.ChangeType(VT_BSTR);
    str.Format(_T("The area code is %s"), CString(v.bstrVal));
    AfxMessageBox(str);

See Also SftMaskCaption Object | Object Hierarchy


Last Updated 09/02/2018 - (email)
© 2019 Softel vdm, Inc.