VerticalAlignment (Property)

The vertical alignment of a control consists in defining the text position in the control in relation to the control borders. This allows you to center the content of an edit control in relation to the borders of input area.

Three types of alignment are available:

Alignment to top
Alignment in the middle
Alignment at bottom

..VerticalAlignment is used to find out and modify the vertical alignment of a control.

The initial alignement of the control is defined when describing the control.

Versions 16 and later

This property is now available for Windows Phone applications.

New in version 16

This property is now available for Windows Phone applications.

Versions 18 and later

This property is now available in Windows Store Apps mode.

This property is now available for report controls in iPhone/iPad applications.

New in version 18

This property is now available in Windows Store Apps mode.

This property is now available for report controls in iPhone/iPad applications.

This property is now available in Windows Store Apps mode.

This property is now available for report controls in iPhone/iPad applications.

Versions 20 and later

This property is now available for table columns in Android and iPhone/iPad applications.

New in version 20

This property is now available for table columns in Android and iPhone/iPad applications.

Versions 21 and later

This property is now available in Universal Windows 10 App mode.

New in version 21

This property is now available in Universal Windows 10 App mode.

Versions 23 and later

This property is now available for all types of window controls in the iPhone/iPad applications.

New in version 23

This property is now available for all types of window controls in the iPhone/iPad applications.

Example

// If the control is aligned to top, align it at bottom
IF STC_Static..VerticalAlignment = vaTop THEN
STC_Static..VerticalAlignment = vaBottom
END

Syntax

Finding out the vertical alignment of a control Hide the details

<Current alignment> = <Control used>..VerticalAlignment

<Current alignment>: Integer constant

Current vertical alignment of control. The possible values are as follows:
vaBottom the text is located at the bottom of control
vaMiddle the text is located in the middle of control
vaTop the text is located at the top of control

Additional alignment options are available:
vaAuto Automatic vertical alignment (correspond to the CSS "auto" value)
vaBaseline Vertical alignment according to the base line (correspond to the CSS "baseline" value)
vaBelow Vertical alignment below the line, in subscript (correspond to the CSS "sub" value)
vaAbove Vertical alignment above the line, in superscript (correspond to the CSS "super" value)
vaNotDefined Vertical alignment inherited from the parent
vaTextBottom Vertical alignment flushed to the bottom (correspond to the CSS "text-bottom" value)
vaTextTop Vertical alignment flushed to the top (correspond to the CSS "text-top" value)

<Control used>: Control name

Name of control to use.

Modifying the vertical alignment of control Hide the details

<Control used>..VerticalAlignment = <New alignment>

<Control used>: Control name

Name of control to use.

<New alignment>: Integer constant

New alignment of the control. The possible values are:
vaBottom the text is located at the bottom of control
vaMiddle the text is located in the middle of control
vaTop the text is located at the top of control

Additional options for the vertical alignment can be specified via the following constants:
vaAuto Automatic vertical alignment (correspond to the CSS "auto" value)
vaBaseline Vertical alignment according to the base line (correspond to the CSS "baseline" value)
vaBelow Vertical alignment below the line, in subscript (correspond to the CSS "sub" value)
vaAbove Vertical alignment above the line, in superscript (correspond to the CSS "super" value)
vaNotDefined Vertical alignment inherited from the parent
vaTextBottom Vertical alignment flushed to the bottom (correspond to the CSS "text-bottom" value)
vaTextTop Vertical alignment flushed to the top (correspond to the CSS "text-top" value)

Remarks

Horizontal alignment

To define the horizontal alignment of the control, use ..HorizontalAlignment.

Limitations

In a window, ..VerticalAlignment is used to find out and modify the vertical alignment for the following types of controls:

Static control
Check box or radio button
Image
Column in a table or in a treeview table
List Box
Combo Box
Bar Code
Chart
Versions 17 and later
Rating control
New in version 17
Rating control
Rating control
Versions 17 and later
Organization Chart
New in version 17
Organization Chart
Organization Chart

In a page, ..VerticalAlignment is used to find out and modify the vertical alignment for the following types of controls:

Edit control
Static control
Button
Check Box / Radio Button
List box, Combo box
Table
Table cell (in read-only)
Versions 18 and later
Treeview table, cell of treeview table (in read-only)
New in version 18
Treeview table, cell of treeview table (in read-only)
Treeview table, cell of treeview table (in read-only)
Formatted display control
HTML control
Link
HTML static
Pager
Breadcrumb
TreeView
Versions 16 and later
Progress Bar
New in version 16
Progress Bar
Progress Bar
Versions 16 and later
Schedule
New in version 16
Schedule
Schedule
Versions 17 and later
Rating control
New in version 17
Rating control
Rating control

In a page, ..VerticalAlignment is used to find out and modify the vertical alignment for the following types of controls:

Edit control
Static control
Button
Check Box / Radio Button
List box, Combo box
Table
Versions 18 and later
Treeview table, cell of treeview table
New in version 18
Treeview table, cell of treeview table
Treeview table, cell of treeview table
Formatted display control
HTML control
Link
HTML static
Pager
TreeView

In a report, ..VerticalAlignment is used to find out and modify the vertical alignment for the following types of controls:

Static control.
Calculated control.
Preset control.
Versions 17 and later
Chart control.
New in version 17
Chart control.
Chart control.
Group of controls: This property will only be applied to the controls that support the vertical alignment.

..VerticalAlignment only applies to the following controls:

Static control.
Image.
Check Box.
Radio Button.
Combo Box.

..VerticalAlignment applies to the table columns.

..VerticalAlignment applies to all types of controls (table columns, static control, ...).