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 VerticalAlignment property is used to get and change the vertical alignment of a control.

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

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 the control
vaMiddle the text is located in the middle of the control
vaTop the text is located at the top of the control

Additional alignment options are available:
vaAbove Vertical alignment above the line, in superscript (correspond to the CSS "super" value)
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)
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 the control to be used.

Modifying the vertical alignment of control Hide the details

<Control used>.VerticalAlignment = <New alignment>

<Control used>: Control name

Name of the control to be used.

<New alignment>: Integer constant

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

Additional options for the vertical alignment can be specified via the following constants:
vaAbove Vertical alignment above the line, in superscript (correspond to the CSS "super" value)
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)
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 the HorizontalAlignment property.

Limitations

In a window, the VerticalAlignment property is used to get and change the vertical alignment for the following types of controls:

Static
Check Box or Radio Button
Image
Column in a Table or TreeView Table
List Box
Combo Box
Bar Code
Chart
Rating control
Organization Chart

In a page, the VerticalAlignment property is used to get and change the vertical alignment for the following types of controls:

Edit control
Static
Button
Check Box / Radio Button
List box, Combo box
Table
Table cell (read-only)
TreeView Table, cell of TreeView Table (read-only)
Formatted display control
HTML control
Link
HTML static
Pager
Breadcrumb
TreeView
Progress Bar
Scheduler
Rating control

In a page, the VerticalAlignment property is used to get and change the vertical alignment for the following types of controls:

Edit control
Static control
Button control
Check Box and Radio Button controls
List Box or Combo Box control
Table control
TreeView Table control and cells of a TreeView Table control
Formatted display control
HTML control
Link control
HTML Static control
Pager control
TreeView control

In a report, the VerticalAlignment property is used to get and change the vertical alignment for the following types of controls:

Static control.
Calculated control.
Preset control.
Chart control.
Group of controls: This property will only apply to controls that support vertical alignment.

The VerticalAlignment property applies only to the following controls:

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

The VerticalAlignment property can be used on table columns.

The VerticalAlignment property applies to all types of controls (table columns, static text, etc.).

The VerticalAlignment property can be used on Static controls.