HeaderPane
Main
Hide
Share Link
Print

VerticalAlignment Property, SftMaskCaption Object

Defines the caption's vertical alignment.

Syntax

Get

C#SftMaskVerticalAlignConstants VAlign = object.VerticalAlignment;
VB.NETVAlign = object.VerticalAlignment As SftMaskVerticalAlignConstants
C++enum SftMaskVerticalAlignConstants VAlign = object->VerticalAlignment;
enum SftMaskVerticalAlignConstants VAlign = object->GetVerticalAlignment();
CHRESULT object->get_VerticalAlignment(enum SftMaskVerticalAlignConstants* VAlign);
VBVAlign = object.VerticalAlignment As SftMaskVerticalAlignConstants

Put

C#SftMaskVerticalAlignConstants object.VerticalAlignment = VAlign;
VB.NETobject.VerticalAlignment = VAlign As SftMaskVerticalAlignConstants
C++enum SftMaskVerticalAlignConstants object->VerticalAlignment = VAlign;
void object->PutVerticalAlignment(enum SftMaskVerticalAlignConstants VAlign);
CHRESULT object->put_VerticalAlignment(enum SftMaskVerticalAlignConstants VAlign);
VBobject.VerticalAlignment = VAlign As SftMaskVerticalAlignConstants

object

A SftMaskCaption object.

VAlign

Defines the caption's vertical alignment.

StyleValueDescription
valignSftMaskTop0The text is aligned with the top border of the caption area.
valignSftMaskBaseline1The baseline of the caption's text is vertically aligned with the baseline of the edit control text. This is typically used to align both the caption and edit control text, when the caption area is on the left or right of the edit control. The baseline is correctly aligned even if different size fonts are used (see Font and Caption.Font properties).
valignSftMaskCenter2The text is vertically centered within the top and bottom border of the caption area.
valignSftMaskBottom3The text is aligned with the bottom border of the caption area.

Comments

The VerticalAlignment property defines the caption's vertical alignment.

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 View entire sample code

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 View entire sample code

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# View entire sample code

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++ View entire sample code

    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 11/03/2026 - (email)
© 2026 Softel vdm, Inc.