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

The Property CadrageVertical makes it possible to know and modify the vertical framing of an 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 LIB_Libel.framingVertical = vaTop THEN
LIB_Libel.framingVertical = 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, the Property VerticalAlignment allows you to know and modify the vertical framing of fields of type:

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, the Property VerticalAlignment allows you to know and modify the vertical framing of fields of type:

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, the Property VerticalAlignment allows you to know and modify the vertical framing of fields of type:

Edit control
Static control
Button control
Control Switch / Control Selector switch
List Box or Combo Box control
Table control
Versions 18 and later
Control Hierarchical table, cell of TreeView Table control
New in version 18
Control Hierarchical table, cell of TreeView Table control
Control Hierarchical table, cell of TreeView Table control
Formatted display control
HTML control
Link control
HTML Static control
Pager control
TreeView control

In an report, the VerticalAlignment property allows you to know and modify the vertical framing of fields of type:

Static control.
Control Calculated.
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.

The Property VerticalAlignment only applies to the following fields:

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

The Property VerticalAlignment applies to table columns.

The Property VerticalAlignment applies to all types of fields (table columns, labels, ...).