HorizontalAlignment (Property)

The horizontal alignment of a control consists in defining the position of the text in the control in relation to the borders of the control. This allows you to center the content of a Static control in relation to the control borders.

Several alignments are available:

alignment to left
alignment to right
centered
justified

HorizontalAlignment is used to find out and modify the horizontal alignment of a control.

The initial alignment of control is defined in the editor during the control description.

Versions 15 and later

This property is now available for Android applications.

New in version 15

This property is now available for Android applications.

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 17 and later

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

New in version 17

This property is now available for window controls in iPhone/iPad 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.

Example

// If the control is left-aligned, align it to right
IF STC_Static1.HorizontalAlignment = haLeft THEN
STC_Static1.HorizontalAlignment = haRight
END

Syntax

Finding out the horizontal alignment of a control Hide the details

<Current alignment>.HorizontalAlignment = <Control used>

<Current alignment>: Integer constant

Current horizontal alignment of control. The possible values are:
haCenter The text is centered.
haRight The text is aligned to right.
haLeft The text is aligned to left.
haJustified The text is justified.
haNotDefined Alignment defined by the CSS inheritance.
This constant is available in WEBDEV only.

<Control used>: Control name

Name of control to use.

Modifying the horizontal alignment of a control Hide the details

<Control used>.HorizontalAlignment = <New alignment>

<Control used>: Control name

Name of control to use.

<New alignment>: Integer constant

New horizontal alignment of the control. The possible values are:
haCenter The text is centered.
haRight The text is aligned to right.
haLeft The text is aligned to left.
haJustified The text is justified.
haNotDefined Alignment defined by the CSS inheritance.
This constant is available in WEBDEV only.

Remarks

Horizontal alignment and text not entirely displayed in the control

The following information is displayed if the text cannot be entirely displayed in the control:

In the report editor, the left part of the text is displayed.
In the window editor:
- in a static control, the right part of text is displayed.
- in an edit control, the left part of text is displayed.

Vertical alignment

To define the vertical alignment of the control, use the VerticalAlignment property.

Limitation

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

Static control
Edit control
Combo Box (editable or not)
Check Box / Radio Button
List Box
ListView
Image
Column in a table and column in a treeview table
Cell in a status bar
Bar code
Chart
Progress Bar. The property is used to find out and modify the horizontal alignment for the percentage of progress displayed in the progress bar.
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 HorizontalAlignment property is used to get and change the horizontal alignment for the following types of controls:

Static, HTML static
Edit control
Button
Check Box / Radio Button
Table, table column
Versions 18 and later
Treeview table, column in treeview table
New in version 18
Treeview table, column in treeview table
Treeview table, column in treeview table
Table cell (in read-only)
Formatted control
List box, Combo box
Looper
HTML control
Link
Pager
Breadcrumb
TreeView

In a PHP page, the HorizontalAlignment property is used to get and change the horizontal alignment for the following types of controls:

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

In a report, the HorizontalAlignment property is used to get and change the horizontal 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.
Groups of controls. This property will only apply to controls that support horizontal alignment.

The HorizontalAlignment property applies only to the following controls:

Static control.
Edit control.
Image.
Check Box.
Radio Button.
List Box.
Combo Box.
Table column (text, combo box or check box).

Versions 20 and later

The HorizontalAlignment property applies to table columns.

New in version 20

The HorizontalAlignment property applies to table columns.