Position Property, SftMaskCaption Object
Defines the caption's position.
Syntax
Get
Put
object
A SftMaskCaption object.
Pos
Defines the position of the built-in caption.
Pos | Value | Description |
---|
positionSftMaskLeft | 0 | The caption is located to the left of the edit control. |
positionSftMaskTop | 1 | The caption is located above the edit control. |
positionSftMaskRight | 2 | The caption is located to the right of the edit control. |
positionSftMaskBottom | 3 | The 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
View Entire Sample Code
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
View Entire Sample Code
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");
}
View Entire Sample Code
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);
View Entire Sample Code
See Also SftMaskCaption Object | Object Hierarchy