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 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.

New in version 18

This property is now available in Windows Store Apps mode.

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 name>

<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 name>: Character string (with or without quotes)

Name of control to use.

Modifying the horizontal alignment of a control Hide the details

<Control name>..HorizontalAlignment = <New alignment>

<Control name>: Character string (with or without quotes)

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 ..VerticalAlignment.

Limitation

In a window, ..HorizontalAlignment is used to find out and modify 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 report, ..HorizontalAlignment is used to find out and modify 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 be applied to the controls that support the horizontal alignment.

..HorizontalAlignment applies 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).