Ellipsis (Property)

a Static control,
an edit control,
a List Box control,
Versions 17 and later
a Combo Box control,
New in version 17
a Combo Box control,
a Combo Box control,
a button,
a Static table column,
Versions 23 and later
a Static control in a report.
New in version 23
a Static control in a report.
a Static control in a report.

Reminder: The ellipsis is used to indicate that a caption is too long to be entirely displayed. The following characters are added to the caption: "...". The Ellipsis property is used to add these characters.

For example:

Versions 16 and later

This property is now available for Android applications.

New in version 16

This property is now available for Android applications.

Versions 17 and later

This property is now available for iPhone/iPad applications.

New in version 17

This property is now available for iPhone/iPad applications.

Versions 20 and later

This property is now available for table columns in Android applications.

New in version 20

This property is now available for table columns in Android applications.

The Ellipsis property is only available for Static and Edit controls.

The Ellipsis property is only available for Static controls, Edit controls and table columns.

The Ellipsis property is only available for Static controls.

Versions 23 and later

This property is now available for reports.

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

This property is available for reports only.

New in version 23

This property is now available for reports.

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

This property is available for reports only.

This property is now available for reports.

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

This property is available for reports only.

Example

// Change truncation mode with ellipses in EDT_MyControl
IF EDT_MyControl.Ellipsis = ellipsisEnd THEN EDT_MyControl.Ellipsis = ellipsisPath

Syntax

Determining the truncation mode with ellipses Hide the details

<Result> = <Control used>.Ellipsis

<Result>: Integer constant

Current truncation mode with ellipses for the specified control:
ellipsisDisabled The "..." characters are not used. The ellipsis is not added.
ellipsisEnd The "..." characters replace the characters that cannot be displayed at the end of control.
ellipsisPath The "..." characters replace characters in the middle of the text. This constant should be used to display a path to a file.

<Control used>: Control name

Name of window control that must support the ellipsis:
Static,
Edit control,
Button,
List Box control,
Versions 17 and later
Combo Box control,
New in version 17
Combo Box control,
Combo Box control,
Static column
Versions 23 and later
Name of Static control found in the report that must support the ellipsis.
New in version 23
Name of Static control found in the report that must support the ellipsis.
Name of Static control found in the report that must support the ellipsis.
This property is available for Static and Edit controls.
This property is available for the Static controls, the edit controls and the table columns.
This property is only available for Static controls.

Changing the truncation mode with ellipses Hide the details

<Control used>.Ellipsis = <New mode>

<Control used>: Control name

Name of control that will manage the ellipsis:
Static,
Edit control,
Button,
List Box control,
Versions 17 and later
Combo Box control,
New in version 17
Combo Box control,
Combo Box control,
Static column
Versions 23 and later
Name of Static control found in the report that must support the ellipsis.
New in version 23
Name of Static control found in the report that must support the ellipsis.
Name of Static control found in the report that must support the ellipsis.
This property is available for Static and Edit controls.
This property is available for the Static controls, the edit controls and the table columns.
This property is only available for Static controls.

<New mode>: Integer constant (or combination of constants)

New truncation mode with ellipses for the specified control.
ellipsisDisabled The "..." characters are not used. The ellipsis is not added.
ellipsisEnd The "..." characters replace the characters that cannot be displayed at the end of control.
ellipsisPath The "..." characters replace characters in the middle of the text. This constant should be used to display a path to a file.

Remarks

List Box control

The Ellipsis property should not be used in a List Box control with a horizontal scrollbar. Two cases may occur:

The horizontal scrollbar is used to view the entire row.
The Ellipsis property is used. The row is truncated but the horizontal scrollbar becomes useless.

Limitations

The Ellipsis property cannot be used on an RTF Edit control or RTF text.
If the Ellipsis property is used on a column of a multiline table, the multiline mode will be disabled.
The Ellipsis property is not taken into account when using drawing functions in list boxes and combo boxes.
This property is available for Static and Edit controls.
This property is available for the Static controls, the edit controls and the table columns.
This property is only available for Static controls.
This property is available for reports only.